man/env.x

   1 '\" Copyright (C) 1998-2019 Free Software Foundation, Inc.
   2 '\"
   3 '\" This is free software.  You may redistribute copies of it under the terms
   4 '\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>.
   5 '\" There is NO WARRANTY, to the extent permitted by law.
   6 [NAME]
   7 env \- run a program in a modified environment
   8 [DESCRIPTION]
   9 .\" Add any additional description here
  10 [OPTIONS]
  11 .SS "\-S/\-\-split\-string usage in scripts"
  12 The
  13 .B \-S
  14 option allows specifying multiple parameters in a script.
  15 Running a script named
  16 .B 1.pl
  17 containing the following first line:
  18 .PP
  19 .RS
  20 .nf
  21 #!/usr/bin/env \-S perl \-w \-T
  22 \&...
  23 .fi
  24 .RE
  25 .PP
  26 Will execute
  27 .B "perl \-w \-T 1.pl".
  28 .PP
  29 Without the
  30 .B '\-S'
  31 parameter the script will likely fail with:
  32 .PP
  33 .RS
  34 .nf
  35 /usr/bin/env: 'perl \-w \-T': No such file or directory
  36 .fi
  37 .RE
  38 .PP
  39 See the full documentation for more details.