PACS - PCSS

Generate User Manual from XML as PDF

• cd vs-pcss-src>/pacs/develop/pcss/

• checkout the doc-files from the herschel.pacs.doc-files

• cd to <cvs-pcss-src>/pacs/develop/pcss/herschel/pacs/doc-files

• make you changes in the *.xml files in help/um/xml
• make sure the following env variables are set:
  • $HCSS_DIR pointing to your hcss distribution
  • $PCSS_OUT pointing to your development out directory (in this example $HOME/out)
• make a file jake.root

  •       hcss.jake.outdir = $PCSS_OUT

• run the make_um.local from the doc-files directory

  •          help/bin/make_um.local pdf 

• In the moment you might get an error : xception in thread "main" java.lang.OutOfMemoryError: Java heap space

• If you get no error
  • check the result in your web browser pointing to $HOME/out/pcss/doc/help/um/html/um.html

• if you get an error : exception in thread "main" java.lang.OutOfMemoryError: Java heap space

  • you find the $HOME/out/doc/help/um/pdf/um.fo file which will need to be converted (with the help of FOP http://xmlgraphics.apache.org/fop/download.html#binary) to PDF

  •            java -Xmx3g herschel.ia.document.tools.Fo \
                  -fo ${LOCATION_PDF}/${DOC_NAME}.fo ${LOCATION_PDF}/${DOC_NAME}.pdf 

  • check the result in your web browser pointing to $HOME/out/pcss/doc/help/um/html/um.html

Usage of TestExecutionBrowser just to get an overview

In JIDE :

from herschel.access.util import *
t=TestExecutionBrowser()
t.main(["apid=1152"])