diff options
Diffstat (limited to '')
| -rw-r--r-- | MANIFEST | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/MANIFEST b/MANIFEST new file mode 100644 index 0000000..736b211 --- /dev/null +++ b/MANIFEST @@ -0,0 +1,191 @@ + Copyright 2001-2022 Free Software Foundation, Inc. + + Copying and distribution of this file, with or without modification, + are permitted in any medium without royalty provided the copyright + notice and this notice are preserved. + +This file summarizes the structure of the groff source distribution. + + +1) Top-level directory contents + + BUG-REPORT A template for bug reports. + ChangeLog Log of changes since last groff minor version release. + ChangeLog.* Logs of changes in past groff versions. + COPYING The GNU General Public License (GPL). + FDL The GNU Free Documentation License (FDL). + FOR-RELEASE Release procedures for groff maintainer(s) to follow. + HACKING Advice for contributors to groff. + INSTALL Generic information on configuration and compiling. + INSTALL.extra How to install groff from a distribution archive. + INSTALL.REPO How to install groff from a Git repository checkout. + LICENSES Copyright and licensing information. + MANIFEST The file you are reading. + MORE.STUFF Useful stuff in other packages. + NEWS Log of feature changes in groff. + PROBLEMS Tips to handle known situations of concern. + PROJECTS Long-term additions to groff. + README Introduction to and contact information for groff. + README.MinGW Build information for MinGW. + TODO Things planned for future groff versions. + + All other files in the top-level directory are related to + configuration, compilation, and installation procedures. + + +2) Directory structure + +./arch Resources to facilitate building on non-POSIX systems. + djgpp Resources for the 32-bit MS-DOS compiler djgpp. + mingw Resources for the MinGW environment. + misc Resources for various other platforms. + +./contrib Resources provided with groff, but maintained by others. + chem Embed chemical structure diagrams in groff documents. + eqn2graph Convert eqn(1) equations into graphical images. + gdiffmk An improved implementation of the diffmk command to mark + differences between groff/nroff/troff files. + glilypond Embed LilyPond sheet music in groff documents. + gperl Populate groff registers and strings using perl(1). + gpinyin Use Hanyu Pinyin input to compose groff documents. + grap2graph Convert grap(1) diagrams into graphical images. + hdtbl A sophisticated table macro package. + mm The groff memorandum macro package. + mom Peter Schaffter's "mom", a friendly groff macro package. + pdfmark Add PDF marks to groff documents; includes "pdfroff", + which eases creation of PDF documents. + pic2graph Convert pic(1) diagrams into graphical images. + rfc1345 Use RFC 1345 mnemonics as groff special characters. + sboxes Use bordered, shaded background boxes with ms and PDF. + +./doc Manuals for various components of groff. + +./font Device and font description files. + devX100 100dpi X11 device (10 point base type size). + devX100-12 100dpi X11 device (12 point base type size). + devX75 75dpi X11 device (10 point base type size). + devX75-12 75dpi X11 device (12 point base type size). + devascii Terminal device with ASCII (ISO 646) encoding. + devcp1047 Terminal device with EBCDIC (code page 1047) encoding. + devdvi TeX DVI device. + devhtml HTML device. + devlatin1 Terminal device with ISO Latin-1 (8859-1) encoding. + devlbp Canon CaPSL laser printers. + devlj4 HP LaserJet 4/PCL 5 and compatible printers. + devps PostScript device. + devpdf PDF device. + devutf8 Terminal device with UTF-8 encoding. + scripts Scripts used in generation of device/font descriptions. + util Tools to aid groff developers with new device support. + +./m4 M4 macro files used to create the "configure" script. + +./man groff manual pages of general applicability. + +./src groff programs and libraries. + +./src/devices Output drivers for devices and file formats. + grodvi TeX DVI. + grohtml HTML. + grolbp Canon CaPSL laser printers. + grolj4 HP LaserJet 4/PCL 5 and compatible printers. + grops PostScript. + gropdf PDF. + grotty Terminal output. + xditview A troff output (pre)viewer for the X Window System. + +./src/include C/C++ header files. + +./src/libs C++ code shared among several groff components. + libbib Manage bibliographic database. + libdriver Parse troff output; also output utility functions. + libgroff General support functions used everywhere. + libxutil Utility functions for gxditview and xtotroff. + +./src/preproc Preprocessors. + eqn Typeset mathematical formulae. + grn Draw Gremlin pictures. + html Prepare tbl and eqn input for grohtml. + pic Draw diagrams. + preconv Convert document input encoding for input to troff. + refer Generate bibliographic references. + soelim Expose 'so' (sourced) documents to preprocessing. + tbl Lay out tables. + +./src/roff Programs that run the formatter. + groff troff wrapper. This is the main user program. + nroff groff wrapper convenient for terminal users. + troff Formatter. + +./src/utils Utility programs relevant to groff. + addftinfo Supplement AT&T troff font descriptions with metrics + groff requires. + afmtodit Create font description files for the PostScript device. + grog Guess groff command-line options required by a document. + hpftodit Create font description files for the 'lj4' device. + indxbib Make inverted index for bibliographic databases. + lkbib Search bibliographic databases. + lookbib Interactively search bibliographic databases. + pfbtops Translate a PostScript Type 1 font in PFB format to PFA. + tfmtodit Create font description files for TeX DVI device. + xtotroff Create font description files for gxditview. + +./tmac Macro files. + mdoc Modules for the mdoc package. + +Various directories contain a "tests" subdirectory. These are automated +tests performed when groff's Makefile is run with the "check" target. + + +3) Documentation + +groff documentation is spread throughout the tree; where possible, it is +close to the source code it describes. + +- The top-level directory contains text files presenting groff as a + software project, with its focus on organization of the code, + development procedures, and project administration. + + If you don't know where to begin, start with "README"; it contains the + information you will require to obtain the groff distribution archive, + report bugs, and contact the developers. + +- A man page for each program (for section 1 of the manual) is + maintained in the source directory of the program itself. + +- Extensive man pages documenting GNU roff's input language, special + character repertoire, differences from AT&T troff, device and font + description file formats, macro files, and historical and conceptual + background are maintained in the "man" directory. + +- Documentation in other formats is located in the "doc" directory, + including groff's Texinfo manual, and tutorial and/or reference + manuals written using groff macro packages. + +- Documentation for contributed components is kept in the relevant + subdirectory of "contrib". + + +4) groff language parser + +The "troff" program in "src/roff/troff" parses the groff input language. +There, "input.cpp" implements the main loop and tokenizes input. Input +tokens are transformed into nodes (a GNU troff internal data structure) +by "env.cpp" and "node.cpp". Routines in the latter file generate the +page description language from lists of nodes. + + +5) page description language parser + +The parser for the page description language produced by troff is +implemented in "src/libs/libdriver/input.cpp". This is used by all +groff output drivers written in C++. ("gropdf", written in Perl, +performs its own parsing.) + + +##### Editor settings +Local Variables: +fill-column: 72 +mode: text +End: +vim: set expandtab textwidth=72: |