On Fri, 31 Jul 2009, Ben Finney wrote:
On 20-Jun-2009, Ben Finney wrote:
My reference is the ‘man-pages(7)’ manual page from
<URL:http://www.kernel.org/doc/man-pages/online/pages/man7/man-pages.7.html>:
I have since been directed to the more specific ‘man(7)’ manual page
<URL:http://www.kernel.org/doc/man-pages/online/pages/man7/man.7.html>.
This has a lot of helpful information, including the section “Safe
Subset”::
Although technically man is a troff macro package, in reality a
large number of other tools process man page files that don’t
implement all of troff’s abilities. Thus, it’s best to avoid some
of troff’s more exotic abilities where possible to permit these
other tools to work correctly. […]
yes i read this, but the set of supported troff macros::
\", ., ad, bp, br, ce, de, ds, el, ie, if, fi, ft, hy, ig, in, na, ne,
nf, nh, ps, so, sp, ti, tr.
is long enough, the writer currently uses mainly the man macros
.SH, ... and .sp , .in and the font mechanism
test as you can and nag me.
next for me would be the setup.py to release on pypi and get more
testers this way. and after this a code cleanup. and probably release
with docutils.
cheers
--