[OS X TeX] Re: [XeTeX] texdoc, was: Microtypography?

[Adam R. Maxwell]

On May 10, 2006, at 09:04, Bruno Voisin wrote:

> Le 10 mai 06 à 17:07, Adam R. Maxwell a écrit :
>
>> If it's just searching for a matching package/doc name, you may as  
>> well use TCOBrowser; that's a similar heuristic to what I used for  
>> finding documentation.  TCOBrowser also searches all subfolders of  
>> whatever tree you give it, and is a drag-and-drop install that  
>> does not require admin privileges.
>
> Thanks, I hadn't realized TCOBrowser could also be used to browse  
> through a local TeX tree (as opposed to a CTAN repository).

I never had time for any documentation or advertising :).

> Does the document icon in the Local and Remote columns mean that  
> the documentation has been found?

Yes.  Local is on your drive, from the location(s) you set in prefs,  
while remote is on the CTAN site.

> If so, then it seems that TCOBrowser looks for a documentation file  
> matching exactly the package name, right? That would explain why  
> the local documentation for hyperref (namely /usr/local/teTeX/share/ 
> texmf.tetex/doc/latex/hyperref/manual.pdf) isn't seen, and why the  
> local documentation for the AMS fonts (namely /usr/local/teTeX/ 
> share/texmf.tetex/doc/fonts/amsfonts/amsfndoc.dvi) is replaced by  
> that (namely /usr/local/teTeX/share/texmf.tetex/doc/latex/amsfonts/ 
> amsfonts.dvi) for the associated LaTeX package.

Yes, that's correct.  At the time, I thought it was pretty lame, but  
I couldn't (and can't) think of anything better.

I could adapt the file content search I added to BibDesk, and allow  
you to search all the recognized file types in the TeX tree by  
content, which would give boolean/wildcard functionality and a search  
score.

> Still, I'm surprised that the remote doc for hyperref (on CTAN) is  
> taken to be tex-archive/macros/latex/contrib/hyperref/doc/ 
> slides.pdf instead of tex-archive/macros/latex/contrib/hyperref/doc/ 
> manual.pdf. How is this determined? From some CTAN mechanism?

If I recall correctly, I take these the TeX Catalogue Online, which  
may list several files for documentation.  I think they're unordered,  
so I just link to the first one listed.

> Suggestion for TCOBrowser: it would be nice if, when moving the  
> mouse over a document of MikTeX package icon, the associated path  
> or URL was displayed in one of those yellow boxes (I don't know the  
> exact name for these boxes).

Would be doable.  I should do my yearly TCOBrowser update, but  
BibDesk is more fun to work on in my not-so-spare time.

Adam------------------------- Info --------------------------
Mac-TeX Website: http://www.esm.psu.edu/mac-tex/
          & FAQ: http://latex.yauh.de/faq/
TeX FAQ: http://www.tex.ac.uk/faq
List Archive: http://tug.org/pipermail/macostex-archives/