Changeset 147608 for trunk/doc-new


Ignore:
Timestamp:
Apr 9, 2016, 7:29:21 PM (3 years ago)
Author:
cal@…
Message:

guide: 'file' is not a Tcl extension, #51104

Clear up the confusion that 'file' is a MacPorts-provided Tcl extension (which
it isn't) and add some descriptions to the file functions.

Closes: #51104

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-tcl.xml

    r144444 r147608  
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    44<section id="reference.tcl-extensions">
    5   <title>Tcl Extensions</title>
     5  <title>Tcl Extensions &amp; Useful Tcl Commands</title>
    66
    77  <para>A MacPorts Portfile is a Tcl script, so it may contain any arbitrary
     
    99  url="http://tmml.sourceforge.net/doc/tcl/">Tcl reference manual</ulink>.
    1010  However, few authors will use arbitrary Tcl code; the vast majority will use
    11   Tcl extensions that are coded within MacPorts for performing the most common
    12   tasks needed for Portfiles. The list below is a list of Tcl extensions
    13   provided by MacPorts base.</para>
     11  a subset of Tcl commands and a number of Tcl extensions that are coded within
     12  MacPorts for performing the most common tasks needed for Portfiles. The list
     13  below is a list of useful Tcl commands for Portfile development and Tcl
     14  extensions provided by MacPorts base.</para>
    1415
    1516  <variablelist>
     
    1819
    1920      <listitem>
    20         <para>Description.</para>
     21        <para>The standard Tcl <command>file</command> command can be used for
     22          a number of operations on files, such as moving, renaming, deleting,
     23          or creating directories, among others. For a complete list, consult
     24          the <ulink url="http://tmml.sourceforge.net/doc/tcl/file.html">Tcl
     25            reference manual for the <command>file</command> command</ulink>,
     26          or the Tcl file manpage in the <option>n</option> section of manpages
     27          on your machine using <command>man n file</command></para>
    2128
    2229        <variablelist>
     
    2532
    2633            <listitem>
    27               <para></para>
     34              <para>Copy a file.</para>
    2835            </listitem>
    2936          </varlistentry>
     
    3542
    3643            <listitem>
    37               <para></para>
     44              <para>Rename a file.</para>
    3845            </listitem>
    3946          </varlistentry>
     
    4552
    4653            <listitem>
    47               <para></para>
     54              <para>Remove a file or (with <option>-force</option>) a directory
     55                and its contents.</para>
    4856            </listitem>
    4957          </varlistentry>
     
    5563
    5664            <listitem>
    57               <para></para>
     65              <para>Create a directory.</para>
    5866            </listitem>
    5967          </varlistentry>
     
    6674
    6775      <listitem>
    68         <para>Description.</para>
     76        <para>For the above operations provided by Tcl's
     77          <command>file</command> command, MacPorts provides the following
     78          shorthands. These used to be separate functions to work around bugs
     79          in older Tcl versions or on old versions of OS X. Nowadays those are
     80          simple aliases.</para>
    6981
    7082        <variablelist>
     
    92104            <listitem>
    93105              <para>Deletes each of the given files/directories. Behaves
    94               similarly to file delete -force except that file delete -force
    95               will fail to delete directories properly on 10.3 systems.</para>
     106                similarly to file delete -force except that file delete -force
     107                will fail to delete directories properly on 10.3
     108                systems.</para>
    96109            </listitem>
    97110          </varlistentry>
Note: See TracChangeset for help on using the changeset viewer.