On 12/8/2012 3:28 PM, Jon Elson wrote: > Anders Wallin wrote: >>> >> Some googling and discussion on IRC yesterday indicates that asciidoc can >> be used as the source for all the three types of documentation the linuxcnc >> project has: html, pdf, man-pages. >> There is an (old) example here: https://bugs.archlinux.org/task/7312 >> a2x, which produces a man-page from asciidoc, is already a requirement for >> the linuxcnc docs. >> > Are you sure? I have tables and math formulas in my driver docs, I > think they need > an add-on to asciidoc. We used to have TeX-style typeset math formulas, > but that got > so broken that I ended up linking .png graphics files in the document! > Hideously > gross way to have to get a simple formula into the text! > > I don't think these formulas can be put in a man page at all, except as > a pure > ascii representation, which was the whole reason to go through the insane > hassle for these formulas. > > Jon >
Well, we don't have them in man pages now, so I imagine we could figure out a way to filter them out during pre- or post- processing of the asciidoc sources on their way to man pages. Concerning our legacy man pages, Eric S Raymond (yes, that Eric) has written a Python program called doclifter (available via the Synaptic Package Manager) which takes troff/groff sources (including man-page source) and generates DocBook files. With other scripts out there one can get from DocBook to asciidoc format. (This latter might seem like swimming upstream for some, but one does what one has to do.) For info on how to use doclifter, see http://www.catb.org/~esr/doclifter/doclifter.html Or one could use brute force and ignorance (my favorite approach if I can't use someone else's work straightaway) and write a text-substitution routine using any of a score of languages to get from the few man markup macros we seem to use in our existing man pages to the equivalent asciidoc markup. Eric is happy to explain why his approach is better:-) Regards, Kent ------------------------------------------------------------------------------ LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial Remotely access PCs and mobile devices and provide instant support Improve your efficiency, and focus on delivering more value-add services Discover what IT Professionals Know. Rescue delivers http://p.sf.net/sfu/logmein_12329d2d _______________________________________________ Emc-developers mailing list Emc-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/emc-developers
