Changeset 28261 for trunk/doc


Ignore:
Timestamp:
Aug 26, 2007, 9:25:25 PM (12 years ago)
Author:
markd@…
Message:

Shorten section IDs, thereby shortening urls within the guide. Thanks to simonr for the
patches.

Location:
trunk/doc/guide/new/xml
Files:
7 edited

Legend:

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

    r28039 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="installing-macports">
     4<chapter id="installing">
    55  <title>Installing MacPorts</title>
    66
     
    99  wish to install MacPorts on FreeBSD, first make sure you have gcc and X11
    1010  installed, and then begin with section <link
    11   linkend="installing-macports.install.macports.source">Install MacPorts -
    12   Source</link>.</para>
    13 
    14   <section id="installing-macports.install.xcode.tools">
     11  linkend="installing.source">Install MacPorts - Source</link>.</para>
     12
     13  <section id="installing.xcode">
    1514    <title>Install Xcode Tools</title>
    1615
     
    4645  </section>
    4746
    48   <section id="installing-macports.install.x11">
     47  <section id="installing.x11">
    4948    <title>Install X11</title>
    5049
     
    8382    </note>
    8483
    85     <section>
     84    <section id="installing.x11.settings">
    8685      <title>Optional X11 Settings</title>
    8786
     
    119118  </section>
    120119
    121   <section id="installing-macports.install.macports.binary">
     120  <section id="installing.binary">
    122121    <title>Install MacPorts - Binary</title>
    123122
    124123    <para>If you wish to install MacPorts to a path other than
    125124    <filename>/opt/local</filename> do not install the MacPorts binary —skip
    126     this section and <link
    127     linkend="installing-macports.install.macports.source">install MacPorts
    128     from the source code</link>. The MacPorts binary installer will only
    129     install to <filename>/opt/local</filename>.</para>
     125    this section and <link linkend="installing.source">install MacPorts from
     126    the source code</link>. The MacPorts binary installer will only install to
     127    <filename>/opt/local</filename>.</para>
    130128
    131129    <orderedlist>
     
    146144
    147145    <note>
    148       <para>A MacPorts <link
    149       linkend="installing-macports.selfupdate">selfupdate</link> operation
    150       will automatically update to the latest release if the binary .dmg image
    151       is behind the latest released tarball.</para>
    152     </note>
    153   </section>
    154 
    155   <section id="installing-macports.install.macports.source">
     146      <para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
     147      operation will automatically update to the latest release if the binary
     148      .dmg image is behind the latest released tarball.</para>
     149    </note>
     150  </section>
     151
     152  <section id="installing.source">
    156153    <title>Install MacPorts - Source</title>
    157154
     
    181178
    182179    <note>
    183       <para>A MacPorts <link
    184       linkend="installing-macports.selfupdate">selfupdate</link> operation
    185       will automatically update to the latest release if the binary .dmg image
    186       is behind the latest released tarball.</para>
    187     </note>
    188   </section>
    189 
    190   <section id="installing-macports.set.bash.shell">
     180      <para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
     181      operation will automatically update to the latest release if the binary
     182      .dmg image is behind the latest released tarball.</para>
     183    </note>
     184  </section>
     185
     186  <section id="installing.shell">
    191187    <title>Set the Bash Shell</title>
    192188
     
    245241  </section>
    246242
    247   <section id="installing-macports.selfupdate">
     243  <section id="installing.selfupdate">
    248244    <title>MacPorts Selfupdate</title>
    249245
    250246    <para>You must always do a selfupdate after a new MacPorts install, and
    251247    you should also do it frequently thereafter. See <link
    252     linkend="using-macports.port.command.selfupdate">selfupdate</link> —one of
    253     several <link linkend="using-macports.port.command">port
    254     commands</link>.</para>
     248    linkend="using.port.selfupdate">selfupdate</link> —one of several <link
     249    linkend="using.port">port commands</link>.</para>
    255250  </section>
    256251</chapter>
  • trunk/doc/guide/new/xml/internals.xml

    r28223 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="macports-internals">
     4<chapter id="internals">
    55  <title>MacPorts Internals</title>
    66
     
    88  of MacPorts or learn how to configure it for non-default operation.</para>
    99
    10   <section id="macports-internals.macports.file.hierarchy">
     10  <section id="internals.hierarchy">
    1111    <title>MacPorts File Hierarchy</title>
    1212
     
    241241  </section>
    242242
    243   <section id="macports-internals.configuration.files">
     243  <section id="internals.configuration-files">
    244244    <title>Configuration Files</title>
    245245
     
    249249    located in <filename>/opt/local/etc/macports</filename>.</para>
    250250
    251     <section id="macports-internals.configuration.files.sources.conf">
     251    <section id="internals.configuration-files.sources-conf">
    252252      <title>sources.conf</title>
    253253
     
    257257    </section>
    258258
    259     <section id="macports-internals.configuration.files.macports.conf">
     259    <section id="internals.configuration-files.macports-conf">
    260260      <title>macports.conf</title>
    261261
     
    264264    </section>
    265265
    266     <section id="macports-internals.configuration.files.variants.conf">
     266    <section id="internals.configuration-files.variants-conf">
    267267      <title>variants.conf</title>
    268268
     
    272272  </section>
    273273
    274   <section id="macports-internals.port.images">
     274  <section id="internals.images">
    275275    <title>Port Images</title>
    276276
     
    298298  </section>
    299299
    300   <section id="macports-internals.macports.apis">
     300  <section id="internals.apis">
    301301    <title>MacPorts APIs</title>
    302302
     
    306306    API used by client applications such as the MacPorts port utility.</para>
    307307
    308     <section id="macports-internals.macports.apis.ports">
     308    <section id="internals.apis.ports">
    309309      <title>Ports API</title>
    310310
     
    350350    </section>
    351351
    352     <section id="macports-internals.macports.apis.macports">
     352    <section id="internals.apis.macports">
    353353      <title>MacPorts API</title>
    354354
     
    493493  </section>
    494494
    495   <section id="macports-internals.macports.registry">
     495  <section id="internals.registry">
    496496    <title>The MacPorts Registry</title>
    497497
     
    522522    </itemizedlist>
    523523
    524     <section id="macports-internals.macports.registry.registry.files">
     524    <section id="internals.registry.files">
    525525      <title>Registry Files</title>
    526526
     
    543543    </section>
    544544
    545     <section id="macports-internals.macports.registry.registry.api">
     545    <section id="internals.registry.api">
    546546      <title>The Registry API</title>
    547547
  • trunk/doc/guide/new/xml/intro.xml

    r28222 r28261  
    4646  descended from the Berkeley Software Distribution (BSD).</para>
    4747
    48   <section>
     48  <section id="introduction.conventions">
    4949    <title>Document Conventions</title>
    5050
  • trunk/doc/guide/new/xml/portfiledev.xml

    r28044 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="portfile-development">
     4<chapter id="development">
    55  <title>Portfile Development</title>
    66
     
    88  local Portfile repository for development, and creating Portfiles.</para>
    99
    10   <section id="portfile-development.portfile.introduction">
     10  <section id="development.introduction">
    1111    <title>Portfile Introduction</title>
    1212
    1313    <para>A MacPorts Portfile is a TCL script that usually contains only the
    1414    simple keyword/value combinations and Tcl extensions as described in the
    15     <link linkend="portfile-reference">Portfile Reference</link> chapter,
    16     though it may also contain arbitrary TCL code. Every port has a
    17     corresponding Portfile, but Portfiles do not completely define a port's
    18     installation behavior since the MacPorts base has default port
    19     installation characteristics coded within it. Therefore Portfiles need
    20     only specify required options and, when required, non-default
    21     characteristics for a port.</para>
     15    <link linkend="reference">Portfile Reference</link> chapter, though it may
     16    also contain arbitrary TCL code. Every port has a corresponding Portfile,
     17    but Portfiles do not completely define a port's installation behavior
     18    since the MacPorts base has default port installation characteristics
     19    coded within it. Therefore Portfiles need only specify required options
     20    and, when required, non-default characteristics for a port.</para>
    2221
    2322    <para>A common way for Portfiles to augment or override MacPorts base
     
    6766    standard behavior, any installation phase may be augmented using pre-
    6867    and/or post- phases, or even overridden or eliminated. See <link
    69     linkend="portfile-development.example.portfiles">Example Portfiles</link>
    70     below.</para>
     68    linkend="development.examples">Example Portfiles</link> below.</para>
    7169
    7270    <note>
    7371      <para>For a detailed description of all port phases, see the <link
    74       linkend="portfile-reference">Portfile Reference</link> chapter.</para>
     72      linkend="reference">Portfile Reference</link> chapter.</para>
    7573    </note>
    7674  </section>
    7775
    78   <section id="portfile-development.local.portfile.repositories">
     76  <section id="development.local-repositories">
    7977    <title>Local Portfile Repositories</title>
    8078
     
    146144  </section>
    147145
    148   <section id="portfile-development.creating.a.portfile">
     146  <section id="development.creating-portfile">
    149147    <title>Creating a Portfile</title>
    150148
     
    202200        keyword lists maintainer email addresses(s). To hide these addresses
    203201        from spambots, see the more full explanation of the maintainer keyword
    204         in the <link linkend="portfile-reference.keywords.global">Global
    205         Keywords</link> section of the <link
    206         linkend="portfile-reference">Portfile Reference</link> chapter.</para>
     202        in the <link linkend="reference.keywords.global">Global
     203        Keywords</link> section of the <link linkend="reference">Portfile
     204        Reference</link> chapter.</para>
    207205
    208206        <programlisting>maintainers       julesverne@example.org</programlisting>
     
    275273  </section>
    276274
    277   <section id="portfile-development.example.portfiles">
     275  <section id="development.examples">
    278276    <title>Example Portfiles</title>
    279277
     
    282280    default phases.</para>
    283281
    284     <section id="portfile-development.example.portfiles.basic.portfile">
     282    <section id="development.examples.basic">
    285283      <title>A Basic Portfile</title>
    286284
     
    310308    </section>
    311309
    312     <section id="portfile-development.example.portfiles.pre.post">
     310    <section id="development.examples.pre-post">
    313311      <title>Portfile Using Pre- / Post- Phases</title>
    314312
     
    325323    </section>
    326324
    327     <section id="portfile-development.example.portfiles.override">
     325    <section id="development.examples.override">
    328326      <title>Portfile that Overrides Default Phases</title>
    329327
     
    337335    </section>
    338336
    339     <section id="portfile-development.example.portfiles.startupitem">
     337    <section id="development.examples.startupitem">
    340338      <title>Portfile Using a StartupItem</title>
    341339
     
    358356  </section>
    359357
    360   <section id="portfile-development.port.variants">
     358  <section id="development.variants">
    361359    <title>Port Variants</title>
    362360
     
    365363    Portfile using the "variant" keyword and may provide a description.</para>
    366364
    367     <section id="portfile-development.port.variants.modify.options">
     365    <section id="development.variants.options">
    368366      <title>Variants to Modify Options</title>
    369367
     
    400398    </section>
    401399
    402     <section id="portfile-development.port.variants.actions.phase">
     400    <section id="development.variants.phase">
    403401      <title>Variant Actions in a Phase</title>
    404402
     
    422420    </section>
    423421
    424     <section id="portfile-development.port.variants.default.variants">
     422    <section id="development.variants.default">
    425423      <title>Default Variants</title>
    426424
     
    439437  </section>
    440438
    441   <section id="portfile-development.patch.files">
     439  <section id="development.patches">
    442440    <title>Patch Files</title>
    443441
     
    447445    functionality.</para>
    448446
    449     <section id="portfile-development.patch.files.portfile.patches">
     447    <section id="development.patches.portfile">
    450448      <title>Creating Portfile Patches</title>
    451449
     
    508506    </section>
    509507
    510     <section id="portfile-development.patch.files.source.patches">
     508    <section id="development.patches.source">
    511509      <title>Creating Source Code Patches</title>
    512510
     
    576574    </section>
    577575
    578     <section id="portfile-development.patch.files.manually.applying">
     576    <section id="development.patches.applying">
    579577      <title>Manually Applying Patches</title>
    580578
     
    604602  </section>
    605603
    606   <section id="portfile-development.portfile.best.practices">
     604  <section id="development.practices">
    607605    <title>Portfile Best Practices</title>
    608606
     
    610608    that install smoothly and provide consistency between ports.</para>
    611609
    612     <section>
     610    <section id="development.practices.dont-overwrite">
    613611      <title>Don't Overwrite Config Files</title>
    614612
     
    616614    </section>
    617615
    618     <section>
     616    <section id="development.practices.install-docs">
    619617      <title>Install Docs and Examples</title>
    620618
     
    622620    </section>
    623621
    624     <section>
     622    <section id="development.practices.provide-messages">
    625623      <title>Provide User Messages</title>
    626624
  • trunk/doc/guide/new/xml/portfileref.xml

    r28078 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="portfile-reference">
     4<chapter id="reference">
    55  <title>Portfile Reference</title>
    66
     
    99  variables, keywords, and Tcl extensions.</para>
    1010
    11   <section id="portfile-reference.port.phases">
     11  <section id="reference.phases">
    1212    <title>Port Phases</title>
    1313
     
    1717    install</command> steps, but for applications that do not conform to this
    1818    behavior, installation phases may be declared in a Portfile to <link
    19     linkend="portfile-development.example.portfiles.pre.post">augment</link>
    20     or <link
    21     linkend="portfile-development.example.portfiles.override">override</link>
    22     the default behavior as described in the <link
    23     linkend="portfile-development">Portfile Development</link> chapter.</para>
    24 
    25     <section id="portfile-reference.port.phases.fetch">
     19    linkend="development.examples.pre-post">augment</link> or <link
     20    linkend="development.examples.override">override</link> the default
     21    behavior as described in the <link linkend="development">Portfile
     22    Development</link> chapter.</para>
     23
     24    <section id="reference.phases.fetch">
    2625      <title>Fetch</title>
    2726
     
    3130    </section>
    3231
    33     <section id="portfile-reference.port.phases.checksum">
     32    <section id="reference.phases.checksum">
    3433      <title>Checksum</title>
    3534
     
    3938    </section>
    4039
    41     <section id="portfile-reference.port.phases.extract">
     40    <section id="reference.phases.extract">
    4241      <title>Extract</title>
    4342
     
    4645    </section>
    4746
    48     <section id="portfile-reference.port.phases.patch">
     47    <section id="reference.phases.patch">
    4948      <title>Patch</title>
    5049
     
    6160    </section>
    6261
    63     <section id="portfile-reference.port.phases.configure">
     62    <section id="reference.phases.configure">
    6463      <title>Configure</title>
    6564
     
    6867    </section>
    6968
    70     <section id="portfile-reference.port.phases.build">
     69    <section id="reference.phases.build">
    7170      <title>Build</title>
    7271
     
    7574    </section>
    7675
    77     <section id="portfile-reference.port.phases.destroot">
     76    <section id="reference.phases.destroot">
    7877      <title>Destroot</title>
    7978
     
    115114    </section>
    116115
    117     <section id="portfile-reference.port.phases.archive">
     116    <section id="reference.phases.archive">
    118117      <title>Archive</title>
    119118
     
    123122    </section>
    124123
    125     <section id="portfile-reference.port.phases.install">
     124    <section id="reference.phases.install">
    126125      <title>Install</title>
    127126
    128127      <para>Overview: Copy a port's destrooted files into
    129128      <filename>${prefix}/var/macports/software</filename>. See <link
    130       linkend="macports-internals.port.images">Port Images</link> in the <link
    131       linkend="macports-internals">MacPorts Internals</link> chapter for
     129      linkend="internals.images">Port Images</link> in the <link
     130      linkend="internals">MacPorts Internals</link> chapter for
    132131      details.</para>
    133132    </section>
    134133
    135     <section id="portfile-reference.port.phases.activate">
     134    <section id="reference.phases.activate">
    136135      <title>Activate</title>
    137136
     
    143142  </section>
    144143
    145   <section id="portfile-reference.dependencies">
     144  <section id="reference.dependencies">
    146145    <title>Dependencies</title>
    147146
     
    160159    library and build dependencies also, but not its run dependencies.</para>
    161160
    162     <section id="portfile-reference.dependencies.dependslib">
     161    <section id="reference.dependencies.dependslib">
    163162      <title>depends_lib</title>
    164163
     
    169168    </section>
    170169
    171     <section id="portfile-reference.dependencies.dependsbuild">
     170    <section id="reference.dependencies.dependsbuild">
    172171      <title>depends_build</title>
    173172
     
    178177    </section>
    179178
    180     <section id="portfile-reference.dependencies.dependsrun">
     179    <section id="reference.dependencies.dependsrun">
    181180      <title>depends_run</title>
    182181
     
    187186    </section>
    188187
    189     <section id="portfile-reference.dependencies.nonport">
     188    <section id="reference.dependencies.nonport">
    190189      <title>Non-Port Dependencies</title>
    191190
     
    217216  </section>
    218217
    219   <section id="portfile-reference.startupitems">
     218  <section id="reference.startupitems">
    220219    <title>StartupItems</title>
    221220
     
    330329  </section>
    331330
    332   <section id="portfile-reference.variables">
     331  <section id="reference.variables">
    333332    <title>Variables</title>
    334333
     
    336335    used within Portfiles.</para>
    337336
    338     <section id="portfile-reference.variables.general">
     337    <section id="reference.variables.general">
    339338      <title>General</title>
    340339
     
    463462    </section>
    464463
    465     <section id="portfile-reference.variables.portgroup">
     464    <section id="reference.variables.portgroup">
    466465      <title>PortGroup Variables</title>
    467466
     
    676675  </section>
    677676
    678   <section id="portfile-reference.keywords">
     677  <section id="reference.keywords">
    679678    <title>Keywords</title>
    680679
     
    694693    phase.</para>
    695694
    696     <section id="portfile-reference.keywords.append.delete">
     695    <section id="reference.keywords.append-delete">
    697696      <title>Using -append and -delete Keywords</title>
    698697
     
    769768    </section>
    770769
    771     <section id="portfile-reference.keywords.global">
     770    <section id="reference.keywords.global">
    772771      <title>Global Keywords</title>
    773772
     
    963962    </section>
    964963
    965     <section id="portfile-reference.keywords.fetch">
     964    <section id="reference.keywords.fetch">
    966965      <title>Fetch</title>
    967966
     
    11041103    </section>
    11051104
    1106     <section id="portfile-reference.keywords.checksum">
     1105    <section id="reference.keywords.checksum">
    11071106      <title>Checksum</title>
    11081107
     
    11281127    </section>
    11291128
    1130     <section id="portfile-reference.keywords.extract">
     1129    <section id="reference.keywords.extract">
    11311130      <title>Extract</title>
    11321131
     
    12161215    </section>
    12171216
    1218     <section id="portfile-reference.keywords.patch">
     1217    <section id="reference.keywords.patch">
    12191218      <title>Patch</title>
    12201219
     
    12401239    </section>
    12411240
    1242     <section id="portfile-reference.keywords.configure">
     1241    <section id="reference.keywords.configure">
    12431242      <title>Configure</title>
    12441243
     
    13521351      </variablelist>
    13531352
    1354       <section>
     1353      <section id="reference.keywords.configure.automake-autoconf">
    13551354        <title>Automake and Autoconf</title>
    13561355
     
    14481447    </section>
    14491448
    1450     <section id="portfile-reference.keywords.build">
     1449    <section id="reference.keywords.build">
    14511450      <title>Build</title>
    14521451
     
    15171516    </section>
    15181517
    1519     <section id="portfile-reference.keywords.destroot">
     1518    <section id="reference.keywords.destroot">
    15201519      <title>Destroot</title>
    15211520
     
    16311630  </section>
    16321631
    1633   <section id="portfile-reference.tcl.extensions">
     1632  <section id="reference.tcl-extensions">
    16341633    <title>Tcl Extensions</title>
    16351634
  • trunk/doc/guide/new/xml/project.xml

    r28037 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="macports-project">
     4<chapter id="project">
    55  <title>MacPorts Project</title>
    66
     
    1414  account to create tickets.</para>
    1515
    16   <section id="macports-project.creating.trac.tickets">
     16  <section id="project.tickets">
    1717    <title>Creating Trac Tickets</title>
    1818
     
    3232    </screenshot>
    3333
    34     <section id="macports-project.creating.trac.tickets.guidelines">
     34    <section id="project.tickets.guidelines">
    3535      <title>Trac Ticket Guidelines</title>
    3636
     
    235235  </section>
    236236
    237   <section id="macports-project.contributing">
     237  <section id="project.contributing">
    238238    <title>Contributing to MacPorts</title>
    239239
     
    244244    documentation, or alternatively add this to the following? -->
    245245
    246     <section>
     246    <section id="project.contributing.new">
    247247      <title>New Ports</title>
    248248
     
    271271    </section>
    272272
    273     <section>
     273    <section id="project.contributing.updates">
    274274      <title>Port Updates</title>
    275275
     
    306306  </section>
    307307
    308   <section id="macports-project.port.update.policies">
     308  <section id="project.update-policies">
    309309    <title>Port Update Policies</title>
    310310
     
    316316    below.</para>
    317317
    318     <section id="macports-project.port.update.policies.nonmaintainer">
     318    <section id="project.update-policies.nonmaintainer">
    319319      <title>Non-Maintainer Port Updates</title>
    320320
     
    375375    </section>
    376376
    377     <section id="macports-project.port.update.policies.abandonment">
     377    <section id="project.update-policies.abandonment">
    378378      <title>Port Abandonment</title>
    379379
     
    404404  </section>
    405405
    406   <section id="macports-project.macports.membership">
     406  <section id="project.membership">
    407407    <title>MacPorts Membership</title>
    408408
  • trunk/doc/guide/new/xml/using.xml

    r28039 r28261  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 <chapter id="using-macports">
     4<chapter id="using">
    55  <title>Using MacPorts</title>
    66
     
    99  server.</para>
    1010
    11   <section id="using-macports.port.command">
     11  <section id="using.port">
    1212    <title>The port Command</title>
    1313
     
    1717    install and manage ports.</para>
    1818
    19     <section id="using-macports.port.command.selfupdate">
     19    <section id="using.port.selfupdate">
    2020      <title>selfupdate</title>
    2121
     
    5353    </section>
    5454
    55     <section id="using-macports.port.command.sync">
     55    <section id="using.port.sync">
    5656      <title>sync</title>
    5757
     
    6262    </section>
    6363
    64     <section id="using-macports.port.command.list">
     64    <section id="using.port.list">
    6565      <title>list</title>
    6666
     
    7171    </section>
    7272
    73     <section id="using-macports.port.command.search">
     73    <section id="using.port.search">
    7474      <title>search</title>
    7575
     
    8383    </section>
    8484
    85     <section id="using-macports.port.command.info">
     85    <section id="using.port.info">
    8686      <title>info</title>
    8787
     
    100100    </section>
    101101
    102     <section id="using-macports.port.command.deps">
     102    <section id="using.port.deps">
    103103      <title>deps</title>
    104104
     
    117117    </section>
    118118
    119     <section id="using-macports.port.command.variants">
     119    <section id="using.port.variants">
    120120      <title>variants</title>
    121121
     
    123123      variations of a port are available before you install it. Variants are a
    124124      way for port authors to provide options that may be invoked at install
    125       time. See <link
    126       linkend="using-macports.port.variants.invoking.variants">Invoking Port
     125      time. See <link linkend="using.variants.invoking">Invoking Port
    127126      Variants</link> below to install ports that have variants.</para>
    128127
     
    136135    </section>
    137136
    138     <section id="using-macports.port.command.install">
     137    <section id="using.port.install">
    139138      <title>install</title>
    140139
    141140      <para>The option <option>install</option> is used to install a port. See
    142       <link linkend="using-macports.port.variants.invoking.variants">Invoking
    143       Port Variants</link> below to install ports that have variants.</para>
     141      <link linkend="using.variants.invoking">Invoking Port Variants</link>
     142      below to install ports that have variants.</para>
    144143
    145144      <programlisting><prompt>%%</prompt> <userinput>sudo port install nmap</userinput></programlisting>
     
    153152    </section>
    154153
    155     <section id="using-macports.port.command.clean">
     154    <section id="using.port.clean">
    156155      <title>clean</title>
    157156
     
    170169    </section>
    171170
    172     <section id="using-macports.port.command.uninstall">
     171    <section id="using.port.uninstall">
    173172      <title>uninstall</title>
    174173
     
    189188    </section>
    190189
    191     <section id="using-macports.port.command.contents">
     190    <section id="using.port.contents">
    192191      <title>contents</title>
    193192
     
    205204    </section>
    206205
    207     <section id="using-macports.port.command.installed">
     206    <section id="using.port.installed">
    208207      <title>installed</title>
    209208
     
    227226    </section>
    228227
    229     <section id="using-macports.port.command.outdated">
     228    <section id="using.port.outdated">
    230229      <title>outdated</title>
    231230
     
    243242    </section>
    244243
    245     <section id="using-macports.port.command.upgrade">
     244    <section id="using.port.upgrade">
    246245      <title>upgrade</title>
    247246
     
    265264        <para>The <option>upgrade</option> option by default does not
    266265        uninstall an upgraded port —it deactivates it. See section <link
    267         linkend="macports-internals.port.images">Port Images</link>, and also
    268         <link
    269         linkend="portfile-reference.port.phases.destroot">Destroot</link> and
    270         <link
    271         linkend="portfile-reference.port.phases.activate">Activate</link>
    272         phases in <link linkend="portfile-reference.port.phases">Port
    273         Phases</link>. If you wish to uninstall the old version use the -u
    274         option.</para>
     266        linkend="internals.images">Port Images</link>, and also <link
     267        linkend="reference.phases.destroot">Destroot</link> and <link
     268        linkend="reference.phases.activate">Activate</link> phases in <link
     269        linkend="reference.phases">Port Phases</link>. If you wish to
     270        uninstall the old version use the -u option.</para>
    275271
    276272        <programlisting><prompt>%%</prompt> <userinput>port -u upgrade vile</userinput></programlisting>
     
    278274    </section>
    279275
    280     <section id="using-macports.port.command.dependents">
     276    <section id="using.port.dependents">
    281277      <title>dependents</title>
    282278
     
    293289    </section>
    294290
    295     <section id="using-macports.port.command.livecheck">
     291    <section id="using.port.livecheck">
    296292      <title>livecheck</title>
    297293
     
    300296  </section>
    301297
    302   <section id="using-macports.port.variants">
     298  <section id="using.variants">
    303299    <title>Port Variants</title>
    304300
     
    320316    </note>
    321317
    322     <section id="using-macports.port.variants.invoking.variants">
     318    <section id="using.variants.invoking">
    323319      <title>Invoking Variants</title>
    324320
     
    340336    </section>
    341337
    342     <section id="using-macports.port.variants.negating.default.variants">
     338    <section id="using.variants.negating">
    343339      <title>Negating Default Variants</title>
    344340
    345341      <para>For an explanation of default variants see <link
    346       linkend="portfile-development.port.variants">Port Variants</link>.
     342      linkend="development.variants">Port Variants</link>.
    347343      Default variants are optional, and not all ports using variants have
    348344      them. For ports with default variants, you may install a port without
     
    362358  </section>
    363359
    364   <section id="using-macports.common.tasks">
     360  <section id="using.common-tasks">
    365361    <title>Common Tasks</title>
    366362
     
    369365  </section>
    370366
    371   <section id="using-macports.port.binaries">
     367  <section id="using.binaries">
    372368    <title>Port Binaries</title>
    373369
     
    376372    types of binaries: archives and packages.</para>
    377373
    378     <section id="using-macports.port.binaries.binary.archives">
     374    <section id="using.binaries.archives">
    379375      <title>Binary Archives</title>
    380376
     
    420416    </section>
    421417
    422     <section id="using-macports.port.binaries.binary.packages">
     418    <section id="using.binaries.binary-packages">
    423419      <title>Binary Packages</title>
    424420
     
    446442    </section>
    447443
    448     <section id="using-macports.port.binaries.port.source.packages">
     444    <section id="using.binaries.source-packages">
    449445      <title>Port Source Packages</title>
    450446
     
    458454  </section>
    459455
    460   <section id="using-macports.rsync.replication.servers">
     456  <section id="using.rsync-replication">
    461457    <title>Rsync Replication Servers</title>
    462458
     
    468464    local network perform selfupdates.</para>
    469465
    470     <section id="using-macports.rsync.replication.servers.rsync.server.setup">
     466    <section id="using.rsync-replication.server-setup">
    471467      <title>Rsync Server Setup</title>
    472468
     
    521517    </section>
    522518
    523     <section id="using-macports.rsync.replication.servers.rsync.client.setup">
     519    <section id="using.rsync-replication.client-setup">
    524520      <title>Rsync Client Setup</title>
    525521
Note: See TracChangeset for help on using the changeset viewer.