svn commit: r367756 - head/usr.bin/chpass

[Mateusz Piotrowski]

On 11/17/20 11:48 AM, Mateusz Piotrowski wrote:
> Author: 0mp (doc,ports committer)
> Date: Tue Nov 17 10:48:01 2020
> New Revision: 367756
> URL: https://svnweb.freebsd.org/changeset/base/367756
>
> Log:
>    Clean up the synopsis section & fix mandoc warnings
>    
>    The synopsis section had two very similar entries. The flags documented by
>    the first one were a strict subset of the second one. Let's just keep only
>    the second entry for simplicity.

Uh, I think I get it now. The simpler one was referring to the chpass, while one second one was 
documenting ypchpass (passwd(1) has a similar synopsis). I guess I'll bring back both entries and 
will use "Nm ypchpass" for the entry listing NIS-specific flags.

>    MFC after:	1 week
>
> Modified:
>    head/usr.bin/chpass/chpass.1
>
> Modified: head/usr.bin/chpass/chpass.1
> ==============================================================================
> --- head/usr.bin/chpass/chpass.1	Tue Nov 17 10:27:42 2020	(r367755)
> +++ head/usr.bin/chpass/chpass.1	Tue Nov 17 10:48:01 2020	(r367756)
> @@ -28,7 +28,7 @@
>   .\"     @(#)chpass.1	8.2 (Berkeley) 12/30/93
>   .\" $FreeBSD$
>   .\"
> -.Dd December 30, 1993
> +.Dd November 17, 2020
>   .Dt CHPASS 1
>   .Os
>   .Sh NAME
> @@ -41,19 +41,13 @@
>   .Nd add or change user database information
>   .Sh SYNOPSIS
>   .Nm
> +.Op Fl loy
>   .Op Fl a Ar list
> -.Op Fl p Ar encpass
> +.Op Fl d Ar domain
>   .Op Fl e Ar expiretime
> -.Op Fl s Ar newshell
> -.Op user
> -.Nm
> -.Op Fl oly
> -.Op Fl a Ar list
> +.Op Fl h Ar host
>   .Op Fl p Ar encpass
> -.Op Fl e Ar expiretime
>   .Op Fl s Ar newshell
> -.Op Fl d Ar domain
> -.Op Fl h Ar host
>   .Op user
>   .Sh DESCRIPTION
>   The
> @@ -216,7 +210,7 @@ Note that
>   .Xr finger 1
>   will display the office location and office phone together under the
>   heading
> -.Ar Office: .
> +.Ar Office\&: .
>   .Pp
>   The user's
>   .Ar home directory
> @@ -313,7 +307,7 @@ changing other fields could be added, this would lead
>   compatibility problems with other NIS-capable systems.
>   Even though the super-user may supply data for other fields
>   while editing an entry, the extra information (other than the
> -password -- see below) will be silently discarded.
> +password \(em see below) will be silently discarded.
>   .Pp
>   Exception: the super-user on the NIS master server is permitted to
>   change any field.