Package documentation (was Re: [OS X TeX] Minimal flowchart)

[Christian Burk]

Am 09.05.2007 um 08:17 schrieb Alan Munn:

> At 8:45 PM -0700 5/8/07, Joshua Smith wrote:
>> On May 8, 2007, at 8:21 PM, Adam M. Goldstein wrote:
>>>
>>> On May 8, 2007, at 8:18 PM, Mark Eli Kalderon wrote:
>>>
>>>> Are you sure it is not installed already? What distribution are  
>>>> you using? Try running kpsewhich pgf.sty to see if it is  
>>>> actually already installed. Best, Mark
>>>
>>> I have TL2007, and the kpsewhihch command Mark suggests found  
>>> pgf.sty om my machine.
>>>
>>> I think Schremmer uses gwTeX, though? As a matter of fact  
>>> ``locate pgf" finds it in the appropriate gwTeX folders.
>>>
>>> So have at it . . .
>>
>> I am considering using pgf/TikZ.  I see (now) that gwTeX includes  
>> it, but when trying to open the documentation, texdoc pgf and  
>> texdoc tikz do not find anything, but texdoc pgfmanual does.  I  
>> only knew this filename because I thought gwTeX did not include it  
>> and found the manual in the package download.  As another example,  
>> texdoc hyperref and texdoc hyperref/manual yield two different  
>> pdfs.  In general, how I am supposed to know how to call the  
>> documentation if texdoc <packagename> does not open it?
>
> This is a bit of a pain.  It would be much nicer if package authors  
> made the documentation file the same as the package name, so that  
> to find the docs for foo.sty one could always type texdoc foo.   
> However, since it's not this way, I usually use locate and grep to  
> find the doc files related to a package.  So locate foo | grep doc  
> will yield a list of files from which one can usually guess the  
> right one for the manaual.

That's a nice tip, thanks. But if I am doing this for

locate hyperref | grep doc

the results a still confusing and it is necessary to read through a  
lot of lines unless guessing the right one.

Christian

------------------------- Helpful Info -------------------------
Mac-TeX Website: http://www.esm.psu.edu/mac-tex/
TeX FAQ: http://www.tex.ac.uk/faq
List Archive: http://tug.org/pipermail/macostex-archives/
List Reminders & Etiquette: http://www.esm.psu.edu/mac-tex/list/