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 f48c12ff for ; Fri, 14 Feb 2020 06:08:45 -0500 (EST) Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTP id f199f360 for ; Fri, 14 Feb 2020 11:06:39 +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=JHhMk/UZrns5OmuOuR427zY8B9Y=; b=QksiJj MQ4wT2BLDI0oCWm8DeZadfMKTU/Kd3/vHpiXU5eYUrMxRmo/HqucRF0YrWOUy3yB go72wvoShDzGBdWkkcOPbiOE+lFzNQ20xPnUUo6nxFOxEoG6bElcexbe2rc+JO2f 6GRphh70C3R5ynGKWeFUeTEMm4ka3rD6i61nsIOJ8eiOjAnmfurAEctW8237xtq2 LF7ujU72TH5r90AqGXBqeRQ0EX5Z+qpkcO2n8ZaGgCsOybwNj3yiCGVqV3L1OmOh g/dQRuvl7It/1nvp3NP9xJ+VzEZhUr3xjr9UKAh2ssZ8ADKQ/cjzLPiSJGGZKc9J 9ua9VsmrZCTFeNrQ== Received: by frisell.zx2c4.com (ZX2C4 Mail Server) with ESMTPSA id a7f20f9e (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for ; Fri, 14 Feb 2020 11:06:39 +0000 (UTC) Received: by mail-ot1-f49.google.com with SMTP id r16so8794482otd.2 for ; Fri, 14 Feb 2020 03:08:44 -0800 (PST) X-Gm-Message-State: APjAAAV0SnjsNFn4mnBhovCJJxrkAEwMWhdWfwJX4MgTC4Bwtyad6tSB O52osLdDpd8rJTcmPh3D6svscPF+EYplkr9XMQs= X-Google-Smtp-Source: APXvYqzCoWl8SH/bhgAbEr9TH/1OnXElQ7I9A3fX9u1+3O51OLEctHaE9Ao4CiONuGnrMDf2zc+9qMfbUQt/mx+5c3g= X-Received: by 2002:a9d:674f:: with SMTP id w15mr1801678otm.243.1581678524314; Fri, 14 Feb 2020 03:08:44 -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> <26710-1581652819.729791@VYCU.Vgnw.Vr5M> In-Reply-To: <26710-1581652819.729791@VYCU.Vgnw.Vr5M> From: "Jason A. Donenfeld" Date: Fri, 14 Feb 2020 12:08:32 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH] Fix formatting in wg-quick(8) To: "Anthony J. Bentley" Cc: discuss@mandoc.bsd.lv, Stephen Gregoratto Content-Type: text/plain; charset="UTF-8" Hey Anthony, Thanks for doing this. Looks like a step in the right direction. A quick look indicates some weird changes, though: - The ... in the command summary is now underlined and inside the [ ], which seems different from other man pages on my machine. - You got rid of the specifically bolded lines in some of the wg-quick examples. As stated elsewhere in this thread, those are intentional. - One of the wg-quick examples doesn't have a trailing new line, making it look awkward with the next paragraph. - You now put quotes around referenced commands instead of underlines. Is that normal? - IP addresses are now quoted instead of underlined. Is that normal? It certainly sticks out less. - You got rid of the for sub command arguments. Is that correct? Other commands seem to use the . - The indented example commands are no longer "blue", which seems odd. - While some things are now quoted that were previously underlined, other things that were emboldened are now quoted. What's up here? Did you change any wording at all? It's quite important to me that the actual words don't change at all without an explicit patch for that so it can be reviewed. In other words, I don't want wording changes sneaking in with the typesetting rewrite. Again, thanks a lot for working on this. I really appreciate it. Jason -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv