Проект OpenNet: MAN ctlmp (1) Команды и прикладные программы пользовательского уровня (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

ctlmp (1)

>> ctlmp (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )

NAME
ctlmp - PostScript pretty printer

SYNOPSIS
ctlmp [ -A4 ] [ -C ] [ -F ] [ -L localename ] [ -O orienta-
tion ] [ -PS ] [ -US ] [ -a ] [ -c chars ] [ -d ] [ -e ] [
-ff ] [ -fp ] [ -l ] [ -m ] [ -o ] [ -p prologue ] [ -s sub-
ject ] [ -tm ] [ -ts ] [ -v ] [ -w words ] [ -W ][ -? ] [
filename... ]

DESCRIPTION
The ctlmp program reads each filename in sequence and gen-
erates a prettified version of the contents in POSTSCRIPT
format, sent to standard output. If no filename argument is
provided, ctlmp reads the standard input. If the standard
input is a terminal, input is terminated by an EOF signal,
usually Ctrl-D.

Mail items, news articles, ordinary ASCII files, complete
mail folders, and digests are all acceptable input formats
for ctlmp. The output format includes grayscale lozenges
containing banner information at the top and bottom of every
page.

The program is conveniently used in conjunction with the
print button of the mailtool(1) program, or the pipe command
provided by mail(1). Add the following two lines to your
.mailrc file:
set printmail='ctlmp | lp'
set cmd="ctlmp | lp &"

Source the .mailrc file, and you are ready to use ctlmp.
For printing ordinary ASCII files, the following alias (to
be placed in your
alias print 'ctlmp -o -s "\!*" <\!* | lp'

OPTIONS
-A4 Use A4 paper size (8.5 x 11.4 inches).

-C Instead of using "\nFrom" to denote the start of new
mail messages, ctlmp will look for (and use) the value
of the Content-Length: mail header. If the Content-
Length doesn't take you to the next "\nFrom", then it's
wrong, and ctlmp falls back to looking for the next
"\nFrom" in the mail folder.

-F Instead of printing who the mail article is for, the
top header will contain who the mail article is from. A
useful option for people with their own personal
printer.

-L localename
Provide the locale of the file to be printed. If this
command line option is not present, then ctlmp looks
for the MP_LANG environment variable. If that is not
present, then the LANG environment variable is used. If
none of these options are present, then ctlmp tries to
determine the locale it is running in, and if it can-
not, then it assumes it is running in the C locale,
otherwise a prologue file specific to the given locale
is prepended to the output. This is to provide I18N
level 4 (multibyte) printing.

In CTL locales (ar, he, and th_TH) the printed text layout
can be controlled by a file located at:
($OPENWINHOME/lib/locale/<localename>/print/ctlmpresource).

The following controls can be added to ctlmpresource file:
Orientation : ORIENTATION_LTR or
: ORIENTATION_LTR or
: ORIENTATION_CONTEXTUAL

Numerals : NUMERALS_NOMINAL or
: NUMERALS_NATIONAL or
: NUMERALS_CONTEXTUAL

TextShaping : TEXT_SHAPED or
: TEXT_NOMINAL or
: TEXT_SHFORM1 or
: TEXT_SHFORM2 or
: TEXT_SHFORM3 or
: TEXT_SHFORM4

SWAPPING : YES or NO

TEXT_VISUAL or TEXT_IMPLICIT

CONTEXT_LTR or CONTEXT_RTL

If one of these values is not correctly set in the
ctlmpresource or the file doesn't exist then ctlmp will
use the default layout values.

-O orientation
A command line that controls the text orientation of
the printed file, specifically for Arabic and Hebrew
locales. the orientation could be rtl for right to
left layout and right justified printed text, ltr for
left to right text, and context for the context depen-
dent layout direction. if this command line option is
not present, then ctlmp will use the Orientation set-
ting in the ctlmpresource file, if the Orientation is
not set in the ctlmpresource file then the default
locale orientation will be used.

-PS If the mail or digest message just has PostScript as
the text of the message, then this is normally just
passed straight through. Specifying this option, causes
PostScript to be printed as text.

-US Use US paper size (8.5 x 11 inches). This is the
default paper size.

-a Format the file as a news article. The top banner con-
tains the text: "Article from newsgroup", where news-
group is the first news group found on the Newsgroups:
line.

-c chars
The maximum number of characters to extract from the
gecos field of the users /etc/passwd entry. The default
is 18.

-d Format the file as a digest.

-e Assume the ELM mail frontend intermediate file format.
Used when printing messages from within ELM (using the
"p" command), especially for printing tagged messages.
This option must be specified in your ELM option setup.

-ff Format the file for use with a Filofax personal
organiser.

-fp Format the file for use with a Franklin Planner per-
sonal organiser.

-l Format output in landscape mode. Two pages of text
will be printed per sheet of paper.

-m Format the file as a mail folder, printing multiple
messages.

-o Format the file as an ordinary ASCII file.

-p prologue
Employ the file prologue as the POSTSCRIPT prologue
file, overriding any previously defined file names.

-s subject
Use subject as the new subject for the printout. If
you are printing ordinary ASCII files which have been
specified on the command line, the the subject will
default to the name of each of these files.

-tm Format the file for use with the Time Manager personal
organiser.

-ts format the file for use with the Time/System Interna-
tional personal organiser.

-v Print the version number of this release of ctlmp.

-v Print the version number of this release of

-w words
The maximum number of words to extract from the gecos
field of the users /etc/passwd entry. The default is 3.

-W Disable the line wrap. (line wrap is enabled by
default).

-? Print the usage line for ctlmp (note that the ? charac-
ter must be escaped if using csh(1)).

ENVIRONMENT VARIABLES
The ctlmp prologue file is determined by first looking for
the environment variable MP_PROLOGUE, which specifies the
directory where ctlmp prologue files are to be found. If
MP_PROLOGUE is not found, then the default directory is
assumed ($OPENWINHOME/share/xnews/client/ctlmp).

ctlmp also checks for the MP_LANG and LANG environment vari-
ables. If present, then a prologue file called
($OPENWINHOME/lib/locale/<localename>/print/prolog.ps) is
prepended to the output to be printed.

SUPPLIED PROLOGUE FILES
The following prologue files are provided:

ctlmp.pro.ps
Used by default

ctlmp.pro.ff.ps
Used if the -ff option is in effect

ctlmp.pro.fp.ps
Used if the -fp option is in effect

ctlmp.pro.tm.ps
Used if the -tm option is in effect

ctlmp.pro.ts.ps
Used if the -ts option is in effect

ctlmp.pro.alt.ps
An alternative modification of the default prolo-
gue file which outputs the page number in the
right corner of the bottom banner.

FILES
.cshrc
initialization file for csh(1)

.mailrc
initialization file for mail(1)

$OPENWINHOME/bin/ctlmp
executable

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ps
POSTSCRIPT prologue for mail printing

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.l.ps
POSTSCRIPT prologue for landscape format

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.alt.ps
alternative "default" POSTSCRIPT prologue, inserts page
numbers in the bottom right corner of each page

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ff.ps
POSTSCRIPT prologue for Filofax format

LIBDIR/ctlmp.pro.fp.ps
POSTSCRIPT prologue for Franklin Planner format.

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.tm.ps
POSTSCRIPT prologue for Time Manager format

$OPENWINHOME/share/xnews/client/ctlmp/ctlmp.pro.ts.ps
POSTSCRIPT prologue for Time/System International for-
mat.