[groff] 16/30: [doc,man]: Clarify `\V` behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit d47f7756067f6b535bfb69f2496d6c706db61019
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 21 18:02:33 2024 -0600

    [doc,man]: Clarify `\V` behavior.
    
    Take greater pains to distinguish the system environment from the
    formatter's environments.
---
 doc/groff.texi.in    | 10 +++++++---
 man/groff.7.man      | 19 +++++++++++++------
 man/groff_diff.7.man |  8 ++++++--
 3 files changed, 26 insertions(+), 11 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 81100bfa8..70ffb56e7 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16716,9 +16716,13 @@ Here a simple macro to write an index entry.
 @cindex @code{\V}, and copy mode
 @cindex copy mode, and @code{\V}
 @cindex mode, copy, and @code{\V}
-Interpolate the contents of the specified environment variable @var{env}
-(one-character name@tie{}@var{e}, two-character name @var{ev}) as
-returned by the function @cite{getenv@r{(3)}}.
+Interpolate the contents of the system environment variable
+@var{env}
+(one-character
+name@tie{}@var{e},
+two-character
+name @var{ev})
+as returned by @cite{getenv@r{(3)}}.
 @cindex @code{\V}, interpretation in copy mode
 @code{\V} is interpreted even in copy mode (@pxref{Copy Mode}).
 @endDefesc
diff --git a/man/groff.7.man b/man/groff.7.man
index 84126f487..554366c4c 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5711,20 +5711,27 @@ Positive motion is downward.
 .
 .TP
 .ESC V e
-Interpolate contents of environment variable with one-character
-.RI name\~ e .
+Interpolate contents of system environment variable with one-character
+.RI name\~ e
+as returned by
+.MR getenv 3 .
 .
 .
 .TP
 .ESC V( ev
-Interpolate contents of environment variable with two-character
-.RI name\~ ev .
+Interpolate contents of system environment variable with two-character
+.RI name\~ ev
+as returned by
+.MR getenv 3 .
 .
 .
 .TP
 .ESC[] V env
-Interpolate contents of environment variable with arbitrarily long
-.RI name\~ env .
+Interpolate contents of system environment variable with arbitrarily
+long
+.RI name\~ env
+as returned by
+.MR getenv 3 .
 .
 .
 .TP
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index e0212368e..c3097350e 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1105,8 +1105,12 @@ scaled points.
 .BI \[rs]V( ev
 .TQ
 .BI \[rs]V[ env ]
-Interpolate contents of the environment variable
-.IR env ,
+Interpolate contents of the system environment variable
+.I env
+(one-character
+.RI name\~ e ,
+two-character
+.RI name\~ ev)
 as returned by
 .MR getenv 3 .
 .