head	1.15;
access;
symbols
	groff-1_20_1_real:1.15
	groff-1_20_1:1.15
	groff-1_20:1.15
	groff-1_19_2:1.10
	FDL:1.9
	groff-1_19_1:1.8
	groff-1_19:1.4
	groff-1_18_1:1.2
	groff-1_18:1.2;
locks; strict;
comment	@# @;


1.15
date	2009.01.05.16.44.48;	author wl;	state Exp;
branches;
next	1.14;
commitid	AgDTdzZWAIlMxhxt;

1.14
date	2007.07.11.21.10.14;	author wl;	state Exp;
branches;
next	1.13;
commitid	JisZprsXRFWUuops;

1.13
date	2006.12.31.04.39.07;	author wl;	state Exp;
branches;
next	1.12;

1.12
date	2006.03.18.08.31.00;	author wl;	state Exp;
branches;
next	1.11;

1.11
date	2005.12.30.09.31.50;	author wl;	state Exp;
branches;
next	1.10;

1.10
date	2005.05.27.07.10.53;	author wl;	state Exp;
branches;
next	1.9;

1.9
date	2004.06.03.06.24.23;	author wlemb;	state Exp;
branches;
next	1.8;

1.8
date	2004.05.12.08.07.36;	author wlemb;	state Exp;
branches;
next	1.7;

1.7
date	2003.12.08.10.11.51;	author wlemb;	state Exp;
branches;
next	1.6;

1.6
date	2003.07.02.15.37.29;	author wlemb;	state Exp;
branches;
next	1.5;

1.5
date	2003.06.14.11.44.52;	author wlemb;	state Exp;
branches;
next	1.4;

1.4
date	2003.04.15.15.13.09;	author wlemb;	state Exp;
branches;
next	1.3;

1.3
date	2003.03.12.22.59.31;	author wlemb;	state Exp;
branches;
next	1.2;

1.2
date	2002.05.23.22.06.19;	author wlemb;	state Exp;
branches;
next	1.1;

1.1
date	2001.12.22.08.28.31;	author wlemb;	state Exp;
branches;
next	;


desc
@@


1.15
log
@

MANIFEST: Updated.
@
text
@    Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2009
      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 gives an overview of the directories and the main files of
the groff source distribution.


1) The top directory.

  BUG-REPORT    A template for bug-reports.
  ChangeLog     Log of the changes in the different groff versions.
  COPYING       The GNU General Public License (GPL).
  FDL           The Free Documentation License (FDL).
  INSTALL       Information on compiling and installing groff.
  INSTALL.gen   Generic information on configuration and compiling.
  LICENSES      Licensing information.
  MANIFEST      The file you are reading.
  MORE.STUFF    Useful stuff in other packages.
  NEWS          Recent user-visible changes in groff.
  PROBLEMS      Tips to handle known critical situations.
  PROJECTS      Long-term additions to groff.
  README        Availability and contact information for groff.
  README.MinGW  Build information for MinGW.
  TODO          Things planned for future groff versions.

  All other files in the top directory are related to the configuration,
  compilation, and install processes.  


2) The directory structure

./arch          Data that is special for different architectures.
  djgpp         Data special for the 32-bit DOS compiler djgpp.
  misc          Data needed for various platforms.

./contrib       Part of groff, but maintained by other people.
  chem          A preprocessor (for pic) to produce chemical structure
                diagrams.
  eqn2graph     Convert equations created with EQN into different
                graphical formats.
  gdiffmk       An improved implementation of the diffmk command to mark
                differences between groff/nroff/troff files.
  grap2graph    Convert grap diagraps into different graphical formats.
  groffer       A wrapper to conveniently view roff files.
  hdtbl         A sophisticated table macro package.
  mm            The groff mm macro package.
  mom           The groff mom macro package.
  pdfmark       A package to add PDF marks to groff documents, together
                with a shell script (pdfroff) for easy creation of PDF
                documents.
  pic2graph     Convert PIC diagrams into different graphical formats.

./doc           Manuals and tutorials to groff aspects.

