Changeset 27950


Ignore:
Timestamp:
Aug 16, 2007, 2:35:55 PM (13 years ago)
Author:
markd@…
Message:

Clean out redundant sections accidentally left in.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/guide/new/xml/portfileref.xml

    r27927 r27950  
    10251025            checked on every mirror. If the mirror subdirectory does not match
    10261026            ${name}, then you may specify it using after the mirror separated
    1027             by a colon. </para>
     1027            by a colon.</para>
    10281028
    10291029            <programlisting><userinput>master_sites   sourceforge:widget \
     
    13361336    <title>Tcl Extensions</title>
    13371337
    1338     <para>A MacPorts <filename>Portfile</filename> is a Tcl script, so it may
    1339     contain any arbitrary Tcl code you may learn about in a <ulink
     1338    <para>A MacPorts Portfile is a Tcl script, so it may contain any arbitrary
     1339    Tcl code you may learn about in a <ulink
    13401340    url="http://tmml.sourceforge.net/doc/tcl/">Tcl reference manual</ulink>.
    13411341    However, few authors will use arbitrary Tcl code; the vast majority will
     
    13441344    extensions provided by MacPorts base.</para>
    13451345
    1346     <section>
    1347       <title>file</title>
    1348 
    1349       <para></para>
    1350 
    1351       <para><variablelist>
    1352           <varlistentry>
    1353             <term>file</term>
    1354 
    1355             <listitem>
    1356               <para>Description.</para>
    1357 
    1358               <variablelist>
    1359                 <varlistentry>
    1360                   <term>file copy</term>
    1361 
    1362                   <listitem>
    1363                     <para></para>
    1364                   </listitem>
    1365                 </varlistentry>
    1366               </variablelist>
    1367 
    1368               <variablelist>
    1369                 <varlistentry>
    1370                   <term>file move</term>
    1371 
    1372                   <listitem>
    1373                     <para></para>
    1374                   </listitem>
    1375                 </varlistentry>
    1376               </variablelist>
    1377 
    1378               <variablelist>
    1379                 <varlistentry>
    1380                   <term>file rename</term>
    1381 
    1382                   <listitem>
    1383                     <para></para>
    1384                   </listitem>
    1385                 </varlistentry>
    1386               </variablelist>
    1387 
    1388               <variablelist>
    1389                 <varlistentry>
    1390                   <term>file delete [-force]</term>
    1391 
    1392                   <listitem>
    1393                     <para></para>
    1394                   </listitem>
    1395                 </varlistentry>
    1396               </variablelist>
    1397 
    1398               <variablelist>
    1399                 <varlistentry>
    1400                   <term>file mkdir</term>
    1401 
    1402                   <listitem>
    1403                     <para></para>
    1404                   </listitem>
    1405                 </varlistentry>
    1406               </variablelist>
    1407             </listitem>
    1408           </varlistentry>
    1409 
    1410           <varlistentry>
    1411             <term>macros</term>
    1412 
    1413             <listitem>
    1414               <para>Description.</para>
    1415 
    1416               <variablelist>
    1417                 <varlistentry>
    1418                   <term>copy</term>
    1419 
    1420                   <listitem>
    1421                     <para>Shorthand alternative to "file copy".</para>
    1422                   </listitem>
    1423                 </varlistentry>
    1424               </variablelist>
    1425 
    1426               <variablelist>
    1427                 <varlistentry>
    1428                   <term>move</term>
    1429 
    1430                   <listitem>
    1431                     <para>Shorthand alternative to "file rename".</para>
    1432                   </listitem>
    1433                 </varlistentry>
    1434 
    1435                 <varlistentry>
    1436                   <term>delete file ...</term>
    1437 
    1438                   <listitem>
    1439                     <para>Deletes each of the given files/directories. Behaves
    1440                     similarly to file delete -force except that file delete
    1441                     -force will fail to delete directories properly on 10.3
    1442                     systems.</para>
    1443                   </listitem>
    1444                 </varlistentry>
    1445 
    1446                 <varlistentry>
    1447                   <term>touch</term>
    1448 
    1449                   <listitem>
    1450                     <para>Mimicks the BSD touch command.</para>
    1451                   </listitem>
    1452                 </varlistentry>
    1453 
    1454                 <varlistentry>
    1455                   <term>ln</term>
    1456 
    1457                   <listitem>
    1458                     <para>Mimickes the BSD ln command.</para>
    1459                   </listitem>
    1460                 </varlistentry>
    1461               </variablelist>
    1462             </listitem>
    1463           </varlistentry>
    1464 
    1465           <varlistentry>
    1466             <term>xinstall</term>
    1467 
    1468             <listitem>
    1469               <para>xinstall copies files and creates directories; it is
    1470               intended to be compatible with install(1).</para>
    1471 
    1472               <variablelist>
    1473                 <varlistentry>
    1474                   <term>xinstall [-o owner] [-g group] [-m mode] [file1 file2
    1475                   ...] directory</term>
    1476 
    1477                   <listitem>
    1478                     <para>Install the specified file(s) to a destination
    1479                     directory.</para>
    1480                   </listitem>
    1481                 </varlistentry>
    1482               </variablelist>
    1483 
    1484               <variablelist>
    1485                 <varlistentry>
    1486                   <term>xinstall [-o owner] [-g group] [-m mode] [-W dir]
    1487                   [file1 file2 ...] directory</term>
    1488 
    1489                   <listitem>
    1490                     <para>Change to <option>dir</option> and install file(s)
    1491                     to a destination directory.</para>
    1492                   </listitem>
    1493                 </varlistentry>
    1494               </variablelist>
    1495 
    1496               <variablelist>
    1497                 <varlistentry>
    1498                   <term>eval xinstall [-o owner] [-g group] [-m mode] [glob
    1499                   regexp] directory</term>
    1500 
    1501                   <listitem>
    1502                     <para>Install the file(s) matching the glob expression to
    1503                     a destination directory.</para>
    1504                   </listitem>
    1505                 </varlistentry>
    1506               </variablelist>
    1507 
    1508               <variablelist>
    1509                 <varlistentry>
    1510                   <term>xinstall -d [-o owner] [-g group] [-m mode]
    1511                   directory</term>
    1512 
    1513                   <listitem>
    1514                     <para>Create a directory.</para>
    1515                   </listitem>
    1516                 </varlistentry>
    1517               </variablelist>
    1518 
    1519               <para>Defaults:</para>
    1520 
    1521               <itemizedlist>
    1522                 <listitem>
    1523                   <para>owner -</para>
    1524                 </listitem>
    1525 
    1526                 <listitem>
    1527                   <para>group -</para>
    1528                 </listitem>
    1529 
    1530                 <listitem>
    1531                   <para>mode -</para>
    1532                 </listitem>
    1533               </itemizedlist>
    1534 
    1535               <para>Examples:</para>
    1536 
    1537               <programlisting>xinstall -m 640 ${worksrcpath}/doc README \
     1346    <para><variablelist>
     1347        <varlistentry>
     1348          <term>file</term>
     1349
     1350          <listitem>
     1351            <para>Description. </para>
     1352
     1353            <variablelist>
     1354              <varlistentry>
     1355                <term>file copy</term>
     1356
     1357                <listitem>
     1358                  <para></para>
     1359                </listitem>
     1360              </varlistentry>
     1361            </variablelist>
     1362
     1363            <variablelist>
     1364              <varlistentry>
     1365                <term>file move</term>
     1366
     1367                <listitem>
     1368                  <para></para>
     1369                </listitem>
     1370              </varlistentry>
     1371            </variablelist>
     1372
     1373            <variablelist>
     1374              <varlistentry>
     1375                <term>file rename</term>
     1376
     1377                <listitem>
     1378                  <para></para>
     1379                </listitem>
     1380              </varlistentry>
     1381            </variablelist>
     1382
     1383            <variablelist>
     1384              <varlistentry>
     1385                <term>file delete [-force]</term>
     1386
     1387                <listitem>
     1388                  <para></para>
     1389                </listitem>
     1390              </varlistentry>
     1391            </variablelist>
     1392
     1393            <variablelist>
     1394              <varlistentry>
     1395                <term>file mkdir</term>
     1396
     1397                <listitem>
     1398                  <para></para>
     1399                </listitem>
     1400              </varlistentry>
     1401            </variablelist>
     1402          </listitem>
     1403        </varlistentry>
     1404
     1405        <varlistentry>
     1406          <term>macros</term>
     1407
     1408          <listitem>
     1409            <para>Description.</para>
     1410
     1411            <variablelist>
     1412              <varlistentry>
     1413                <term>copy</term>
     1414
     1415                <listitem>
     1416                  <para>Shorthand alternative to "file copy".</para>
     1417                </listitem>
     1418              </varlistentry>
     1419            </variablelist>
     1420
     1421            <variablelist>
     1422              <varlistentry>
     1423                <term>move</term>
     1424
     1425                <listitem>
     1426                  <para>Shorthand alternative to "file rename".</para>
     1427                </listitem>
     1428              </varlistentry>
     1429
     1430              <varlistentry>
     1431                <term>delete file ...</term>
     1432
     1433                <listitem>
     1434                  <para>Deletes each of the given files/directories. Behaves
     1435                  similarly to file delete -force except that file delete
     1436                  -force will fail to delete directories properly on 10.3
     1437                  systems.</para>
     1438                </listitem>
     1439              </varlistentry>
     1440
     1441              <varlistentry>
     1442                <term>touch</term>
     1443
     1444                <listitem>
     1445                  <para>Mimicks the BSD touch command.</para>
     1446                </listitem>
     1447              </varlistentry>
     1448
     1449              <varlistentry>
     1450                <term>ln</term>
     1451
     1452                <listitem>
     1453                  <para>Mimickes the BSD ln command.</para>
     1454                </listitem>
     1455              </varlistentry>
     1456            </variablelist>
     1457          </listitem>
     1458        </varlistentry>
     1459
     1460        <varlistentry>
     1461          <term>xinstall</term>
     1462
     1463          <listitem>
     1464            <para>xinstall copies files and creates directories; it is
     1465            intended to be compatible with install(1).</para>
     1466
     1467            <variablelist>
     1468              <varlistentry>
     1469                <term>xinstall [-o owner] [-g group] [-m mode] [file1 file2
     1470                ...] directory</term>
     1471
     1472                <listitem>
     1473                  <para>Install the specified file(s) to a destination
     1474                  directory.</para>
     1475                </listitem>
     1476              </varlistentry>
     1477            </variablelist>
     1478
     1479            <variablelist>
     1480              <varlistentry>
     1481                <term>xinstall [-o owner] [-g group] [-m mode] [-W dir] [file1
     1482                file2 ...] directory</term>
     1483
     1484                <listitem>
     1485                  <para>Change to <option>dir</option> and install file(s) to
     1486                  a destination directory.</para>
     1487                </listitem>
     1488              </varlistentry>
     1489            </variablelist>
     1490
     1491            <variablelist>
     1492              <varlistentry>
     1493                <term>eval xinstall [-o owner] [-g group] [-m mode] [glob
     1494                regexp] directory</term>
     1495
     1496                <listitem>
     1497                  <para>Install the file(s) matching the glob expression to a
     1498                  destination directory.</para>
     1499                </listitem>
     1500              </varlistentry>
     1501            </variablelist>
     1502
     1503            <variablelist>
     1504              <varlistentry>
     1505                <term>xinstall -d [-o owner] [-g group] [-m mode]
     1506                directory</term>
     1507
     1508                <listitem>
     1509                  <para>Create a directory.</para>
     1510                </listitem>
     1511              </varlistentry>
     1512            </variablelist>
     1513
     1514            <para>Defaults:</para>
     1515
     1516            <itemizedlist>
     1517              <listitem>
     1518                <para>owner -</para>
     1519              </listitem>
     1520
     1521              <listitem>
     1522                <para>group -</para>
     1523              </listitem>
     1524
     1525              <listitem>
     1526                <para>mode -</para>
     1527              </listitem>
     1528            </itemizedlist>
     1529
     1530            <para>Examples:</para>
     1531
     1532            <programlisting>xinstall -m 640 ${worksrcpath}/doc README \
    15381533       ${destroot}${prefix}/share/doc/${name}</programlisting>
    15391534
    1540               <programlisting>xinstall -m 640 -W ${worksrcpath}/doc README INSTALL COPY \
     1535            <programlisting>xinstall -m 640 -W ${worksrcpath}/doc README INSTALL COPY \
    15411536       ${destroot}${prefix}/share/doc/${name}</programlisting>
    15421537
    1543               <programlisting>eval xinstall -m 640 [glob ${worksrcpath}/doc/* \
     1538            <programlisting>eval xinstall -m 640 [glob ${worksrcpath}/doc/*] \
    15441539       ${destroot}${prefix}/share/doc/${name}</programlisting>
    15451540
    1546               <programlisting>xinstall -d ${destroot}${prefix}/share/doc/${name}</programlisting>
    1547             </listitem>
    1548           </varlistentry>
    1549 
    1550           <varlistentry>
    1551             <term>reinplace</term>
    1552 
    1553             <listitem>
    1554               <para>Description.</para>
    1555 
    1556               <para>Examples:</para>
    1557 
    1558               <programlisting></programlisting>
    1559 
    1560               <programlisting></programlisting>
    1561 
    1562               <programlisting></programlisting>
    1563             </listitem>
    1564           </varlistentry>
    1565 
    1566           <varlistentry>
    1567             <term>user/group</term>
    1568 
    1569             <listitem>
    1570               <para></para>
    1571 
    1572               <variablelist>
    1573                 <varlistentry>
    1574                   <term>adduser username [uid=uid] [gid=gid] [passwd=passwd]
    1575                   [realname=realname] [home=home] [shell=shell]</term>
    1576 
    1577                   <listitem>
    1578                     <para>Add a new local user to the system with the
    1579                     specified uid, gid, password, real name, home directory
    1580                     and login shell.</para>
    1581                   </listitem>
    1582                 </varlistentry>
    1583               </variablelist>
    1584 
    1585               <variablelist>
    1586                 <varlistentry>
    1587                   <term>existsuser username</term>
    1588 
    1589                   <listitem>
    1590                     <para>Check if a local user exists.</para>
    1591                   </listitem>
    1592                 </varlistentry>
    1593               </variablelist>
    1594 
    1595               <variablelist>
    1596                 <varlistentry>
    1597                   <term>nextuid</term>
    1598 
    1599                   <listitem>
    1600                     <para>Returns the highest used uid plus one.</para>
    1601                   </listitem>
    1602                 </varlistentry>
    1603               </variablelist>
    1604 
    1605               <variablelist>
    1606                 <varlistentry>
    1607                   <term>addgroup group [gid=gid] [passwd=passwd]
    1608                   [realname=realname] [users=users]</term>
    1609 
    1610                   <listitem>
    1611                     <para>Add a new local group to the system, with the
    1612                     specified gid, password, real name, and with a list users
    1613                     as members.</para>
    1614                   </listitem>
    1615                 </varlistentry>
    1616               </variablelist>
    1617 
    1618               <variablelist>
    1619                 <varlistentry>
    1620                   <term>existsgroup group</term>
    1621 
    1622                   <listitem>
    1623                     <para>Check if a local group exists and return the
    1624                     corresponding gid. This can be used with adduser:</para>
    1625 
    1626                     <programlisting>addgroup foo
     1541            <programlisting>xinstall -d ${destroot}${prefix}/share/doc/${name}</programlisting>
     1542          </listitem>
     1543        </varlistentry>
     1544
     1545        <varlistentry>
     1546          <term>reinplace</term>
     1547
     1548          <listitem>
     1549            <para>Description.</para>
     1550
     1551            <para>Examples:</para>
     1552
     1553            <programlisting>example 1</programlisting>
     1554
     1555            <programlisting>example 2</programlisting>
     1556
     1557            <programlisting>example 3</programlisting>
     1558          </listitem>
     1559        </varlistentry>
     1560
     1561        <varlistentry>
     1562          <term>user/group</term>
     1563
     1564          <listitem>
     1565            <para></para>
     1566
     1567            <variablelist>
     1568              <varlistentry>
     1569                <term>adduser username [uid=uid] [gid=gid] [passwd=passwd]
     1570                [realname=realname] [home=home] [shell=shell]</term>
     1571
     1572                <listitem>
     1573                  <para>Add a new local user to the system with the specified
     1574                  uid, gid, password, real name, home directory and login
     1575                  shell.</para>
     1576                </listitem>
     1577              </varlistentry>
     1578            </variablelist>
     1579
     1580            <variablelist>
     1581              <varlistentry>
     1582                <term>existsuser username</term>
     1583
     1584                <listitem>
     1585                  <para>Check if a local user exists.</para>
     1586                </listitem>
     1587              </varlistentry>
     1588            </variablelist>
     1589
     1590            <variablelist>
     1591              <varlistentry>
     1592                <term>nextuid</term>
     1593
     1594                <listitem>
     1595                  <para>Returns the highest used uid plus one.</para>
     1596                </listitem>
     1597              </varlistentry>
     1598            </variablelist>
     1599
     1600            <variablelist>
     1601              <varlistentry>
     1602                <term>addgroup group [gid=gid] [passwd=passwd]
     1603                [realname=realname] [users=users]</term>
     1604
     1605                <listitem>
     1606                  <para>Add a new local group to the system, with the
     1607                  specified gid, password, real name, and with a list users as
     1608                  members.</para>
     1609                </listitem>
     1610              </varlistentry>
     1611            </variablelist>
     1612
     1613            <variablelist>
     1614              <varlistentry>
     1615                <term>existsgroup group</term>
     1616
     1617                <listitem>
     1618                  <para>Check if a local group exists and return the
     1619                  corresponding gid. This can be used with adduser:</para>
     1620
     1621                  <programlisting>addgroup foo
    16271622adduser foo gid=[existsgroup foo]</programlisting>
    1628                   </listitem>
    1629                 </varlistentry>
    1630               </variablelist>
    1631 
    1632               <variablelist>
    1633                 <varlistentry>
    1634                   <term>nextgid</term>
    1635 
    1636                   <listitem>
    1637                     <para>Returns the highest used gid plus one.</para>
    1638                   </listitem>
    1639                 </varlistentry>
    1640               </variablelist>
    1641             </listitem>
    1642           </varlistentry>
    1643 
    1644           <varlistentry>
    1645             <term>External program execution</term>
    1646 
    1647             <listitem>
    1648               <para></para>
    1649             </listitem>
    1650           </varlistentry>
    1651         </variablelist></para>
    1652 
    1653       <para></para>
    1654 
    1655       <para></para>
    1656     </section>
    1657 
    1658     <section>
    1659       <title>xinstall</title>
    1660 
    1661       <para>xinstall copies files and creates directories; it is intended to
    1662       be compatible with install(1).</para>
    1663 
    1664       <para><variablelist>
    1665           <varlistentry>
    1666             <term>xinstall [-o owner] [-g group] [-m mode] [file1 file2 ...]
    1667             directory</term>
    1668 
    1669             <listitem>
    1670               <para>Install the specified file(s) to a destination
    1671               directory.</para>
    1672             </listitem>
    1673           </varlistentry>
    1674         </variablelist><variablelist>
    1675           <varlistentry>
    1676             <term>xinstall [-o owner] [-g group] [-m mode] [-W dir] [file1
    1677             file2 ...] directory</term>
    1678 
    1679             <listitem>
    1680               <para>Change to <option>dir</option> and install file(s) to a
    1681               destination directory.</para>
    1682             </listitem>
    1683           </varlistentry>
    1684         </variablelist><variablelist>
    1685           <varlistentry>
    1686             <term>eval xinstall [-o owner] [-g group] [-m mode] [glob regexp]
    1687             directory</term>
    1688 
    1689             <listitem>
    1690               <para>Install the file(s) matching the glob expression to a
    1691               destination directory.</para>
    1692             </listitem>
    1693           </varlistentry>
    1694         </variablelist><variablelist>
    1695           <varlistentry>
    1696             <term>xinstall -d [-o owner] [-g group] [-m mode] directory</term>
    1697 
    1698             <listitem>
    1699               <para>Create a directory.</para>
    1700             </listitem>
    1701           </varlistentry>
    1702         </variablelist></para>
    1703 
    1704       <para>Defaults:</para>
    1705 
    1706       <itemizedlist>
    1707         <listitem>
    1708           <para>owner -</para>
    1709         </listitem>
    1710 
    1711         <listitem>
    1712           <para>group -</para>
    1713         </listitem>
    1714 
    1715         <listitem>
    1716           <para>mode - 755</para>
    1717         </listitem>
    1718       </itemizedlist>
    1719 
    1720       <para>Examples:</para>
    1721 
    1722       <programlisting>xinstall -m 640 ${worksrcpath}/doc README \
    1723        ${destroot}${prefix}/share/doc/${name}</programlisting>
    1724 
    1725       <programlisting>xinstall -m 640 -W ${worksrcpath}/doc README INSTALL COPY \
    1726        ${destroot}${prefix}/share/doc/${name}</programlisting>
    1727 
    1728       <programlisting>eval xinstall -m 640 [glob ${worksrcpath}/doc/* \
    1729        ${destroot}${prefix}/share/doc/${name}</programlisting>
    1730 
    1731       <programlisting>xinstall -d ${destroot}${prefix}/share/doc/${name}</programlisting>
    1732 
    1733       <para></para>
    1734 
    1735       <para></para>
    1736     </section>
    1737 
    1738     <section>
    1739       <title>reinplace</title>
    1740 
    1741       <para></para>
    1742     </section>
    1743 
    1744     <section>
    1745       <title>user/group</title>
    1746 
    1747       <para></para>
    1748 
    1749       <variablelist>
    1750         <varlistentry>
    1751           <term>adduser username [uid=uid] [gid=gid] [passwd=passwd]
    1752           [realname=realname] [home=home] [shell=shell]</term>
    1753 
    1754           <listitem>
    1755             <para>Add a new local user to the system with the specified uid,
    1756             gid, password, real name, home directory and login shell.</para>
    1757           </listitem>
    1758         </varlistentry>
    1759 
    1760         <varlistentry>
    1761           <term>existsuser username</term>
    1762 
    1763           <listitem>
    1764             <para>Check if a local user exists.</para>
    1765           </listitem>
    1766         </varlistentry>
    1767 
    1768         <varlistentry>
    1769           <term>nextuid</term>
    1770 
    1771           <listitem>
    1772             <para>Returns the highest used uid plus one.</para>
    1773           </listitem>
    1774         </varlistentry>
    1775 
    1776         <varlistentry>
    1777           <term>addgroup group [gid=gid] [passwd=passwd] [realname=realname]
    1778           [users=users]</term>
    1779 
    1780           <listitem>
    1781             <para>Add a new local group to the system, with the specified gid,
    1782             password, real name, and with a list users as members.</para>
    1783           </listitem>
    1784         </varlistentry>
    1785 
    1786         <varlistentry>
    1787           <term>existsgroup group</term>
    1788 
    1789           <listitem>
    1790             <para>Check if a local group exists and return the corresponding
    1791             gid. This can be used with adduser:</para>
    1792 
    1793             <programlisting>addgroup foo
    1794 adduser foo gid=[existsgroup foo]</programlisting>
    1795           </listitem>
    1796         </varlistentry>
    1797       </variablelist>
    1798     </section>
    1799 
    1800     <section>
    1801       <title>Execute External Programs</title>
    1802 
    1803       <para>Only use when ...</para>
    1804     </section>
     1623                </listitem>
     1624              </varlistentry>
     1625            </variablelist>
     1626
     1627            <variablelist>
     1628              <varlistentry>
     1629                <term>nextgid</term>
     1630
     1631                <listitem>
     1632                  <para>Returns the highest used gid plus one.</para>
     1633                </listitem>
     1634              </varlistentry>
     1635            </variablelist>
     1636          </listitem>
     1637        </varlistentry>
     1638
     1639        <varlistentry>
     1640          <term>External program execution</term>
     1641
     1642          <listitem>
     1643            <para>Use only when ....</para>
     1644          </listitem>
     1645        </varlistentry>
     1646      </variablelist></para>
     1647
     1648    <para></para>
    18051649  </section>
    18061650</chapter>
Note: See TracChangeset for help on using the changeset viewer.