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