[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Questions regarding my man/info summer project



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







[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]