diff options
Diffstat (limited to 'doc/user/README')
| -rw-r--r-- | doc/user/README | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/doc/user/README b/doc/user/README new file mode 100644 index 0000000..fd69ccb --- /dev/null +++ b/doc/user/README @@ -0,0 +1,37 @@ +Directory lout/doc/user + +This directory contains the Lout source files for the User's Guide +to the Lout Document Formatting System. To produce the Guide, +type the command + + lout all > op + +in this directory. This must be done five times to completely +resolve all cross references, although the PostScript file op is +printable after the first run. Auxiliary files with .li and .ld +suffixes will be created in this directory. + +The first run will produce a large number of error messages, +nearly all beginning with "unresolved cross reference". These +should gradually go away on later runs. The following shows the +error message output on the fifth run for A4 size printing: + +lout file "cpp_tabs" (from "cpp" line 24, from "all" line 38): + 53,23: c2lout: C text ended inside a comment + 55,35: c2lout: C text ended inside a comment + +These two warnings point to two places where a C program text ended +inside a comment, which in these cases was deliberate so is no problem. +If you set the document in Letter size paper, you will also get a +couple of other warning messages pointing to places where Lout had +to slightly scale a display to fit the smaller page. + +Optimal page breaking has been turned off for this document owing to +repeated failure to converge, caused by footnotes and floating figures +close to large unbreakable displays. + +A copy of the final PostScript output file (A4 paper size) is +stored at "ftp://ftp.cs.su.oz.au/jeff/lout/lout.3.17.user.ps.gz". + +Jeffrey H. Kingston +17 September 1999 |