diff options
Diffstat (limited to 'doc/user')
| -rw-r--r-- | doc/user/README | 19 | ||||
| -rw-r--r-- | doc/user/all | 6 | ||||
| -rw-r--r-- | doc/user/bgr_scal | 1 | ||||
| -rw-r--r-- | doc/user/preface | 6 | ||||
| -rw-r--r-- | doc/user/str_list | 4 | ||||
| -rw-r--r-- | doc/user/typ_book | 12 |
6 files changed, 27 insertions, 21 deletions
diff --git a/doc/user/README b/doc/user/README index 16f4db9..86f6ce2 100644 --- a/doc/user/README +++ b/doc/user/README @@ -21,24 +21,29 @@ lout file "typ_repo" (from "typ" line 19, from "all" line 38): 38,1: 1.0c object too high for 0.2c space; will try elsewhere lout file "typ_over" (from "typ" line 21, from "all" line 38): 8,1: 1.0c object too high for 0.0c space; will try elsewhere +lout file "gra_summ" (from "gra" line 44, from "all" line 45): + 8,1: 23.6c object too high for 23.6c space; @Scale inserted lout file "prg_tabs" (from "prg" line 108, from "all" line 46): 58,23: prg2lout 2,1: program text ended within comment 60,35: prg2lout 2,1: program text ended within comment The first two warnings are about footnotes whose first lines did not fit on the bottom of the current page, so had to begin on the following -page. The last two warnings point to two places where a C program text -ended inside a comment, which in these cases was deliberate. If you set -the document in Letter size paper, you will also get different warning -messages pointing to places where Lout had to slightly scale a display -to fit the smaller page. +page. The third warning is about a large table that had to be scaled +down very slightly to fit on the page (lengths are printed to one +decimal place, which in this case gives the misleading impression +that the table did actually fit to begin with). The last two warnings +point to two places where a C program text ended inside a comment, +which in these cases was deliberate. If you set the document in +Letter size paper, you will get a somewhat different set of warning +messages. 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.25.user.ps.gz". +stored at "ftp://ftp.cs.su.oz.au/jeff/lout/lout-3.26.user.ps.gz". Jeffrey H. Kingston -24 December 2001 +16 October 2002 diff --git a/doc/user/all b/doc/user/all index bafac7a..a10e5c6 100644 --- a/doc/user/all +++ b/doc/user/all @@ -21,10 +21,10 @@ Lout Document Formatting System } @Author { Jeffrey H. Kingston } - @Edition { Version 3.25 -September, 2001 } + @Edition { Version 3.26 +October, 2002 } @Publisher { -Copyright @CopyRight 1991, 2000 Jeffrey H. Kingston, +Copyright @CopyRight 1991, 2002 Jeffrey H. Kingston, Basser Department of Computer Science, The University of Sydney 2006, Australia. ISBN 0 86758 951 5. } diff --git a/doc/user/bgr_scal b/doc/user/bgr_scal index 37b6582..7623967 100644 --- a/doc/user/bgr_scal +++ b/doc/user/bgr_scal @@ -65,5 +65,4 @@ does produce scaling: This is a good option if scaling is being used when a display is around the same width as the page; it scales only if this is needed to fit the display into the column, not otherwise. -slig @End @Section diff --git a/doc/user/preface b/doc/user/preface index ff16e97..c694c59 100644 --- a/doc/user/preface +++ b/doc/user/preface @@ -16,9 +16,9 @@ with the software. Lout is distributed free of charge under the GNU Public License. The gnu. @Index { GNU Public License } primary source is directory -@ID @Code "ftp://ftp.cs.usyd.edu.au/jeff/lout" +@ID @Code "ftp://ftp.it.usyd.edu.au/jeff/lout" in which may be found a gzipped tar file containing the main distribution -(currently {@Code "lout-3.25.tar.gz"}), and various other things including +(currently {@Code "lout-3.26.tar.gz"}), and various other things including a PostScript version of this guide. The distribution contains source code, libraries, documentation, license, and installation instructions. @PP @@ -64,6 +64,6 @@ Jeffrey H. Kingston School of Information Technologies (formerly Basser Department of Computer Science) The University of Sydney 2006, Australia -@Code "jeff@cs.usyd.edu.au" +@Code "jeff@it.usyd.edu.au" } @End @Preface diff --git a/doc/user/str_list b/doc/user/str_list index 0654ca6..890acbf 100644 --- a/doc/user/str_list +++ b/doc/user/str_list @@ -187,7 +187,9 @@ drop.list.item @Index @Code "@DropListItem" dli. @Index @Code "@DLI" symbol corresponding to {@Code "@ListItem"}, but it is very rarely needed. Lout is not able to decide for itself whether a label is wide -enough to require a drop item. +enough to require a drop item. Lout will refuse to skip to the next +column or page between a drop tag and its item, preferring instead +to move the drop tag to the next column or page. @PP Each list has a `raw' version which omits the preceding space, and raw.lists @Index { raw lists } diff --git a/doc/user/typ_book b/doc/user/typ_book index fd83483..059029a 100644 --- a/doc/user/typ_book +++ b/doc/user/typ_book @@ -284,12 +284,12 @@ part.text @Index @Code "@PartText" " @PartTitle { The Ancient World }" " @PartText { ... }" } -Any chapter with a non-empty @Code "@PartTitle" option will become the -first chapter of a part. It will be preceded by two pages containing the -part number, title, and text, and there will also be an entry -made in the table of contents. @Code "@PartNumber" and @Code "@PartText" -may be omitted. Parts are @I not numbered automatically: you -have to supply your own numbers or letters as shown above. +Any chapter with a non-empty @Code "@PartNumber" or @Code "@PartTitle" +option will become the first chapter of a part. It will be preceded +by two pages containing the part number, title, and text, and there +will also be an entry made in the table of contents. Parts are @I not +numbered automatically: you have to supply your own numbers or letters +as shown above. @PP The features described in other chapters are all available within books. A table of contents and index will appear automatically, and |