On Thu, 2011-02-24 at 15:22 +1000, Peter Hutterer wrote: > not having to write or look at roff syntax is an added benefit :) >
Indeed, the syntax is intimidating. Yet another alternative is DocBook/XML which directly supports man pages. This would save the step going from asciddoc to docbook and then from docbook to man pages. The man pages (in xml format) could be viewed directly in the desktop help browser, gnome-help for example. This is more appealing to wacom than it is to xorg, as wacom is a linux only project where free XML editors are available such as XMLmind. Of course, typing xml is no better than typing roff, so the editor would be a deciding factor. http://www.xmlmind.com/xmleditor/ Finding a balance between ease of use and ease of maintenance is never easy.
signature.asc
Description: This is a digitally signed message part
------------------------------------------------------------------------------ Free Software Download: Index, Search & Analyze Logs and other IT data in Real-Time with Splunk. Collect, index and harness all the fast moving IT data generated by your applications, servers and devices whether physical, virtual or in the cloud. Deliver compliance at lower cost and gain new business insights. http://p.sf.net/sfu/splunk-dev2dev
_______________________________________________ Linuxwacom-devel mailing list Linuxwacom-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel