README 1.7 KB

1234567891011121314151617181920212223242526272829303132
  1. This directory contains supplementary documentation on GNU pic2plot.
  2. `pic2plot' is a translator from the pic language to numerous graphics
  3. formats such as X11, PS/EPS, PCL 5, PNM, GIF, Tektronix, and to editable
  4. formats such as idraw, xfig, Illustrator, and CGM.
  5. The pic language makes it easy to create and modify box-and-arrow diagrams
  6. of the kind frequently found in technical papers and textbooks. It was
  7. originally designed to be translated to the troff text-processing language,
  8. so that diagrams could be interspersed with text. The utility program
  9. `pic', the GNU version of which is `gpic', can perform this translation.
  10. It is usually invoked on the command line by doing `groff -p', where
  11. `groff' is the GNU version of the troff text-processing utility. `gpic'
  12. can also translate pic diagrams to TeX macros, for inclusion in a TeX
  13. document.
  14. `pic2plot' provides a third alternative. By using `pic2plot', you may
  15. translate diagrams, written in the pic language, directly to graphics
  16. formats.
  17. In this directory, the file pic0.ps is Brian Kernighan's original Bell Labs
  18. technical report on the pic language. The file pic1.ps is Eric Raymond's
  19. report "Making Pictures with GNU pic", which contains additional details.
  20. Neither of these mentions `pic2plot', however.
  21. The documentation file picmacros.ps was kindly contributed by the late
  22. W. Richard Stevens, who died on Sept. 1, 1999. Rich Stevens wrote many
  23. fine books on programming and network programming, including `TCP/IP
  24. Illustrated' (Addison-Wesley, 1994). picmacros.ps shows how pic macros may
  25. be used to draw diagrams (the diagrams are taken from his books). The
  26. macros themselves are given in the file macros.pic. Rich asked me to
  27. describe them as "work in progress".