From nobody Fri Apr 1 22:52:04 2022 X-Original-To: dev-commits-src-main@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 7AE8C1A524E8; Fri, 1 Apr 2022 22:52:05 +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 4KVb5d0gWnz4hZ0; Fri, 1 Apr 2022 22:52:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648853525; 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=nmQUoblwjUxGTjGfQUSaHbIM7s0r0cdB4OL/W+piHfg=; b=lcW/qyi0kS0DRsbMzkl1WhUd7XQoiv9ODK8Vq5s0qp7QOu2oKdbA/MSzLm0HpL/2Jjkmmu FyhmeyIegLOMfWEO5ClcMwi49dUcObtz+SokuQLBrkOjCwRO8JIFIMIRM1F82nVTRexDt3 6ibk9MKxWkmjhEQPMbQH34naHv3lk4cbCdxXIl7/ONE8111tkKqpdKJwLurKCESp9lutV6 C15HOeXmTK5rBGzTDkPMsjldcRa81E4QlcIhSMyPDKMe2WyDnK8+q2794MxAJwEfRC1oET jpSmwqskuoWyWn250vEoDSPg5FtOGUFlYT3M4q54FA1eVgs8B4caEoRvE2whEg== 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 C207E1D1E0; Fri, 1 Apr 2022 22:52:04 +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 231Mq4Tr094980; Fri, 1 Apr 2022 22:52:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 231Mq4Ch094979; Fri, 1 Apr 2022 22:52:04 GMT (envelope-from git) Date: Fri, 1 Apr 2022 22:52:04 GMT Message-Id: <202204012252.231Mq4Ch094979@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 61e11ed9bd18 - main - pw.8: Improve use of mdoc macros in description section List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@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/main X-Git-Reftype: branch X-Git-Commit: 61e11ed9bd183aacc684b56d96177a194053f622 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1648853525; 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=nmQUoblwjUxGTjGfQUSaHbIM7s0r0cdB4OL/W+piHfg=; b=WFRvZbVQafUOdbSJxpWQ94O5FMSzKExg367YgBv1G7aM+uf+GymUJbt+h39E39tUWISt0g fK3e+SZVngqIVXkjHHoTyDtayaguZUJpahTESAlFlSzDyC0ELUBaocVj4kuZJ5We1lNtZh 9V85r0XEgHN/09QGPY7609odpQmrUJMZOCWI5TvSJgGZPcJmdKcvYVkEbHDMkpufmqMagQ 8FKoVnMg6tl1rtfQE6u3Bq6w6N061L7kId4eDPTkJIY6cDZevwYHg9NV9GHiJzRTHdjyLW Qt34R3Qq322Kcp3wM12Jfbsn98RMfxSrLOxVd67xhGsT1FoTeQ7mmqa3NNgg7g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1648853525; a=rsa-sha256; cv=none; b=Vu5fOEDxA40IoGAVLwTFxUDd73w7H7YMLGKlK0ZnmKI9LC3jJSx5PvNG2qrMsu1Ykjuvkv NxvI9g4Xt9BMlh/on1nap0Ez5BuAXUI4y5FcHdctRZkKQ+Mn8/NBpiP5vJ/2oSeVuFHg9S njTYV3cQsUby0b3+e+a/38hPDSg8DOSWCkMSZDnZoXtofteb5VZzVpZal2BELtuFXzn8lh b6Aw6EsSyXtvIkdsOTvN9O8q/9+WgmaT2VGMNd33SeJ/6oCtemD837p97o9Z0BU2n97jxu s/8Z40hrPasSa/Ma2TBDIBYqpZP0Qeq6ilAVqEpc2eFD/CSm3wirF1b4vABN/A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=61e11ed9bd183aacc684b56d96177a194053f622 commit 61e11ed9bd183aacc684b56d96177a194053f622 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-04-01 10:58:52 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-01 22:49:52 +0000 pw.8: Improve use of mdoc macros in description section MFC after: 1 week --- 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