semi-automated semantic markup?

Rich Morin rdm at cfcl.com
Tue May 9 11:52:11 UTC 2006


Several years ago, there was some discussion of ways
to help automate the process of bringing "old style"
man pages into the semantic markup fold.  IIRC, all
sorts of projects announced their intention to move
to DocBook.  However, it appears that most projects
have chosen, instead, to stick with mandoc (or just
to retain their random collection of man macros :-).

Anyway, I'm wondering about the available tools for
moving fairly arbitrary man pages to mandoc format.
Although Eric Raymond's doclifter could be used to
turn the pages into DocBook XML, and Steve Cheng's
docbook2x can be used to emit troff, this seems like
a rather convoluted approach.

Comments, clues, suggestions?

-r
-- 
http://www.cfcl.com/rdm            Rich Morin
http://www.cfcl.com/rdm/resume     rdm at cfcl.com
http://www.cfcl.com/rdm/weblog     +1 650-873-7841

Technical editing and writing, programming, and web development



More information about the freebsd-doc mailing list