From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f65.google.com (mail-pj1-f65.google.com [209.85.216.65]) by mandoc.bsd.lv (OpenSMTPD) with ESMTP id 0dc8f968 for ; Fri, 14 Feb 2020 17:36:42 -0500 (EST) Received: by mail-pj1-f65.google.com with SMTP id fa20so4442658pjb.1 for ; Fri, 14 Feb 2020 14:36:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=anjbe-name.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:in-reply-to:references:comments:mime-version :content-id:date:message-id; bh=MwNRHzHY0QLU34qWuf3DduFiBhuIJ/SeyBIehLxJ/kI=; b=Myi1dGzXd3nwUE+H/m6fw6T47iQbQKatONv02Q48b4djRTvUt25n/wy895QfQ1jzpQ QwSCy1qcc1hWvJndtoQ+SD13gMCSTR15zHwUT+wAGvLP7NShPYKFxDke2a2NctD8tNuN QC09v/v/jNfLGmSnLOdOKiyHr+Q38Tkb6AZZ/2qA35/d5482XFI5IvQfsV9hZzh7Ygc0 0OnG507OScHlSrhsSHqMCkUK5yfndff4Yx5IdlGTX6sGS80LKtGAYKCGJ68cjVyFVHoS rTd1tx1wkwpzVE0c9d3Uo/gMhovP2DVomLcjTCuPJoDU4re7znKJzCGO1gvn5I6Pw6P3 /E+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references :comments:mime-version:content-id:date:message-id; bh=MwNRHzHY0QLU34qWuf3DduFiBhuIJ/SeyBIehLxJ/kI=; b=ARacOcmTOSmJNzYoahOyRQDy4ibdrDWuOX8HAuCzLBKCDHI+uC2/xTuJwHV9RqWM6e 3y96hCJbj/NipNF3mPb1FDwXDZe7AfBeNTOjthRfxcHj3KuG9eyudDg3JkJECMa2Xfr1 tVL9aMA7bMP6pLZYIuctmUp/bX6g3JWX8Zekr1PZiY+rBFJzVvPylvgZ/CzvrHtwhcqE EyfywuleBsBIQR8tkM5T52Mnzo6pOsjqbJfkv/t8UOa1cX8Mi0jrBXb48QH6dGLdup22 B1smV8kcl8PPBC7hoMw+zLr0ERofvaYlI+Sk40oPhRy1/RoGDM/JPcYwAszcnSkx/Njj +jDA== X-Gm-Message-State: APjAAAXO7pe7Yhh0HRvh9g4ULfrd3M6ZxlH4nO4aTUEdlf+74VVpDY8g BpP+P5zczm/buw4kJXaAFC/ZqA== X-Google-Smtp-Source: APXvYqw/6s14nxPpDNq0g2yQ7/XuxImtMwFVWjyzQaIx2kC1Ja4cU3mnYiAiWGA/7cLVYjeWIBZcSA== X-Received: by 2002:a17:902:9a8f:: with SMTP id w15mr5713163plp.30.1581719800340; Fri, 14 Feb 2020 14:36:40 -0800 (PST) Received: from desktop.ajb.soy (174-28-243-81.albq.qwest.net. [174.28.243.81]) by smtp.gmail.com with ESMTPSA id b5sm8102330pfb.179.2020.02.14.14.36.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 14 Feb 2020 14:36:39 -0800 (PST) Received: from desktop.ajb.soy (localhost [127.0.0.1]) by desktop.ajb.soy (OpenSMTPD) with ESMTP id eb648ffa; Fri, 14 Feb 2020 15:36:38 -0700 (MST) From: "Anthony J. Bentley" To: "Jason A. Donenfeld" cc: discuss@mandoc.bsd.lv, Stephen Gregoratto Subject: Re: [PATCH] Fix formatting in wg-quick(8) In-reply-to: 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> Comments: In-reply-to "Jason A. Donenfeld" message dated "Fri, 14 Feb 2020 12:08:32 +0100." X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <91500.1581719798.1@desktop.ajb.soy> Date: Fri, 14 Feb 2020 15:36:38 -0700 Message-ID: <10339-1581719798.184667@sTB8.3w_H.FchF> Hi Jason, Forgive brevity, I have no computer this weekend. Jason A. Donenfeld writes: > - You got rid of the specifically bolded lines in som > e of the wg-quick > examples. As stated elsewhere in this thread, those a > re intentional. Sorry, I overlooked that. > - One of the wg-quick examples doesn't have a trailin > g new line, > making it look awkward with the next paragraph. Mistake, I think Ingo corrected it. > - The ... in the command summary is now underlined an > d inside the [ ], > which seems different from other man pages on my mach > ine. > - You now put quotes around referenced commands inste > ad 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 argume > nts. 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 previous > ly underlined, > other things that were emboldened are now quoted. Wha > t's up here? These formatting changes more or less come with the mdoc semantic markup. This is consistent with BSD man page style. There are some conflicts with the non-mdoc way of doing things perhaps. In general I think the semantics are worth it (especially with mandoc's searching, tagging, HTML generation capabilities). > Did you change any wording at all? It's quite importa > nt 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 word > ing changes > sneaking in with the typesetting rewrite. Except where I introduced semantic markup, I tried to keep things the same. It's possible there's a place or two where I changed something without thinking. But I tried to avoid it. > Again, thanks a lot for working on this. I really app > reciate it. Side note... last time I poked at WireGuard manpages, it resulted in this commit: https://github.com/openbsd/src/commit/df9a9479ddee899e1995f8eba1983628deecbec6 -- Anthony J. Bentley -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv