From nobody Fri Apr 08 09:04:00 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 66E871A8D232; Fri, 8 Apr 2022 09:04:01 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (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 "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KZXNw3Wztz4T5s; Fri, 8 Apr 2022 09:04:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649408640; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=I0LR9lOHpwnc6cvCgLbTuKcZ2Fy0uXykFLtSYIWkGNk=; b=OwCpvDXlzaBc244XSk2tqKPhxjn7wSAcfzCn1OPX/z41IzmGf3AEEyJzH+tQiLCQGOi8ra nnt0RlNgAlErV0otb4ds63IMZZaKT8Hrq1oX0kXbuJvMgxaCJZb7eCkxX7ya/EEkMMRZj5 8u+6LrwgO+YVaZqdwZKVpIHKMs71Uo+I9J7izoqwIhS5etP1qVuhAFm6sgz8wbVETkeEZj lRBGnrcSEmUO5vLgOPWS0PBT8mfDwjBM+lPDxhYEv3BpD6CgPcku6ffJ9N2RWIs2vx7LH9 y1LammQpnq4bk9hkUisi8aZS+X0jROvdR4BcWSKa89hdDQJPQZjh+sWy4lWNmQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 29F1C22029; Fri, 8 Apr 2022 09:04:00 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 238940ao015345; Fri, 8 Apr 2022 09:04:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 238940m6015344; Fri, 8 Apr 2022 09:04:00 GMT (envelope-from git) Date: Fri, 8 Apr 2022 09:04:00 GMT Message-Id: <202204080904.238940m6015344@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 210c02a2ce63 - stable/13 - pw.8: Improve use of mdoc macros in description section List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: 210c02a2ce63b7541e0a4e75853932e9de33b299 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649408640; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=I0LR9lOHpwnc6cvCgLbTuKcZ2Fy0uXykFLtSYIWkGNk=; b=OU409WQroqhaoVsabXZoCVhP9MvBP1suu4tD27k3nIH5v6ZJkWAgxe72TlchuXMcGJEBXG 2m9WdhdL7wg/uor7tOTohuMa5gCKFmJLsMV2Gb9T3Qhuz7WwlAG+4ch0yRGhGeoByPVF03 l4bJkQ4oaIYDbQs0U34vkiHWpp057sABFHa2bkgVBy4uKgz6HMYUp5wpu/kjOdHVa7sjVw HNECywAOSzGpkyoZZ+yeEP4UOgvNB3toBTF4ch8faSc18j8cclIB5HUJzHAkk9Gqa0ZxxE WHE84LuW+Fd5ekC2CWjIw62LKr55EvW19YvRtR3HxB36IZXVCwmkW5VD6t8ifg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649408640; a=rsa-sha256; cv=none; b=pwjYTJj0QH8S/9Hw5LAexvs6CjkR6DO7okZ2oFpx0/WxNgmCcXdXfv10ALuPHBQcqC6+/l GmiMYA43ZutKGpyZBuYxVIFx00NnPNNGU0nTHvFLDSGh4HNZiXyePaXzhcNWiAHBoKANTQ Tg/3sHINOBVy6662IMjpc6gLMQWsdjK6eq9/H+uIfOaAv2kuDt/jLcLWGzWeVhJtS2Ktmd +FS+YJXrpC5CgkKocIFpqWEqwbR5cqInatOvwGOFILB6aS/Q5Eo0RNlhGTPMs0Enizxo6t Nw+jcylMlBkawdq/WPvBixDhO4KsOMGF/l2J5YQy3yGPC+CKxTjlCUzeLI557Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=210c02a2ce63b7541e0a4e75853932e9de33b299 commit 210c02a2ce63b7541e0a4e75853932e9de33b299 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-04-01 10:58:52 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-08 09:03:23 +0000 pw.8: Improve use of mdoc macros in description section MFC after: 1 week (cherry picked from commit 61e11ed9bd183aacc684b56d96177a194053f622) --- usr.sbin/pw/pw.8 | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8 index 721b4fbdb209..f7b6a8a4830b 100644 --- a/usr.sbin/pw/pw.8 +++ b/usr.sbin/pw/pw.8 @@ -202,9 +202,9 @@ server. The .Nm utility handles updating the -.Pa passwd , -.Pa master.passwd , -.Pa group +.Xr passwd 5 , +.Xr master.passwd 5 , +.Xr group 5 and the secure and insecure password database files, and must be run as root. .Pp @@ -212,23 +212,23 @@ The first one or two keywords provided to .Nm on the command line provide the context for the remainder of the arguments. The keywords -.Ar user +.Cm user and -.Ar group +.Cm group may be combined with -.Ar add , -.Ar del , -.Ar mod , -.Ar show , +.Cm add , +.Cm del , +.Cm mod , +.Cm show , or -.Ar next +.Cm next in any order. (For example, -.Ar showuser , -.Ar usershow , -.Ar show user , +.Cm showuser , +.Cm usershow , +.Cm show user , and -.Ar user show +.Cm user show all mean the same thing.) This flexibility is useful for interactive scripts calling .Nm @@ -255,7 +255,9 @@ Can be used to maintain a user/group database in an alternate location. If this switch is specified, the system .Pa /etc/pw.conf will not be sourced for default configuration data, -but the file pw.conf in the specified directory will be used instead +but the file +.Pa pw.conf +in the specified directory will be used instead .Pq or none, if it does not exist . The .Fl C @@ -286,9 +288,9 @@ is preferable to interpret status codes returned by rather than messing up a carefully formatted display. .It Fl N This option is available in -.Ar add +.Cm add and -.Ar modify +.Cm modify operations, and tells .Nm to output the result of the operation without updating the user or group