|Prev||Appendix A. Documentation||Next|
The hardcopy Postscript documentation is generated by converting the SGML source code to RTF, then importing into Applixware. After a little cleanup (see the following section) the output is "printed" to a postscript file.
Some figures were redrawn to avoid having bitmap GIF files in the hardcopy documentation. One figure, of the system catalogs, was sufficiently complex that there was not time to redraw it. It was converted to fit using the following commands:
% convert -v -geometry 400x400'>' figure03.gif temp.gif % convert -v -crop 400x380 temp.gif catalogs.gif
Several items must be addressed in generating Postscript hardcopy:
Applixware RTF Cleanup
Applixware does not seem to do a complete job of importing RTF generated by jade/MSS. In particular, all text is given the “Header1” style attribute label, although the text formatting itself is acceptable. Also, the Table of Contents page numbers do not refer to the section listed in the table, but rather refer to the page of the ToC itself.
Generate the RTF input by typing
% cd doc/src/sgml % make tutorial.rtf
Open a new document in Applix Words and then import the RTF file.
Print out the existing Table of Contents, to mark up in the following few steps.
Insert figures into the document. Center each figure on the page using the centering margins button.
Not all documents have figures. You can grep the SGML source files for the string “Graphic” to identify those parts of the documentation which may have figures. A few figures are replicated in various parts of the documentation.
Work through the document, adjusting page breaks and table column widths.
If a bibliography is present, Applix Words seems to mark all remaining text after the first title as having an underlined attribute. Select all remaining text, turn off underlining using the underlining button, then explicitly underline each document and book title.
Work through the document, marking up the ToC hardcopy with the actual page number of each ToC entry.
Replace the right-justified incorrect page numbers in the ToC with correct values. This only takes a few minutes per document.
Save the document as native Applix Words format to allow easier last minute editing later.
Export the document to a file in Postscript format.
Compress the Postscript file using gzip. Place the compressed file into the doc directory.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.