From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from frisell.zx2c4.com (frisell.zx2c4.com [192.95.5.64]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 5ba43a70 for ; Thu, 13 Feb 2020 17:38:15 -0500 (EST) Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTP id 44e9d4bf for ; Thu, 13 Feb 2020 22:36:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=zx2c4.com; h=mime-version :references:in-reply-to:from:date:message-id:subject:to:cc :content-type; s=mail; bh=sY3HgVGYj9YtgWqrMjshTu+zLA4=; b=H89QdL p8F3CTKA/kYREOypk4iT94KVP72/p/DrSRjLqlLuO78hEBpOn/fk9sFZ3hEocsvc EpaNSFNQ6ZWi6yCaaY0+lIcjZ1gMFTeIpi0ZdspVEyBeHt7DkW5KmO0eRpPIuXuI QjaOShumYBb5sKiqmPEjvaKRuLu7D6/63FXfFNGY12sKs/o4EnZyn+SRcJ7FPQ3F 9BP1lUXMsb2EipTjluyZakyNlUTlw4zOkWcBD0nksZHamHMw7VPTynQU6/+Jn3JZ H41mRX76GWnaZO+bm7pURmwkjlzjqtYJK8biU6gmq6t8lvIy4pJLdry6EyFtuZnz JGOr7/A9qLOasAIw== Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTPSA id 8019d909 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for ; Thu, 13 Feb 2020 22:36:11 +0000 (UTC) Received: by mail-oi1-f179.google.com with SMTP id a142so7516699oii.7 for ; Thu, 13 Feb 2020 14:38:12 -0800 (PST) X-Gm-Message-State: APjAAAUX4ve//tPS2eHlQvimR8DtfT4W1PV40aQdiHjjbLsp5+cbyHf+ JmqdqIDCnCUz5q/4Ky3/hqBCo+zCeWO98O8b9/8= X-Google-Smtp-Source: APXvYqz5nGouluCDEAfB7jNbOhDE4hWsDJ5zUzW+UwWzv1LAtzw9dzNhQQEuRiZza/yXvAQbH3G29ekb7bReFsuHK/4= X-Received: by 2002:a05:6808:4cc:: with SMTP id a12mr4704747oie.115.1581633492302; Thu, 13 Feb 2020 14:38:12 -0800 (PST) X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 References: <20200213042900.2ed2sbhglg5uzjq5@BlackBox> <20200213044921.8115-1-dev@sgregoratto.me> <20200213175735.GE75465@athene.usta.de> <20200213193430.GG75465@athene.usta.de> <20200213222845.GA31578@athene.usta.de> In-Reply-To: <20200213222845.GA31578@athene.usta.de> From: "Jason A. Donenfeld" Date: Thu, 13 Feb 2020 23:38:01 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH] Fix formatting in wg-quick(8) To: Ingo Schwarze Cc: Stephen Gregoratto , discuss@mandoc.bsd.lv Content-Type: text/plain; charset="UTF-8" Hi Ingo, On Thu, Feb 13, 2020 at 11:28 PM Ingo Schwarze 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