Re: [PATCH] man: Rewrite NetworkManager.8 and NetworkManager.conf.5 in DocBook

[Dan Winship <danw gnome org>]

On 04/10/2013 06:37 AM, Colin Walters wrote:
> DocBook is not my favorite thing in the world, but it's
> <lots-of-emphasis>far</lots-of-emphasis> saner than troff.  Some style
> parts cribbed from systemd.
>
> This is preparatory work for actually improving the content of the
> man pages.

Yay. Makes sense to me. There are a few trailing-whitespace issues in
the XML files ("blank" lines that contain whitespace), and a few minor
glitches in the layout:

           dnsmasqNetworkManager will run dnsmasq as a local caching

but yeah, troff sucks, and we never even bothered to figure out how to
do some of the layout that we really needed to be doing there. (Like,
the section under "dns" really ought to be another <variablelist>...)

I wouldn't bother converting nmcli.1 right now, since jklimes is
changing the syntax around a lot.

-- Dan