From 71bdb35d52747e6d7d9f55df4524d57c2966be94 Mon Sep 17 00:00:00 2001 From: "Jeffrey H. Kingston" Date: Tue, 14 Sep 2010 19:21:41 +0000 Subject: Lout 3.17. git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@2 9365b830-b601-4143-9ba8-b4a8e2c3339c --- doc/user/README | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 doc/user/README (limited to 'doc/user/README') 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 -- cgit