Re: [Discuss-gnuradio] XML Editing Tools

2010-04-13 Thread Josh Blum
I feel wiki markup is the best way to go. Its friendly on the writer and makes for readable diffs. I dont like the idea of checking in generated docbook xml. We could use restructured text http://en.wikipedia.org/wiki/ReStructuredText and docutils to convert it to xml, html, etc. -josh 1

Re: [Discuss-gnuradio] XML Editing Tools

2010-04-13 Thread Firas Abbas
Thank you Josh and Eric for the Responses > From: Josh Blum > > I am afraid that the files look hand-written. You can misuse doxygen to make > manuals by feeding it hand written xml. At least I think thats the case. Whats I'm looking for is a new approach to generate both html and PDF docu

Re: [Discuss-gnuradio] XML Editing Tools

2010-04-13 Thread Eric Blossom
On Mon, Apr 12, 2010 at 11:50:56PM -0700, Firas Abbas wrote: > Hi. > > > What are the tools used to create the following Gnu Radio documents: > > a) exploring-gnuradio.xml > b) usrp_guide.xml > c) gr-trellis.xml These are DOCBOOK source files (XML). http://www.docbook.org/whatis They where wr

Re: [Discuss-gnuradio] XML Editing Tools

2010-04-13 Thread Josh Blum
I am afraid that the files look hand-written. You can misuse doxygen to make manuals by feeding it hand written xml. At least I think thats the case. I am interested to have a wiki-based markup, where the wiki code could be rendered into doxygen xml by a small python script (or just strait to

[Discuss-gnuradio] XML Editing Tools

2010-04-13 Thread Firas Abbas
Hi. What are the tools used to create the following Gnu Radio documents: a) exploring-gnuradio.xml b) usrp_guide.xml c) gr-trellis.xml Best Regards, Firas ___ Discuss-gnuradio mailing list Discuss-gnuradio@gnu.org http://lists.gnu.org/mailman/lis