GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PRG2LOUT (1)

NAME

prg2lout - convert computer program text into Lout

CONTENTS

Synopsis
Description
Options
     Raw Mode
See Also
References
Author

SYNOPSIS

prg2lout -l language [ options ] files...

DESCRIPTION

Reformat computer program text for input to the Lout document 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 symbols 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 programs.
-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.
-b num Select a blank line scale factor. The default is -b1.0 meaning no scaling. A good alternative is 0.6.
-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 following tabs even with varying-width fonts, provided width is sufficiently large. For example, -T0.5i produces half-inch tab intervals.
-L number
  Attach line numbers to the program text, beginning with number or 1 if number is not given. You may need to give the 1 anyway to prevent .I prg2lout from taking a following file name as a number.
-N Do not print line numbers on blank lines.
-M Like -N but do not assign line numbers to blank lines.
-S filename
  Use filename as the setup file instead of the system default setup file. The setup file determines the value of all formatting options not given to prg2lout as command line arguments.
-u Print usage information on stderr, including available languages, and exit.
-V Print version information on stderr and exit.

    Raw Mode

There is a \(lqraw mode\(rq 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 trailing information. Synopsis:

prg2lout -r -i infile -o out -e err -t num -T width

Users should never need this mode; it is invoked automatically from within Lout by symbols supplied with the standard configuration (see reference).

SEE ALSO

lout(1), lpr(1), ghostview(1).

REFERENCES

Jeffrey H. Kingston, \(lqA User’s Guide to the Lout Document Formatting System\(rq , Chapter 11.

AUTHOR

Jeffrey H. Kingston

Search for    or go to Top of page |  Section 1 |  Main Index


PRG2LOUT (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.