Re: proc.5: Still refers to "described in more detail below" for splitted out manpages

[Salvatore Bonaccorso <carnil@debian.org>]

[-- Attachment #1: Type: text/plain, Size: 978 bytes --]

Hi Alex,

On Fri, Apr 12, 2024 at 07:47:07PM +0200, Alejandro Colomar wrote:
> Hi Salvatore,
> 
> On Fri, Apr 12, 2024 at 07:21:11PM +0200, Salvatore Bonaccorso wrote:
> > Hi Alejandro
> > 
> > Back in August 2023, various parts were split out of proc(5) into
> > separate manpage. What seems to have remained from the split is the
> > mentioning:
> > 
> > [...]
> > 178 .P
> > 179 All of the above are described in more detail below.
> > [...]
> > 
> > I'm not sure what you would like to prefer, so I have no explict patch
> > here. But maybe this can be reworded to "All of the above are desribed
> > in sepate manpages prefixes with proc_"?
> 
> Thanks for catching this.  Yeah, something like that makes sense.
> 
> You could add to the commit message:
> 
> Fixes: 92cdcec79df0 ("proc.5: Clean up after making sashimi of this page")

Thanks for the quick feedback. So please find attached the proposed
change. Let me know if you want something changed.

Regards,
Salvatore

[-- Attachment #2: 0001-proc.5-Refer-to-split-out-manpages-for-detailed-desc.patch --]
[-- Type: text/x-diff, Size: 1222 bytes --]

From 07bf84cbb2e78595b4514fe820ae5574bba8d0ec Mon Sep 17 00:00:00 2001
From: Salvatore Bonaccorso <carnil@debian.org>
Date: Fri, 12 Apr 2024 20:29:06 +0200
Subject: [PATCH] proc.5: Refer to split out manpages for detailed description

Back in August 2023 various parts of proc(5) were split out int separate
manpages. The final cleanup in 92cdcec79df0 ("proc.5: Clean up after
making sashimi of this page") missed to as well refer to the split out
manpages and retained the wording that details are found further below
in the manpages for the various files.

Fixes: 92cdcec79df0 ("proc.5: Clean up after making sashimi of this page")
Signed-off-by: Salvatore Bonaccorso <carnil@debian.org>
---
 man5/proc.5 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index bdc47456bdce..4c20920e1e3c 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -176,7 +176,10 @@ Various other files and subdirectories under
 .I /proc
 expose system-wide information.
 .P
-All of the above are described in more detail below.
+All of the above are described in more detail in separate manpages
+prefixed with
+.BR proc_.
+.TP
 .\"
 .\" .SH FILES
 .\" FIXME Describe /proc/[pid]/sessionid
-- 
2.43.0