[Bug 283080] manpage of linprocfs(5) differs from reality

From: <bugzilla-noreply_at_freebsd.org>
Date: Mon, 02 Dec 2024 12:04:11 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=283080

            Bug ID: 283080
           Summary: manpage of linprocfs(5) differs from reality
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: michaelo@FreeBSD.org
                CC: doc@FreeBSD.org

The manpage says:
FILES
     /compat/linux/proc/pid           A directory containing process
                                      information for process pid.
     /compat/linux/proc/self          A directory containing process
                                      information for the current process.

* There is no "pid" directory, the 'pid' term should be denoted as a
placeholder for the real PID.
* There is no "self" directory, "self" is a symlink to a PID directory

The manpage on RHEL 8 says:
       /proc/[pid]
              There is a numerical subdirectory for each running process; the
subdirectory is named by the process ID.

but as bad as:
       /proc/self
              This directory refers to the process accessing the /proc
filesystem, and is identical to the /proc directory named by the process ID of
the same process.

Both definitions confuse users.

-- 
You are receiving this mail because:
You are on the CC list for the bug.