./font          Device information and fonts.
  devX100       100dpi device for X Window System.
  devX100-12    100dpi device with narrower font (for 12pt base font).
  devX75        75dpi device for X Window System.
  devX75-12     75dpi device with narrower font (for 12pt base font).
  devascii      Text device for ASCII output.
  devcp1047     EBCDIC device.
  devdvi        TeX DVI device.
  devhtml       HTML device.
  devlatin1     Text device for latin-1 (ISO 8859-1) output.
  devlbp        Device for Canon CAPSL laser printers.
  devlj4        Device for HP Laserjet 4, PCL 5, and compatible printers.
  devps         PostScript device.
  devutf8       Text device for Unicode output.
  util          Utility programs.

./m4            M4 macro files used creating the configure script.

./man           Some groff manual pages of more general character.

./src           Everything written in programming languages.

./src/devices   The postprocessors.
  grodvi        TeX DVI output.
  grohtml       HTML output.
  grolbp        Canon printers.
  grolj4        HP Laserjet 4, PCL 5, and compatible printers.
  grops         PostScript output.
  grotty        Text output.
  xditview      A groff (pre)viewer for the X Window system.

./src/include   The *.h C/C++ include files.

./src/libs      C++ code common to several parts of the groff sources.
  libbib        Library of bibliographic functions.
  libdriver     Parser for intermediate output and postprocessor code.
  libgroff      Library for general support functions used everywhere.
  libxutil      Utility functions for xditview and xtotroff.
  snprintf      An implementation of snprintf() and friends.

./src/preproc   Preprocessors.
  eqn           Mathematical formulae.
  grn           Gremlin pictures.
  html          The preprocessor part of grohtml.
  pic           Diagram drawer.
  preconv       Input encoding conversion.
  refer         Bibliographic references.
  soelim        File inclusion using tmac path.
  tbl           Tables.

./src/roff      Front-end programs.
  groff         Wrapper around troff.  This is the main user program.
  grog          Guess groff command line options.
  nroff         Emulate classical nroff text formatter.
  troff         Main roff formatter program.

./src/utils     Utility programs around groff.
  addftinfo     Add information to old troff font files for use with groff.
  afmtodit      Create font description files for the PostScript device.
  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 font in PFB format to PFA.
  tfmtodit      Create font description files for TeX DVI device.
  xtotroff      Create font description files for xditview.

./tmac          Macro files.


3) Documentation

The groff documentation is scattered upon several places.

- The main directory contains documents related to the groff source.
  The README file contains the information needed to get the groff
  package, report bugs, and contact the developers.

- The man-page of each program (section 1) is kept in the source
  directory of the program.

- The man-pages for the other sections are found in `src/man'.

- Documentation in other formats are located in the `doc' directory,
  including the groff info file, tutorials, and manuals.


4) The roff parser

