[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
pgpXHhmh7bWf3.pgp
Description: OpenPGP digital signature
- ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/13
- Re: ✘Doc files: .adoc, .html, .xml, Greg Troxel, 2021/01/13
- Re: ✘Doc files: .adoc, .html, .xml,
Gary E. Miller <=
- Re: ✘Doc files: .adoc, .html, .xml, Greg Troxel, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, Greg Troxel, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, James Browning, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/14
- Re: ✘Doc files: .adoc, .html, .xml, Eric S. Raymond, 2021/01/16
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/16
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/16
- Re: ✘Doc files: .adoc, .html, .xml, Gary E. Miller, 2021/01/16