Re: [PATCH] Fix formatting in wg-quick(8)

["Jason A. Donenfeld" <Jason@zx2c4.com>]

Hi Ingo,

On Thu, Feb 13, 2020 at 11:28 PM Ingo Schwarze <schwarze@usta.de> wrote:
> On any BSD, any Linux, on Illumos, and on commercial Oracle Solaris 11:
> yes, any installation of man(1) you might have will display mdoc(7)
> just fine.  On most BSDs, man(1) will use mandoc(1) for formatting.
> On most Linuxes, man(1) will use groff(1) by default for formatting,
> but groff(1) has been supporting mdoc(7) for about three decades
> now.

That all sounds perfect. Out of the box support for a better set of
macros on all the platforms I care about. I just tried pasting the
hello world example from the mdoc manual preference, and man(1)
handled it without a hitch.

> If you use MacOS, it will work, too, but there might be occasional
> formatting problems.

I suppose we can just hack around these, should they come up.

> Do you want somebody to have a go at converting your two files
> to mdoc(7)?

That would be terrific! Thank you.

I'm happy to be going this route, rather than giving up and succumbing
to docbook or asciidoc or a similar cop out. Seems like mdoc has all
the right semantic markup for what we need.

Jason
--
 To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv