On Thu, Feb 24, 2011 at 02:18:10PM +1000, Peter Hutterer wrote:
> > So we want the user to read man wacom, xsetwacom, xinput and then
> > assemble their own script combining xsetwacom and xinput?  I agree
> 
> mind you, the whole point of xsetwacom is that users don't need xinput. I
> still expect them to read the wacom man page so they understand what they're
> changing though.

slight topic change. for some reason, man pages have a bad reputation. I'm
not sure why though.

One thing that may help here is a switch to asciidoc for the man page. the
biggest benefit here is that the man page is a simple text file that we can
link to. and you can link to the latest version in git of it directly and
anyone can read it. example:
http://cgit.freedesktop.org/evtest/plain/evtest.txt

the actual conversion to groff format is done during the build process.

drawback - less formatting styles (though asciidoc may provide more than I
currently know) and another dependency (which already exists for plenty
other packages though, e.g libXi)

Cheers,
  Peter

------------------------------------------------------------------------------
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

Reply via email to