[38366] trunk/doc-new/guide/xml/portfile-tcl.xml

[simon at macports.org]

Revision: 38366
          http://trac.macosforge.org/projects/macports/changeset/38366
Author:   simon at macports.org
Date:     2008-07-17 09:12:46 -0700 (Thu, 17 Jul 2008)
Log Message:
-----------
doc-new: Updated description for Tcl extension "reinplace", closes #16005. Thanks to blb at macports.org.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-tcl.xml

Modified: trunk/doc-new/guide/xml/portfile-tcl.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-tcl.xml	2008-07-17 16:06:36 UTC (rev 38365)
+++ trunk/doc-new/guide/xml/portfile-tcl.xml	2008-07-17 16:12:46 UTC (rev 38366)
@@ -227,15 +227,32 @@
       <term>reinplace</term>
 
       <listitem>
-        <para>Description.</para>
+        <para>Allows text specified by a regular expression to be replaced
+        by new text, in-place (the file will be updated itself, no need to
+        place output into a new file and rename).</para>
 
+        <variablelist>
+          <varlistentry>
+            <term>reinplace [-E] [--] <replaceable>command</replaceable>
+            <replaceable>file ...</replaceable></term>
+            <listitem>
+              <para>Replace text given by the regular expression portion of
+              the command with the replacement text, in all files
+              specified.</para>
+              <para>Use -E to use the extended regular expression style (see
+              re_format(7) for a description of the basic and extended
+              styles)</para>
+              <para>Use -- to end option processing and allow any further
+              dashes not to be treated as options.</para>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+
         <para>Examples:</para>
 
-        <programlisting>example 1</programlisting>
+        <programlisting>reinplace "s|/usr/local|${prefix}|g" ${worksrcpath}/configure</programlisting>
 
-        <programlisting>example 2</programlisting>
-
-        <programlisting>example 3</programlisting>
+        <programlisting>reinplace "s|@@PREFIX@@|${prefix}|g" ${worksrcpath}/Makefile</programlisting>
       </listitem>
     </varlistentry>
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20080717/44642af3/attachment.html