From nobody Fri Apr 08 09:03:51 2022 X-Original-To: dev-commits-src-branches@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 A46391A8CB2D; Fri, 8 Apr 2022 09:03:52 +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 4KZXNm2MHfz4TDC; Fri, 8 Apr 2022 09:03:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649408632; 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=AFeukeVZnH04upBHErtZTcOaL+XWlC4bzOTHpdkSg0Q=; b=p8tnBGGVGcSM2GbOIkzhzwtc0svMx6wmoEpC0XX7vkUN5bMllovLXOUbyvSlGsKvs6kot2 FKawOZjdutV5o0psw3Ga2mF5xGLMI9Rd2nwiX7EcFNG4U2yvxqMYZsQu5djVyiU2rEKa12 XkOfA9rxqc+5mlzFZzGz0ZrT5IUObt32dGC46ndD9aL1JtH9FzHsC5HPnYhxGNkj04m4pE dTIqGfKbarxvXh4tnL9s+SJk39zPaMzRZohmUfSZILwB+3UgKJqjL7ecofrR83R4ERlRHT 82Ek0xdS1tUi48IKo7MJA0/rPi9bYV7+qfpT6yHl8U6Xe6WsVQ3uTTKhpeg1/g== 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 1E97821C5F; Fri, 8 Apr 2022 09:03:52 +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 23893p22015126; Fri, 8 Apr 2022 09:03:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23893pNN015125; Fri, 8 Apr 2022 09:03:51 GMT (envelope-from git) Date: Fri, 8 Apr 2022 09:03:51 GMT Message-Id: <202204080903.23893pNN015125@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: ad4aa53b46e2 - stable/12 - pw.8: Improve use of mdoc macros in description section List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/12 X-Git-Reftype: branch X-Git-Commit: ad4aa53b46e22789c4abf7ee7475c20efe7509cb Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1649408632; 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=AFeukeVZnH04upBHErtZTcOaL+XWlC4bzOTHpdkSg0Q=; b=MSmOz2gZ5gyexMOssRoHvJEVKH6zs6oayFIoPHwObIrPJ5aOLHs9O7ct8EwuRbqxqRJnby kVUcZzLfDnclVkyuHlOT79TS2spdVG91VkNpdomY5H6XNCVm77GX9jXl+KDiJLItaQkQKj CghGE1y3NMtCyI9HH3fNB3obzvJR9DRsmFlJzx0c0dSyxFdtuQWac4KwWOvqbZ3v/wrjle MQzCeTv53pXIj/6OWqgp3ZeYNdvAqkmpEfdy5Va8dblCbEiqn/2k6wy+PaXFTAt+wfKr7E qEORCEJ2gpJc18bR/7lTfBwipz32SdYcwSKCq6rx94JZLjDQ8cj7cyKJBdUZFA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1649408632; a=rsa-sha256; cv=none; b=bNg76w84ft/h2gJEO0so0Vax3JMakUMtsWkKvtQI55/wgWRCK0q6/jOxtpILzco38ECnEK XgUhXT5sfgpSmkL7huZMSVd5XSqmk4hsp0GN0vbQF+3NfBjwPUNt43OuORQRESeUkEtSWW n2Q0b3vuYfvyncnQQQEgRDiMDwarQPIweQXNLqKPLxFfj/cA6rFFPENkOkgPraaEQuJyJw XOf8NcYi+knLuLXftHgR8d00zgTECmEeY/sRGMddKRFkgJdq8xihLAD8tC4/d4ydwngZFs v23k/7HXP4COTrCTFyXhyXxyeBtGv/wDEKs4qec6T3kj05NYqskqJF/A8NHx3A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=ad4aa53b46e22789c4abf7ee7475c20efe7509cb commit ad4aa53b46e22789c4abf7ee7475c20efe7509cb Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-04-01 10:58:52 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-04-08 08:59:33 +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