Differences between version 3 and previous revision of grops(1).
Other diffs: Previous Major Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 3 | Last edited on Tuesday, June 4, 2002 12:22:07 am | by perry | Revert |
| Older page: | version 2 | Last edited on Tuesday, June 4, 2002 12:22:07 am | by perry | Revert |
@@ -11,9 +11,9 @@
----
!!NAME
-grops - PostScript driver for groff
+grops - !
PostScript driver for groff
!!SYNOPSIS
__grops__ [[ __-glmv__ ] [[ __-b__''n'' ] [[
@@ -27,14 +27,14 @@
!!DESCRIPTION
__grops__ translates the output of GNU __troff__ to
-PostScript. Normally __grops__ should be invoked by using
+!
PostScript. Normally __grops__ should be invoked by using
the groff command with a __-Tps__ option. (Actually, this
is the default for groff.) If no files are given,
__grops__ will read the standard input. A filename of
__-__ will also cause __grops__ to read the standard
-input. PostScript output is written to the standard output.
+input. !
PostScript output is written to the standard output.
When __grops__ is run by __groff__ options can be
passed to __grops__ using the __groff -P__
option.
!!OPTIONS
@@ -49,20 +49,20 @@
spoolers and previewers can't handle such output. The value
of ''n'' controls what __grops__ does to its output
acceptable to such programs. A value of 0 will cause grops
not to employ any workarounds. Add 1 if no
-__%%BeginDocumentSetup__ and __%%EndDocumentSetup__
+__%%!
BeginDocumentSetup__ and __%%!
EndDocumentSetup__
comments should be generated; this is needed for early
-versions of TranScript that get confused by anything between
-the __%%EndProlog__ comment and the first __%%Page__
+versions of !
TranScript that get confused by anything between
+the __%%!
EndProlog__ comment and the first __%%Page__
comment. Add 2 if lines in included files beginning with
__%!__ should be stripped out; this is needed for Sun's
pageview previewer. Add 4 if __%%Page__, __%%Trailer__
-and __%%EndProlog__ comments should be stripped out of
+and __%%!
EndProlog__ comments should be stripped out of
included files; this is needed for spoolers that don't
-understand the __%%BeginDocument__ and
-__%%EndDocument__ comments. Add 8 if the first line of
-the PostScript output should be __%!PS-Adobe-2.__ rather
+understand the __%%!
BeginDocument__ and
+__%%!
EndDocument__ comments. Add 8 if the first line of
+the !
PostScript output should be __%!PS-Adobe-2.__ rather
than __%!PS-Adobe-3.0__; this is needed when using Sun's
Newsprint with a printer that requires page reversal. The
default value can be specified by a
@@ -82,9 +82,9 @@
__-g__
-Guess the page length. This generates PostScript code that
+Guess the page length. This generates !
PostScript code that
guesses the page length. The guess will be correct only if
the imageable area is vertically centered on the page. This
option allows you to generate documents that can be printed
both on letter (8.511) paper and on A4 paper without
@@ -144,27 +144,27 @@
__AR__
-AvantGarde-Book
+!
AvantGarde-Book
__AI__
-AvantGarde-BookOblique
+!
AvantGarde-!
BookOblique
__AB__
-AvantGarde-Demi
+!
AvantGarde-Demi
__ABI__
-AvantGarde-DemiOblique
+!
AvantGarde-!
DemiOblique
__BMR__
@@ -174,9 +174,9 @@
__BMI__
-Bookman-LightItalic
+Bookman-!
LightItalic
__BMB__
@@ -186,9 +186,9 @@
__BMBI__
-Bookman-DemiItalic
+Bookman-!
DemiItalic
__CR__
@@ -210,9 +210,9 @@
__CBI__
-Courier-BoldOblique
+Courier-!
BoldOblique
__HR__
@@ -234,9 +234,9 @@
__HBI__
-Helvetica-BoldOblique
+Helvetica-!
BoldOblique
__HNR__
@@ -258,33 +258,33 @@
__HNBI__
-Helvetica-Narrow-BoldOblique
+Helvetica-Narrow-!
BoldOblique
__NR__
-NewCenturySchlbk-Roman
+!
NewCenturySchlbk-Roman
__NI__
-NewCenturySchlbk-Italic
+!
NewCenturySchlbk-Italic
__NB__
-NewCenturySchlbk-Bold
+!
NewCenturySchlbk-Bold
__NBI__
-NewCenturySchlbk-BoldItalic
+!
NewCenturySchlbk-!
BoldItalic
__PR__
@@ -306,9 +306,9 @@
__PBI__
-Palatino-BoldItalic
+Palatino-!
BoldItalic
__TR__
@@ -330,9 +330,9 @@
__TBI__
-Times-BoldItalic
+Times-!
BoldItalic
There is also the following font which is not a member of a
family:
@@ -340,14 +340,14 @@
__ZCMI__
-ZapfChancery-MediumItalic
+!
ZapfChancery-!
MediumItalic
There are also some special fonts called __SS__ and
__S__. Zapf Dingbats is available as __ZD__ and a
-reversed version of ZapfDingbats (with symbols pointing in
+reversed version of !
ZapfDingbats (with symbols pointing in
the opposite direction) is available as __ZDR__; most
characters in these fonts are unnamed and must be accessed
using __N__.
@@ -360,10 +360,10 @@
__X'ps: exec__ ''code''__'__
-This executes the arbitrary PostScript commands in
-''code''. The PostScript currentpoint will be set to the
+This executes the arbitrary !
PostScript commands in
+''code''. The !
PostScript currentpoint will be set to the
position of the __X__ command before executing
''code''. The origin will be at the top left corner of
the page, and y coordinates will increase down the page. A
procedure __u__ will be defined that converts groff units
@@ -405,15 +405,15 @@
__X'ps: file__ ''name''__'__
This is the same as the __exec__ command except that the
-PostScript code is read from file ''name''.
+!
PostScript code is read from file ''name''.
__X'ps: def__ ''code''__'__
-Place a PostScript definition contained in ''code'' in
+Place a !
PostScript definition contained in ''code'' in
the prologue. There should be at most one definition per
__X__ command. Long definitions can be split over several
__X__ commands; all the ''code'' arguments are simply
joined together separated by newlines. The definitions are
@@ -429,19 +429,19 @@
Like __def__, except that ''code'' may contain up to
''n'' definitions. __grops__ needs to know how many
definitions ''code'' contains so that it can create an
-appropriately sized PostScript dictionary to contain
+appropriately sized !
PostScript dictionary to contain
them.
__X'ps: import__ ''file llx lly urx ury width'' [[
''height'' ]__'__
-Import a PostScript graphic from ''file''. The arguments
+Import a !
PostScript graphic from ''file''. The arguments
''llx'', ''lly'', ''urx'', and ''ury'' give the
-bounding box of the graphic in the default PostScript
+bounding box of the graphic in the default !
PostScript
coordinate system; they should all be integers; ''llx''
and ''lly'' are the x and y coordinates of the lower left
corner of the graphic; ''urx'' and ''ury'' are the x
and y coordinates of the upper right corner of the graphic;
@@ -455,11 +455,11 @@
specified width. Note that the contents of the __X__
command are not interpreted by __troff__; so vertical
space for the graphic is not automatically added, and the
''width'' and ''height'' arguments are not allowed to
-have attached scaling indicators. If the PostScript file
+have attached scaling indicators. If the !
PostScript file
complies with the Adobe Document Structuring Conventions and
-contains a __%%BoundingBox__ comment, then the bounding
+contains a __%%!
BoundingBox__ comment, then the bounding
box can be automatically extracted from within groff by
using the __psbb__ request.
@@ -521,9 +521,9 @@
line.
The input to __grops__ must be in the format output by
-troff(1). This is described in groff_out(5).
+troff(1). This is described in __
groff_out__
(5).
In addition the device and font description files for the
device used must meet certain requirements. The device and
font description files supplied for __ps__ device meet
all these requirements. afmtodit(1) can be used to
@@ -545,39 +545,39 @@
__internalname__ ''psname''
-which says that the PostScript name of the font is
+which says that the !
PostScript name of the font is
''psname''. It may also contain a command
__encoding__ ''enc_file''
-which says that the PostScript font should be reencoded
+which says that the !
PostScript font should be reencoded
using the encoding described in ''enc_file''; this file
should consist of a sequence of lines of the
form:
''pschar code''
-where ''pschar'' is the PostScript name of the character,
+where ''pschar'' is the !
PostScript name of the character,
and ''code'' is its position in the encoding expressed as
a decimal integer. The code for each character given in the
font file must correspond to the code for the character in
encoding file, or to the code in the default encoding for
-the font if the PostScript font is not to be reencoded. This
+the font if the !
PostScript font is not to be reencoded. This
code can be used with the __N__ escape sequence in
__troff__ to select the character, even if the character
does not have a groff name. Every character in the font file
-must exist in the PostScript font, and the widths given in
-the font file must match the widths used in the PostScript
+must exist in the !
PostScript font, and the widths given in
+the font file must match the widths used in the !
PostScript
font. __grops__ will assume that a character with a groff
name of __space__ is blank (makes no marks on the page);
it can make use of such a character to generate more
-efficient and compact PostScript output.
+efficient and compact !
PostScript output.
__grops__ can automatically include the downloadable
fonts necessary to print the document. Any downloadable
@@ -589,9 +589,9 @@
''font filename''
-where ''font'' is the PostScript name of the font, and
+where ''font'' is the !
PostScript name of the font, and
''filename'' is the name of the file containing the font;
lines beginning with __#__ and blank lines are ignored;
fields may be separated by tabs or spaces; ''filename''
will be searched for using the same mechanism that is used
@@ -609,37 +609,37 @@
inter-resource dependencies. For example, suppose that you
have a downloadable font called Garamond, and also a
downloadable font called Garamond-Outline which depends on
Garamond (typically it would be defined to copy Garamond's
-font dictionary, and change the PaintType), then it is
+font dictionary, and change the !
PaintType), then it is
necessary for Garamond to be appear before Garamond-Outline
-in the PostScript document. __grops__ will handle this
+in the !
PostScript document. __grops__ will handle this
automatically provided that the downloadable font file for
Garamond-Outline indicates its dependence on Garamond by
means of the Document Structuring Conventions, for example
by beginning with the following lines
__%!PS-Adobe-3.0 Resource-Font
-%%DocumentNeededResources: font Garamond
-%%EndComments
-%%IncludeResource: font Garamond__
+%%!
DocumentNeededResources: font Garamond
+%%!
EndComments
+%%!
IncludeResource: font Garamond__
In this case both Garamond and Garamond-Outline would need
to be listed in the __download__ file. A downloadable
font should not include its own name in a
-__%%DocumentSuppliedResources__ comment.
+__%%!
DocumentSuppliedResources__ comment.
-__grops__ will not interpret __%%DocumentFonts__
-comments. The __%%DocumentNeededResources__,
-__%%DocumentSuppliedResources__,
-__%%IncludeResource__, __%%BeginResource__ and
-__%%EndResource__ comments (or possibly the old
-__%%DocumentNeededFonts__,
-__%%DocumentSuppliedFonts__, __%%IncludeFont__,
-__%%BeginFont__ and __%%EndFont__ comments) should be
+__grops__ will not interpret __%%!
DocumentFonts__
+comments. The __%%!
DocumentNeededResources__,
+__%%!
DocumentSuppliedResources__,
+__%%!
IncludeResource__, __%%!
BeginResource__ and
+__%%!
EndResource__ comments (or possibly the old
+__%%!
DocumentNeededFonts__,
+__%%!
DocumentSuppliedFonts__, __%%!
IncludeFont__,
+__%%!
BeginFont__ and __%%!
EndFont__ comments) should be
used.
!!ENVIRONMENT
@@ -694,9 +694,9 @@
__/usr/share/groff/1.17.2/tmac/psold.tmac__
Macros to disable use of characters not present in older
-PostScript printers (e.g. `eth' or `thorn').
+!
PostScript printers (e.g. `eth' or `thorn').
__/tmp/grops__''XXXXXX''
@@ -705,7 +705,7 @@
!!SEE ALSO
afmtodit(1), groff(1), troff(1),
-psbb(1), groff_out(5), __groff_font__(5),
-groff_char(7)
+psbb(1), __
groff_out__
(5), __groff_font__(5),
+__
groff_char__
(7)
----
