[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff-commit] groff/doc pic.ms
From: |
Werner LEMBERG |
Subject: |
[Groff-commit] groff/doc pic.ms |
Date: |
Mon, 29 Sep 2008 21:36:50 +0000 |
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