aboutsummaryrefslogtreecommitdiffstats
path: root/doc/user
diff options
context:
space:
mode:
authorJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 20:38:02 +0000
committerJeffrey H. Kingston <jeff@it.usyd.edu.au>2010-09-14 20:38:02 +0000
commit9daa98ce90ceeeaba9e942d28575d8fcfe36db4b (patch)
tree94d258acb2a5bdddc318dbdc59b788bb8f52c704 /doc/user
parentc89f0bc2209f7f98695e6b94fbac316c84fbf9d4 (diff)
downloadlout-9daa98ce90ceeeaba9e942d28575d8fcfe36db4b.tar.gz
Lout 3.26.
git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@21 9365b830-b601-4143-9ba8-b4a8e2c3339c
Diffstat (limited to 'doc/user')
-rw-r--r--doc/user/README19
-rw-r--r--doc/user/all6
-rw-r--r--doc/user/bgr_scal1
-rw-r--r--doc/user/preface6
-rw-r--r--doc/user/str_list4
-rw-r--r--doc/user/typ_book12
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