Re: ✘asciidoc vs asciidoctor, issue #118

[Gary E. Miller]

Yo Greg!

On Thu, 28 Jan 2021 07:58:22 -0500
Greg Troxel <gdt@lexort.com> wrote:

> "Gary E. Miller" <gem@rellim.com> writes:
> 
> >> 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?  
> >
> > I don't think it has ever been an error.  Since the default is
> > manbuild=yes, it would be annoying to hard fail.
> >
> > Easy to change if anyone feels strongly about it.  
> 
> (If asciidoctor is available a default build should build the docs,
> obviously, and uncontroversially.)
> 
> My opinion, for cases when asciidoctor is not available:
> 
>   If one does the build without saying an explicit manbuild=yes, the
>   build must succeed and simply not build the docs.  asciidoctor is
> not that hard to install, but it's not something that can be expected
> to be present on any reasonable system.
> 
>   If one does say manbuild=yes, a failure is appropriate.

I do not know how to tell those cases apart in the code.

> This leads to variables having values no/auto/yes, where auto means
> yes with a warning only if no tool and yes means fail if no tool.   A
> bunch of work that I have no desire to do, but if somebody else did
> I'd see it as an improvement.

We would have to replace scons options processor, that would be a PITA.

Some other way? Maybe option: forcemanpages?

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

pgpWXnTzq1LnU.pgp
Description: OpenPGP digital signature