Lout 3.21.

git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@11 9365b830-b601-4143-9ba8-b4a8e2c3339c

1 files changed, 27 insertions, 1 deletions

diff --git a/doc/user/prg_chan b/doc/user/prg_chan
index 6273b7d..781e9bb 100644
--- a/doc/user/prg_chan
+++ b/doc/user/prg_chan
@@ -23,6 +23,7 @@ cprint. @Index @Code "@CPSetup"
 {
 @Rowa A { "@Use {  @CPSetup" }
 @Rowb A { "pipe" } B {          }
+@Rowb A { "numbered" } B { No         }
 @Rowb A { "style" } B { fixed         }
 
 @Rowa 
@@ -39,6 +40,7 @@ cprint. @Index @Code "@CPSetup"
 @Rowb A { "fixednumbers" }		B { Base  }
 @Rowb A { "fixedstrings" }		B { Base  }
 @Rowb A { "fixedcomments" }		B { Base  }
+@Rowb A { "fixedlinenumbers" }		B { Base  }
 
 @Rowa 
 @Rowb A { "fixedidentifiersformat" }	B { "@Body"  }
@@ -47,6 +49,7 @@ cprint. @Index @Code "@CPSetup"
 @Rowb A { "fixednumbersformat" }	B { "@Body"  }
 @Rowb A { "fixedstringsformat" }	B { "@Body"  }
 @Rowb A { "fixedcommentsformat" }	B { "@Body"  }
+@Rowb A { "fixedlinenumbersformat" }	B { "@Body"  }
 
 @Rowa 
 @Rowa A { "..." }
@@ -60,13 +63,24 @@ options whose name begins with @Code "fixed" apply only when
 shown, which apply when @Code style is {@Code varying} and {@Code symbol}.
 @PP
 We can see in this extract that the default value of @Code style is
-{@Code fixed}.  We can also see the default font family, font face, font size,
+{@Code fixed}, and of @Code "numbers" is {@Code No}.  We can also see the
+default font family, font face, font size,
 line spacing, and tab settings when the style is {@Code "fixed"}.  The
 font family name for @Code "fixed" style is {@Code "Courier"}, but for the
 other styles (not shown) it is empty.  This causes the @Code "fixed" style
 to always switch to Courier, and the other styles to use the same font
 family as in the surrounding document.
 @PP
+The options from @Code "fixedidentifiers" to @Code "fixedlinenumbers" allow
+you to set the font face to use for each of these parts of your
+program.  People who want fixed-width fonts do not usually want very
+exciting font faces either, so the default values above are all
+{@Code "Base"}, but for the {@Code varying} and {@Code symbol} styles,
+the default identifier face is {@Code Slope}, the default keyword
+face is {@Code Bold}, and so on.  You can actually give a family name
+before the face name in these options, allowing you to switch font
+families for different parts of the program if you wish.
+@PP
 The @Code fixedidentifiersformat option allows you to make a more
 radical change to the format of identifiers than just the font.  Within
 this option, @Code "@Body" stands for the identifier being formatted, and
@@ -99,6 +113,18 @@ Or suppose you like @Code "varying" as it stands, but would like it to be
 the default style rather than {@Code "fixed"}.  Again, only one line needs
 to be changed, to {@Code "style { varying }"}.
 @PP
+It is probably not a good idea to change the default value of
+@Code { numbered } to {@Code Yes}, because small fragments of
+code within paragraphs will then get line numbers as well as large
+displayed programs.  If you do have many large numbered programs as
+well as small fragments, a better approach would be to place
+@ID @OneRow @Code @Verbatim {
+import @CPSetup
+macro @NCP { @CP numbered { Yes } }
+}
+(or the equivalent for your language) in your @Code mydefs file, so that
+you can type @Code "@NCP" instead of {@Code "@CP numbered { Yes }"}.
+@PP
 The setup files for the other languages are identical to this one, except
 that the symbol after @Code "@Use" is different, and some of the
 default values may be different.  Changing an option affects only the