From nobody Thu Nov 27 20:50:21 2025 X-Original-To: dev-commits-doc-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 4dHT8Z2mKfz6J61d for ; Thu, 27 Nov 2025 20:50:22 +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 "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dHT8Z03Chz3ZJ2 for ; Thu, 27 Nov 2025 20:50:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764276622; 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=m+YOMt7N1Zcylh3G6B4+X2222r+E4AKmQPTQcy+/8kI=; b=UGNHfC7pAMcoukwF12oTqFaURiC6fRZUcQcsc+luJc69EZeZ2sa9/H4uYohSeuK2fXhStJ i1lDp0KGfBXUwf3xeL1BI9JvouhPK+UOocsDpxBq7xRgMk1ALM+Qv8HVp10A+7vQMfvIxo PoqO5vZU3tP6WqOUCQG5lE951B0F2f0Y1QUEWdwZTlma3lwgpvrD9lq++V6BfB6ps46jqo 5UYSxQT3TAhyhp8P5IyM8/s9Tp0aje4ZgK85aXxCVpIOddnd/dmrvkZeGmmukEM+SHeZ5Q xvE9Fh2OfJHbAvoZImxnZ1B74/WaRJNmEbhnfiuDr+bbxEqAN8HucqyFrPPm9Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1764276622; 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=m+YOMt7N1Zcylh3G6B4+X2222r+E4AKmQPTQcy+/8kI=; b=eh2hj7DxtcmWLyOEn6hWsPNmDXEHNP70Dfj9w5M8MgxpxCpko0qTtMwMiK4/J/oxFxpi3I YJLfwPWKOO2b5sZtOXawvAk6yLzciZf1siZog+5RLP+r3YAJDAJQ1ZbvrWRx3Ts2IOxHEM fZT0UydYDC8HxvumlODx5U3tdEyyhk2x7JPqpY7P+XbPgHm4Cq3qssu94VHABfQk0eVONx gg81OntyxpjwR82Z59QecQaVaghelQ7d/V1PyqZUzLzJwQrtabph2GW88wYM8u+TT3SCnf cUyrz+30cYNi13BuMI5bQd3KK/XHBnX18Qpnnw4CSokgAcGO3XTSCT+iK3fxvA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1764276622; a=rsa-sha256; cv=none; b=G/5vdbMi+J9iGFUGSgnM3eSA/bw4cb9hsq1M3CU9oy2kjWrPY+6/E/fCbxh3l04Qqq+VoJ CWdnJEyEGGYbrGHxu9+nr59J2Y+e1cVYfgSDs5nwUeiJsORf01eyhdq4YnXNfAc9KcXBI0 mIkGmTvcpgQB/VfvXayDGz67R9t6iq1E54yrVgxTvbI3bZJTHw5bfjzZAygv93lBzCfWc+ TvA8FWTiD18EN+jzl4xwnxFdiSikmFpjaduGerr9kLF9+LFio1XEjsp/tsMEGd8XYjocLk PORjCT3otnPHjHw25fPGg33RQXuRrQ0t38jeTfV7+7vRSIjE+V5ayv4I8Hn4jw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dHT8Y683dzYCY for ; Thu, 27 Nov 2025 20:50:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2be62 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 27 Nov 2025 20:50:21 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Olivier Certner Subject: git: 3fdee92b8c - main - releases/15.0R/relnotes: ps(1): Fix wording style of paragraphs' start List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: olce X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3fdee92b8c2df4beb3501a19a028a666545c66cd Auto-Submitted: auto-generated Date: Thu, 27 Nov 2025 20:50:21 +0000 Message-Id: <6928b98d.2be62.44f2864a@gitrepo.freebsd.org> The branch main has been updated by olce: URL: https://cgit.FreeBSD.org/doc/commit/?id=3fdee92b8c2df4beb3501a19a028a666545c66cd commit 3fdee92b8c2df4beb3501a19a028a666545c66cd Author: Olivier Certner AuthorDate: 2025-11-27 20:45:36 +0000 Commit: Olivier Certner CommitDate: 2025-11-27 20:45:36 +0000 releases/15.0R/relnotes: ps(1): Fix wording style of paragraphs' start Previous style was arguably quite telegraphic and more similar to a commit's first line. Replace header sentences with true sentences, as is done elsewhere. Sponsored by: The FreeBSD Foundation --- website/content/en/releases/15.0R/relnotes.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/website/content/en/releases/15.0R/relnotes.adoc b/website/content/en/releases/15.0R/relnotes.adoc index 7d08bf011c..348b710a4f 100644 --- a/website/content/en/releases/15.0R/relnotes.adoc +++ b/website/content/en/releases/15.0R/relnotes.adoc @@ -414,20 +414,20 @@ gitref:7b9a772f9f64[repository=src] An option has been added to change the directory in man:env[1] which closely resembles the feature in the GNU version of env, although it does not support long options. gitref:08e8554c4a39[repository=src] (Sponsored by Klara, Inc.) -man:ps[1]: Automatically remove canned displays' columns that contain same data as those of some explicitly-requested columns. +man:ps[1] now automatically removes canned displays' columns that contain same data as some explicitly-requested columns. Before this change, if some user requested to add some "canned display" (options `-j`, `-l`, `-u` or `-v`), columns in it that were duplicates of explicitly-requested ones earlier on the command line were omitted, but this did not work the other way around, when a canned display appears before explicitly-requested columns. Additionally, columns with different keywords but which are aliases to the same keyword are now also considered holding the same data, in addition to columns having the same keyword. gitref:cd768a840644[repository=src] (Sponsored by The FreeBSD Foundation.) -man:ps[1]: Make `-O` more versatile and predictable. +man:ps[1]'s `-O` option is now more versatile and predictable. The man:ps[1] display's list of columns is now first built without taking into account the `-O` options. In a second step, all columns passed via `-O` are finally inserted after the built-so-far display's first PID column (if it exists, else at start), in their order of appearance as arguments to the `-O` options. gitref:5dad61d9b949[repository=src] (Sponsored by The FreeBSD Foundation.) -man:ps[1]: Make `-a` and `-A` always show all processes. +man:ps[1]'s `-a` and `-A` options now always show all processes. When combined with other options affecting the selection of processes, except for `-X` and `-x`, option `-a` would have no effect (and `-A` would reduce to just `-x`). This was in contradiction with the rule applying to all other selection options stating that one process is listed as soon as any of these options has been specified and selects it, which is both mandated by POSIX and arguably a natural expectation. As a practical consequence, specifying `-a` or `-A` now causes all processes to be listed regardless of other selection options such as `-U`, `-p`, `-G`, etc., except for the `-X` and `-x` filter options, which continue to apply. @@ -436,13 +436,13 @@ Option `-J`, contrary to its apparent initial intent, never worked as a filter i gitref:93a94ce731a8[repository=src] (Sponsored by The FreeBSD Foundation.) -man:ps[1]: Match current user's processes using the effective user ID. +man:ps[1] now matches current user's processes using the effective user ID. Previously, we would match using the real user ID. This puts man:ps[1] in conformance with POSIX on that topic. gitref:1aabbb25c9f9c4372[repository=src] (Sponsored by The FreeBSD Foundation.) -man:ps[1]: Fix `-U` flag to select processes by real user IDs. +man:ps[1]'s `-U` flag now selects processes by real user IDs. This is what POSIX mandates for option `-U` and arguably the behavior that most users actually need in most cases. Before, `-U` would select processes by their effective user IDs (which is the behavior mandated by POSIX for option `-u`). gitref:995b690d1398[repository=src] @@ -1003,9 +1003,9 @@ gitref:39f92a4c4c49[repository=src] Refer to man:graid[8] and man:zfs[8] instead of man:gvinum[8] in man:ccdconfig[8]). (gitref:55cb3a33d920[repository=src]). -man:ps[1]: Revamp: Explain general principles, update to match reality. +The man:ps[1] manual page has been revamped to explain the general principles, and descriptions in there have been updated to match reality. The preamble has been revamped to give a thorough overview of the different aspects of the man:ps[1] command. -The description of several options and some keywords have been fixed to match their actual behavior or expanded. +The description of several options and some keywords have been fixed to match their actual behavior and/or expanded. The STANDARDS and BUGS sections have been expanded. gitref:ddf144a04b53[repository=src] (Sponsored by The FreeBSD Foundation.)