On 05/22/12 08:11 AM, Rich Burridge wrote: > > I've got some manpages for an up-n-coming Userland component that are > processed > with: > > $ groff -t -e -mdoc -Tascii <manpage>.3 > > Our man utility has conniptions with this. Looking at the various patches to > Userland > components (like .../components/libevent/patches/event.3.patch) I see these > have > been > converted to the format that we use on Solaris. > > Was this done "by hand" or is there any way to automate this?
If I was trying to automate, I'd be tempted to look into using doclifter [1] to translate to DocBook, and then translate from there into Solaris compatible nroff, with the advantage that having DocBook format man pages will be easier to publish to docs.oracle.com in the future (not yet though). Alternatively, you could work on getting the mdoc macros bundled with Solaris nroff and train the man command to use them when needed. [1] http://www.catb.org/~esr/doclifter/ [2] http://mdocml.bsd.lv/ seems to be the standalone version, also found as an integrated component of BSD distros -- -Alan Coopersmith- [email protected] Oracle Solaris Engineering - http://blogs.oracle.com/alanc _______________________________________________ userland-discuss mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/userland-discuss
