From owner-svn-src-all@freebsd.org  Thu Oct 15 14:47:38 2020
Return-Path: <owner-svn-src-all@freebsd.org>
Delivered-To: svn-src-all@mailman.nyi.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.nyi.freebsd.org (Postfix) with ESMTP id C1D9144088F;
 Thu, 15 Oct 2020 14:47:38 +0000 (UTC) (envelope-from gbe@freebsd.org)
Received: from smtp.freebsd.org (smtp.freebsd.org
 [IPv6:2610:1c1:1:606c::24b:4])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256
 client-signature RSA-PSS (4096 bits) client-digest SHA256)
 (Client CN "smtp.freebsd.org",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 4CBsZf4Wrnz4ZDK;
 Thu, 15 Oct 2020 14:47:38 +0000 (UTC) (envelope-from gbe@freebsd.org)
Received: from localhost (p4fd3a1f5.dip0.t-ipconnect.de [79.211.161.245])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate) (Authenticated sender: gbe)
 by smtp.freebsd.org (Postfix) with ESMTPSA id 3A9C62D20F;
 Thu, 15 Oct 2020 14:47:38 +0000 (UTC) (envelope-from gbe@freebsd.org)
Date: Thu, 15 Oct 2020 16:47:35 +0200
From: Gordon Bergling <gbe@freebsd.org>
To: Mateusz Piotrowski <0mp@freebsd.org>
Cc: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: Re: svn commit: r366725 - head/lib/geom/eli
Message-ID: <20201015144735.GA33346@lion.0xfce3.net>
References: <202010151417.09FEHjjq080474@repo.freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <202010151417.09FEHjjq080474@repo.freebsd.org>
X-Url: <https://www.gordons-perspective.com/>
X-Operating-System: FreeBSD 12.2-STABLE amd64
X-Host-Uptime: 4:34PM  up 22:26, 4 users, load averages: 0.38, 0.44, 0.48
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.33
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 15 Oct 2020 14:47:38 -0000

Hi Mateusz,

On Thu, Oct 15, 2020 at 02:17:45PM +0000, Mateusz Piotrowski wrote:
> Author: 0mp (doc,ports committer)
> Date: Thu Oct 15 14:17:45 2020
> New Revision: 366725
> URL: https://svnweb.freebsd.org/changeset/base/366725
> 
> Log:
>   Fix formatting of SYNOPSIS
>   
>   There was an unnecessary newline being added before Nm.
>   
>   MFC after:	3 days
> 
> Modified:
>   head/lib/geom/eli/geli.8
> 
> Modified: head/lib/geom/eli/geli.8
> ==============================================================================
> --- head/lib/geom/eli/geli.8	Thu Oct 15 13:47:52 2020	(r366724)
> +++ head/lib/geom/eli/geli.8	Thu Oct 15 14:17:45 2020	(r366725)
> @@ -24,7 +24,7 @@
>  .\"
>  .\" $FreeBSD$
>  .\"
> -.Dd July 22, 2020
> +.Dd October 15, 2020
>  .Dt GELI 8
>  .Os
>  .Sh NAME
> @@ -45,8 +45,7 @@ to your
>  geom_eli_load="YES"
>  .Ed
>  .Pp
> -Usage of the
> -.Nm
> +.No Usage of the Nm
>  utility:
>  .Pp
>  .Nm

The formatting of the SYNOPSIS was correct before this change. It's a common practice
in man pages to use

The
.Nm
utility
...

Your change is looking somewhat strange, since ".No Usage of the Nm" reads like the
man page would renders "Nm", since it is not used as macro.

A .Dd bump is also not necessary since no user visible changes were made to the man page.

-- Gordon