The parsing of the roff language is done by troff.  The input is converted
to tokens in `src/roff/troff/input.cpp' and transformed into `nodes' by
`src/roff/troff/env.cpp' and `src/roff/troff/node.cpp'.  From these, the
intermediate output is generated (also in `node.cpp').


5) Postprocessing

The parser for the intermediate output and the postprocessing is in
`src/libs/libdriver/input.cpp'.  This is used by all postprocessors.
@


1.14
log
@

Add copyrights and/or normalize them.
@
text
@d1 1
a1 1
    Copyright 2001, 2002, 2003, 2004, 2005, 2006
d49 1
d73 3
a99 1
  preconv       Input encoding conversion.
d104 1
@


1.13
log
@

* font/devps/generate/Makefile (symbolsl.afm): Use $(srcdir).

* Makefile.comm (fonts): New (empty) target.
* Makefile.in (TARGETS): Add `fonts'.

* MANIFEST: Add `chem'.
@
text
@d1 2
a2 1
MANIFEST 
d4 3
a6 18
Last update: 18 Dec 2005

This file is part of groff, the GNU roff type-setting system.

Copyright (C) 2001, 2003, 2004, 2005 Free Software Foundation, Inc.
written by Bernd Warken <bwarken@@mayn.de>
maintained by Werner Lemberg <wl@@gnu.org>

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with the
Invariant Sections being this .ig-section and AUTHORS, with no
Front-Cover Texts, and with no Back-Cover Texts.

A copy of the Free Documentation License is included as a file called
FDL in the main directory of the groff source package.

########################################################################
@


1.12
log
@*** empty log message ***
@
text
@d55 2
@


1.11
log
@

New preprocessor `preconv' to convert input encodings to something
groff can understand.  Not yet integrated within groff.  Proper
autoconf stuff is missing too.

Tomohiro Kubota has written a first draft of this program, and some
ideas have been reused (while almost no code has been taken
actually).

* src/preproc/preconv/preconv.cpp. src/preproc/preconv/Makefile.sub:
New files.

* MANIFEST, Makefile.in (CCPROGDIRS), test-groff.in
(GROFF_BIN_PATH): Add preconv.
@
text
@d34 1
a34 1
  LICENSE       Licensing information.
@


1.10
log
@

* MANIFEST, README, doc/webpage.ms: Updated.
@
text
@d3 1
a3 1
Last update: 26 May 2005
d108 1
@


1.9
log
@

* aclocal.m4 (GROFF_X11): s/have_no_x/groff_no_x/.
Add X11 stuff to CFLAGS, LDFLAGS, and LIBS temporarily.
Add test for Xmu library.
(GROFF_APPRESDIR_OPTION, GROFF_APPRESDIR_CHECK,
GROFF_APPRESDIR_DEFAULT): New macros.

* configure.ac: Call GROFF_APPRESDIR_OPTION, GROFF_APPRESDIR_CHECK,
and GROFF_APPRESDIR_DEFAULT.

* configure: Regenerated.

* Makefile.in (appresdir): New variable.
(MDEFINES): Add appresdir.

* src/devices/xditview/Makefile.sub (EXTRA_LDFLAGS): Add -Xmu and
-Xt.
(install_data, uninstall_sub): New targets to handle GXditview.ad.

* src/utils/indxbib/Makefiles.ub (install_data): Depend on
`$(srcdir)/eign', not `eign'.

* MANIFEST, INSTALL, NEWS, PROBLEMS: Updated.

* man/groff_out.man, man/roff.man, src/devices/grops/grops.man,
src/devices/xditview/gxditview.man, src/roff/groff/groff.man:
Protect (g)xditview with `\%' to avoid hyphenation.
Other minor formatting.
@
text
@d3 1
a3 1
Last update: 1 June 2004
d7 1
a7 1
Copyright (C) 2001, 2003, 2004 Free Software Foundation, Inc.
a40 1
  README.CVS    Development build information.
d57 2
d63 3
@


1.8
log
@

* NEWS, README, TODO, PROJECTS, PROBLEMS, MANIFEST, doc/webpage.ms,
tmac/TODO: Updated.

* tmac/doc-syms (doc-str-Lb-libposix, doc-str-Lb-libpthread,
doc-str-Lb-librt): Reset font.
(Lb): Rename `doc-str-Lb' to `doc-str-Lb1'.
Provide `doc-str-Lb' to reset font.
* tmac/groff_mdoc.man: Updated.
@
text
@d3 1
a3 1
Last update: 10 May 2004
d92 1
d100 1
d127 1
a127 2

./src/xditview  A groff (pre)viewer for the X Window System.
@


1.7
log
@

* LICENSE: Updated.

* INSTALL: Improved.
@
text
@d3 1
a3 1
Last update: 01 Jul 2003
d7 1
a7 1
Copyright (C) 2001, 2003 Free Software Foundation, Inc.
d34 1
d41 2
d53 1
@


1.6
log
@
Integrated grap2graph, contributed by Eric S. Raymond.

* contrib/grap2graph/{Makefile.sub, grap2graph.sh, grap2graph.man}:
New files.
* Makefile.in, NEWS, MANIFEST, contrib/eqn2graph.man,
contrib/pic2graph.man, src/roff/groff/groff.man: Updated.
@
text
@d3 1
a3 1
Last update: 11 Jun 2003
@


1.5
log
@

* src/preproc/tbl/tbl.man: Document formatting of text blocks.

* src/roff/troff/input.cc (token::next) <handle_escape_char>:
Assign `n' even here.  It is possible to construct a node
immediately following an escape character:

  .di xx
  \?\\\?a
  .br
  .di
  .xx
@
text
@d54 1
@


1.4
log
@Renamed all `*.cc' files to `*.cpp'.
Updated all configuration files, makefiles, and documentation.
@
text
@d3 1
a3 1
Last update: 13 Apr 2003
a39 1
  README.WIN32  Documentation of the Win32 port of groff.
@


1.3
log
@
Make variable `pr' local to libdriver/input.cc.  Based on a patch
by Bernd Warken <bwarken@@mayn.de>.

* src/include/driver.h (pr): Removed.

* src/libs/libdriver/input.cc (pr): New global variable.
(do_file): Deallocate `pr'.
* src/libs/libdriver/printer.cc (pr): Removed.

* src/devices/grodvi/dvi.cc (main), src/devices/grohtml/post-html.cc
(main), src/devices/grolbp/lbp.cc (main), src/devices/grolj4/lj4.cc
(main), src/devices/grops/ps.cc (main), src/devices/grotty/tty.cc
(main): Don't delete `pr'.

* tmac/a4.tmac, tmac/composite.tmac: Use `.do'.
* tmac/papersize.tmac: New file.
* tmac/troffrc: Include `papersize.tmac'.
* tmac/Makefile.sub (NORMALFILES): Add `papersize.tmac'.
* tmac/an-old.tmac: Set LT to LL by default.

* NEWS, MANIFEST, tmac/groff_man.man, man/groff_tmac.man,
doc/groff.texinfo: Updated.

* src/libs/libgroff/paper.cc (add_iso_paper): Fix very embarassing
bug which caused all odd iso papers to have wrong dimensions.

* src/devices/grops/ps.cc (user_paper_width): New global variable.
(main) <'p'>: Set `user_paper_width' also.
(ps_printer::media_width, ps_printer::media_height): Use values
given with option `-p'.
@
text
@d3 1
a3 1
Last update: 11 Mar 2003
d147 3
a149 3
to tokens in `src/roff/troff/input.cc' and transformed into `nodes' by
`src/roff/troff/env.cc' and `src/roff/troff/node.cc'.  From these, the
intermediate output is generated (also in `node.cc').
d155 1
a155 1
`src/libs/libdriver/input.cc'.  This is used by all postprocessors.
@


1.2
log
@
Integrating the `mom' macro package, contributed by Peter Schaffter
<df191@@ncf.ca>.

* contrib/mom/*: New subdirectory tree.
* Makefile.in (docdir, exampledir, htmldocdir): New variables to
be used for documentation files.
(MDEFINES, uninstall_dirs): Use them.
(OTHERDIRS): Add contrib/mom.
* Makefile.comm (.man.n): Add @@DOCDIR@@, @@EXAMPLEDIR@@, and
@@HTMLDOCDIR@@.
* MANIFEST, NEWS: Updated.
@
text
@d3 1
a3 1
Last update: 21 Dec 2001
d7 1
a7 1
Copyright (C) 2001 Free Software Foundation, Inc.
d53 2
a111 2
./src/xditview  A groff (pre)viewer for the X Window System.

d119 1
a119 1
  pfbtops       Translate a PostScript font in .pfb format to ASCII.
d122 2
d146 4
a149 3
The parsing of the roff language is done by troff.  The input is
transformed into "nodes" by `src/roff/troff/node.cc'.  From these, the
intermediate output is generated.
@


1.1
log
@
* tmac/doc-common, tmac/doc-syms: Small updates.
* tmac/an-old.tmac (an-p-footer): Set title length in environment 1.

* MANIFEST: New file.

* src/preproc/grn/grn.man: Updated.
* src/preproc/grn/hdb.cc (MAXSTRING_S): New macro.
(DBRead): Use it.
@
text
@d53 1
d55 1
@

