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: James Browning
Subject: Re: ✘Doc files: .adoc, .html, .xml
Date: Thu, 14 Jan 2021 17:39:53 -0800

On Thu, Jan 14, 2021 at 5:06 PM Gary E. Miller <gem@rellim.com> wrote:
Yo Greg!

On Thu, 14 Jan 2021 19:08:21 -0500
Greg Troxel <gdt@lexort.com> wrote:

> I mentioned haskell because often people think it's ok to use pandoc.
> Perhaps nobody in gpsd-land.   But I run into people who think it's ok
> and have no understanding of the issues it causes.

Pandoc is interesting:
        https://pandoc.org/

It is available in Gentoo unstable, but not Gentoo stable.  And only
depends on 129 unstable Haskell packages.  Ouch.

It can convert between most doc formats.  So maybe I can use it to
convert the existing .xml manpage to asciidoc.

It generates some interesting bad results. Much cleaner results can be
derived from the docbook -> manpage -> asciidoc conversion chain. except
for doc/ where I cut the middle step and manually grafted some things.
Quotes are off for the former though. Other chains will produce
different results.

reply via email to

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