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

[Greg Troxel]

"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

  Requires:
  getopt-[0-9]*
  docbook-xsl>=1.67.0nb1
  libxml2>=2.6.2
  libxslt>=1.1.34nb4

although none of that is problematic.

>     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 think it is important to produce man pages in mandoc format.

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

signature.asc
Description: PGP signature