Lout 3.18 tag.3.18

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

1 files changed, 96 insertions, 0 deletions

diff --git a/man/prg2lout.txt b/man/prg2lout.txt
new file mode 100644
index 0000000..991315d
--- /dev/null
+++ b/man/prg2lout.txt
@@ -0,0 +1,96 @@
+
+
+NAME
+     prg2lout - convert computer program text into Lout
+
+SYNOPSIS
+     prg2lout -l language [ options ] files...
+
+DESCRIPTION
+     Reformat computer program text for input to the  Lout  docu-
+     ment  formatting  system, taking care of comments, character
+     strings, tab characters, etc.
+
+     prg2lout reads the named program source files  and  produces
+     output suitable for input to lout -s.  Thus,
+
+          prg2lout -l C foo.c | lout -s | lpr
+
+     will print the C program  foo.c  on  a  PostScript  printer.
+     Each  file will start on a new page, preceded by its name in
+     bold.
+
+OPTIONS
+     -llanguage
+          (Compulsory.)  Files are written in  this  programmming
+          language.  Run prg2lout -u to see the list of languages
+          available.
+
+     -pfixed
+          Use a fixed width font (the default for C).
+
+     -pvarying
+          Use a varying-width italic font  with  non-italic  bold
+          keywords (the default for Eiffel).
+
+     -psymbol
+          Use a varying-width italic font with mathematical  sym-
+          bols and non-italic bold keywords.
+
+     -n   Do not print the file name before each source file.
+
+     -f font
+          Select a font family.  The  default  is  -fCourier  for
+          -pfixed, and -fTimes for -pvarying and -psymbol.
+
+     -s size
+          Select a Lout font size.  The default is -s9p  (meaning
+          9  points)  for  -pfixed,  and  -s10p for -pvarying and
+          -psymbol.  These work well with 80-character-wide  pro-
+          grams.
+
+     -v vsize
+          Select a Lout vertical inter-line gap.  The default  is
+          -v1.1fx  meaning  1.1 times the font size measured from
+          baseline to baseline.
+
+     -t num
+          Set the tab interval  to  num  characters  (default  is
+          -t8).
+
+     -T width
+          Without  this  option,  prg2lout  simulates  tabs  with
+          spaces.  With this option, prg2lout simulates tabs with
+          Lout tabulation operators; width is the  width  of  one
+          tab  interval  in  the  final  print,  measured in Lout
+          units.  This guarantees alignment of characters follow-
+          ing  tabs even with varying-width fonts, provided width
+          is sufficiently large.  For  example,  -T0.5i  produces
+          half-inch tab intervals.
+
+     -u   Print usage information on stderr, including  available
+          languages, and exit.
+
+     -V   Print version information on stderr and exit.
+
+  Raw Mode
+     There is a raw mode usage of prg2lout invoked by a  -r  flag
+     (must  be  the  first  argument).  This converts one program
+     file into Lout-readable source without any heading or trail-
+     ing information.  Synopsis:
+
+          prg2lout -r -i infile -o out -e err -t num -T width
+
+     Users should never need this mode; it is  invoked  automati-
+     cally from within Lout by symbols supplied with the standard
+     configuration (see reference).
+
+SEE ALSO
+     lout(1), lpr(1), ghostview(1).
+
+REFERENCES
+     Jeffrey H. Kingston, A User's Guide  to  the  Lout  Document
+     Formatting System, Chapter 11.
+
+AUTHOR
+     Jeffrey H. Kingston