Re: [ovs-dev] [RFC 0/4] Introduce Sphinx for man pages

2017-04-13 Thread Ben Pfaff
On Thu, Apr 13, 2017 at 05:40:37PM -0700, Ben Pfaff wrote: > On Mon, Apr 10, 2017 at 01:12:26PM +0100, Stephen Finucane wrote: > > This series introduces the use of Sphinx for building man pages. There are a > > couple of reasons for doing this: > > > > - roff is ruff to write > > > > Sorry. ro

Re: [ovs-dev] [RFC 0/4] Introduce Sphinx for man pages

2017-04-13 Thread Ben Pfaff
On Mon, Apr 10, 2017 at 01:12:26PM +0100, Stephen Finucane wrote: > This series introduces the use of Sphinx for building man pages. There are a > couple of reasons for doing this: > > - roff is ruff to write > > Sorry. roff is an old markup format that's mostly used for man pages today. > Wh

[ovs-dev] [RFC 0/4] Introduce Sphinx for man pages

2017-04-10 Thread Stephen Finucane
This series introduces the use of Sphinx for building man pages. There are a couple of reasons for doing this: - roff is ruff to write Sorry. roff is an old markup format that's mostly used for man pages today. While certainly not impossible to parse, it isn't very pleasant to either read o