Hi!
I have to admit that I don't have any idea how (or better if) our man pages
are kept up2date.
After having a short look at the groff format I am very sure that no one
wants to edit that. (Info pages are a different thing).
So the question is how can the man pages transformed into wiki markup and
back without loss of information. There is some groff markup that naturally
translates into wiki markup. For all other stuff you could write MoinMoin
macros. For creating the diffs you should be able to translate the wiki page
back to groff and do the diffs between the groff versions insted of the wiki
markup pages. That way the patches are much more likely to be useful for
updating the man pages.
The easiest way of translating page content is using an Formatter. But that
won't help for the non MoinMoin markup features you'd modeled as macros. The
way out is special casing the output of the macros depending on the
formatter used. If they get an groff formatter they return the groff source
otherwise they use the formatter to highlight the text properly.
If you have questions feel free to ask my on #moin or #moin-dev.
Florian Festi
--
fedora-devel-list mailing list
fedora-devel-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/fedora-devel-list
