Re: ✘asciidoc vs asciidoctor, issue #118

[Sanjeev Gupta]

Gary, et al,

I am not sure what desired behaviour should be.

If I specify that manbuild=yes , and asciidoctor is not available, I get a warning, but the build completes (as does the install).

This is surprising.  Perhaps if manbuild=yes , the warning should be a failure?

--
Sanjeev Gupta
+65 98551208     http://www.linkedin.com/in/ghane

On Tue, Jan 26, 2021 at 7:51 AM Sanjeev Gupta <ghane0@gmail.com> wrote:

Gary,

One of the reasons I remember for using asciidoc instead of asciidoctor was that "asciidoctor pulls in tons of ruby stuff".

I installed asciidoc on a fresh debian install yesterday, and it wanted to download 175MB of packages, including texlive.  As such, I am not sure if it is "lighter" than asciidoctor.

So the only reason I have left against asciidoctor is that uses the that newfangled ruby stuff.  But then, I prefer FORTRAN to that new kid, C, so feel free to ignore me.

TLDR; drop asciidoc support.

1. People playing with GPS, like me, can install asciidoctor
2. People installing packages on leaf nodes will use pre-built man pages, so do not need to know this stuff
3. People building their own packages to install fleetwide will not need man pages locally, anyway
4. etc
   

--
Sanjeev Gupta
+65 98551208     http://www.linkedin.com/in/ghane

On Tue, Jan 26, 2021 at 4:36 AM Gary E. Miller <gem@rellim.com> wrote:

Yo All!

Issue #118, from Sanjeev Gupts, points out the asciidoc man page
generation is broken.  I added it, but did not test well enough:

https://gitlab.com/gpsd/gpsd/-/issues/118

I can fix it without too much trouble, but I noticed that to do so
requires asccidoc (but not asciidoctor) to pull in all the flakey
XSL stuff that I though asciidoc syntax was supposed to avoid.

I think I was the last one that cared to keep asccidoc, since
asciidoctor works fine.  Anyone care if the requirement becomes
asciidoctor only?

BTWE, all the man pages have been converted from .xml to .adoc.  I find
the .adoc files much easier to edit.  I'll contunue work to convert
the remaining .xml files.

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

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