Editing and Building the Condor Documentation
From Ben's Writing
Contents |
Getting the Documentation
Checking-Out Just the Documentation
mkdir /scratch/<username>/manual cd /scratch/username/manual cvs -d /p/condor/respository/CONDOR_SRC co -r V6_9_4-branch doc
Editing a Part of the Documentation
cd doc/admin-man emacs vm.tex aspell -t -c vm.tex cd .. make ref.pdf
(fix any errors, repeat until no errors)
Commiting the Changes
cvs -q update user-man/vm.tex cvs -q diff user-man/vm.tex cvs commit user-man/vm.tex
Building the Documentation in Windows
You will need several Cygwin packages to build the Condor Documentation:
- tetex
- xfig
Some of which will have added dependencies, that will be added for you.
You will also need the following style file:
- html.sty — from: http://saftsack.fs.uni-bayreuth.de/~latex2ht/ (in the directory latex2html-2002\texinputs, when unpacked)
This will need to be copied to your local texmf directory. Then, of course, you'll need to run texconfig to configure your TeX environment. This is, unfortunatly—due, in part, to the lack of sudo in cygwin—will not function properly, due to some permission problems. These can easily be fixed with the following commands:
chmod 750 /usr/share/texmf chmod 750 /var/cache/fonts chmod 750 /var/lib/texmf
The run the command:
texconfig
If you need to do some serious configuration, or:
mktexlsr
If you just need to tell TeX where the new *.sty files are. After you are done, revert the permissions of the above directories:
chmod 550 /usr/share/texmf chmod 550 /var/cache/fonts chmod 550 /var/lib/texmf
That should about do it (although it does leave the ls-R files writable by your user, but that's a minor point).
