[LON-CAPA-cvs] cvs: doc /help README
bowersj2
lon-capa-cvs@mail.lon-capa.org
Tue, 10 Dec 2002 20:09:34 -0000
bowersj2 Tue Dec 10 15:09:34 2002 EDT
Modified files:
/doc/help README
Log:
Updated information for accuracy.
Index: doc/help/README
diff -u doc/help/README:1.1 doc/help/README:1.2
--- doc/help/README:1.1 Fri Jul 5 12:12:30 2002
+++ doc/help/README Tue Dec 10 15:09:34 2002
@@ -10,7 +10,6 @@
SECTIONS: (dashes to help with using search)
* ---texxml---
-* ---fragmentTopics.gdbm---
* ---fragmentLabels.gdbm---
* ---latexSplitter.py---
* ---simpleEdit.py---
@@ -46,12 +45,9 @@
outputs the latex to std.output.. Then you can render the resulting .tex
however you want.
----fragmentTopics.gdbm---
-
-The has fragmentTopics.dbm is a DBM hash that maps topics to the files
-that contain those topics. Obviously, the topics are thus case
-sensitive. Each topic can only go to one file, but multiple topics can
-point to the same file.
+Note that the current user needs to be able to read the tex files in
+/home/httpd/html/adm/help/tex/, or the script will not work properly
+(and does not currently have any failure messages).
---fragmentLabels.gdbm---
@@ -113,14 +109,23 @@
---texxml files---
* author.manual.texxml - A texxml file for the author's manual.
+* course.manual.texxml - A texxml file for the course coordinator's
+ manual.
In order to build this file, execute
perl texxml2latex.pl authot.manual.texxml > author.manual.tex
-In order to build this file with LaTeX correctly, the images used in
-the manual need to be in the current directory. The images will be
-installed in /home/httpd/html/adm/help/eps , so you can either move
-the LaTeX file in to that directory and build the author manual, or
-copy the LaTeX file and the .eps files in that directory to another
-directory to build. The latter is recommended.
\ No newline at end of file
+---Rendering texxml files---
+
+The script render.texxml.pl takes a texxml file on the command line
+and will render it to ps and pdf files in the current directory. Run
+it from this directory, like so:
+
+perl render.texxml.pl -- author.manual.texxml
+
+Wait, and the ps and pdf files will pop out.
+
+This is usually done by the build system, which will rebuild the files
+when the source files have changed.
+