On 7/5/05, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: > > Am 05.07.2005 um 08:43 schrieb Stephen Deasey: > > > On 7/5/05, Zoran Vasiljevic <[EMAIL PROTECTED]> wrote: > > > >> > >> Am 05.07.2005 um 02:36 schrieb Stephen Deasey: > >> > >> > >>> http://naviserver.sf.net/wiki/index.php/User:Sdeasey > >>> > >>> Neato: templates! The wiki == nroff :-) > >>> > >> > >> Excuse my ignorance, but: where is nroff? > >> > > > > > > I was exagerating, sorry. Templates... with args... macros... > > nroff... > > > > > > Still, where man.macros (oh, my, God) has: > > > > .OP cmdName dbName dbClass > > > > The wiki would have Template:OP, called as: > > > > {{OP:cmdName=X|dbName=Y|dbClass=Z}} > > > > Which could expand to whatever you like, including HTML comments to > > aid converting back to nroff etc... > > > Does this mean that converting from wiki format to nroff > would be relatively trivial? IOW, I can invent just about > any Tempate:OP were OP is whatever nroff will support, like > .CE, .CS, .PP, .SH ? > > I do not know wiki enough to be able to make any decision, > but if there is a way of writing it all in wiki and getting > it converted to decent nroff (and html) without much fuss, > then I'm all for it. > > OTOH, have you ever looked at doctools? > > Zoran
I really don't know what the best thing to do is. I can see plusses and minuses either way. I personally I don't have a lot of use for paper docs, but I know it's important to some people. You can already get an XML page dump: http://naviserver.sourceforge.net/wiki/index.php/Special:Export/User:Sdeasey Kind of dissapointing, just a big blob of wiki-source. However, the macros are preserved. So the problem basically becomes, can you write a program which spiders the website and converts {{X:1|2|3}} into .X 1 2 3. Maybe we should pick one C function and one Tcl command to document fully on the wiki, write some wiki macros to make it easy, then try converting it into whatever?