Markus Weissmann <mww@macports.org> writes:
Good to hear the idea has some support. As far as the XML formatting, it has proved to be difficult to to get man pages from them that are formatted well, and I'm not sure they are formatted all that well now. I was surprised at the difficulties we've run into, and I see why most people still use troff. But I do think that having a single source for the man pages and docs and the resulting accuracy and ease of keeping updated docs trumps any of the difficulties. That's my view anyway.
For the esthetics, perhaps we can do something like adding a command to port(1) that opens a generated html-file in a browser (via `open'), like 'port help portfile' -- or just also include a html- version of the "manpages" with port(1).
That sounds like an interesting idea. Mark