Mention how env(1) can be used with the "#!" construct.

PR:		27690
Submitted by:	Mike Meyer <mwm@mired.org>

1 files changed, 19 insertions, 0 deletions

diff --git a/usr.bin/printenv/printenv.1 b/usr.bin/printenv/printenv.1
index a2912ef..4efcf04 100644
--- a/usr.bin/printenv/printenv.1
+++ b/usr.bin/printenv/printenv.1
@@ -101,6 +101,25 @@ If no command is specified,
 .Nm env
 prints out the names and values
 of the variables in the environment, with one name/value pair per line.
+.Pp
+.Nm env
+is sometimes useful with the
+.Qq #!
+construct (see
+.Xr execve 2 ) .
+The only difference between
+.Qq #!/usr/local/bin/foo
+and
+.Qq #!/usr/bin/env /usr/local/bin/foo
+is that the latter works even if
+.Pa /usr/local/bin/foo
+is itself interpreted.
+Using
+.Nm env
+this way also allows one to reference
+.Pa foo
+without the path,
+as well as set up the environment as desired.
 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr sh 1 ,