Re: [gpsd-dev] Improving the gpsd documentation

[Gary E. Miller]

Yo All!

On Fri, 9 Nov 2018 02:20:21 +0800
Sanjeev Gupta <address@hidden> wrote:

> I think asciidoc, if used sparingly, is easier to read as plain text.

I looked into this a bit more.  Some of the gpsd www pages are already
AsciiDoc and scons handle them just fine.  So no blocker there.

> Sure.  My English is miles better than my C or python :-)  Will start
> one at a time, like the Linux docs moving to Rest.

I had thought there were tools to convert DocBook to AsciiDoc.  There
are several, but none works on the DocBook flavor that gpsd uses.

So Sanjeev's initial idea was right.  We'll have to convert one at a time.

If i get any asciidoc files I'll add them and do the scons work.

RGDS
GARY
---------------------------------------------------------------------------
Gary E. Miller Rellim 109 NW Wilmington Ave., Suite E, Bend, OR 97703
        address@hidden  Tel:+1 541 382 8588

            Veritas liberabit vos. -- Quid est veritas?
    "If you can’t measure it, you can’t improve it." - Lord Kelvin

pgptfGwaWP3g5.pgp
Description: OpenPGP digital signature