"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "src/paps.1" between
paps-0.6.8.tar.gz and paps-0.7.1.tar.gz

About: is a text to postscript converter through pango.

paps.1  (paps-0.6.8):paps.1  (paps-0.7.1)
PAPS(1) General Commands Manual PAPS(1) PAPS(1) General Commands Manual PAPS(1)
NAME NAME
paps - UTF-8 to PostScript converter using Pango paps - text to PostScript converter using Pango
SYNOPSIS SYNOPSIS
paps [options] files... paps [options] files...
DESCRIPTION DESCRIPTION
paps reads a UTF-8 encoded file and generates a PostScript language rend paps reads an input file and writes a PostScript language or user specif
ering of the file. The rendering ied format rendering of the file
is done by creating outline curves through the pango ft2 backend. to standard output. paps accepts international text in any locale and p
rovides internationalized text
layout including text shaping and bidirectional text rendering.
If no filename argument is provided, paps reads the standard input. If t
he standard input is a terminal,
input is terminated by an EOF signal, usually Control-d.
OPTIONS OPTIONS
These programs follow the usual GNU command line syntax, with long opti paps follows the usual GNU command line syntax, with long options startin
ons starting with two dashes g with two dashes (`-'). A sum-
(`-'). A summary of options is included below. mary of options is included below.
-h, --help
Show summary of options.
--landscape --landscape
Landscape output. Default is portrait. Landscape output. Default is portrait.
--columns=cl --columns=cl
Number of columns output. Default is 1. Format output into cl columns. Default is 1.
--font=desc --font=desc
Set the font description. Default is Monospace 12. Use font based on description desc. Default is "Monospace 12". Th
e format of the string represen-
tation is:
"[family-list] [style-options] [size]"
where family-list is a comma separated list of families optionally
terminated by a comma, style-
options is a whitespace separated list of words where each word
describes one of style, variant,
weight, or stretch, and size is a decimal number for size in point
s, e.g. "Courier,Monospace Bold
Italic 10".
-o, --output=file
Output file. Default is stdout. Output format is set based on f
ile's extension when --format is
not provided.
--rtl Do right-to-left text layout and align text to the right. Text di
rection is detected automati-
cally. Use this option for explicit RTL layout and right alignment
.
--justify
Justify the layout. Stretch complete lines to fill the entire widt
h.
--wrap=wm
Use line wrapping mode wm. Default is word-char.
word Wrap lines at word boundaries
char Wrap lines at character boundaries
word-char Wrap lines at word boundaries, but fall back to char
acter boundaries if there is not
enough space for a full word
--show-wrap
Mark wrapped lines with special characters.
--paper=ps
Choose paper size. Accepted paper sizes are 'legal', 'letter', 'a3
' and 'a4'. Default is A4.
--rtl Do rtl layout. --gravity=gr
Set base glyph orientation. Default is auto.
--paper ps south Glyphs stand upright
Choose paper size. Known paper sizes are legal, letter, a4. Defaul
t is A4. east Glyphs are rotated 90 degrees clockwise
north Glyphs are upside-down
west Glyphs are rotated 90 degrees counter-clockwise
auto Gravity is resolved from the context
--gravity-hint=gh
Set how horizontal scripts behave in a vertical context. Default i
s natural.
natural Scripts will take their natural gravity based on the ba
se gravity and the script
strong Always use the base gravity, regardless of the script
line For scripts not in their natural direction (e.g. Latin
in East gravity), choose per-
script gravity such that every script respects the lin
e progression. This means, Latin
and Arabic will take opposite gravities and both flow t
op-to-bottom for example.
--format=fmt
Choose output format. Default is ps.
ps PostScript
pdf Portable Document Format
svg Scalable Vector Graphics
--bottom-margin=bm --bottom-margin=bm
Set bottom margin in postscript points (1/72 inch). Default is 36. Set bottom margin in postscript points (1/72 inch). Default is 36.
--top-margin=tm --top-margin=tm
Set top margin. Default is 36. Set top margin. Default is 36.
--left-margin=lm --left-margin=lm
Set left margin. Default is 36. Set left margin. Default is 36.
--right-margin=rm --right-margin=rm
Set right margin. Default is 36. Set right margin. Default is 36.
--help Show summary of options.
--header --header
Draw page header for each page. Draw page header with document name, date and page number for each
page. Header is not printed by
default.
--title="text"
Use text as the title string for page header. By default the input
filename or "stdin" is used.
--markup --markup
Interpret the text as pango markup. Interpret input as pango markup. Pango Text Attribute Markup Lang
uage allows marking parts of the
text with tags defining additional attributes such as font face, s
ize, weight, colors or text dec-
oration such as underline or strikethrough.
--encoding=enc
Assume encoding of the input text is enc. By default the encodi
ng of the current locale is used
(e.g. UTF-8).
--lpi=lines
Set number of lines per inch. This determines the line spacing.
--cpi=chars
Set number of characters per inch. This is an alternative method o
f specifying the font size.
--g-fatal-warnings
Make all glib warnings fatal.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error occurred.
EXAMPLES
Example 1 Printing UTF-8 text file
The following command can be used to print a file in any of the UTF-8 bas
ed locales if the file is in
UTF-8 or compatible codeset.
$ paps en_US_UTF-8.txt
By default paps will print PostScript rendering to standard output. Send
the output to a printer using lp
$ paps en_US_UTF-8.txt | lp
or to a file using redirection or the -o option
$ paps en_US_UTF-8.txt > out.ps
$ paps -o out.ps en_US_UTF-8.txt
Example 2 Specify encoding
To print a file in specific encoding regardless of the current locale se
tting use the --encoding option.
An example for Japanese EUC encoded input file:
$ paps --encoding eucjp ja_JP_eucjp.txt > out.ps
paps will still use current locale setting to prioritize the available fo
nts for current language.
Example 3 Specify locale
Override the LC_ALL environment variable to run paps in a different local
e.
$ LC_ALL=ja_JP.eucjp paps ja_JP_eucjp.txt > out.ps
Here paps will assume the input is in Japanese EUC encoding and will use
Japanese eucjp locale to render
the output. If --header is added, the date is printed in Japanese.
ENVIRONMENT VARIABLES
paps uses locale environment variables to determine its behavior. The fol
lowing categories are used:
LC_CTYPE to assume the encoding of the input. This can be overridd
en by --encoding.
--lpi Set the lines per inch. This determines the line spacing. LC_TIME to format the date for header.
--cpi Set the characters per inch. This is an alternative method of spec Font selection is also affected by current locale. Example 3 describe
ifying the font size. s how to run paps in a different
locale.
--stretch-chars SEE ALSO
Indicates that characters should be stretched in the y-direction fc-match(1), setlocale(3C)
to fill up their vertical space.
This is similar to the texttops behaviour.
AUTHOR AUTHOR
paps was written by Dov Grobgeld <dov.grobgeld@gmail.com>. paps was written by Dov Grobgeld <dov.grobgeld@gmail.com>.
This manual page was written by Lior Kaplan <kaplan@debian.org>, for the Debian project (but may be used This manual page was written by Lior Kaplan <kaplan@debian.org>, for the Debian project (but may be used
by others). by others).
April 17, 2006 PAPS(1) October 12, 2015 PAPS(1)
 End of changes. 14 change blocks. 
24 lines changed or deleted 186 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)