Date: Thu, 21 Apr 2016 13:12:22 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48696 - head/en_US.ISO8859-1/books/porters-handbook/uses Message-ID: <201604211312.u3LDCMmE082585@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Thu Apr 21 13:12:22 2016 New Revision: 48696 URL: https://svnweb.freebsd.org/changeset/doc/48696 Log: Improve USES=shebangfix's documentation. Reviewed by: wblock Sponsored by: Absolight Differential Revision: https://reviews.freebsd.org/D5949 Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Thu Apr 21 09:36:38 2016 (r48695) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Thu Apr 21 13:12:22 2016 (r48696) @@ -1167,16 +1167,51 @@ SHEBANG_FILES= scripts/foobar.pl scripts <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> - - <programlisting>SHEBANG_LANG= lua -lua_OLD_CMD= /usr/bin/lua -lua_CMD= ${LOCALBASE}/bin/lua</programlisting> + and <application>Tk</application> are supported by + default.</para> + + <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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201604211312.u3LDCMmE082585>