1README for pdfmark.tmac
2=======================
3
4Copyright (C) 2004, Free Software Foundation Inc.
5Contributed by Keith Marshall (keith.d.marshall@ntlworld.com)
6
7This is free software.  See file COPYING, for copying permissions,
8and warranty disclaimer.
9
10This is a preview release of a proposed pdfmark.tmac macro package,
11for use with GNU troff (groff).  It is not yet complete, and should
12be considered as an alpha release;  there are a few problems to be
13resolved (see file PROBLEMS).
14
15Partial documentation is provided, in groff-ms format.  To convert
16this to PDF format, you will require a working groff installation,
17a working ghostscript installation, with the gs command in your PATH,
18and a GNU-compatible make.  The tarball should be unpacked in the
19top directory of your groff source tree, then:
20
21  cd <groff-current>/contrib/pdfmark
22  make pdfmark
23
24where <groff-current> is the top directory of your current groff
25source tree.
26
27Included in this package, are:
28
29  pdfmark.tmac -- the core pdfmark macro set
30  spdf.tmac    -- a rudimentary set of bindings for ms macros
31  pdfmark.ms   -- preliminary documentation
32  cover.ms     -- a template for the documentation cover sheet
33  gnu.eps      -- the groff logo, copied from the groff distribution
34  Makefile     -- makefile, for formatting the documentation
35  README       -- this file
36  PROBLEMS     -- a list of known problems
37  TODO         -- a list of planned features, not yet implemented
38
39To make the pdfmark macros generally usable, copy pdfmark.tmac to the
40'site-tmac' directory appropriate to your groff installation; (ms users
41may also wish to copy spdf.tmac).  The macros may then be accessed, by
42including the '-mpdfmark' option on the groff command line; (for ms
43users, '-mspdf' is equivalent to '-ms -mpdfmark', with some extra
44macros 'thrown in').
45
46Comments, and bug reports are welcomed.  Please post to the groff
47mailing list, groff@gnu.org; (you must be subscribed to this list to
48post mails).  To subscribe, visit
49  
50  http://lists.gnu.org/mailman/listinfo/groff
51