git: 6a847b6d1ee8 - stable/13 - linux.4: clarify path translation

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Mon, 26 Aug 2024 13:23:06 UTC
The branch stable/13 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=6a847b6d1ee8ccf7e109d13bece2ad634672e6ff

commit 6a847b6d1ee8ccf7e109d13bece2ad634672e6ff
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2024-08-19 13:43:37 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2024-08-26 13:22:58 +0000

    linux.4: clarify path translation
    
    Try to be a little more explicit about the path translation mechanism
    accessing /compat/linux/<path> then falling back to /<path>.
    
    As suggested by martin@lispworks.com, refer to the compat path
    explicitly, and correct an existing grammaro.
    
    PR:             277804
    Reviewed by:    fernape
    Sponsored by:   The FreeBSD Foundation
    
    (cherry picked from commit f66e71fa78e16164339f7fd4791306fb30165581)
    (cherry picked from commit d1daec3d358eb5aaa38fa7c95fbfa330c46a69a1)
    (cherry picked from commit 226c733737383478f3c1d3f8c119207136c05de0)
---
 share/man/man4/linux.4 | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/share/man/man4/linux.4 b/share/man/man4/linux.4
index 0efc469985f9..0659651d6596 100644
--- a/share/man/man4/linux.4
+++ b/share/man/man4/linux.4
@@ -61,11 +61,13 @@ under
 .Pa /compat/linux )
 before
 .Pa / .
-For example, when Linux process attempts to open
+For example, when a Linux process attempts to open
 .Pa /etc/passwd ,
-it will really access
+it will first access
 .Pa /compat/linux/etc/passwd ,
-unless the latter does not exist.
+falling back to
+.Pa /etc/passwd
+if the compat path does not exist.
 This is used to make sure Linux processes load Linux shared libraries
 instead of their similarly-named FreeBSD counterparts, and also
 to provide alternative versions of certain other files and virtual