[Groff-commit] groff/doc pic.ms

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     08/09/29 21:36:50

Modified files:
        doc            : pic.ms 

Log message:
        Formatting.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/doc/pic.ms?cvsroot=groff&r1=1.40&r2=1.41

Patches:
Index: pic.ms
===================================================================
RCS file: /cvsroot/groff/groff/doc/pic.ms,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -b -r1.40 -r1.41
--- pic.ms      29 Sep 2008 19:54:59 -0000      1.40
+++ pic.ms      29 Sep 2008 21:36:49 -0000      1.41
@@ -31,7 +31,7 @@
 .\" Eric S. Raymond <address@hidden> in August 1995.  It has been put
 .\" under the GPL in March 2006.
 .\"
-.\"    $Id: pic.ms,v 1.40 2008/09/29 19:54:59 esr Exp $        
+.\"    $Id: pic.ms,v 1.41 2008/09/29 21:36:49 wl Exp $ 
 .
 .
 .\" Set a proper TeX and LaTeX
@@ -86,7 +86,7 @@
 simple geometric forms and splines.  Because these descriptions are
 procedural and object-based, they are both compact and easy to modify.
 .PP
-The phrase "GNU pic" may refer to either of two \fBpic\fP
+The phrase \[lq]GNU pic\[rq] may refer to either of two \fBpic\fP
 implementations distributed by the Free Software Foundation and
 intended to accept the same input language.  The \fIgpic\/\fP(1)
 implementation is for use with the \fIgroff\/\fP(1) implementation of
@@ -109,17 +109,16 @@
 .PP
 The \fBpic2plot\fR program does not require the rest of the
 \fIgroff\/\fP(1) toolchain to render graphics.  It can display
