Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 9 May 2006 04:52:06 -0700
From:      Rich Morin <rdm@cfcl.com>
To:        freebsd-doc@FreeBSD.org
Subject:   semi-automated semantic markup?
Message-ID:  <p06230991c086265b736c@[192.168.254.205]>

next in thread | raw e-mail | index | archive | help
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@cfcl.com
http://www.cfcl.com/rdm/weblog     +1 650-873-7841

Technical editing and writing, programming, and web development



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?p06230991c086265b736c>