143 lines
4.3 KiB
Groff
143 lines
4.3 KiB
Groff
.\" to view this file, use: nroff -man vnpstext.1V | more
|
|
.\" @(#)vnpstext.1V 2.2 (TriChlor) 5/14/92 21:43:55
|
|
.\"
|
|
.TH vnpstext 1V
|
|
.SH NAME
|
|
vnpstext \- PostScript filter for Vietnamese text printing
|
|
.SH SYNTAX
|
|
.B vnpstext
|
|
[\fB-i <prologfile>\fP]
|
|
[input_8-bit_VISCII_file(s) ...]
|
|
.SH DESCRIPTION
|
|
.NXR "vnpstext command"
|
|
.PP
|
|
The
|
|
.PN vnpstext
|
|
command operates much like the
|
|
.MS pstext 1PS
|
|
command: it reads a text file from standard input,
|
|
and outputs the text in a format suitable for sending
|
|
directly to a PostScript printer. A typical invocation
|
|
is:
|
|
.EX
|
|
% vnpstext 8-bit-vietnamese-file | lpr -PPostScript
|
|
.EE
|
|
.PN Vnpstext
|
|
expects the Vietnamese font (by default, Courier-VN)
|
|
to have been downloaded to the PostScript printer.
|
|
This will be discussed further below.
|
|
.PP
|
|
Without any arguments,
|
|
.PN vnpstext
|
|
will use the font Courier-VN at 10-point size.
|
|
You may change this by specifying an appropriate
|
|
prolog file. As of this date (5/92), the prolog files
|
|
available with
|
|
.I vnpstext
|
|
are cour10.pro (default), cour12.pro, cour17.pro,
|
|
cour10b.pro, cour12b.pro, cour17b.pro, which use
|
|
Vietnamese Courier fonts at 10-, 12-, and 17-point
|
|
sizes in normal and bold faces, respectively.
|
|
.PP
|
|
The location of the prolog file can either be
|
|
the current directory, or in
|
|
.I /usr/local/lib/ps.
|
|
The latter setting may be overridden by
|
|
the environment variable
|
|
.I PSLIBDIR.
|
|
.SH OPTIONS
|
|
.IP "\fI-i <prologfile>\fP" 20m
|
|
use the specified prolog file
|
|
instead of generating the default (cour10.pro).
|
|
.PP
|
|
The prolog file is searched relative to the directory
|
|
specified by PSLIBDIR, or the current working
|
|
directory if PSLIBDIR is not set in the environment.
|
|
If the prolog file name starts with the '/' character,
|
|
it is assumed to be an absolute path name and
|
|
PSLIBDIR is ignored.
|
|
.SH USAGE NOTES
|
|
.PN Vnpstext
|
|
expects the font you use to have been downloaded
|
|
to the printer. To do this, send it the appropriate
|
|
font installation file. As of this date (5/92), the following
|
|
are available with
|
|
.PN vnpstext:
|
|
initcour.ps and initcourb.ps, which will download
|
|
the Vietnamese Courier and Courier-Bold fonts
|
|
to the printer. The font sizes are continuously
|
|
scalable and is specified in the prolog file.
|
|
.PP
|
|
The downloaded font will persist
|
|
until the next time the printer is power cycled.
|
|
Also, note that the PS engine requires that a password
|
|
be supplied for this kind of operation to take place;
|
|
the password is normally "0" unless it is changed
|
|
by the user. This assumption is made in the
|
|
init*.ps files.
|
|
If the printer password is something other than "0",
|
|
modify these files
|
|
accordingly before sending it to the printer.
|
|
.SH EXAMPLES
|
|
To print out a mail message that contains 7-bit VIQR data,
|
|
you might use:
|
|
.EX
|
|
% vn7to8 -m input_file | vnpstext | lpr -PPostScript
|
|
.EE
|
|
The
|
|
.I -m
|
|
option to
|
|
.MS vn7to8 1V
|
|
tells it to start out assuming English mode.
|
|
.PP
|
|
Or if the message contain Viet-Net style Vietnamese but is not
|
|
necessarily VIQR-compliant in that it does not explicitly
|
|
specify the Vietnamese language state with the sequence "\V":
|
|
.EX
|
|
% vn7to8 -v input_file | vnpstext | lpr -PPostScript
|
|
.EE
|
|
.PP
|
|
Two sample shell scripts are provided
|
|
to facilitate Vietnamese printing:
|
|
.PN vnlpr7
|
|
and
|
|
.PN vnlpr8
|
|
which performs the necessary conversions
|
|
to print 7-bit VIQR and 8-bit VISCII
|
|
data, respectively. See the contents
|
|
of those shell scripts for usage details.
|
|
.SH RESTRICTIONS
|
|
.IP -
|
|
The line length is limited to 1024 characters.
|
|
.IP -
|
|
Lines are not wrapped. If a line is too long to
|
|
fit across a page width, it is truncated (by the printer).
|
|
.SH FILES
|
|
.IP \fI/usr/local/lib/ps:\fP 20m
|
|
default prolog search directory
|
|
.IP \fIinitcour.ps:\fP 20m
|
|
Vietnamese Courier font file to download to the printer.
|
|
.IP \fIinitcourb.ps:\fP 20m
|
|
Vietnamese Courier-Bold font file to download to the printer.
|
|
.IP \fIcour*.pro:\fP 20m
|
|
Various prolog files which specify non-default values
|
|
for font face and size.
|
|
.SH AUTHOR
|
|
The TriChlor Group, TriChlor@haydn.Stanford.EDU.
|
|
.br
|
|
Thanks also to Nam Chan Phamdo (nam@src.umd.edu)
|
|
for pointing out the lines-per-page bug (which has been fixed!)
|
|
.SH "SEE ALSO"
|
|
vn7to8(1V), vnelvis(1V), pstext(1PS)
|
|
.SH STANDARDS
|
|
Viet-Std Standardization Specification (Viet-Std@Haydn.Stanford.EDU)
|
|
.PP
|
|
RFC 1456 Vietnamese Standardization Working Group,
|
|
"Conventions for Encoding the Vietnamese Language
|
|
.br
|
|
VISCII: VIetnamese Standard Code for Information Interchange
|
|
.br
|
|
VIQR: VIetnamese Quoted-Readable Specification Revision 1.1",
|
|
.br
|
|
May 1993.
|