Re: ✘asciidoc vs asciidoctor, issue #118

[Gary E. Miller]

Yo Greg!

On Fri, 05 Feb 2021 19:55:35 -0500
Greg Troxel <gdt@lexort.com> wrote:

> "Gary E. Miller" <gem@rellim.com> writes:
> 
> >> I also see missing docbuild steps:  
> >
> > If you see it, how is it missing?  
> 
> What I meant is that in the diff, package with asciidoctor has then
> and package without asciidoctor does not.   So missing from one build
> log relative to the other build log, is all.  aka "didn't happen".
> but all is fine here.

Good.

> >> Looks like hardware.html is not installed (which is ok, probably,
> >> and not about this) -- pkgsrc is not expecting it in the
> >> filesystem.  
> >
> > It is installed in gpsd-3.22.1~dev/www, as expected.  That is where
> > the GitLab web pages expect it.  So as intended and as expected.  
> 
> "installed", as in put in the destdir by "scons install"?  Or just
> existing in the build directory?  It is not part ofthe pkgsrc pakcage
> because it has not showed up in the destdir after the install step.

hardware.html is "installed" as in put into the build directory:
gpsd-3.22.1~dev/www.  That is the final destination for the web files.
The only consumer of them is GitLab.

It should not go in any package, or go to the destdir.  Users have no
use for the www files.  Only GitLab uses them.

I guess some of the www files could go in /usr/share/gpsd.  But who
expects html there?  And what good would it be?

One could make the argument that the web pages should be a separate
git repository.  NTPsec keeps www in a separate git repo.  But so much
of gpsd www is html colpies of the man apges that the separate repo
seems excessive to me.

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

pgpTtH1qf9RKX.pgp
Description: OpenPGP digital signature