along the lines of "starman jones'" ever so useful contribution to the
community i thought i'd toss in my own. like any programmer i really
enjoy doing documentation. ok, that's a total lie. but if i can play
with some amusing tools along the way it's a bit more tolerable.
anyway since i've been using troff to do another part of a project i
used it for the docs. it's pretty nifty. not much markup required and
i can get indexing, table of contents, etc with not much work. the hard
part is getting docs on it but a good place to start is richard stevens'
though it's kind of weird visiting a web page of a person who has passed
away. one part that is a bit out of date is the section on indexing.
on my redhat box there's a program called makeindex that does the indexing
work that the collection of awk scripts mentioned on the page does.
makeindex will spew latex as well if that gets your jollies. not that
i've tried. however the man page is a bit off, so i include an index
style file that does work below.
in addition redhat 6.1's groff doesn't include an a4 macro for, well,
a4 type paper. that's also included below. just make it the first file
on the groff command line.
make handles building the document and index for postscript, pdf or even
an x previewer (groff -TX75 -t -me files.me).
finally i used the "me" macros since i could find more docs for it.
the "ms" macros look nice too, but i'm at a loss for docs for it.
.\" Set up groff for A4 paper.
".\\\" start of index output
.\\\" enter two column mode
postamble "\n.\\\" end of index output"
setpage_prefix "\n.nr % "
group_skip "\n.sp 1.0"
delim_0 ", "
delim_1 ", "
delim_2 ", "
kevin at suberic.net q: what's the difference between batman & b. gates?
fork()'ed on 37058400 a: when batman fought the penguin, he won.
meatspace place: home http://suberic.net/~kevin/
>> want privacy? www.gnupg.org or www.pgp.com. encrypted mail preferred <<
Maintained by the ILUG website team. The aim of Linux.ie is to
support and help commercial and private users of Linux in Ireland. You can
display ILUG news in your own webpages, read backend
information to find out how. Networking services kindly provided by HEAnet, server kindly donated by
Dell. Linux is a trademark of Linus Torvalds,
used with permission. No penguins were harmed in the production or maintenance
of this highly praised website. Looking for the
Indian Linux Users' Group? Try here. If you've read all this and aren't a lawyer: you should be!