[OS X TeX] ntheorem is out fishing

[Bruno Voisin]

Le 28 mai 04, à 23:01, Alain Schremmer a écrit :

>  I looked up the Not so short and the Flynn. They mention a Local 
> Guide supposed to come with "each Latex Installation" that I can't 
> find either and the Latex Companion that I am going to buy Tuesday.

The Local Guide is a concept from the early days of LaTeX, before the 
invention of the personal computer, when every user was supposed to 
work on a mainframe in an institution, university or company with a 
system administrator taking care of installation and day-to-day 
maintenance of LaTeX. The Local Guide was supposed to be the manual 
written by the administrator, telling about all the peculiars of the 
installation, about all the styles (now packages) available, and so 
forth.

The closest to this in a (La)TeX distribution nowadays, either 
commercial or free, is the installation guide or manual written by the 
creator of the distribution, I think. For teTeX, it would be 
/Library/teTeX/share/texmf/doc/tetex/TETEXDOC.pdf, and also 
/Library/teTeX/README.texmf.gwtex.txt and 
/Library/teTeX/README.howtexfindsfiles.txt, etc.

>  I finally asked Google which sent me to Göttingen and, yes, there it 
> was and yes, there it still is, meanning I had no ides of what they 
> meant by

> Just get all ntheorem.dtx and ntheorem.ins and run "latex 
> ntheorem.ins". This creates "ntheorem.sty", "ntheorem.std" and 
> "ntheorem.drv". Copy/move them to suitable directories (where 
> $TEXINPUTS will search for them). Then run "latex ntheorem.drv" thrice 
> to get the documentation (you have to run it three times to get all 
> references and generated lists right).

>  It seems exactly what I need but could a gentle soul translate this 
> for me? (I am running 10.3.3.)

It works exactly as told, except for the $TEXINPUTS bit (the meaning of 
$TEXINPUTS is explained in the above file 
/Library/teTeX/README.howtexfindsfiles.txt, see also 
/Library/teTeX/texmf.cnf).

Let's suppose you got the files 00readme, ntheorem.dtx and ntheorem.ins 
from CTAN and want to install ntheorem in your home directory, in 
~/Library/texmf:

- Run LaTeX on ntheorem.ins. It will produce, out of ntheorem.dtx, the 
files ntheorem.drv, ntheorem.std and ntheorem.sty (and also a 
ntheorem.log, which isn't used).

- Put ntheorem.sty and ntheorem.std inside ~/Library/texmf/tex/latex/, 
for example inside ~/Library/texmf/tex/latex/ntheorem/. That's the only 
really necessary bit.

- If you're interested by docs, run LaTeX on ntheorem.drv (TeXShop 
won't accept to LaTeX this file, you'll have to rename it to 
ntheorem.tex, say, beforehand) thrice (once to create a .toc -- table 
of contents -- file, twice to incorporate the content of this file into 
ntheorem.pdf, and thrice to update the page numbers which may have 
changed because of the inclusion).

- Put the doc files ntheorem.pdf and 00readme inside 
~/Library/texmf/doc/latex/, for example inside 
~/Library/texmf/doc/latex/ntheorem. It doesn't affect at all the 
running of LaTeX, it's just to put these files at a place where you can 
find them easily in the future.

Regarding the complicated directory structure of TeX, more can be found 
in /Library/teTeX/share/texmf.tetex/doc/help/tds.dvi (drag this file 
onto the Desktop, then onto TeXShop which will convert it to PDF and 
preview it).

I don't use ntheorem myself, thus I can't say more. The above 
instructions are not specific to it, that's more-or-less the procedure 
to install any LaTeX package which is not already built-in in your 
LaTeX distribution.

Hope this helps,

Bruno Voisin
-----------------------------------------------------
Post: <mailto:MacOSX-TeX at email.esm.psu.edu>
Please see <http://www.esm.psu.edu/mac-tex/> for list
guidelines, information, and LaTeX/TeX resources.