-\fBpic\fR diagrams in a X window, or generate output plots in a large
-number of different formats not supported by GNU \fB\fR.  These
-formats include: PNG, PBM, PGM, PPM, GIF, SVG, Adobe Illustrator
-format, idraw-editable Postscript, the WebCGM format for Web-based
-vector graphics, the format used by the `xfig' drawing editor, the
-Hewlett-Packard PCL 5 printer language, the Hewlett-Packard Graphics
-Language (by default, HP-GL/2), the ReGIS (remote graphics instruction
-set) format developed by DEC, Tektronix format, and device-independent
-GNU graphics metafile format.
+\fBpic\fR diagrams in a X\~window, or generate output plots in a large
+number of other formats.  These formats include: PNG, PBM, PGM, PPM, GIF,
+SVG, Adobe Illustrator format, idraw-editable Postscript, the WebCGM
+format for Web-based vector graphics, the format used by the \fBxfig\fP
+drawing editor, the Hewlett-Packard PCL\~5 printer language, the
+Hewlett-Packard Graphics Language (by default, HP-GL/2), the ReGIS
+(remote graphics instruction set) format developed by DEC, Tektronix
+format, and device-independent GNU graphics metafile format.
 .PP
-In this document, \fIgpic\/\fP(1) and \fIpic2plot\fP(1) extensions are
+In this document, \fIgpic\/\fP(1) and \fIpic2plot\/\fP(1) extensions are
 marked as such.
 .
 .
@@ -127,10 +126,10 @@
 Invoking PIC
 .PP
 Every \fBpic\fP description is a little program describing drawing
-actions.  The \fB[gtn]roff\fP-dependent versions compile the program into
+actions.  The \fB[gtn]roff\fP-dependent versions compile the program
 by \fIpic\/\fP(1) into \fIgtroff\/\fP(1) macros; the
-\fIpic32plot\fP(1) implementation uses a plotting library to draw the
-picture directly.).  Programs that process or display
+\fIpic2plot\/\fP(1) implementation uses a plotting library to draw the
+picture directly.  Programs that process or display
 \fIgtroff\/\fP(1) output need not know or care that parts of the image
 began life as \fBpic\fP descriptions.
 .PP
@@ -392,14 +391,15 @@
 The simplest way to think about these defaults is that they make the
 other basic objects fit snugly into a default-sized box.
 .PP
-\fIpic2plot\fP(1) does not necessarily emit a physical inch for
-each virtual inch in its drawing coordinate system.  Instead it draws
-on a canvas 8 virtual inches by 8 virtual inches wide.  If its
-output page size is "letter", these virtual inches will map to
-real ones.  Specifying a different page size (such as, say, "a4") 
-will scale virtual inches so they are output as one eighth
-of the page width.  Also, \fIpic2plot\fP(1) centers all images 
-by default, though the -n option can be used to prevent this. 
+\fIpic2plot\/\fP(1) does not necessarily emit a physical inch for
+each virtual inch in its drawing coordinate system.  Instead, it draws
+on a canvas 8\~virtual inches by 8\~virtual inches wide.  If its
+output page size is \[lq]letter\[rq], these virtual inches will map to
+real ones.  Specifying a different page size (such as, say,
+\[lq]a4\[rq]) will scale virtual inches so they are output as one
+eighth of the page width.  Also, \fIpic2plot\/\fP(1) centers all
+images by default, though the \fB\-n\fP option can be used to prevent
+this.
 .
 .NH 2
 Objects Do Not Stretch!
@@ -619,7 +619,7 @@
 .PP
 \fBpic2plot\fP replaces \fB[gtn]roff\fP horizontal- and vertical-motion
 escapes with \e-escapes of its own.  Troff special glyphs are not
-available, but in most back ends Latin-1 special characters and a s
+available, but in most back ends Latin-1 special characters and a
 square-root radical will be. See the \fBpic2plot\fP documentation for 
 full details.
 .
@@ -821,11 +821,11 @@
 \f(CWps.tmac\fP; additional colors can be defined with the
 \fB.defcolor\fP request (see the manual page of GNU \fItroff\/\fP(1)
 for more details).  Currently, color support is not available at all
-in in \*[tx] mode.
+in \*[tx] mode.
 .PP
-The \fIpic2plot\fP(1) carries with it its own set of color names,
-essentially those recognized by the X window system with "grey"
-accepted as a variant of "gray".
+The \fIpic2plot\/\fP(1) carries with its own set of color names,
+essentially those recognized by the X\~window system with \[lq]grey\[rq]
+accepted as a variant of \[lq]gray\[rq].
 .PP
 \fBpic\fP assumes that at the beginning of a picture both glyph and fill
 color are set to the default value.
@@ -1065,11 +1065,11 @@
 .PP
 The simplest is absolute coordinates in inches; \fBpic\fP uses a
 Cartesian system with (0,0) at the lower left corner of the virtual
-drawing surface for each picture (that is, X increases to the right
-and Y increases upwards).  An absolute location may always be written in the
+drawing surface for each picture (that is, X\~increases to the right
+and Y\~increases upwards).  An absolute location may always be written in the
 conventional form as two comma-separated numbers surrounded by
 parentheses (and this is recommended for clarity).  In contexts where
-it creates no ambiguity, the pair of X and Y coordinates suffices
+it creates no ambiguity, the pair of X and Y\~coordinates suffices
 without parentheses.
 .PP
 It is a good idea to avoid absolute coordinates, however.  They tend
@@ -1246,7 +1246,7 @@
 Projections of Points
 .PP
 Given two positions \fIp\fP and \fIq\fP, the position
-\fB(\,\fP\fIp\fP\fB,\fP \fIq\fP\fB)\fP has the X coordinate of \fIp\fP
+\fB(\,\fP\fIp\fP\fB,\fP \fIq\fP\fB)\fP has the X\~coordinate of \fIp\fP
 and the Y coordinate of \fIq\fP.  This can be helpful in placing an
 object at one of the corners of the virtual box defined by two other
 objects.
@@ -1818,7 +1818,7 @@
 can use this to include pre-generated images.
 .PP
 A variant of this statement replicates the \fBcopy thru\fP feature of
-\fIgrap\fP(1).  The call
+\fIgrap\/\fP(1).  The call
 .DS
 \f(CWcopy\fP \fIfilename\fR \f(CWthru\fP \fImacro\fP
 .DE
@@ -2867,7 +2867,8 @@
 Revert to previous style; only works one level deep, does not stack.
 .PP
 Color names are dependent on the \gBpic\fR implementation, but in 
-all modern versions color names recognized by the X window system are 
supported.
+all modern versions color names recognized by the X\~window system are
+supported.
 .PP
 A position is an (x,y) coordinate pair.  There are lots of different
 ways to specify positions:
@@ -3037,8 +3038,8 @@
 address@hidden@Width of rear of arrowhead
 address@hidden@Enable/disable arrowhead filling
 address@hidden@Interval for dashed lines
address@hidden@Maximum width of picture
address@hidden@Maximum height of picture
address@hidden@Maximum width of picture
address@hidden@Maximum height of picture
 address@hidden@Unit scale factor
 address@hidden@Default fill value
 .sp 5p