[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff ./ChangeLog man/groff_out.man src/devices...
From: |
Werner LEMBERG |
Subject: |
[Groff-commit] groff ./ChangeLog man/groff_out.man src/devices... |
Date: |
Sun, 03 Jul 2005 08:18:55 -0400 |
CVSROOT: /cvsroot/groff
Module name: groff
Branch:
Changes by: Werner LEMBERG <address@hidden> 05/07/03 12:18:55
Modified files:
. : ChangeLog
man : groff_out.man
src/devices/xditview: gxditview.man
src/preproc/pic: troff.cpp
src/roff/groff : groff.man
Log message:
* src/devices/xditview/gxditview.man: Change many `.I' to `.B'.
* man/groff_out.man: More markup and minor improvements.
* src/roff/groff/groff.man: Minor improvements.
CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/ChangeLog.diff?tr1=1.841&tr2=1.842&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/man/groff_out.man.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/src/devices/xditview/gxditview.man.diff?tr1=1.5&tr2=1.6&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/src/preproc/pic/troff.cpp.diff?tr1=1.5&tr2=1.6&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/groff/groff/src/roff/groff/groff.man.diff?tr1=1.41&tr2=1.42&r1=text&r2=text
Patches:
Index: groff/ChangeLog
diff -u groff/ChangeLog:1.841 groff/ChangeLog:1.842
--- groff/ChangeLog:1.841 Tue Jun 28 16:19:21 2005
+++ groff/ChangeLog Sun Jul 3 12:18:54 2005
@@ -1,3 +1,9 @@
+2005-07-02 Bernd Warken
+
+ * src/devices/xditview/gxditview.man: Change many `.I' to `.B'.
+ * man/groff_out.man: More markup and minor improvements.
+ * src/roff/groff/groff.man: Minor improvements.
+
2005-06-28 Werner LEMBERG <address@hidden>
* ChangeLog: Split off older entries into...
Index: groff/man/groff_out.man
diff -u groff/man/groff_out.man:1.21 groff/man/groff_out.man:1.22
--- groff/man/groff_out.man:1.21 Sat Jul 3 12:46:58 2004
+++ groff/man/groff_out.man Sun Jul 3 12:18:55 2005
@@ -3,11 +3,12 @@
.ig
groff_out.5
-Last update: 2 Jul 2004
+Last update: 2 Jul 2005
This file is part of groff, the GNU roff type-setting system.
-Copyright (C) 1989, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
+Copyright (C) 1989, 2001, 2002, 2003, 2004, 2005
+Free Software Foundation, Inc.
rewritten from scrach 2001 by Bernd Warken <address@hidden>
Permission is granted to copy, distribute and/or modify this document
@@ -255,18 +256,29 @@
.SH DESCRIPTION
.\" --------------------------------------------------------------------
.
-This manual page describes the intermediate output format of the GNU
+This manual page describes the
+.I intermediate output
+format of the GNU
.BR roff (@MAN7EXT@)
-text processing system.
+text processing system
+.BR groff (@MAN1EXT@).
.
This output is produced by a run of the GNU
-.BR troff (@MAN1EXT@)
-program before it is fed into a device postprocessor program.
+.BR @address@hidden (@MAN1EXT@)
+program.
+.
+It contains already all device-specific information, but it is not yet
+fed into a device postprocessor program.
+.
.
.P
-As the GNU roff processor
+As the GNU
+.I roff
+processor
.BR groff (@MAN1EXT@)
-is a wrapper program around troff that automatically calls a
+is a wrapper program around
+.B @address@hidden
+that automatically calls a
postprocessor, this output does not show up normally.
.
This is why it is called
@@ -279,15 +291,19 @@
.B groff
program provides the option
.B -Z
-to inhibit postprocessing, such that the produced intermediate output
+to inhibit postprocessing, such that the produced
+.I intermediate output
is sent to standard output just like calling
-.B troff
+.B @address@hidden
manually.
.
+.
.P
In this document, the term
-.I troff output
-describes what is output by the GNU troff program, while
+.I @address@hidden output
+describes what is output by the GNU
+.B @address@hidden
+program, while
.I intermediate output
refers to the language that is accepted by the parser that prepares
this output for the postprocessors.
@@ -295,14 +311,15 @@
This parser is smarter on whitespace and implements obsolete elements
for compatibility, otherwise both formats are the same.
.
-The pre-groff roff versions are denoted as
-.I classical
-.IR troff .
+Both formats can be viewed directly with
+.BR \%gxditview (@MAN1EXT@).
+.
.
.P
-The main purpose of the intermediate output concept is to facilitate
-the development of postprocessors by providing a common programming
-interface for all devices.
+The main purpose of the
+.I intermediate output
+concept is to facilitate the development of postprocessors by
+providing a common programming interface for all devices.
.
It has a language of its own that is completely different from the
.BR groff (@MAN7EXT@)
@@ -311,18 +328,28 @@
While the
.I groff
language is a high-level programming language for text processing, the
-intermediate output language is a kind of low-level assembler language
-by specifying all positions on the page for writing and drawing.
+.I intermediate output
+language is a kind of low-level assembler language by specifying all
+positions on the page for writing and drawing.
+.
.
.P
-The intermediate output produced by
-.I groff
+The
+.RI pre- groff
+.I roff
+versions are denoted as
+.I classical
+.IR troff .
+The
+.I intermediate output
+produced by
+.B groff
is fairly readable, while
.I classical troff
output was hard to understand because of strange habits that are
still supported, but not used any longer by
.I GNU
-.IR troff .
+.IR @address@hidden .
.
.
.\" --------------------------------------------------------------------
@@ -330,17 +357,23 @@
.\" --------------------------------------------------------------------
.
During the run of
-.BR troff ,
-the roff input is cracked down to the information on what has to be
-printed at what position on the intended device.
+.BR @address@hidden ,
+the
+.I roff
+input is cracked down to the information on what has to be printed at
+what position on the intended device.
.
-So the language of the intermediate output format can be quite small.
+So the language of the
+.I intermediate output
+format can be quite small.
.
Its only elements are commands with or without arguments.
.
-In this document, the term "command" always refers to the intermediate
-output language, never to the roff language used for document
-formatting.
+In this document, the term "command" always refers to the
+.I intermediate output
+language, never to the
+.I roff
+language used for document formatting.
.
There are commands for positioning and text writing, for drawing, and
for device controlling.
@@ -354,11 +387,11 @@
had strange requirements on whitespace.
.
The
-.I groff
+.B groff
output parser, however, is smart about whitespace by making it
maximally optional.
.
-The whitespace characters, i.e.\& the
+The whitespace characters, i.e., the
.IR tab ,
.IR space ,
and
@@ -368,14 +401,15 @@
They are never printable because spacing within the output is always
done by positioning commands.
.
+.
.P
Any sequence of
.I space
or
.I tab
characters is treated as a single
-.B syntactical
-.BR space .
+.I syntactical
+.IR space .
.
It separates commands and arguments, but is only required when there
would occur a clashing between the command code and the arguments
@@ -385,7 +419,10 @@
arguments, argument lists, or command clusters meet.
.
Commands and arguments with a known, fixed length need not be
-separated by syntactical space.
+separated by
+.I syntactical
+.IR space .
+.
.
.P
A line break is a syntactical element, too.
@@ -394,18 +431,22 @@
newline character.
.
Thus a
-.B syntactical line break
-is defined to consist of optional syntactical space that is optionally
-followed by a comment, and a newline character.
+.I syntactical line break
+is defined to consist of optional
+.I syntactical space
+that is optionally followed by a comment, and a newline character.
+.
.
.P
The normal commands, those for positioning and text, consist of a
single letter taking a fixed number of arguments.
.
For historical reasons, the parser allows to stack such commands on
-the same line, but fortunately, in groff intermediate output, every
-command with at least one argument is followed by a line break, thus
-providing excellent readability.
+the same line, but fortunately, in
+.I groff intermediate
+.IR output ,
+every command with at least one argument is followed by a line break,
+thus providing excellent readability.
.
.P
The other commands \[em] those for drawing and device controlling \[em]
@@ -424,10 +465,10 @@
.RB ` x\ X '
has an argument that can stretch over several lines, all other
commands must have all of their arguments on the same line as the
-command, i.e.\& the arguments may not be splitted by a line break.
+command, i.e., the arguments may not be splitted by a line break.
.
.P
-Empty lines, i.e.\& lines containing only space and/or a comment, can
+Empty lines, i.e., lines containing only space and/or a comment, can
occur everywhere.
.
They are just ignored.
@@ -442,7 +483,9 @@
.I scale indicator
is not written with the output command arguments; see
.BR groff (@MAN7EXT@)
-and the groff info file for more on this topic.
+and the
+.I groff info file
+for more on this topic.
.
Most commands assume the scale indicator\~\c
.unit u ,
@@ -460,6 +503,7 @@
file; see
.BR groff_font (@MAN5EXT@).
.
+.
.P
Note that single characters can have the eighth bit set, as can the
names of fonts and special characters.
@@ -468,6 +512,7 @@
.
A character that is to be printed will always be in the current font.
.
+.
.P
A string argument is always terminated by the next whitespace
character (space, tab, or newline); an embedded
@@ -483,8 +528,12 @@
.\" --------------------------------------------------------------------
.SS "Document Parts"
.\" --------------------------------------------------------------------
-A correct intermediate output document consists of two parts, the
-prologue and the body.
+A correct
+.I intermediate output
+document consists of two parts, the
+.I prologue
+and the
+.IR body .
.
.P
The task of the
@@ -509,8 +558,10 @@
with the arguments set as outlined in the section
.BR "Device Control Commands" .
.
-But the parser for the intermediate output format is able to swallow
-additional whitespace and comments as well.
+But the parser for the
+.I intermediate output
+format is able to swallow additional whitespace and comments as well.
+.
.
.P
The
@@ -518,15 +569,20 @@
is the main section for processing the document data.
.
Syntactically, it is a sequence of any commands different from the
-ones used in the prologue.
+ones used in the
+.IR prologue .
.
Processing is terminated as soon as the first
.B x\ stop
-command is encountered; the last line of any groff intermediate output
+command is encountered; the last line of any
+.I groff intermediate output
always contains such a command.
.
+.
.P
-Semantically, the body is page oriented.
+Semantically, the
+.I body
+is page oriented.
.
A new page is started by a
.BR p \~command.
@@ -547,8 +603,9 @@
.SH "COMMAND REFERENCE"
.\" --------------------------------------------------------------------
.
-This section describes all intermediate output commands, the classical
-commands as well as the
+This section describes all
+.I intermediate output
+commands, the classical commands as well as the
.I groff
extensions.
.
@@ -566,8 +623,9 @@
character up to the next newline character.
.
.P
-This command is the only possibility for commenting in the intermediate
-output.
+This command is the only possibility for commenting in the
+.I intermediate
+.IR output .
.
Each comment can be preceded by arbitrary
.I syntactical
@@ -595,9 +653,10 @@
other simple commands or followed by arbitrary other commands on the
same line.
.
-A separating syntactical space is only necessary when two integer
-arguments would clash or if the preceding argument ends with a string
-argument.
+A separating
+.I syntactical space
+is only necessary when two integer arguments would clash or if the
+preceding argument ends with a string argument.
.
.
.if (address@hidden == 1) \{\
@@ -622,11 +681,14 @@
Print a special groff character named
.argument xxx .
.
-The trailing syntactical space or line break is necessary to allow
-character names of arbitrary length.
+The trailing
+.I syntactical space
+or
+.I line break
+is necessary to allow character names of arbitrary length.
.
-The character is printed at the current print position;
-the character's size is read from the font file.
+The character is printed at the current print position; the
+character's size is read from the font file.
.
The print position is not changed.
.
@@ -661,7 +723,7 @@
.unit u
horizontally to the right.
.
-.I [54]
+.I [CSTR\~#54]
allows negative values for
.I n
also, but
@@ -681,12 +743,16 @@
The number of color components and their meaning vary for the
different color schemes.
.
-These commands are generated by the groff escape sequence
+These commands are generated by the
+.I groff
+escape sequence
.BR address@hidden .
.
No position changing.
.
-These commands are a groff extension.
+These commands are a
+.I groff
+extension.
.
.
.RS
@@ -735,23 +801,31 @@
.B N\~-193
represents an unbreakable space which has a width of 193u.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.command n b\ a
Inform the device about a line break, but no positioning is done by
this command.
.
-In classical troff, the integer arguments
+In
+.I classical
+.IR troff ,
+the integer arguments
.argument b
and\~\c
.argument a
informed about the space before and after the current line to
-make the intermediate output more human readable without performing
-any action.
+make the
+.I intermediate output
+more human readable without performing any action.
.
-In groff, they are just ignored, but they must be provided for
-compatibility reasons.
+In
+.IR groff ,
+they are just ignored, but they must be provided for compatibility
+reasons.
.
.
.command p n
@@ -778,9 +852,10 @@
(this is unit\~\c
.unit z
in GNU
-.BR troff ).
+.BR @address@hidden ).
.
-Classical troff used the unit
+.I Classical troff
+used the unit
.I points
(\c
.unit p )
@@ -790,7 +865,7 @@
.
.command t xxx \[la]white_space\[ra]
.command+ t "xxx dummy_arg" \[la]white_space\[ra]
-Print a word, i.e.\& a sequence of characters
+Print a word, i.e., a sequence of characters
.argument xxx
terminated by a space character or a line break; an optional second
integer argument is ignored (this allows the formatter to generate
@@ -808,7 +883,9 @@
.B C
command for named characters).
.
-This command is a groff extension; it is only used for devices whose
+This command is a
+.I groff
+extension; it is only used for devices whose
.I DESC
file contains the
.B tcommand
@@ -828,7 +905,9 @@
(an integer in
basic units\~\c
.unit u ).
-This command is a groff extension; it is only used for devices whose
+This command is a
+.I groff
+extension; it is only used for devices whose
.I DESC
file contains the
.B tcommand
@@ -853,7 +932,7 @@
.RI ( n
is a non-negative integer).
.
-.I [54]
+.I [CSTR\~#54]
allows negative values for
.I n
also, but
@@ -871,22 +950,28 @@
.SS "Graphics Commands"
.\" --------------------------------------------------------------------
.
-Each graphics or drawing command in the intermediate output starts
-with the letter\~\c
+Each graphics or drawing command in the
+.I intermediate output
+starts with the letter\~\c
.B D
followed by one or two characters that specify a subcommand; this
is followed by a fixed or variable number of integer arguments that
are separated by a single space character.
.
A
-.BR D \ command
-may not be followed by another command on the same line
-(apart from a comment), so each
-.BR D \ command
-is terminated by a syntactical line break.
+.B D\c
+\~command
+may not be followed by another command on the same line (apart from a
+comment), so each
+.B D\c
+\~command
+is terminated by a
+.I syntactical line
+.IR break .
+.
.
.P
-.I troff
+.B @address@hidden
output follows the classical spacing rules (no space between command
and subcommand, all arguments are preceded by a single space
character), but the parser allows optional space between the command
@@ -894,6 +979,7 @@
.
As usual, each space can be any sequence of tab and space characters.
.
+.
.P
Some graphics commands can take a variable number of arguments.
.
@@ -912,6 +998,7 @@
.
All these distances are offsets relative to the current location.
.
+.
.P
Unless indicated otherwise, each graphics command directly corresponds
to a similar
@@ -920,12 +1007,16 @@
escape sequence; see
.BR groff (@MAN7EXT@).
.
+.
.P
-Unknown D\~commands are assumed to be device-specific.
+Unknown
+.B D\c
+\~commands are assumed to be device-specific.
.
Its arguments are parsed as strings; the whole information is then
sent to the postprocessor.
.
+.
.P
In the following command reference, the syntax element
.I \[la]line_break\[ra]
@@ -942,8 +1033,8 @@
.indexed_offset h 2 v 2
if given, etc.\& up to
.indexed_offset h n v n .
-This command takes a variable number of argument pairs;
-the current position is moved to the terminal point of the drawn curve.
+This command takes a variable number of argument pairs; the current
+position is moved to the terminal point of the drawn curve.
.
.
.Da-command
@@ -967,7 +1058,9 @@
An optional second integer argument is ignored (this allows to the
formatter to generate an even number of arguments).
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.D-command c d
@@ -990,7 +1083,9 @@
with the leftmost point at the current position; then move to the
rightmost point of the ellipse.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.D-command e "h v"
@@ -1016,7 +1111,9 @@
The number of color components and their meaning vary for the
different color schemes.
.
-These commands are generated by the groff escape sequences
+These commands are generated by the
+.I groff
+escape sequences
.B address@hidden'F\ .\|.\|.'
and
.B address@hidden
@@ -1024,7 +1121,9 @@
.
No position changing.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.RS
@@ -1091,10 +1190,13 @@
sets all colors to blue.
.RE
.
+.
.P
No position changing.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.RE
.
@@ -1129,7 +1231,9 @@
the position doesn't change.
\}
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.D-multiarg P
@@ -1145,7 +1249,9 @@
.el \
No position changing.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.D-command t n
@@ -1175,7 +1281,9 @@
.el \
No position changing.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.\" --------------------------------------------------------------------
@@ -1185,8 +1293,11 @@
Each device control command starts with the letter
.B x
followed by a space character (optional or arbitrary space/\:tab in
-groff) and a subcommand letter or word; each argument (if any) must be
-preceded by a syntactical space.
+.IR groff )
+and a subcommand letter or word; each argument (if any) must be
+preceded by a
+.I syntactical
+.IR space .
.
All
.B x
@@ -1197,13 +1308,13 @@
.
.P
The subcommand is basically a single letter, but to increase
-readability, it can be written as a word, i.e.\& an arbitrary sequence
+readability, it can be written as a word, i.e., an arbitrary sequence
of characters terminated by the next tab, space, or newline character.
.
All characters of the subcommand word but the first are simply ignored.
.
For example,
-.I troff
+.B @address@hidden
outputs the initialization command
.B x\ i
as
@@ -1233,12 +1344,15 @@
.argument name
as the intended name for the current file in error reports.
.
-This is useful for remembering the original file name when groff uses
-an internal piping mechanism.
+This is useful for remembering the original file name when
+.B groff
+uses an internal piping mechanism.
.
The input file is not changed by this command.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.x-command f "n\ s"
@@ -1259,8 +1373,8 @@
(a positive integer in scaled points\~\c
.unit z ).
.
-Classical troff used the unit
-points (\c
+.I Classical troff
+used the unit points (\c
.unit p )
instead; see section
.BR COMPATIBILITY .
@@ -1270,7 +1384,8 @@
.xsub init
Initialize device.
.
-This is the third command of the prologue.
+This is the third command of the
+.IR prologue .
.
.
.x-command p
@@ -1295,7 +1410,8 @@
.unit u
per inch.
.
-This is the second command of the prologue.
+This is the second command of the
+.IR prologue .
.
.
.x-command S n
@@ -1309,7 +1425,9 @@
.x-command s
.xsub stop
Terminates the processing of the current file; issued as the last
-command of any intermediate troff output.
+command of any
+.I intermediate @address@hidden
+.IR output .
.
.
.x-command t
@@ -1317,7 +1435,7 @@
Generate trailer information, if any.
.
In
-.IR groff ,
+.BR groff ,
this is actually just ignored.
.
.
@@ -1331,7 +1449,8 @@
.B -T
option.
.
-This is the first command of the prologue.
+This is the first command of the
+.IR prologue .
.
.
.x-command u n
@@ -1348,10 +1467,12 @@
This is needed for the
.B cu
request in
-.I nroff
+.B @address@hidden
mode and is ignored otherwise.
.
-This command is a groff extension.
+This command is a
+.I groff
+extension.
.
.
.x-command X anything
@@ -1380,7 +1501,9 @@
escape sequence
.BR address@hidden .
.
-The line-continuing feature is a groff extension.
+The line-continuing feature is a
+.I groff
+extension.
.
.
.\" --------------------------------------------------------------------
@@ -1405,10 +1528,14 @@
then print character\~\c
.argument c .
.
+.
.RS
.P
-In groff, arbitrary syntactical space around and within this command
-is allowed to be added.
+In
+.IR groff ,
+arbitrary
+.I syntactical space
+around and within this command is allowed to be added.
.
Only when a preceding command on the same line ends with an argument
of variable length a separating space is obligatory.
@@ -1421,12 +1548,15 @@
.
.RE
.
+.
.P
For modern high-resolution devices, this command does not make sense
because the width of the characters can become much larger than two
decimal digits.
.
-In groff, this is only used for the devices
+In
+.BR groff ,
+this is only used for the devices
.BR X75 ,
.BR X75-12 ,
.BR X100 ,
@@ -1448,7 +1578,8 @@
The
.I roff
postprocessors are programs that have the task to translate the
-intermediate output into actions that are sent to a device.
+.I intermediate output
+into actions that are sent to a device.
.
A device can be some piece of hardware such as a printer, or a software
file format suitable for graphical or text processing.
@@ -1458,9 +1589,10 @@
system provides powerful means that make the programming of such
postprocessors an easy task.
.P
-There is a library function that parses the intermediate output and
-sends the information obtained to the device via methods of a class
-with a common interface for each device.
+There is a library function that parses the
+.I intermediate output
+and sends the information obtained to the device via methods of a
+class with a common interface for each device.
.
So a
.I groff
@@ -1474,22 +1606,27 @@
.SH "EXAMPLES"
.\" --------------------------------------------------------------------
.
-This section presents the intermediate output generated from the same
-input for three different devices.
+This section presents the
+.I intermediate output
+generated from the same input for three different devices.
.
The input is the sentence
.I hell world
-fed into groff on the command line.
+fed into
+.B groff
+on the command line.
+.
.
.Topic
High-resolution device
.I ps
.
-.RS
.
+.RS
.P
.ShellCommand echo "hell world" | groff -Z -T ps
.
+.
.P
.nf
.ft CB
@@ -1515,6 +1652,7 @@
.fi
.RE
.
+.
.P
This output can be fed into the postprocessor
.BR grops (@MAN1EXT@)
@@ -1525,8 +1663,8 @@
Low-resolution device
.I latin1
.
-.RS
.
+.RS
.P
This is similar to the high-resolution device except that the
positioning is done at a minor scale.
@@ -1536,9 +1674,11 @@
were added for clarification; they were not generated by the
formatter.
.
+.
.P
.ShellCommand echo "hell world" | groff -Z -T latin1
.
+.
.P
.nf
.I "# prologue"
@@ -1579,6 +1719,7 @@
.fi
.RE
.
+.
.P
This output can be fed into the postprocessor
.BR grotty (@MAN1EXT@)
@@ -1588,16 +1729,20 @@
.Topic
Classical style output
.
-.RS
.
+.RS
.P
As a computer monitor has a very low resolution compared to modern
-printers the intermediate output for the X\~devices can use the
-jump-and-write command with its 2-digit displacements.
+printers the
+.I intermediate output
+for the X\~devices can use the jump-and-write command with its 2-digit
+displacements.
+.
.
.P
.ShellCommand echo "hell world" | groff -Z -T X100
.
+.
.P
.nf
.ft CB
@@ -1621,6 +1766,7 @@
.fi
.RE
.
+.
.P
This output can be fed into the postprocessor
.BR \%xditview (1x)
@@ -1628,6 +1774,7 @@
.BR \%gxditview (@MAN1EXT@)
for displaying in\~X.
.
+.
.P
Due to the obsolete jump-and-write command, the text clusters in the
classical output are almost unreadable.
@@ -1637,41 +1784,55 @@
.SH "COMPATIBILITY"
.\" --------------------------------------------------------------------
.
-The intermediate output language of the
+The
+.I intermediate output
+language of the
.I classical troff
was first documented in
-.IR [97] .
+.IR [CSTR\~#97] .
.
The
-.I groff
-intermediate output format is compatible with this specification
-except for the following features.
+.I groff intermediate output
+format is compatible with this specification except for the following
+features.
+.
+.
.Topic
The classical quasi device independence is not yet implemented.
.
+.
.Topic
The old hardware was very different from what we use today.
.
-So the groff devices are also fundamentally different from the ones in
-classical troff.
+So the
+.I groff
+devices are also fundamentally different from the ones in
+.I classical
+.IR troff .
.
For example, the classical PostScript device was called
.I post
and had a resolution of 720 units per inch,
-while groff's
+while
+.IR groff 's
.I ps
device has a resolution of 72000 units per inch.
.
Maybe, by implementing some rescaling mechanism similar to the
classical quasi device independence, these could be integrated into
-modern groff.
+modern
+.IR groff .
+.
.
.Topic
The B-spline command
.B D~
-is correctly handled by the intermediate output parser, but the
-drawing routines aren't implemented in some of the postprocessor
-programs.
+is correctly handled by the
+.I intermediate output
+parser, but the drawing routines aren't implemented in some of the
+postprocessor programs.
+.
+.
.Topic
The argument of the commands
.B s
@@ -1679,20 +1840,28 @@
.B x H
has the implicit unit scaled point\~\c
.unit z
-in groff, while classical troff had point (\c
+in
+.IR groff ,
+while
+.I classical troff
+had point (\c
.unit p ).
.
-This isn't an incompatibility, but a compatible extension,
-for both units coincide for all devices without a
+This isn't an incompatibility, but a compatible extension, for both
+units coincide for all devices without a
.I sizescale
-parameter, including all classical and the groff text devices.
+parameter, including all classical and the
+.I groff
+text devices.
.
-The few groff devices with a sizescale parameter either did
-not exist, had a different name, or seem to have had a different
-resolution.
+The few
+.I groff
+devices with a sizescale parameter either did not exist, had a
+different name, or seem to have had a different resolution.
.
So conflicts with classical devices are very unlikely.
.
+.
.ie (address@hidden == 1) \{\
.Topic
The position changing after the commands
@@ -1707,11 +1876,14 @@
.Topic
Temporarily, there existed some confusion on the positioning after the
.B D
-commands that are groff extensions.
+commands that are
+.I groff
+extensions.
.
This has been clarified by establishing the classical rule for all
groff drawing commands:
.
+.
.RS
.P
.ft I
@@ -1720,13 +1892,18 @@
.ft
.RE
.
+.
.P
From this, the positionings specified for the drawing commands above
follow quite naturally.
.\} \" @STUPID_DRAWING_POSITIONING
.
.P
-The differences between groff and classical troff are documented in
+The differences between
+.I groff
+and
+.I classical troff
+are documented in
.BR groff_diff (@MAN7EXT@).
.
.
@@ -1741,7 +1918,9 @@
.
.TP
.IB \[la]groff_source_dir\[ra] /src/libs/libdriver/input.cpp
-Defines the parser and postprocessor for the intermediate output.
+Defines the parser and postprocessor for the
+.I intermediate
+.IR output .
.
It is located relative to the top directory of the
.I groff
@@ -1749,8 +1928,8 @@
.IR @GROFFSRCDIR@ .
.
This parser is the definitive specification of the
-.I groff
-intermediate output format.
+.I groff intermediate output
+format.
.
.
.\" --------------------------------------------------------------------
@@ -1760,7 +1939,7 @@
A reference like
.BR groff (@MAN7EXT@)
refers to a manual page; here
-.I groff
+.B groff
in section\~\c
.I @MAN7EXT@
of the man-page documentation system.
@@ -1768,46 +1947,62 @@
To read the example, look up address@hidden@ in your desktop help
system or call from the shell prompt
.
+.
.RS
.P
.ShellCommand man @MAN7EXT@ groff
.RE
.
+.
.P
For more details, see
.BR man (1).
.
+.
.TP
.BR groff (@MAN1EXT@)
option
.B -Z
and further readings on groff.
.
+.
.TP
.BR groff (@MAN7EXT@)
for details of the
.I groff
language such as numerical units and escape sequences.
.
+.
.TP
.BR groff_font (@MAN5EXT@)
for details on the device scaling parameters of the
.B DESC
file.
.
+.
.TP
-.BR troff (@MAN1EXT@)
+.BR @address@hidden (@MAN1EXT@)
generates the device-independent intermediate output.
.
+.
.TP
.BR roff (@MAN7EXT@)
for historical aspects and the general structure of roff systems.
.
+.
.TP
.BR groff_diff (@MAN7EXT@)
The differences between the intermediate output in groff and classical
troff.
.
+.
+.TP
+.BR gxditview (@MAN1EXT@)
+Viewer for the
+.I intermediate
+.IR output .
+.
+.
.P
.BR \%grodvi (@MAN1EXT@),
.BR \%grohtml (@MAN1EXT@),
@@ -1820,6 +2015,7 @@
the groff postprocessor programs.
.RE
.
+.
.P
For a treatment of all aspects of the groff system within a single
document, see the
@@ -1834,6 +2030,7 @@
.ShellCommand info groff
.RE
.
+.
.P
The
.I classical troff output language
@@ -1841,6 +2038,7 @@
.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr.html \
"Bell Labs CSTR site" .
.
+.
.TP
.I [CSTR #97]
.I A Typesetter-independent TROFF
@@ -1850,6 +2048,7 @@
see
.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz CSTR\~#97 .
.
+.
.TP
.I [CSTR\~#54]
The 1992 revision of the
@@ -1860,8 +2059,7 @@
.I Brian Kernighan
isn't as concise as
.I [CSTR\~#97]
-regarding the output language;
-see
+regarding the output language; see
.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz CSTR\~#54 .
.
.
@@ -1870,6 +2068,8 @@
.\" --------------------------------------------------------------------
.
Copyright (C) 1989, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
+.
+.
.P
This document is distributed under the terms of the FDL (GNU Free
Documentation License) version 1.1 or later.
@@ -1878,19 +2078,21 @@
available on-line at the
.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
.
+.
.P
This document is part of
.IR groff ,
-the GNU roff distribution.
+the GNU
+.I roff
+distribution.
.
It is based on a former version \- published under the GPL \- that
described only parts of the
.I groff
extensions of the output language.
.
-It has been rewritten 2002 by
-.MTO address@hidden "Bernd Warken"
-and is maintained by
+It has been rewritten 2002 by \m[blue]Bernd Warken\m[] and is
+maintained by
.MTO address@hidden "Werner Lemberg" .
.
.cp \n[groff_out_C]
Index: groff/src/devices/xditview/gxditview.man
diff -u groff/src/devices/xditview/gxditview.man:1.5
groff/src/devices/xditview/gxditview.man:1.6
--- groff/src/devices/xditview/gxditview.man:1.5 Sun Jun 26 20:42:46 2005
+++ groff/src/devices/xditview/gxditview.man Sun Jul 3 12:18:55 2005
@@ -14,7 +14,7 @@
.
.SH DESCRIPTION
The
-.I \%gxditview
+.B \%gxditview
program displays the
.I groff intermediate
.IR output ,
@@ -26,7 +26,7 @@
server machine for font loading.
.
There are several ways to use
-.IR \%gxditview .
+.BR \%gxditview .
.
.
.PP
@@ -35,13 +35,13 @@
can be generated by
.BR groff\~\-Z .
This can be viewed by explicity calling
-.I \%gxditview
+.B \%gxditview
.IR \%filename .
If
.I filename
is
.BR \- ,
-.I \%gxditview
+.B \%gxditview
will read the standard input;
.I \%filename
cannot be omitted.
@@ -50,7 +50,7 @@
.I groff intermediate output
is different for all devices.
.
-.I \%gxditview
+.B \%gxditview
can view it for all devices, but the quality is not always good.
.
.
@@ -58,7 +58,7 @@
The best result is achieved with the
.BR X *
devices for
-.IR groff 's
+.BR groff 's
option
.BR \-T .
.
@@ -73,27 +73,26 @@
size (10pt or 12pt).
.
They are especially built for
-.IR \%gxditview .
+.BR \%gxditview .
When using one of them
-.I groff
+.B groff
generates the
.I intermediate output
for this device and calls
-.I \%gxditview
+.B \%gxditview
automatically for viewing.
.
.
.PP
-.IR groff 's
+.BR groff 's
option
.B \-X
-should be considered obsolete today;
-it produces
+should be considered obsolete today; it produces
.I intermediate output
for
.I Postscript
and uses
-.I \%gxditview
+.B \%gxditview
as a viewer for it, but with a bad quality.
.
Simply don't use it.
@@ -101,7 +100,7 @@
.
.PP
During the run of
-.IR \%gxditview ,
+.BR \%gxditview ,
the left mouse button brings up a menu with the following entries:
.
.TP 8
@@ -142,7 +141,7 @@
.TP
.B Quit
Exit from
-.IR \%gxditview .
+.BR \%gxditview .
.
.
.PP
@@ -186,12 +185,12 @@
.B paperwidth
commands in the DESC file specify the length and width in machine units
of the virtual page displayed by
-.IR \%gxditview .
+.BR \%gxditview .
.
.
.SH OPTIONS
The
-.I \%gxditview
+.B \%gxditview
program accepts all of the standard X\~Toolkit command line options
along with the additional options listed below:
.
@@ -256,7 +255,7 @@
.PP
The following standard X\~Toolkit command line arguments are commonly used
with
-.IR \%gxditview :
+.BR \%gxditview :
.
.TP 8
.BI \-bg\ color
@@ -376,13 +375,13 @@
.
.SH ORIGIN
This program is derived from
-.IR \%xditview ;
+.BR \%xditview ;
portions of
-.I \%xditview
+.B \%xditview
originated in
-.I \%xtroff
+.B \%xtroff
which was derived from
-.IR \%suntroff .
+.BR \%suntroff .
.
.
.SH COPYRIGHT
Index: groff/src/preproc/pic/troff.cpp
diff -u groff/src/preproc/pic/troff.cpp:1.5 groff/src/preproc/pic/troff.cpp:1.6
--- groff/src/preproc/pic/troff.cpp:1.5 Fri Jun 24 19:55:04 2005
+++ groff/src/preproc/pic/troff.cpp Sun Jul 3 12:18:55 2005
@@ -498,7 +498,7 @@
if (last_filled || last_outlined) {
reset_color();
}
- // .bcolor and .fcolor emit a node in compatibility mode only,
+ // .gcolor and .fcolor emit a node in compatibility mode only,
// but that won't work anyway
if (color_fill) {
printf(".fcolor %s\n", color_fill);
Index: groff/src/roff/groff/groff.man
diff -u groff/src/roff/groff/groff.man:1.41 groff/src/roff/groff/groff.man:1.42
--- groff/src/roff/groff/groff.man:1.41 Tue Feb 1 08:13:30 2005
+++ groff/src/roff/groff/groff.man Sun Jul 3 12:18:55 2005
@@ -1,7 +1,7 @@
.ig
groff.man
-Last update: 01 Feb 2005
+Last update: 01 Jul 2005
Copyright (C) 1989, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
Rewritten in 2002 by Bernd Warken <address@hidden>
@@ -520,12 +520,21 @@
.OptDef T "" dev
Set output device to
.IR dev .
-Contrary to
-.BR @address@hidden ,
+For this device,
+.B @address@hidden
+generates the
+.I intermediate
+.IR output ;
+see
+.BR \%groff_out (@MAN5EXT@).
+.
+Then
.B groff
calls a postprocessor to convert
.BR @address@hidden 's
-intermediate output to its final format.
+.I intermediate output
+to its final format.
+.
Real devices in
.B groff
are
@@ -669,13 +678,19 @@
.
.
.OptDef Z
-Do not postprocess the output of
-.B @address@hidden
-that is normally
-called automatically by
-.BR groff .
-This will print the intermediate output to standard output; see
+Print the
+.I groff intermediate output
+to standard output; see
.BR \%groff_out (@MAN5EXT@).
+Normally
+.BR groff
+calls automatically a postprocessor.
+.
+With this option, the output of
+.B @address@hidden
+for the device, the so-called
+.I intermediate output
+is issued without postprocessing.
.
.
.\" --------------------------------------------------------------------
@@ -1582,7 +1597,7 @@
.MTO address@hidden "James Clark" .
.
It was rewritten, enhanced, and put under the FDL license by
-.MTO address@hidden "Bernd Warken" .
+\m[blue]Bernd Warken\m[].
.
It is maintained by
.MTO address@hidden "Werner Lemberg" .
@@ -1662,7 +1677,9 @@
.BR ditroff (@MAN7EXT@).
.
.TP
-The intermediate output language:
+The
+.I intermediate output
+language:
.BR \%groff_out (@MAN7EXT@).
.
.TP
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Groff-commit] groff ./ChangeLog man/groff_out.man src/devices...,
Werner LEMBERG <=