From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from wout1-smtp.messagingengine.com (wout1-smtp.messagingengine.com [64.147.123.24]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id feba4593 for ; Sun, 16 Feb 2020 05:32:58 -0500 (EST) Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.west.internal (Postfix) with ESMTP id 695FE510; Sun, 16 Feb 2020 05:32:57 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Sun, 16 Feb 2020 05:32:57 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sgregoratto.me; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=fm2; bh=wzTNzTwmxDAs/mqysg6PrmcH8S3 d2vktwAn049PcOUQ=; b=d945kHNo1i2vuqn6qyp8WmDuc1Hd/UyKNPgM2sZ6oaO cSRDuOT+NvxE4p/4bY3YDYXLw76j0FC+JcoN67i5ECHDaMed9C5/nOD7aiGgSO7m tto+DNfVV0rdjhKLjKWb7JhfouN6YA8CdJ1NeB/6ZoHSif6qA8NS0Pq/LdupOOuZ gDysLmkWEYarpDMdGI8auCMcMqx6M+5VDH4ZHAFwSOp2a09Wg2CUMNb396NCMRNd auJM8ZAwYbioaRKE8/69V/VVCcm4xmVI5OjQrJJWcdUf97jpV0v0pzJUGvFCu8Lx rSePkASm64cuY21XWDLi/OVzFUrgvpV1+gsD+K8UBBg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=wzTNzT wmxDAs/mqysg6PrmcH8S3d2vktwAn049PcOUQ=; b=dnoSIhGZxGNK/RRJQ7ZZD1 ++KvliN4T7/pFRLdERflkZCnKyyns7Ode8nkyE7Ei3rCNWi/I4d0PWHkMRW5Gunq WemAHJh4UbN5oLOk7Oo52mqK5Z1bMIB8vpEwKfT/OF2IG0dUNiCtfGzFkrEJisew XJSnxxFOQouqhxijxA+V3hTOWvrl1+reO384/h0uUpTaPGg6Hc1hcyFN0m2uQtY+ pkHz0SuhVISwI7Dc9nzBNmcG+TE3EFYnmDGYRg7Hx4FlKVYBFWD4g6PAdfYz/A7+ ryaGe+KbVAJYc7/TF5W2hhPF2u7Cb3UiPHcQcE5qNB/PHtouQor7HS4ZI3IOENvg == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrjeeggddujecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpeffhffvuffkfhggtggujgesthdtredttddtjeenucfhrhhomhepufhtvghphhgv nhcuifhrvghgohhrrghtthhouceouggvvhesshhgrhgvghhorhgrthhtohdrmhgvqeenuc fkphepheekrddujeelrdeggedrudejvdenucevlhhushhtvghrufhiiigvpedtnecurfgr rhgrmhepmhgrihhlfhhrohhmpeguvghvsehsghhrvghgohhrrghtthhordhmvg X-ME-Proxy: Received: from localhost (172.44.179.58.sta.dodo.net.au [58.179.44.172]) by mail.messagingengine.com (Postfix) with ESMTPA id F26A2328005E; Sun, 16 Feb 2020 05:32:55 -0500 (EST) Date: Sun, 16 Feb 2020 21:32:52 +1100 From: Stephen Gregoratto To: "Jason A. Donenfeld" Cc: Stephen Gregoratto , discuss@mandoc.bsd.lv, WireGuard mailing list Subject: Re: [PATCH v2] Rewrite wg-quick.8 in mdoc Message-ID: <20200216103252.ewt4agdpmvgpndid@BlackBox> Mail-Followup-To: "Jason A. Donenfeld" , Stephen Gregoratto , discuss@mandoc.bsd.lv, WireGuard mailing list References: <20200213044921.8115-1-dev@sgregoratto.me> <20200215004556.11766-1-dev@sgregoratto.me> X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: Hi Jason, On Sat Feb 15, 2020 at 8:53 PM, Jason A. Donenfeld wrote: > Thanks for doing this. I appreciate it. I can manually diff the text > to the old one if you insist, but I'd really prefer to see either a > list of what text you changed or having the type setting and the text > change done in separate commits. The changes made are very minor: The config_file and interface arguments were made lowercase, and all mention of them in the rest of the manual has been changed as well. The interface additions were changed from a bulleted list to a definition list, where the additions were the definitions. I removed the boldening in the examples along with the sentance: "Bold lines below are for options that extend wg(8)." The justification was that since the [interface] additions were properly marked up in the example explanations, having the lines be emboldened was redundant. You can see the difference better when viewing them as PDF's through groff side-by-side. If you'd like I can revert this. As mentioned by Ingo, more manual references were added to the SEE ALSO section, with them being sorted in section-name order. I also moved the link to the project page into this section, and dropped the "World Wide Web" bit. Finally, the AUTHORS section was reworded slightly: original: "wg-quick was written by..." new: "The wg-quick program was written by..." This is a convention for system programs. As for Anthony's work, this seems to be a case of "convergent evolution," since our work is very similar ;). I think if I combine the best parts of both, along with Ingo's comments, I could prepare a final patch for wg-quick. I'm not sure if everyone that helped needs to sign off on the patch, but I'll make sure they're mentioned. For the next patch, would you like to see the list above in the commit message? -- Stephen Gregoratto -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv