/usr/share/doc/groff-base/html/pic-1.html is in groff 1.22.2-8.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 | <!-- Creator : groff version 1.22.2 -->
<!-- CreationDate: Thu Sep 4 17:17:41 2014 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>pic-1.html</title>
</head>
<hr>
[ <a href="pic-2.html">next</a> | <a href="pic.html">top</a> ]
<hr>
<h2>1. Introduction to PIC
<a name="1. Introduction to PIC"></a>
</h2>
<h3>1.1. Why PIC?
<a name="1.1. Why PIC?"></a>
</h3>
<p style="margin-top: 1em">The <b>pic</b> language provides
an easy way to write procedural box-and-arrow diagrams to be
included in <b>troff</b> documents. The language is
sufficiently flexible to be quite useful for state charts,
Petri-net diagrams, flow charts, simple circuit schematics,
jumper layouts, and other kinds of illustration involving
repetitive uses of simple geometric forms and splines.
Because these descriptions are procedural and object-based,
they are both compact and easy to modify.</p>
<p style="margin-top: 1em">The phrase “GNU pic”
may refer to either of two <b>pic</b> implementations
distributed by the Free Software Foundation and intended to
accept the same input language. The <i>gpic</i>(1)
implementation is for use with the <i>groff</i>(1)
implementation of <b>troff</b>. The <i>pic2plot</i>(1)
implementation runs standalone and is part of the
<b>plotutils</b> package. Because both implementations are
widely available in source form for free, they are good bets
for writing very portable documentation.</p>
<h3>1.2. PIC Versions
<a name="1.2. PIC Versions"></a>
</h3>
<p style="margin-top: 1em">The original 1984
pre-<i>ditroff</i>(1) version of <b>pic</b> is long
obsolete. The rewritten 1991 version is still available as
part of the Documenter’s Work Bench module of System
V.</p>
<p style="margin-top: 1em">Where differences between
Documenter’s Work Bench (1991) <b>pic</b> and GNU
<b>pic</b> need to be described, original <b>pic</b> is
referred to as “DWB pic”. Details on the history
of the program are given at the end of this document.</p>
<p style="margin-top: 1em">The <b>pic2plot</b> program does
not require the rest of the <i>groff</i>(1) toolchain to
render graphics. It can display <b>pic</b> 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 <b>xfig</b> 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.</p>
<p style="margin-top: 1em">In this document, <i>gpic</i>(1)
and <i>pic2plot</i>(1) extensions are marked as such.</p>
<hr>
[ <a href="pic-2.html">next</a> | <a href="pic.html">top</a> ]
<hr>
|