gpsd-dev
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: ✘Doc files: .adoc, .html, .xml


From: Gary E. Miller
Subject: Re: ✘Doc files: .adoc, .html, .xml
Date: Wed, 13 Jan 2021 17:05:46 -0800

Yo Greg!

On Wed, 13 Jan 2021 19:33:39 -0500
Greg Troxel <gdt@lexort.com> wrote:

> "Gary E. Miller" <gem@rellim.com> writes:
> 
> > The choices have non-obvious consequences.
> >
> >     AsciiDoc pulls in Python
> >     AsciiDoctor pulls in Ruby
> >     Sphinx pulls in Python, and has a ton of add-ins.
> >     xmlto is a simple shell script, but has not been touched in 5
> > years/  
> 
> not really.  the package in pkgsrc needs

I'm not sure what part you are commenting on?  Their commit history
clarly shows no commits in 5 years:

    https://pagure.io/xmlto/commits?author=ovasik@redhat.com

>   Requires:
>   getopt-[0-9]*
>   docbook-xsl>=1.67.0nb1
>   libxml2>=2.6.2
>   libxslt>=1.1.34nb4  
> 
> although none of that is problematic.

So why mention it?  What am I missing?

Are you just referring to xmkto pulling in libxslt, which pulls in that
other stuff?

> >     xsltproc is C, but has not seen much work since 2017
> >
> > Keeping Ruby up to date for AsciiDoctor has been a pain, so I lean
> > towards going back to AsciiDoc.  
> 
> That makes sense.  gpsd already needs python.

I'm thinking that supporting AsciiDoc and AsciiDoctor in gpsd may
be easy.  Then I can get rid of a ton of Ruby packages.

> I think it is important to produce man pages in mandoc format.

I thought mandoc was an imput format, like .xml, in fact, it is .xml.
Unless you are talking about M$ .mdoc?

gpsd currently has no way to turn .adoc into .xml, nor can I imagine
anyone wanting to, except for conversions.

I see only the BSDs uses mandoc, and I thought BSD was happy with the
current nroff gpsd man pges?  

What am I missing?

> You left out texinfo, but probably that was on purpose, and it doesn't
> really make man pages.

gpsd currently has no .tex files, and, yes,, since it does not make
man pages (by itself), is not in the running.

Otherwise you have no preference on which is the one true doc format?

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

Attachment: pgpXHhmh7bWf3.pgp
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]