os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Improve USES=shebangfix's documentation.

Browse source 
Reviewed by:	wblock
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D5949
This commit is contained in:
Mathieu Arnold 2016-04-21 13:12:22 +00:00
parent 1a8e76550b
commit 62faa5940a
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=48696
1 changed files with 44 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

53
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
View file

@ -1167,16 +1167,51 @@ SHEBANG_FILES= scripts/foobar.pl scripts/*.sh</programlisting>
<application>Perl</application>, <application>PHP</application>,
<application>Python</application>,
<application>Ruby</application>, <application>Tcl</application>,
and <application>Tk</application> are supported by default. To
support another interpreter, set
<varname>SHEBANG_LANG</varname>,
<varname><replaceable>interp</replaceable>_OLD_CMD</varname> and
<varname><replaceable>interp</replaceable>_CMD</varname>. For
example:</para>
and <application>Tk</application> are supported by
default.</para>
<programlisting>SHEBANG_LANG= lua
lua_OLD_CMD= /usr/bin/lua
lua_CMD= ${LOCALBASE}/bin/lua</programlisting>
<para>There are three configuration variables:</para>
<variablelist>
<varlistentry>
<term><varname>SHEBANG_LANG</varname></term>
<listitem>
<para>The list of supported interpreters.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname><replaceable>interp</replaceable>_CMD</varname></term>
<listitem>
<para>The path to the command interpreter on &os;. The
default value is
<literal>${LOCALBASE}/bin/<replaceable>interp</replaceable></literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname><replaceable>interp</replaceable>_OLD_CMD</varname></term>
<listitem>
<para>The list of wrong invocations of interpreters. These
are typically obsolete paths, or paths used on other
operating systems that are incorrect on &os;. They
will be replaced by the correct path in
<varname><replaceable>interp</replaceable>_CMD</varname>.
This list will always be part of
<varname><replaceable>interp</replaceable>_OLD_CMD</varname>:
<literal>"/usr/bin/env <replaceable>interp</replaceable>"
/bin/<replaceable>interp</replaceable>
/usr/bin/<replaceable>interp</replaceable></literal>.</para>
</listitem>
</varlistentry>
</variablelist>
<para>To add another interpreter, set
<varname>SHEBANG_LANG</varname>. For example:</para>
<programlisting>SHEBANG_LANG= lua</programlisting>
<para><literal><replaceable>interp</replaceable>_OLD_CMD</literal>
will contain multiple values. Any entry with spaces must be