aboutsummaryrefslogtreecommitdiffstats
path: root/doc/user
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user')
-rw-r--r--doc/user/README2
-rw-r--r--doc/user/all4
-rw-r--r--doc/user/preface2
-rw-r--r--doc/user/typ_book28
-rw-r--r--doc/user/typ_repo17
5 files changed, 33 insertions, 20 deletions
diff --git a/doc/user/README b/doc/user/README
index 22b735c..e03e324 100644
--- a/doc/user/README
+++ b/doc/user/README
@@ -34,4 +34,4 @@ A copy of the final PostScript output file (A4 paper size) is
stored at "ftp://ftp.cs.su.oz.au/jeff/lout/lout-3.19.user.ps.gz".
Jeffrey H. Kingston
-11 May 2000
+3 June 2000
diff --git a/doc/user/all b/doc/user/all
index cf518db..46c35f5 100644
--- a/doc/user/all
+++ b/doc/user/all
@@ -21,8 +21,8 @@ Lout
Document Formatting System
}
@Author { Jeffrey H. Kingston }
- @Edition { Version 3.21
-May, 2000 }
+ @Edition { Version 3.22
+June, 2000 }
@Publisher {
Copyright @CopyRight 1991, 2000 Jeffrey H. Kingston,
Basser Department of Computer Science,
diff --git a/doc/user/preface b/doc/user/preface
index b136bb0..9569cab 100644
--- a/doc/user/preface
+++ b/doc/user/preface
@@ -18,7 +18,7 @@ gnu. @Index { GNU Public License }
primary source is directory
@ID @Code "ftp://ftp.cs.usyd.edu.au/jeff/lout"
in which may be found a gzipped tar file containing the main distribution
-(currently {@Code "lout-3.21.tar.gz"}), and various other things including
+(currently {@Code "lout-3.22.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
diff --git a/doc/user/typ_book b/doc/user/typ_book
index 34abde2..59d81e5 100644
--- a/doc/user/typ_book
+++ b/doc/user/typ_book
@@ -326,13 +326,29 @@ representative sample of these options, showing their default values:
"}"
}
Section {@NumberOf setup} explains how to make your own setup file and
-change its options. @Code "@TitlePageFont" is the font used on the title
+change its options; here we just explain what the options do.
+@PP
+@Code "@TitlePageFont" is the font used on the title
title.page.font. @Index @Code "@TitlePageFont"
-page of the book, not including a size. @Code "@ChapterStartPages"
-determines what kinds of pages chapters and other major components of the
-book may begin on, and may be {@Code Any}, {@Code Odd}, or {@Code Even},
-meaning any page, odd-numbered pages only, or even-numbered pages
-only. @Code "@SeparateIntroNumbering"
+page of the book, not including a size.
+@PP
+@Code "@ChapterStartPages" determines what kinds of pages chapters and
+chapter.start.pages @Index @Code "@ChapterStartPages"
+other major components of the book may begin on, and may be {@Code Any},
+{@Code Odd}, or {@Code Even}, meaning any page, odd-numbered pages only,
+or even-numbered pages only. It may also be {@Code SamePage}, which
+means that chapters and appendices will continue directly after the
+previous chapter or appendix, on the same page (other major components
+such as the table of contents and index will start on a fresh page
+as usual). If you switch to {@Code SamePage}, you will probably need
+to adjust {@Code "@ChapterHeadingFont"} and {@Code "@AboveChapterGap"},
+described below, since their default values are intended for use with
+chapters and appendices that start on a fresh page; and you will also
+need to begin the body of your chapter with a paragraph symbol such as
+@Code "@LP" or {@Code "@PP"}, since otherwise there will be no
+vertical space between the chapter heading and body.
+@PP
+@Code "@SeparateIntroNumbering"
separate.intro.numbering @Index @Code "@SeparateIntroNumbering"
determines whether the introductory part of the book is to have a
separate numbering sequence or not. @Code "@ReferencesBeforeAppendices"
diff --git a/doc/user/typ_repo b/doc/user/typ_repo
index 5cd70ba..a536b12 100644
--- a/doc/user/typ_repo
+++ b/doc/user/typ_repo
@@ -178,17 +178,14 @@ Finally we have three options that control the abstract.
@Code "@AbstractDisplay" may be @Code { Yes } or {@Code No};
it determines whether the abstract is displayed (occupying
the full page width except for an indent at each side like a quoted
-display) or inline (occupying the column width).
-@Code "@AbstractTitle" is the title of the abstract; its default
-value is @Code Abstract or its equivalent in the current language.
+display) or inline (occupying the column width). There is a more
+general option, {@Code "@AbstractFormat"}, in the setup file that
+offers more formatting choices. @Code "@AbstractTitle" is the title
+of the abstract; its default value is @Code Abstract or its equivalent
+in the current language. Finally, @Code "@Abstract" contains the
abstract. @Index @Code "@Abstract"
-Finally, @Code "@Abstract" contains the abstract itself; it may be
-empty or absent, in which case there will be no abstract.
-@PP
-The abstract may contain footnotes in the usual way. Regrettably, each
-footnote in the abstract will generate one spurious `unresolved cross
-reference' error message that does not go away. This slight problem
-might be fixed in the future.
+abstract itself; it may be empty or absent, in which case there will
+be no abstract. The abstract may contain footnotes in the usual way.
@PP
After the compulsory {@Code "//"} comes the report body in the
form of a sequence of sections: