On Wed, 2013-04-10 at 13:15 -0400, Dan Winship wrote:
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
Fixed both of those, new patch attached.
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>...)
Yeah, I was just going for a "literal" translation as a starting point.
I wouldn't bother converting nmcli.1 right now, since jklimes is changing the syntax around a lot.
Ok. The main thing I think needs to be documented well is the semantics around the connection state; what's there isn't bad, but how it interacts with the "plugin" is not obvious to me yet.
Attachment:
0001-man-Rewrite-NetworkManager.8-and-NetworkManager.conf.patch
Description: Text Data