Changeset 31828 for trunk/doc-new


Ignore:
Timestamp:
Dec 9, 2007, 3:14:26 PM (12 years ago)
Author:
simon@…
Message:

doc-new: Integrated much data of the old portfile.7 man page. Also updated examples to follow our new whitespace conventions.

Location:
trunk/doc-new/guide/xml
Files:
5 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-global-keywords.7.xml

    r31624 r31828  
    4040
    4141        <listitem>
    42           <para>The name of the Port; it should be lowercase.</para>
     42          <para>The name of the Port; it should be lowercase to prevent
     43          uninstallation problems due to a macports base bug.</para>
    4344
    4445          <programlisting>name                foo</programlisting>
     
    6465          it would benefit users to upgrade an installed port, and cleared
    6566          when the port is updated to a newer version.</para>
     67          <para>It should be used if a bug in the Portfile was found and all
     68          installations of this port have to be updated. If the change only
     69          affects new installations, there is no need to increase it.</para>
    6670
    6771          <programlisting>revision            1</programlisting>
     
    249253      desirable for a special reason. Dependencies of this type are called
    250254      non-port dependencies.</para>
     255      <para>Non-port dependencies should only be used if the application or
     256      library can be installed by multiple ports (for example stable and
     257      -devel version) or if it can't be installed with Macports.</para>
    251258
    252259      <para>Port dependencies, the preferred type, are specified as shown in
    253260      these examples:</para>
    254261
    255       <programlisting>depends_lib        port:rrdtool port:apache2
    256 
    257 depends_build      port:apache2 port:php5</programlisting>
     262      <programlisting>depends_lib         port:rrdtool port:apache2
     263
     264depends_build       port:libtool
     265
     266depends_run         port:apache2 port:php5</programlisting>
    258267
    259268      <para>Non-port dependencies are specified as shown in these
    260269      examples:</para>
    261270
    262       <programlisting>depends_lib        lib:libX11.6:xorg
    263 
    264 depends_build      bin:rrdtool</programlisting>
     271      <programlisting>depends_lib         lib:libX11.6:xorg
     272
     273depends_build       bin:glibtool:libtool
     274
     275depends_run         path:${prefix}/lib/libltdl.a:libtool</programlisting>
    265276    </section>
    266277  </section>
     
    298309
    299310              <programlisting>variant gnome requires glib {
    300     configure.args-append --with-gnome
    301     depends_lib-append port:gnome-session
     311    configure.args-append   --with-gnome
     312    depends_lib-append      port:gnome-session
    302313}</programlisting>
    303314            </listitem>
     
    314325          Portfile modularity and also allows users to suppress default
    315326          variants if they wish.</para>
     327          <para>Due to a bug in the current Macports base default_variants
     328          shouldn't be used at the moment as they cause problems while
     329          upgrading ports.</para>
    316330
    317331          <itemizedlist>
     
    323337              <para>Example:</para>
    324338
    325               <programlisting>default_variants +ssl +tcpd
     339              <programlisting>default_variants    +ssl +tcpd
    326340
    327341</programlisting>
     
    357371              <para>Example:</para>
    358372
    359               <programlisting>universal_variant  no</programlisting>
     373              <programlisting>universal_variant   no</programlisting>
    360374            </listitem>
    361375          </itemizedlist>
     
    411425
    412426              <programlisting>livecheck.check     regex
    413 livecheck.url       http://dev.mysql.com/
    414 livecheck.regex     "Generally Available (${major_version}\\.\[0-9.\]+)"
    415 </programlisting>
     427livecheck.url       ${homepage}
     428livecheck.regex     "Generally Available (\\d+(?:\\.\\d+)*)"</programlisting>
    416429            </listitem>
    417430          </itemizedlist>
     
    441454              <para>Example:</para>
    442455
    443               <programlisting>livecheck.name   hibernate</programlisting>
     456              <programlisting>livecheck.name      hibernate</programlisting>
    444457            </listitem>
    445458          </itemizedlist>
     
    537550              <para>Example:</para>
    538551
    539               <programlisting>livecheck.url  http://ftp.gnu.org/gnu/bison/</programlisting>
     552              <programlisting>livecheck.url       http://ftp.gnu.org/gnu/bison/</programlisting>
    540553            </listitem>
    541554          </itemizedlist>
     
    563576              <para>Example:</para>
    564577
    565               <programlisting>livecheck.regex  4th-([a-z0-9.]+)-unix.tar.gz</programlisting>
     578              <programlisting>livecheck.regex     4th-([a-z0-9.]+)-unix.tar.gz</programlisting>
    566579            </listitem>
    567580          </itemizedlist>
     
    588601              <para>Example:</para>
    589602
    590               <programlisting>livecheck  md5 37e6a5b6516a680c7178b72021d3b706</programlisting>
     603              <programlisting>livecheck.md5      37e6a5b6516a680c7178b72021d3b706</programlisting>
    591604            </listitem>
    592605          </itemizedlist>
     
    621634              <para>Example:</para>
    622635
    623               <programlisting>distcheck.check  none</programlisting>
     636              <programlisting>distcheck.check     none</programlisting>
    624637            </listitem>
    625638          </itemizedlist>
  • trunk/doc-new/guide/xml/portfile-global-variables.7.xml

    r31622 r31828  
    99  of additional variables available to ports that are assigned to a MacPorts
    1010  Portgroup, see portgroup(7).</para>
     11  <para>All of these variables except <varname>prefix</varname> are
     12  read-only!</para>
    1113
    1214  <variablelist>
     
    2022        installed in <filename>/Applications/MacPorts</filename>.</para>
    2123
    22         <para>Default: /opt/local</para>
     24        <para>Default: <filename>/opt/local</filename></para>
    2325      </listitem>
    2426    </varlistentry>
     
    4547      <listitem>
    4648        <para>Full path to the Portfile location.</para>
     49
     50        <para>Value: <literal>work</literal></para>
    4751      </listitem>
    4852    </varlistentry>
     
    5458        <para>Path to port files relative to
    5559        <varname>${portpath}</varname>.</para>
     60
     61        <para>Value: <literal>files</literal></para>
     62      </listitem>
     63    </varlistentry>
     64
     65    <varlistentry>
     66      <term>filespath</term>
     67
     68      <listitem>
     69        <para>Path to port files relative to
     70        <varname>${portpath}</varname>.</para>
     71
     72        <para>Value: <varname>${portpath}/${filesdir}</varname></para>
    5673      </listitem>
    5774    </varlistentry>
     
    6279      <listitem>
    6380        <para>Full path to work directory.</para>
     81
     82        <!-- TODO: what is ${portbuildpath}? -->
     83
     84        <para>Value: <varname>${portbuildpath}/work</varname></para>
    6485      </listitem>
    6586    </varlistentry>
     
    6990
    7091      <listitem>
    71         <para>Full path to extracted source code. Equivalent to
    72         <varname>${workpath}/${worksrcdir}</varname>.</para>
     92        <para>Full path to extracted source code.</para>
     93
     94        <para>Value: <varname>${workpath}/${worksrcdir}</varname></para>
    7395      </listitem>
    7496    </varlistentry>
     
    78100
    79101      <listitem>
    80         <para>Full path into which software will be destrooted. Equivalent
    81         to <filename>${workpath}/destroot</filename>.</para>
     102        <para>Full path into which software will be destrooted.</para>
     103
     104        <para>Value: <varname>${workpath}/destroot</varname></para>
    82105      </listitem>
    83106    </varlistentry>
     
    88111      <listitem>
    89112        <para>Location to store downloaded distfiles.</para>
     113
     114        <!-- TODO: which value have the variables? -->
     115
     116        <para>Value: <varname>${sysportpath}/distfiles/${dist_subdir}/</varname></para>
    90117      </listitem>
    91118    </varlistentry>
     
    111138
    112139      <listitem>
    113         <para>Identifies platform type (ie, "darwin", "freebsd",
     140        <para>Identifies platform type (ie "darwin", "freebsd",
    114141        etc).</para>
    115142      </listitem>
     
    120147
    121148      <listitem>
    122         <para>Identifies hardware type (ie, "powerpc", "intel").</para>
     149        <para>Identifies hardware type (ie "powerpc", "intel").</para>
    123150      </listitem>
    124151    </varlistentry>
     
    134161
    135162    <varlistentry>
     163      <term>os.endian</term>
     164
     165      <listitem>
     166        <para>Endianness of the processor (ie "bigEndian").</para>
     167      </listitem>
     168    </varlistentry>
     169
     170    <varlistentry>
    136171      <term>os.major</term>
    137172
     
    141176      </listitem>
    142177    </varlistentry>
     178
     179    <varlistentry>
     180      <term>x11prefix</term>
     181
     182      <listitem>
     183        <para>Absolute path to X11.</para>
     184      </listitem>
     185    </varlistentry>
     186
    143187  </variablelist>
    144188</section>
  • trunk/doc-new/guide/xml/portfile-phase.7.xml

    r31622 r31828  
    66  <title>Port Phases</title>
    77
    8   <section>
     8  <section id="reference.phases.installation">
    99    <title>Installation Phase Keywords</title>
    1010
     
    123123  </section>
    124124
    125   <section>
     125  <section id="reference.phases.fetch">
    126126    <title>Fetch Phase Keywords</title>
    127127
     
    146146              <para>Examples:</para>
    147147
    148               <programlisting>master_sites   http://www.somesite.org/files/ \
    149                http://www.somemirror.org/somesite_org/files/
     148              <programlisting>master_sites        http://www.somesite.org/files/ \
     149                    http://www.somemirror.org/somesite_org/files/
    150150
    151151</programlisting>
     
    155155              used.</para>
    156156
    157               <programlisting>master_sites   sourceforge gnu
     157              <programlisting>master_sites        sourceforge gnu
    158158
    159159</programlisting>
     
    164164              specify it using after the mirror separated by a colon.</para>
    165165
    166               <programlisting>master_sites   sourceforge:widget \
    167                gnu:widget
     166              <programlisting>master_sites        sourceforge:widget \
     167                    gnu:widget
    168168
    169169</programlisting>
     
    179179              the gnu mirrors in subdirectory sources.</para>
    180180
    181               <programlisting>master_sites    sourceforge::tagone \
    182                 gnu:sources:tagtwo
    183 
    184 distfiles       file_one.tar.gz:tagone \
    185                 file_two.tar.gz:tagtwo</programlisting>
     181              <programlisting>master_sites        sourceforge::tagone \
     182                    gnu:sources:tagtwo
     183
     184distfiles           file_one.tar.gz:tagone \
     185                    file_two.tar.gz:tagtwo</programlisting>
     186            </listitem>
     187          </itemizedlist>
     188        </listitem>
     189      </varlistentry>
     190
     191      <varlistentry>
     192        <term>master_sites.mirror_subdir</term>
     193
     194        <listitem>
     195          <para>Subdirectory to append to all mirror sites for any list
     196          specified in <varname>${master_sites}</varname>.</para>
     197
     198          <!-- TODO: add a better explanation -->
     199
     200          <itemizedlist>
     201            <listitem>
     202              <para>Default: <varname>${name}</varname></para>
     203            </listitem>
     204
     205            <listitem>
     206              <para>Example:</para>
     207
     208              <programlisting>master_sites.mirror_subdir  magic</programlisting>
    186209            </listitem>
    187210          </itemizedlist>
     
    204227              <para>Example:</para>
    205228
    206               <programlisting>patch_sites    ftp://ftp.patchcityrepo.com/pub/magic/patches</programlisting>
     229              <programlisting>patch_sites         ftp://ftp.patchcityrepo.com/pub/magic/patches</programlisting>
     230            </listitem>
     231          </itemizedlist>
     232        </listitem>
     233      </varlistentry>
     234
     235      <varlistentry>
     236        <term>patch_sites.mirror_subdir</term>
     237
     238        <listitem>
     239          <para>Subdirectory to append to all mirror sites for any list
     240          specified in <varname>${patch_sites}</varname>.</para>
     241
     242          <!-- TODO: add a better explanation -->
     243
     244          <itemizedlist>
     245            <listitem>
     246              <para>Default: <varname>${name}</varname></para>
     247            </listitem>
     248
     249            <listitem>
     250              <para>Example:</para>
     251
     252              <programlisting>patch_sites.mirror_subdir   magic</programlisting>
    207253            </listitem>
    208254          </itemizedlist>
     
    215261        <listitem>
    216262          <para>The name of the distribution filename, not including the
    217           extract suffix.</para>
     263          extract suffix (see below).</para>
    218264
    219265          <itemizedlist>
     
    225271              <para>Example:</para>
    226272
    227               <programlisting>distname     ${name}</programlisting>
     273              <programlisting>distname            ${name}</programlisting>
    228274            </listitem>
    229275          </itemizedlist>
     
    247293
    248294            <listitem>
    249               <para>Example:</para>
    250 
    251               <programlisting>distfiles    ${name}-dev_src.tgz
    252 
    253 
    254 distfiles       file_one.tar.gz:tagone \
    255                 file_two.tar.gz:tagtwo</programlisting>
     295              <para>Examples:</para>
     296
     297              <programlisting>distfiles           ${name}-dev_src.tgz</programlisting>
     298
     299              <programlisting>distfiles           file_one.tar.gz:tagone \
     300                    file_two.tar.gz:tagtwo</programlisting>
     301            </listitem>
     302          </itemizedlist>
     303        </listitem>
     304      </varlistentry>
     305
     306      <varlistentry>
     307        <term>dist_subdir</term>
     308
     309        <listitem>
     310          <para>Create a sub-directory in distpath to store all fetched
     311          files.</para>
     312
     313          <itemizedlist>
     314            <listitem>
     315              <para>Default: <varname>${name}</varname></para>
     316            </listitem>
     317
     318            <listitem>
     319              <para>Example:</para>
     320
     321              <programlisting>dist_subdir         vim${version}</programlisting>
    256322            </listitem>
    257323          </itemizedlist>
     
    274340              <para>Example:</para>
    275341
    276               <programlisting>extract.suffix   .tgz</programlisting>
     342              <programlisting>extract.suffix      .tgz</programlisting>
    277343            </listitem>
    278344          </itemizedlist>
     
    284350
    285351        <listitem>
    286           <para>This option is used to specify if the directory
     352          <para>This keyword is used to specify if the directory
    287353          <filename>worksrcdir</filename> is part of the distfile or if it
    288354          should be created automatically and the distfiles should be
     
    299365              <para>Example:</para>
    300366
    301               <programlisting>extract.mkdir   yes</programlisting>
     367              <programlisting>extract.mkdir       yes</programlisting>
    302368            </listitem>
    303369          </itemizedlist>
     
    313379
    314380          <literallayout>extract.suffix = .tar.bz
    315 extract.cmd = bzip
     381extract.cmd    = bzip
    316382
    317383</literallayout>
     
    325391              <para>Example:</para>
    326392
    327               <programlisting>use_bzip2     yes</programlisting>
     393              <programlisting>use_bzip2           yes</programlisting>
    328394            </listitem>
    329395          </itemizedlist>
     
    335401
    336402        <listitem>
    337           <para>This keyword is for downloads are zipped. When invoked, it
    338           automatically sets:</para>
    339 
    340           <literallayout>extract.suffix = .zip
    341 extract.cmd = unzip
    342 extract.pre_args = -q
     403          <para>This keyword is for downloads which are zipped. When invoked,
     404          it automatically sets:</para>
     405
     406          <literallayout>extract.suffix    = .zip
     407extract.cmd       = unzip
     408extract.pre_args  = -q
    343409extract.post_args = "-d ${portpath}/${workdir}"
    344410
     
    353419              <para>Example:</para>
    354420
    355               <programlisting>use_zip       yes</programlisting>
     421              <programlisting>use_zip             yes</programlisting>
     422            </listitem>
     423          </itemizedlist>
     424        </listitem>
     425      </varlistentry>
     426
     427      <varlistentry>
     428        <term>worksrcdir</term>
     429
     430        <listitem>
     431          <para>Sets the path to source directory relative to workpath. It can
     432          be used if the extracted source directory has a different name then
     433          the distfile.</para>
     434
     435          <itemizedlist>
     436            <listitem>
     437              <para>Default: <varname>${distname}</varname></para>
     438            </listitem>
     439
     440            <listitem>
     441              <para>Example:</para>
     442
     443              <programlisting>worksrcdir          ${name}-src-${version}</programlisting>
    356444            </listitem>
    357445          </itemizedlist>
     
    360448    </variablelist>
    361449
    362     <section>
    363       <title>Fetch from CVS</title>
    364 
    365       <para><ulink url="http://www.nongnu.org/cvs/">CVS</ulink> may be used
    366       as an alternative method of fetching distribution files using the
    367       keywords in this section. However, fetching via CVS may cause
    368       non-reproducible builds, so it is strongly discouraged.</para>
     450    <section id="reference.phases.fetch.advanced">
     451      <title>Advanced Fetch Options</title>
     452
     453      <para>Some mirrors require special options for a resource to be properly
     454      fetched.</para>
    369455
    370456      <variablelist>
    371457        <varlistentry>
    372           <term>cvs.root</term>
     458          <term>fetch.user</term>
    373459
    374460          <listitem>
    375             <para>Specify the url from which to fetch files.</para>
     461            <para>HTTP or FTP user to fetch the resource.</para>
    376462
    377463            <itemizedlist>
    378464              <listitem>
    379                 <para>Default: none</para>
     465                <para>Default: ???</para>
    380466              </listitem>
    381467
     
    383469                <para>Example:</para>
    384470
    385                 <programlisting>cvs.root :pserver:anonymous@cvs.sv.gnu.org:/sources/emacs</programlisting>
     471                <programlisting>TODO: add example</programlisting>
    386472              </listitem>
    387473            </itemizedlist>
     
    390476
    391477        <varlistentry>
    392           <term>cvs.tag</term>
     478          <term>fetch.password</term>
    393479
    394480          <listitem>
    395             <para>Optional for fetching with CVS, this specifies the code
    396             revision to checkout.</para>
     481            <para>HTTP or FTP password to fetch the resource.</para>
    397482
    398483            <itemizedlist>
    399484              <listitem>
    400                 <para>Default: none</para>
     485                <para>Default: ???</para>
    401486              </listitem>
    402487
     
    404489                <para>Example:</para>
    405490
    406                 <programlisting>cvs.tag  HEAD</programlisting>
     491                <programlisting>TODO: add example</programlisting>
    407492              </listitem>
    408493            </itemizedlist>
     
    411496
    412497        <varlistentry>
    413           <term>cvs.date</term>
     498          <term>fetch.use_epsv</term>
    414499
    415500          <listitem>
    416             <para>A date that identifies the CVS code set to
    417             checkout.</para>
     501            <para>Whether to use EPSV command for FTP transfers.</para>
    418502
    419503            <itemizedlist>
    420504              <listitem>
    421                 <para>Default: none</para>
     505                <para>Default: <option>yes</option></para>
    422506              </listitem>
    423507
     
    425509                <para>Example:</para>
    426510
    427                 <programlisting>cvs.date "12-April-2007"</programlisting>
     511                <programlisting>fetch.use_epsv      no</programlisting>
    428512              </listitem>
    429513            </itemizedlist>
     
    432516
    433517        <varlistentry>
    434           <term>cvs.module</term>
     518          <term>fetch.ignore_sslcert</term>
    435519
    436520          <listitem>
    437             <para>A CVS module from which to check out the code.</para>
     521            <para>Whether to ignore the host SSL certificate (for
     522            HTTPS).</para>
    438523
    439524            <itemizedlist>
    440525              <listitem>
    441                 <para>Default: none</para>
     526                <para>Default: <option>no</option></para>
    442527              </listitem>
    443528
     
    445530                <para>Example:</para>
    446531
    447                 <programlisting>cvs.module  Sources</programlisting>
     532                <programlisting>fetch.ignore_sslcert    yes</programlisting>
    448533              </listitem>
    449534            </itemizedlist>
     
    453538    </section>
    454539
    455     <section>
     540    <section id="reference.phases.fetch.cvs">
     541      <title>Fetch from CVS</title>
     542
     543      <para><ulink url="http://www.nongnu.org/cvs/">CVS</ulink> may be used
     544      as an alternative method of fetching distribution files using the
     545      keywords in this section. However, fetching via CVS may cause
     546      non-reproducible builds, so it is strongly discouraged.</para>
     547
     548      <variablelist>
     549        <varlistentry>
     550          <term>cvs.root</term>
     551
     552          <listitem>
     553            <para>Specify the url from which to fetch files.</para>
     554
     555            <itemizedlist>
     556              <listitem>
     557                <para>Default: none</para>
     558              </listitem>
     559
     560              <listitem>
     561                <para>Example:</para>
     562
     563                <programlisting>cvs.root            :pserver:anonymous@cvs.sv.gnu.org:/sources/emacs</programlisting>
     564              </listitem>
     565            </itemizedlist>
     566          </listitem>
     567        </varlistentry>
     568
     569        <varlistentry>
     570          <term>cvs.tag</term>
     571
     572          <listitem>
     573            <para>Optional for fetching with CVS, this specifies the code
     574            revision to checkout.</para>
     575
     576            <itemizedlist>
     577              <listitem>
     578                <para>Default: none</para>
     579              </listitem>
     580
     581              <listitem>
     582                <para>Example:</para>
     583
     584                <programlisting>cvs.tag             HEAD</programlisting>
     585              </listitem>
     586            </itemizedlist>
     587          </listitem>
     588        </varlistentry>
     589
     590        <varlistentry>
     591          <term>cvs.date</term>
     592
     593          <listitem>
     594            <para>A date that identifies the CVS code set to
     595            checkout.</para>
     596
     597            <itemizedlist>
     598              <listitem>
     599                <para>Default: none</para>
     600              </listitem>
     601
     602              <listitem>
     603                <para>Example:</para>
     604
     605                <programlisting>cvs.date            "12-April-2007"</programlisting>
     606              </listitem>
     607            </itemizedlist>
     608          </listitem>
     609        </varlistentry>
     610
     611        <varlistentry>
     612          <term>cvs.module</term>
     613
     614          <listitem>
     615            <para>A CVS module from which to check out the code.</para>
     616
     617            <itemizedlist>
     618              <listitem>
     619                <para>Default: none</para>
     620              </listitem>
     621
     622              <listitem>
     623                <para>Example:</para>
     624
     625                <programlisting>cvs.module          Sources</programlisting>
     626              </listitem>
     627            </itemizedlist>
     628          </listitem>
     629        </varlistentry>
     630      </variablelist>
     631    </section>
     632
     633    <section id="reference.phases.fetch.svn">
    456634      <title>Fetch from Subversion</title>
    457635
     
    477655                <para>Examples:</para>
    478656
    479                 <programlisting>svn.url http://www.domain.com/svn-repo/mydirectory
    480 svn.url svn://www.domain.com/svn-repo/mydirectory
    481 </programlisting>
     657                <programlisting>svn.url             http://www.domain.com/svn-repo/mydirectory</programlisting>
     658
     659                <programlisting>svn.url             svn://www.domain.com/svn-repo/mydirectory</programlisting>
    482660              </listitem>
    483661            </itemizedlist>
     
    491669            <para>Optional tag for fetching with Subversion, this specifies
    492670            the code revision to checkout; it corresponds to the -r option
    493             in the svn cli. You must use backslashes to escape characters
    494             that are meaningful to the Tcl interpreter, such as braces and
    495             double quotes.</para>
     671            in the svn cli.</para>
    496672
    497673            <itemizedlist>
     
    501677
    502678              <listitem>
    503                 <para>Examples:</para>
    504 
    505                 <programlisting>svn.tag 37192
    506 svn.tag \{\"2006-02-17 15:30 +0230\"\}</programlisting>
     679                <para>Example:</para>
     680
     681                <programlisting>svn.tag             37192</programlisting>
    507682              </listitem>
    508683            </itemizedlist>
     
    513688  </section>
    514689
    515   <section>
     690  <section id="reference.phases.checksum">
    516691    <title>Checksum Phase Keywords</title>
    517692
     
    526701          multiple distribution files, filenames must be included to
    527702          associate files with their checksums.</para>
     703          <para>All checksum types (md5, sha1 and rdm160) should be used to
     704          ensure the integrity of the distfiles.</para>
    528705
    529706          <itemizedlist>
     
    535712              <para>Examples:</para>
    536713
    537               <programlisting>checksums     md5 dafa161bc9c61e57636a6085c87c1fe8 \
    538               sha1 5da610e1c8bc01b80abc21ab9e98e004363b429c \
    539               rmd160 0c1147242adf476f5e93f4d59b553ee3ea378b23</programlisting>
    540 
    541               <programlisting>checksums     ${distname}${extract.suffix} md5 dafa161bc9c61e57636a6085c87c1fe8 \
    542                   sha1 5da610e1c8bc01b80abc21ab9e98e004363b429c \
    543                   rmd160 0c1147242adf476f5e93f4d59b553ee3ea378b23 \
    544               hobbit.tar.gz md5 3b8d02c6cf6239b9bdadbc6543c5a683 \
    545                   sha1 27874638b23e66d39ed94fe716ca25c967f6e993 \
    546                   rmd160 82b9991f3bf0ceedbf74c188c5fa44b98b5e40c9</programlisting>
     714              <programlisting>checksums           md5 dafa161bc9c61e57636a6085c87c1fe8 \
     715                    sha1 5da610e1c8bc01b80abc21ab9e98e004363b429c \
     716                    rmd160 0c1147242adf476f5e93f4d59b553ee3ea378b23</programlisting>
     717
     718              <programlisting>checksums           ${distname}${extract.suffix} \
     719                        md5 dafa161bc9c61e57636a6085c87c1fe8 \
     720                        sha1 5da610e1c8bc01b80abc21ab9e98e004363b429c \
     721                        rmd160 0c1147242adf476f5e93f4d59b553ee3ea378b23 \
     722                    hobbit.tar.gz \
     723                        md5 3b8d02c6cf6239b9bdadbc6543c5a683 \
     724                        sha1 27874638b23e66d39ed94fe716ca25c967f6e993 \
     725                        rmd160 82b9991f3bf0ceedbf74c188c5fa44b98b5e40c9</programlisting>
    547726            </listitem>
    548727          </itemizedlist>
     
    552731  </section>
    553732
    554   <section>
     733  <section id="reference.phases.extract">
    555734    <title>Extract Phase Keywords</title>
    556735
     
    567746        <listitem>
    568747          <para>List of files to extract into
    569           <varname>${worksrcpath}</varname>; the default is
    570           <varname>${distfiles}</varname>. Only use if default extract
     748          <varname>${worksrcpath}</varname>. Only use if default extract
    571749          behavior is not correct for your port.</para>
    572750
    573751          <itemizedlist>
    574752            <listitem>
    575               <para>Default: none</para>
    576             </listitem>
    577 
    578             <listitem>
    579               <para>Example:</para>
    580 
    581               <programlisting>extract.only     foo.tar.gz
    582 
    583 </programlisting>
    584             </listitem>
    585           </itemizedlist>
    586         </listitem>
    587 
    588         <listitem>
    589           <para>List modifier examples:</para>
    590 
    591           <programlisting>extract.only-append  bar.tar.gz
    592 extract.only-delete  foo.tar.gz</programlisting>
     753              <para>Default: <varname>${distfiles}</varname></para>
     754            </listitem>
     755
     756            <listitem>
     757              <para>Example:</para>
     758
     759              <programlisting>extract.only        foo.tar.gz</programlisting>
     760              <programlisting>extract.only-append     bar.tar.gz
     761extract.only-delete     foo.tar.gz</programlisting>
     762            </listitem>
     763          </itemizedlist>
    593764        </listitem>
    594765      </varlistentry>
     
    602773          <itemizedlist>
    603774            <listitem>
    604               <para>Default: gzip</para>
    605             </listitem>
    606 
    607             <listitem>
    608               <para>Example:</para>
    609 
    610               <programlisting>extract.cmd     gunzip</programlisting>
     775              <para>Default: <command>gzip</command></para>
     776            </listitem>
     777
     778            <listitem>
     779              <para>Example:</para>
     780
     781              <programlisting>extract.cmd         gunzip</programlisting>
    611782            </listitem>
    612783          </itemizedlist>
     
    627798          <itemizedlist>
    628799            <listitem>
    629               <para>Default: ${distpath}/${distfile}</para>
    630             </listitem>
    631 
    632             <listitem>
    633               <para>Example:</para>
    634 
    635               <programlisting>extract.args      ${distpath}/${distfile}
     800              <para>Default: <varname>${distpath}/${distfile}</varname></para>
     801            </listitem>
     802
     803            <listitem>
     804              <para>Example:</para>
     805
     806              <programlisting>extract.args        ${distpath}/${distfile}
    636807
    637808</programlisting>
     
    645816          <itemizedlist>
    646817            <listitem>
    647               <para>extract.pre_args default: "-dc"</para>
    648             </listitem>
    649 
    650             <listitem>
    651               <para>extract.post_args default: " | tar -xf"</para>
     818              <para><literal>extract.pre_args</literal>, defaults to:
     819              <literal>-dc</literal></para>
     820            </listitem>
     821
     822            <listitem>
     823              <para><literal>extract.post_args</literal>, defaults to:
     824              <literal>"| tar -xf"</literal></para>
    652825            </listitem>
    653826
     
    655828              <para>Examples:</para>
    656829
    657               <programlisting>extract.pre_args     xf
    658 extract.post_args    "| gnutar –x"</programlisting>
     830              <programlisting>extract.pre_args    xf
     831extract.post_args   "| gnutar –x"</programlisting>
    659832            </listitem>
    660833          </itemizedlist>
     
    664837  </section>
    665838
    666   <section>
     839  <section id="reference.phases.patch">
    667840    <title>Patch Phase Keywords</title>
    668841
     
    684857              <para>Example:</para>
    685858
    686               <programlisting>patch.dir      ${worksrcpath}/util</programlisting>
     859              <programlisting>patch.dir           ${worksrcpath}/util</programlisting>
    687860            </listitem>
    688861          </itemizedlist>
     
    704877              <para>Example:</para>
    705878
    706               <programlisting>patch.cmd      cat</programlisting>
     879              <programlisting>patch.cmd           cat</programlisting>
    707880            </listitem>
    708881          </itemizedlist>
     
    730903              <para>Example:</para>
    731904
    732               <programlisting>patchfiles     patch-Makefile.in \
    733                patch-source.c
    734 
    735 </programlisting>
    736             </listitem>
    737           </itemizedlist>
    738         </listitem>
    739 
    740         <listitem>
    741           <para>List modifier examples:</para>
    742 
    743           <programlisting>patchfiles-append   patch-configure
    744 patchfiles-delete   patch-src-Makefile.in
    745 </programlisting>
     905              <programlisting>patchfiles          patch-Makefile.in \
     906                    patch-source.c</programlisting>
     907              <programlisting>patchfiles-append   patch-configure
     908patchfiles-delete   patch-src-Makefile.in</programlisting>
     909            </listitem>
     910          </itemizedlist>
    746911        </listitem>
    747912      </varlistentry>
     
    766931              <para>Example:</para>
    767932
    768               <programlisting>patch.args   ???
     933              <programlisting>patch.args          ???
    769934
    770935</programlisting>
     
    778943          <itemizedlist>
    779944            <listitem>
    780               <para>patch.pre_args default: -p0</para>
    781             </listitem>
    782 
    783             <listitem>
    784               <para>patch.post_args default: none</para>
     945              <para><literal>patch.pre_args</literal>, defaults to:
     946              <literal>-p0</literal></para>
     947            </listitem>
     948
     949            <listitem>
     950              <para><literal>patch.post_args</literal>, defaults to:
     951              none</para>
    785952            </listitem>
    786953
     
    788955              <para>Examples:</para>
    789956
    790               <programlisting>patch.pre_args     -p1
    791 patch.post_args    ???</programlisting>
     957              <programlisting>patch.pre_args      -p1
     958patch.post_args     ???</programlisting>
    792959            </listitem>
    793960          </itemizedlist>
     
    797964  </section>
    798965
    799   <section>
     966  <section id="reference.phases.configure">
    800967    <title>Configure Phase Keywords</title>
    801968
     
    811978    <variablelist>
    812979      <varlistentry>
     980        <term>use_configure</term>
     981
     982        <listitem>
     983          <para>Sets if the configure phase should be run.</para>
     984
     985          <itemizedlist>
     986            <listitem>
     987              <para>Default: <option>yes</option></para>
     988            </listitem>
     989
     990            <listitem>
     991              <para>Example:</para>
     992
     993              <programlisting>use_configure    no</programlisting>
     994            </listitem>
     995          </itemizedlist>
     996        </listitem>
     997      </varlistentry>
     998
     999      <varlistentry>
    8131000        <term>configure.env</term>
    8141001
     
    8221009          or a default set by MacPorts base. If available, it is encouraged
    8231010          to use the predefined options (like configure.cflags) instead of
    824           modifying configure.env directly</para>
     1011          modifying configure.env directly.</para>
    8251012
    8261013          <itemizedlist>
     
    8331020              <para>Example:</para>
    8341021
    835               <programlisting>configure.env   QTDIR=${prefix}/lib/qt3
    836 </programlisting>
    837             </listitem>
    838           </itemizedlist>
    839         </listitem>
    840 
    841         <listitem>
    842           <para>List modifier examples:</para>
    843 
    844           <programlisting>configure.env-append   ABI=32
    845 configure.env-delete   TCLROOT=${prefix}</programlisting>
     1022              <programlisting>configure.env       QTDIR=${prefix}/lib/qt3</programlisting>
     1023              <programlisting>configure.env-append    ABI=32
     1024configure.env-delete    TCLROOT=${prefix}</programlisting>
     1025            </listitem>
     1026          </itemizedlist>
    8461027        </listitem>
    8471028      </varlistentry>
     
    8671048              <para>Example:</para>
    8681049
    869               <programlisting>configure.cflags    -Os -flat_namespace
    870 
    871 </programlisting>
    872             </listitem>
    873           </itemizedlist>
    874         </listitem>
    875 
    876         <listitem>
    877           <para>List modifier examples:</para>
    878 
    879           <programlisting>configure.cflags-append   "-undefined suppress"
    880 configure.cflags-delete   -O2</programlisting>
     1050              <programlisting>configure.cflags    -Os -flat_namespace</programlisting>
     1051              <programlisting>configure.cflags-append     "-undefined suppress"
     1052configure.cflags-delete     -O2</programlisting>
     1053            </listitem>
     1054          </itemizedlist>
    8811055        </listitem>
    8821056      </varlistentry>
     
    9021076              <para>Example:</para>
    9031077
    904               <programlisting>configure.ldflags    -L${worksrcpath}/zlib -lz
    905 
    906 </programlisting>
    907             </listitem>
    908           </itemizedlist>
    909         </listitem>
    910 
    911         <listitem>
    912           <para>List modifier examples:</para>
    913 
    914           <programlisting>configure.ldflags-append   "-L/usr/X11R6/lib -L${worksrcpath}/lib"
    915 configure.ldflags-delete   -L${prefix}/lib/db44</programlisting>
     1078              <programlisting>configure.ldflags   "-L${worksrcpath}/zlib -lz"</programlisting>
     1079              <programlisting>configure.ldflags-append    "-L/usr/X11R6/lib -L${worksrcpath}/lib"
     1080configure.ldflags-delete    -L${prefix}/lib/db44</programlisting>
     1081            </listitem>
     1082          </itemizedlist>
    9161083        </listitem>
    9171084      </varlistentry>
     
    9371104              <para>Example:</para>
    9381105
    939               <programlisting>configure.cppflags    -I${worksrcpath}/include
    940 
    941 </programlisting>
    942             </listitem>
    943           </itemizedlist>
    944         </listitem>
    945 
    946         <listitem>
    947           <para>List modifier examples:</para>
    948 
    949           <programlisting>configure.cppflags-append   "-I/usr/X11R6/lib -I${worksrcpath}/lib -DHAVE_RRD_12X"
     1106              <programlisting>configure.cppflags  -I${worksrcpath}/include</programlisting>
     1107              <programlisting>configure.cppflags-append   "-I/usr/X11R6/lib -I${worksrcpath}/lib -DHAVE_RRD_12X"
    9501108configure.cppflags-delete   -I${prefix}/lib/db44</programlisting>
     1109            </listitem>
     1110          </itemizedlist>
     1111        </listitem>
     1112      </varlistentry>
     1113
     1114      <varlistentry>
     1115        <term>configure.cxxflags</term>
     1116
     1117        <term>configure.cxxflags-append</term>
     1118
     1119        <term>configure.cxxflags-delete</term>
     1120
     1121        <listitem>
     1122          <para>Set CXXFLAGS to be passed to the C++ processor; list modifiers
     1123          add or delete items from a previous Portfile configure.cxxflags
     1124          keyword or the default set by MacPorts base.</para>
     1125
     1126          <itemizedlist>
     1127            <listitem>
     1128              <para>Default: <literal>-O2</literal></para>
     1129            </listitem>
     1130
     1131            <listitem>
     1132              <para>Example:</para>
     1133
     1134              <programlisting>TODO: add example</programlisting>
     1135            </listitem>
     1136          </itemizedlist>
     1137        </listitem>
     1138      </varlistentry>
     1139
     1140      <varlistentry>
     1141        <term>configure.objcflags</term>
     1142
     1143        <term>configure.objcflags-append</term>
     1144
     1145        <term>configure.objcflags-delete</term>
     1146
     1147        <listitem>
     1148          <para>TODO: add description</para>
     1149
     1150          <itemizedlist>
     1151            <listitem>
     1152              <para>Default: <literal>-O2</literal></para>
     1153            </listitem>
     1154
     1155            <listitem>
     1156              <para>Example:</para>
     1157
     1158              <programlisting>TODO: add example</programlisting>
     1159            </listitem>
     1160          </itemizedlist>
     1161        </listitem>
     1162      </varlistentry>
     1163
     1164      <varlistentry>
     1165        <term>configure.classpath</term>
     1166
     1167        <term>configure.classpath-append</term>
     1168
     1169        <term>configure.classpath-delete</term>
     1170
     1171        <listitem>
     1172          <para>TODO: add description</para>
     1173
     1174          <itemizedlist>
     1175            <listitem>
     1176              <para>Default: ???</para>
     1177            </listitem>
     1178
     1179            <listitem>
     1180              <para>Example:</para>
     1181
     1182              <programlisting>TODO: add example</programlisting>
     1183            </listitem>
     1184          </itemizedlist>
     1185        </listitem>
     1186      </varlistentry>
     1187
     1188      <varlistentry>
     1189        <term>configure.macosx_deployment_target</term>
     1190
     1191        <term>configure.macosx_deployment_target-append</term>
     1192
     1193        <term>configure.macosx_deployment_target-delete</term>
     1194
     1195        <listitem>
     1196          <para>TODO: add description</para>
     1197
     1198          <itemizedlist>
     1199            <listitem>
     1200              <para>Default: ???</para>
     1201            </listitem>
     1202
     1203            <listitem>
     1204              <para>Example:</para>
     1205
     1206              <programlisting>TODO: add example</programlisting>
     1207            </listitem>
     1208          </itemizedlist>
    9511209        </listitem>
    9521210      </varlistentry>
     
    9751233              <para>Example:</para>
    9761234
    977               <programlisting>configure.fflags    -Os
    978 
    979 </programlisting>
     1235              <programlisting>configure.fflags    -Os</programlisting>
    9801236            </listitem>
    9811237          </itemizedlist>
     
    10041260              <para>Example:</para>
    10051261
    1006               <programlisting>configure.fcflags    -Os
    1007 
    1008 </programlisting>
     1262              <programlisting>configure.fcflags   -Os</programlisting>
    10091263            </listitem>
    10101264          </itemizedlist>
     
    10331287              <para>Example:</para>
    10341288
    1035               <programlisting>configure.f90flags    -Os
    1036 
    1037 </programlisting>
     1289              <programlisting>configure.f90flags  -Os</programlisting>
    10381290            </listitem>
    10391291          </itemizedlist>
     
    10491301
    10501302        <listitem>
    1051           <para>Set CC compiler flags for selecting a C compiler;</para>
    1052 
    1053           <itemizedlist>
    1054             <listitem>
    1055               <para>Default: <literal></literal></para>
    1056             </listitem>
    1057 
    1058             <listitem>
    1059               <para>Example:</para>
    1060 
    1061               <programlisting>configure.cc    ${prefix}/bin/gcc-mp-4.2</programlisting>
     1303          <para>Set CC compiler flags for selecting a C compiler.</para>
     1304
     1305          <itemizedlist>
     1306            <listitem>
     1307              <para>Default: <literal>???</literal></para>
     1308            </listitem>
     1309
     1310            <listitem>
     1311              <para>Example:</para>
     1312
     1313              <programlisting>configure.cc        ${prefix}/bin/gcc-mp-4.2</programlisting>
    10621314            </listitem>
    10631315          </itemizedlist>
     
    10701322        <listitem>
    10711323          <para>Set CPP compiler flags for selecting a C
    1072           preprocessor;</para>
    1073 
    1074           <itemizedlist>
    1075             <listitem>
    1076               <para>Default: <literal></literal></para>
    1077             </listitem>
    1078 
    1079             <listitem>
    1080               <para>Example:</para>
    1081 
    1082               <programlisting>configure.cpp    /usr/bin/cpp-3.3</programlisting>
     1324          preprocessor.</para>
     1325
     1326          <itemizedlist>
     1327            <listitem>
     1328              <para>Default: <literal>???</literal></para>
     1329            </listitem>
     1330
     1331            <listitem>
     1332              <para>Example:</para>
     1333
     1334              <programlisting>configure.cpp       /usr/bin/cpp-3.3</programlisting>
    10831335            </listitem>
    10841336          </itemizedlist>
     
    10901342
    10911343        <listitem>
    1092           <para>Set CXX compiler flags for selecting a C++ compiler;</para>
    1093 
    1094           <itemizedlist>
    1095             <listitem>
    1096               <para>Default: <literal></literal></para>
    1097             </listitem>
    1098 
    1099             <listitem>
    1100               <para>Example:</para>
    1101 
    1102               <programlisting>configure.cpp    /usr/bin/g++-4.0</programlisting>
     1344          <para>Set CXX compiler flags for selecting a C++ compiler.</para>
     1345
     1346          <itemizedlist>
     1347            <listitem>
     1348              <para>Default: <literal>???</literal></para>
     1349            </listitem>
     1350
     1351            <listitem>
     1352              <para>Example:</para>
     1353
     1354              <programlisting>configure.cxx       /usr/bin/g++-4.0</programlisting>
    11031355            </listitem>
    11041356          </itemizedlist>
     
    11111363        <listitem>
    11121364          <para>Set OBJC compiler flags for selecting an Objective-C
    1113           compiler;</para>
    1114 
    1115           <itemizedlist>
    1116             <listitem>
    1117               <para>Default: <literal></literal></para>
    1118             </listitem>
    1119 
    1120             <listitem>
    1121               <para>Example:</para>
    1122 
    1123               <programlisting>configure.objc    /usr/bin/gcc-4.0</programlisting>
     1365          compiler.</para>
     1366
     1367          <itemizedlist>
     1368            <listitem>
     1369              <para>Default: <literal>???</literal></para>
     1370            </listitem>
     1371
     1372            <listitem>
     1373              <para>Example:</para>
     1374
     1375              <programlisting>configure.objc      /usr/bin/gcc-4.0</programlisting>
    11241376            </listitem>
    11251377          </itemizedlist>
     
    11321384        <listitem>
    11331385          <para>Set FC compiler flags for selecting a Fortran
    1134           compiler;</para>
    1135 
    1136           <itemizedlist>
    1137             <listitem>
    1138               <para>Default: <literal></literal></para>
    1139             </listitem>
    1140 
    1141             <listitem>
    1142               <para>Example:</para>
    1143 
    1144               <programlisting>configure.fc    ${prefix}/bin/gfortran-mp-4.2</programlisting>
     1386          compiler.</para>
     1387
     1388          <itemizedlist>
     1389            <listitem>
     1390              <para>Default: <literal>???</literal></para>
     1391            </listitem>
     1392
     1393            <listitem>
     1394              <para>Example:</para>
     1395
     1396              <programlisting>configure.fc        ${prefix}/bin/gfortran-mp-4.2</programlisting>
    11451397            </listitem>
    11461398          </itemizedlist>
     
    11531405        <listitem>
    11541406          <para>Set F77 compiler flags for selecting a Fortran 77
    1155           compiler;</para>
    1156 
    1157           <itemizedlist>
    1158             <listitem>
    1159               <para>Default: <literal></literal></para>
    1160             </listitem>
    1161 
    1162             <listitem>
    1163               <para>Example:</para>
    1164 
    1165               <programlisting>configure.f77    ${prefix}/bin/gfortran-mp-4.2</programlisting>
     1407          compiler.</para>
     1408
     1409          <itemizedlist>
     1410            <listitem>
     1411              <para>Default: <literal>???</literal></para>
     1412            </listitem>
     1413
     1414            <listitem>
     1415              <para>Example:</para>
     1416
     1417              <programlisting>configure.f77       ${prefix}/bin/gfortran-mp-4.2</programlisting>
    11661418            </listitem>
    11671419          </itemizedlist>
     
    11741426        <listitem>
    11751427          <para>Set F90 compiler flags for selecting a Fortran 90
    1176           compiler;</para>
    1177 
    1178           <itemizedlist>
    1179             <listitem>
    1180               <para>Default: <literal></literal></para>
    1181             </listitem>
    1182 
    1183             <listitem>
    1184               <para>Example:</para>
    1185 
    1186               <programlisting>configure.f90    ${prefix}/bin/gfortran-mp-4.2</programlisting>
     1428          compiler.</para>
     1429
     1430          <itemizedlist>
     1431            <listitem>
     1432              <para>Default: <literal>???</literal></para>
     1433            </listitem>
     1434
     1435            <listitem>
     1436              <para>Example:</para>
     1437
     1438              <programlisting>configure.f90       ${prefix}/bin/gfortran-mp-4.2</programlisting>
    11871439            </listitem>
    11881440          </itemizedlist>
     
    11951447        <listitem>
    11961448          <para>Set JAVAC compiler flags for selecting a Java
    1197           compiler;</para>
    1198 
    1199           <itemizedlist>
    1200             <listitem>
    1201               <para>Default: <literal></literal></para>
    1202             </listitem>
    1203 
    1204             <listitem>
    1205               <para>Example:</para>
    1206 
    1207               <programlisting>configure.javac    ${prefix}/bin/jikes</programlisting>
     1449          compiler.</para>
     1450
     1451          <itemizedlist>
     1452            <listitem>
     1453              <para>Default: <literal>???</literal></para>
     1454            </listitem>
     1455
     1456            <listitem>
     1457              <para>Example:</para>
     1458
     1459              <programlisting>configure.javac     ${prefix}/bin/jikes</programlisting>
    12081460            </listitem>
    12091461          </itemizedlist>
     
    12241476          <itemizedlist>
    12251477            <listitem>
    1226               <para>Default: <literal>gcc-3.3</literal>Mac OS X 10.3</para>
    1227 
    1228               <para>Default: <literal>gcc-4.0</literal>Mac OS X 10.4,
     1478              <para>Default: <literal>gcc-3.3</literal> on Mac OS X
     1479              10.3</para>
     1480            </listitem>
     1481            <listitem>
     1482              <para>Default: <literal>gcc-4.0</literal> on Mac OS X 10.4 and
    12291483              10.5</para>
    12301484            </listitem>
    12311485
    12321486            <listitem>
     1487              <!-- TODO: should this be Options or renamed? -->
    12331488              <para>Options:</para>
    12341489
     
    12391494              <para>Example:</para>
    12401495
    1241               <programlisting>configure.compiler    macports-gcc-4.2</programlisting>
     1496              <programlisting>configure.compiler  macports-gcc-4.2</programlisting>
    12421497            </listitem>
    12431498          </itemizedlist>
     
    12531508
    12541509        <listitem>
    1255           <para>Set PERL flag for selecting a Perl interpreter;</para>
    1256 
    1257           <itemizedlist>
    1258             <listitem>
    1259               <para>Default: <literal></literal></para>
    1260             </listitem>
    1261 
    1262             <listitem>
    1263               <para>Example:</para>
    1264 
    1265               <programlisting>configure.perl    ${prefix}/bin/perl5.8</programlisting>
     1510          <para>Set PERL flag for selecting a Perl interpreter.</para>
     1511
     1512          <itemizedlist>
     1513            <listitem>
     1514              <para>Default: <literal>???</literal></para>
     1515            </listitem>
     1516
     1517            <listitem>
     1518              <para>Example:</para>
     1519
     1520              <programlisting>configure.perl      ${prefix}/bin/perl5.8</programlisting>
    12661521            </listitem>
    12671522          </itemizedlist>
     
    12731528
    12741529        <listitem>
    1275           <para>Set PYTHON flag for selecting a Python interpreter;</para>
    1276 
    1277           <itemizedlist>
    1278             <listitem>
    1279               <para>Default: <literal></literal></para>
     1530          <para>Set PYTHON flag for selecting a Python interpreter.</para>
     1531
     1532          <itemizedlist>
     1533            <listitem>
     1534              <para>Default: <literal>???</literal></para>
    12801535            </listitem>
    12811536
     
    12931548
    12941549        <listitem>
    1295           <para>Set RUBY flag for selecting a Ruby interpreter;</para>
    1296 
    1297           <itemizedlist>
    1298             <listitem>
    1299               <para>Default: <literal></literal></para>
    1300             </listitem>
    1301 
    1302             <listitem>
    1303               <para>Example:</para>
    1304 
    1305               <programlisting>configure.ruby    ${prefix}/bin/ruby</programlisting>
     1550          <para>Set RUBY flag for selecting a Ruby interpreter.</para>
     1551
     1552          <itemizedlist>
     1553            <listitem>
     1554              <para>Default: <literal>???</literal></para>
     1555            </listitem>
     1556
     1557            <listitem>
     1558              <para>Example:</para>
     1559
     1560              <programlisting>configure.ruby      ${prefix}/bin/ruby</programlisting>
    13061561            </listitem>
    13071562          </itemizedlist>
     
    13181573        <listitem>
    13191574          <para>Set INSTALL flag for selecting an install tool; used for
    1320           copying files and creating directories</para>
     1575          copying files and creating directories.</para>
    13211576
    13221577          <itemizedlist>
     
    13281583              <para>Example:</para>
    13291584
    1330               <programlisting>configure.install    ${prefix}/bin/ginstall</programlisting>
     1585              <programlisting>configure.install   ${prefix}/bin/ginstall</programlisting>
    13311586            </listitem>
    13321587          </itemizedlist>
     
    13381593
    13391594        <listitem>
    1340           <para>Set AWK flag for selecting an awk executable</para>
    1341 
    1342           <itemizedlist>
    1343             <listitem>
    1344               <para>Default: <literal></literal></para>
    1345             </listitem>
    1346 
    1347             <listitem>
    1348               <para>Example:</para>
    1349 
    1350               <programlisting>configure.awk    ${prefix}/bin/gawk</programlisting>
     1595          <para>Set AWK flag for selecting an awk executable.</para>
     1596
     1597          <itemizedlist>
     1598            <listitem>
     1599              <para>Default: <literal>???</literal></para>
     1600            </listitem>
     1601
     1602            <listitem>
     1603              <para>Example:</para>
     1604
     1605              <programlisting>configure.awk       ${prefix}/bin/gawk</programlisting>
    13511606            </listitem>
    13521607          </itemizedlist>
     
    13591614        <listitem>
    13601615          <para>Set BISON flag for selecting a bison executable, a parser
    1361           generator</para>
    1362 
    1363           <itemizedlist>
    1364             <listitem>
    1365               <para>Default: <literal></literal></para>
    1366             </listitem>
    1367 
    1368             <listitem>
    1369               <para>Example:</para>
    1370 
    1371               <programlisting>configure.bison    /usr/bin/bison</programlisting>
     1616          generator.</para>
     1617
     1618          <itemizedlist>
     1619            <listitem>
     1620              <para>Default: <literal>???</literal></para>
     1621            </listitem>
     1622
     1623            <listitem>
     1624              <para>Example:</para>
     1625
     1626              <programlisting>configure.bison     /usr/bin/bison</programlisting>
    13721627            </listitem>
    13731628          </itemizedlist>
     
    13841639          <itemizedlist>
    13851640            <listitem>
    1386               <para>Default: <literal></literal></para>
     1641              <para>Default: <literal>???</literal></para>
    13871642            </listitem>
    13881643
     
    14051660          <itemizedlist>
    14061661            <listitem>
    1407               <para>Default: <literal></literal></para>
    1408             </listitem>
    1409 
    1410             <listitem>
    1411               <para>Example:</para>
    1412 
    1413               <programlisting>configure.pkg_config_path    ${prefix}/lib/pkgconfig:${x11prefix}/lib/pkgconfig</programlisting>
     1662              <para>Default: <literal>???</literal></para>
     1663            </listitem>
     1664
     1665            <listitem>
     1666              <para>Example:</para>
     1667
     1668              <programlisting>configure.pkg_config_path   ${prefix}/lib/pkgconfig:${x11prefix}/lib/pkgconfig</programlisting>
    14141669            </listitem>
    14151670          </itemizedlist>
     
    14381693              <para>Example:</para>
    14391694
    1440               <programlisting>configure.args    --bindir=${prefix}/bin
     1695              <programlisting>configure.args      --bindir=${prefix}/bin
    14411696
    14421697</programlisting>
     
    14501705          <itemizedlist>
    14511706            <listitem>
    1452               <para>configure.pre_args default: --prefix=${prefix}</para>
    1453             </listitem>
    1454 
    1455             <listitem>
    1456               <para>configure.post_args default: none</para>
     1707              <para><literal>configure.pre_args</literal>, defaults to:
     1708              <literal>--prefix=${prefix}</literal></para>
     1709            </listitem>
     1710
     1711            <listitem>
     1712              <para><literal>configure.post_args</literal>, defaults to:
     1713              none</para>
    14571714            </listitem>
    14581715
     
    14601717              <para>Examples:</para>
    14611718
    1462               <programlisting>configure.pre_args   --prefix=${prefix}/share/bro
    1463 configure.post_args  OPT="-D__DARWIN_UNIX03"</programlisting>
     1719              <programlisting>configure.pre_args  --prefix=${prefix}/share/bro
     1720configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
    14641721            </listitem>
    14651722          </itemizedlist>
     
    14681725    </variablelist>
    14691726
    1470     <section>
     1727    <section id="reference.phases.configure.universal">
    14711728      <title>Configure Universal</title>
    14721729
     
    14911748            <itemizedlist>
    14921749              <listitem>
    1493                 <para>Default: --disable-dependency-tracking</para>
     1750                <para>Default:
     1751                <literal>--disable-dependency-tracking</literal></para>
    14941752              </listitem>
    14951753
     
    14971755                <para>Example:</para>
    14981756
    1499                 <programlisting></programlisting>
     1757                <programlisting>TODO: add example</programlisting>
    15001758              </listitem>
    15011759            </itemizedlist>
     
    15121770            <itemizedlist>
    15131771              <listitem>
    1514                 <para>Default: -sysroot /Developer/SDKs/MacOSX10.4u.sdk
    1515                 -arch i386 -arch ppc</para>
     1772                <para>Default: <literal>-sysroot
     1773                /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
     1774                ppc</literal></para>
    15161775              </listitem>
    15171776
     
    15191778                <para>Example:</para>
    15201779
    1521                 <programlisting></programlisting>
     1780                <programlisting>TODO: add example</programlisting>
    15221781              </listitem>
    15231782            </itemizedlist>
     
    15341793            <itemizedlist>
    15351794              <listitem>
    1536                 <para>Default: ???</para>
     1795                <para>Default: <literal>???</literal></para>
    15371796              </listitem>
    15381797
     
    15401799                <para>Example:</para>
    15411800
    1542                 <programlisting></programlisting>
     1801                <programlisting>TODO: add example</programlisting>
    15431802              </listitem>
    15441803            </itemizedlist>
     
    15551814            <itemizedlist>
    15561815              <listitem>
    1557                 <para>Default: -isysroot /Developer/SDKs/MacOSX10.4u.sdk
    1558                 -arch i386 -arch ppc</para>
     1816                <para>Default: <literal>-isysroot
     1817                /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
     1818                ppc</literal></para>
    15591819              </listitem>
    15601820
     
    15621822                <para>Example:</para>
    15631823
    1564                 <programlisting></programlisting>
     1824                <programlisting>TODO: add example</programlisting>
    15651825              </listitem>
    15661826            </itemizedlist>
     
    15771837            <itemizedlist>
    15781838              <listitem>
    1579                 <para>Default: -arch i386 -arch ppc</para>
     1839                <para>Default: <literal>-arch i386 -arch ppc</literal></para>
    15801840              </listitem>
    15811841
     
    15831843                <para>Example:</para>
    15841844
    1585                 <programlisting></programlisting>
     1845                <programlisting>TODO: add example</programlisting>
    15861846              </listitem>
    15871847            </itemizedlist>
     
    15911851    </section>
    15921852
    1593     <section>
     1853    <section id="reference.phases.configure.automake-autoconf">
    15941854      <title>Automake and Autoconf</title>
    15951855
     
    16021862
    16031863          <listitem>
    1604             <para>Whether or not to use automake; the default is
    1605             "no".</para>
    1606 
    1607             <programlisting>use_automake      yes</programlisting>
     1864            <para>Whether or not to use automake.</para>
     1865
     1866            <itemizedlist>
     1867              <listitem>
     1868                <para>Default: <option>no</option></para>
     1869              </listitem>
     1870
     1871              <listitem>
     1872                <para>Example:</para>
     1873
     1874                <programlisting>use_automake        yes</programlisting>
     1875              </listitem>
     1876            </itemizedlist>
    16081877          </listitem>
    16091878        </varlistentry>
     
    16151884            <para>Environment variables to pass to automake.</para>
    16161885
    1617             <programlisting>automake.env      CFLAGS=-I${prefix}/include</programlisting>
     1886            <itemizedlist>
     1887              <listitem>
     1888                <para>Default: ???</para>
     1889              </listitem>
     1890
     1891              <listitem>
     1892                <para>Example:</para>
     1893
     1894                <programlisting>automake.env        CFLAGS=-I${prefix}/include</programlisting>
     1895              </listitem>
     1896            </itemizedlist>
    16181897          </listitem>
    16191898        </varlistentry>
     
    16251904            <para>Arguments to pass to automake.</para>
    16261905
    1627             <programlisting>automake.args     --foreign</programlisting>
     1906            <itemizedlist>
     1907              <listitem>
     1908                <para>Default: ???</para>
     1909              </listitem>
     1910
     1911              <listitem>
     1912                <para>Example:</para>
     1913
     1914                <programlisting>automake.args       --foreign</programlisting>
     1915              </listitem>
     1916            </itemizedlist>
    16281917          </listitem>
    16291918        </varlistentry>
     
    16341923          <listitem>
    16351924            <para>Directory in which to run
    1636             <varname>${automake.cmd}</varname>; the default is
    1637             <varname>${worksrcpath}</varname>.</para>
    1638 
    1639             <programlisting>automake.dir      ./src</programlisting>
     1925            <varname>${automake.cmd}</varname>.</para>
     1926
     1927            <itemizedlist>
     1928              <listitem>
     1929                <para>Default: <varname>${worksrcpath}</varname></para>
     1930              </listitem>
     1931
     1932              <listitem>
     1933                <para>Example:</para>
     1934
     1935                <programlisting>automake.dir        ./src</programlisting>
     1936              </listitem>
     1937            </itemizedlist>
    16401938          </listitem>
    16411939        </varlistentry>
     
    16451943
    16461944          <listitem>
    1647             <para>Whether or not to use autoconf; the default is
    1648             "no".</para>
    1649 
    1650             <programlisting>use_autoconf      yes</programlisting>
     1945            <para>Whether or not to use autoconf.</para>
     1946
     1947            <itemizedlist>
     1948              <listitem>
     1949                <para>Default: <option>no</option></para>
     1950              </listitem>
     1951
     1952              <listitem>
     1953                <para>Example:</para>
     1954
     1955                <programlisting>use_autoconf        yes</programlisting>
     1956              </listitem>
     1957            </itemizedlist>
    16511958          </listitem>
    16521959        </varlistentry>
     
    16581965            <para>Environmental variables to pass to autoconf.</para>
    16591966
    1660             <programlisting>autoconf.env      CFLAGS=-I${prefix}/include/gtk12</programlisting>
     1967            <itemizedlist>
     1968              <listitem>
     1969                <para>Default: ???</para>
     1970              </listitem>
     1971
     1972              <listitem>
     1973                <para>Example:</para>
     1974
     1975                <programlisting>autoconf.env        CFLAGS=-I${prefix}/include/gtk12</programlisting>
     1976              </listitem>
     1977            </itemizedlist>
    16611978          </listitem>
    16621979        </varlistentry>
     
    16681985            <para>Arguments to pass to autoconf.</para>
    16691986
    1670             <programlisting>autoconf.args     -l src/aclocaldir</programlisting>
     1987            <itemizedlist>
     1988              <listitem>
     1989                <para>Default: ???</para>
     1990              </listitem>
     1991
     1992              <listitem>
     1993                <para>Example:</para>
     1994
     1995                <programlisting>autoconf.args       "-l src/aclocaldir"</programlisting>
     1996              </listitem>
     1997            </itemizedlist>
    16711998          </listitem>
    16721999        </varlistentry>
     
    16772004          <listitem>
    16782005            <para>Directory in which to run
    1679             <varname>${autoconf.cmd}</varname>; the default is
    1680             <varname>${worksrcpath}</varname>.</para>
    1681 
    1682             <programlisting>autoconf.dir      src</programlisting>
     2006            <varname>${autoconf.cmd}</varname>.</para>
     2007
     2008            <itemizedlist>
     2009              <listitem>
     2010                <para>Default: <varname>${worksrcpath}</varname></para>
     2011              </listitem>
     2012
     2013              <listitem>
     2014                <para>Example:</para>
     2015
     2016                <programlisting>autoconf.dir        src</programlisting>
     2017              </listitem>
     2018            </itemizedlist>
    16832019          </listitem>
    16842020        </varlistentry>
     
    16872023  </section>
    16882024
    1689   <section>
     2025  <section id="reference.phases.build">
    16902026    <title>Build Phase Keywords</title>
    16912027
     
    17002036          default is "make".</para>
    17012037
    1702           <programlisting>build.cmd      pbxbuild</programlisting>
     2038          <itemizedlist>
     2039            <listitem>
     2040              <para>Default: <command>make</command></para>
     2041            </listitem>
     2042
     2043            <listitem>
     2044              <para>Example:</para>
     2045
     2046              <programlisting>build.cmd           pbxbuild</programlisting>
     2047            </listitem>
     2048          </itemizedlist>
    17032049        </listitem>
    17042050      </varlistentry>
     
    17112057          build.cmd to either "gnumake" or "bsdmake" accordingly.</para>
    17122058
    1713           <programlisting>build.type     gnu</programlisting>
     2059          <!-- TODO: how to display "gnu" or "bsd". -->
     2060
     2061          <itemizedlist>
     2062            <listitem>
     2063              <para>Default: <literal>gnu</literal></para>
     2064            </listitem>
     2065
     2066            <listitem>
     2067              <para>Example:</para>
     2068
     2069              <programlisting>build.type          bsd</programlisting>
     2070            </listitem>
     2071          </itemizedlist>
    17142072        </listitem>
    17152073      </varlistentry>
     
    17232081
    17242082        <listitem>
    1725           <para>Main arguments to build.cmd; optional argument modifiers
    1726           pass arguments before and after the main arguments.</para>
     2083          <para>Main arguments to <varname>${build.cmd}</varname>; optional
     2084          argument modifiers pass arguments before and after the main
     2085          arguments.</para>
    17272086
    17282087          <itemizedlist>
     
    17342093              <para>Example:</para>
    17352094
    1736               <programlisting>build.args    -DNOWARN
     2095              <programlisting>build.args          -DNOWARN
    17372096
    17382097</programlisting>
     
    17462105          <itemizedlist>
    17472106            <listitem>
    1748               <para>build.pre_args default:
     2107              <para><literal>build.pre_args</literal>, defaults to:
    17492108              <varname>${build.target.current}</varname></para>
    17502109            </listitem>
    17512110
    17522111            <listitem>
    1753               <para>build.post_args default: none</para>
     2112              <para><literal>build.post_args</literal>, defaults to:
     2113              none</para>
    17542114            </listitem>
    17552115
     
    17572117              <para>Examples:</para>
    17582118
    1759               <programlisting>build.pre_args  -project AudioSlicer.xcode
    1760 build.post_args CFLAGS_SYS="-DUSE_FREETYPE -DPREFER_FREETYPE"</programlisting>
     2119              <programlisting>build.pre_args      -project AudioSlicer.xcode
     2120build.post_args     CFLAGS_SYS="-DUSE_FREETYPE -DPREFER_FREETYPE"</programlisting>
    17612121            </listitem>
    17622122          </itemizedlist>
     
    17722132
    17732133        <listitem>
    1774           <para>Build target to pass to ${build.cmd}; list modifiers add or
    1775           delete items from a previous Portfile build.target keyword or the
    1776           default set by MacPorts base.</para>
    1777 
    1778           <itemizedlist>
    1779             <listitem>
    1780               <para>Default: all</para>
    1781             </listitem>
    1782 
    1783             <listitem>
    1784               <para>Example:</para>
    1785 
    1786               <programlisting>build.target    all-src
    1787 
    1788 </programlisting>
    1789             </listitem>
    1790           </itemizedlist>
    1791         </listitem>
    1792 
    1793         <listitem>
    1794           <para>List modifier examples:</para>
    1795 
    1796           <programlisting>build.target-append   doc extra
    1797 build.target-delete   compat</programlisting>
     2134          <para>Build target to pass to <varname>${build.cmd}</varname>; list
     2135          modifiers add or delete items from a previous Portfile build.target
     2136          keyword or the default set by MacPorts base.</para>
     2137
     2138          <itemizedlist>
     2139            <listitem>
     2140              <para>Default: <literal>all</literal></para>
     2141            </listitem>
     2142
     2143            <listitem>
     2144              <para>Example:</para>
     2145
     2146              <programlisting>build.target        all-src</programlisting>
     2147              <programlisting>build.target-append     doc extra
     2148build.target-delete     compat</programlisting>
     2149            </listitem>
     2150          </itemizedlist>
    17982151        </listitem>
    17992152      </varlistentry>
     
    18212174              <para>Example:</para>
    18222175
    1823               <programlisting>use_parallel_build     yes</programlisting>
     2176              <programlisting>use_parallel_build  yes</programlisting>
    18242177            </listitem>
    18252178          </itemizedlist>
     
    18292182  </section>
    18302183
    1831   <section>
     2184  <section id="reference.phases.destroot">
    18322185    <title>Destroot Phase Keywords</title>
    18332186
     
    18402193        <listitem>
    18412194          <para>Install command to run relative to
    1842           <varname>${worksrcdir}</varname>; default is
    1843           <varname>${build.cmd}</varname>.</para>
    1844 
    1845           <programlisting>destroot.cmd         pbxbuild</programlisting>
     2195          <varname>${worksrcdir}</varname>.</para>
     2196
     2197          <itemizedlist>
     2198            <listitem>
     2199              <para>Default: <varname>${build.cmd}</varname></para>
     2200            </listitem>
     2201
     2202            <listitem>
     2203              <para>Example:</para>
     2204
     2205              <programlisting>destroot.cmd        pbxbuild</programlisting>
     2206            </listitem>
     2207          </itemizedlist>
    18462208        </listitem>
    18472209      </varlistentry>
     
    18512213
    18522214        <listitem>
    1853           <para>Defines which "make" is required: either "gnu" or "bsd".
    1854           Sets install.cmd to either "gnumake" or "bsdmake"
     2215          <para>Defines which "make" is required: either "gnu" or "bsd". Sets
     2216          <varname>${destroot.cmd}</varname> to either "gnumake" or "bsdmake"
    18552217          accordingly.</para>
    18562218
    1857           <programlisting>destroot.type        gnu</programlisting>
     2219          <!-- TODO: Options? -->
     2220
     2221          <itemizedlist>
     2222            <listitem>
     2223              <para>Default: <varname>${build.type}</varname></para>
     2224            </listitem>
     2225
     2226            <listitem>
     2227              <para>Example:</para>
     2228
     2229              <programlisting>destroot.type       bsd</programlisting>
     2230            </listitem>
     2231          </itemizedlist>
    18582232        </listitem>
    18592233      </varlistentry>
     
    18672241
    18682242        <listitem>
    1869           <para>Main arguments to ${destroot.cmd}; optional argument
    1870           modifiers pass arguments before and after the main
     2243          <para>Main arguments to <varname>${destroot.cmd}</varname>; optional
     2244          argument modifiers pass arguments before and after the main
    18712245          arguments.</para>
    18722246
     
    18792253              <para>Example:</para>
    18802254
    1881               <programlisting>destroot.args    BINDIR=${prefix}/bin
     2255              <programlisting>destroot.args       BINDIR=${prefix}/bin
    18822256
    18832257</programlisting>
     
    18912265          <itemizedlist>
    18922266            <listitem>
    1893               <para>destroot.pre_args default:
     2267              <para><literal>destroot.pre_args</literal>, defaults to:
    18942268              <varname>${destroot.target}</varname></para>
    18952269            </listitem>
    18962270
    18972271            <listitem>
    1898               <para>destroot.post_args default: none</para>
     2272              <para><literal>destroot.post_args</literal>, defaults to:
     2273              none</para>
    18992274            </listitem>
    19002275
     
    19022277              <para>Examples:</para>
    19032278
    1904               <programlisting>destroot.pre_args  -project AudioSlicer.xcode
    1905 destroot.post_args INSTDIR=${destroot}${prefix}</programlisting>
     2279              <programlisting>destroot.pre_args   -project AudioSlicer.xcode
     2280destroot.post_args  INSTDIR=${destroot}${prefix}</programlisting>
    19062281            </listitem>
    19072282          </itemizedlist>
     
    19172292
    19182293        <listitem>
    1919           <para>Install target to pass to ${destroot.cmd}; list modifiers
    1920           add or delete items from a previous Portfile destroot.target
    1921           keyword or the default set by MacPorts base.</para>
     2294          <para>Install target to pass to <varname>${destroot.cmd}</varname>;
     2295          list modifiers add or delete items from a previous Portfile
     2296          destroot.target keyword or the default set by MacPorts base.</para>
    19222297
    19232298          <itemizedlist>
     
    19292304              <para>Example:</para>
    19302305
    1931               <programlisting>destroot.target    install install-config install-commandmode
    1932 
    1933 </programlisting>
    1934             </listitem>
    1935           </itemizedlist>
    1936         </listitem>
    1937 
    1938         <listitem>
    1939           <para>List modifier examples:</para>
    1940 
    1941           <programlisting>destroot.target-append   install-plugins
    1942 destroot.target-delete   install-commandmode</programlisting>
     2306              <programlisting>destroot.target     install install-config install-commandmode</programlisting>
     2307              <programlisting>destroot.target-append  install-plugins
     2308destroot.target-delete  install-commandmode</programlisting>
     2309            </listitem>
     2310          </itemizedlist>
    19432311        </listitem>
    19442312      </varlistentry>
     
    19482316
    19492317        <listitem>
    1950           <para>Arguments passed to ${destroot.cmd} to install correctly
    1951           into the destroot.</para>
    1952 
    1953           <programlisting>destroot.destdir     prefix=${destroot}${prefix}</programlisting>
     2318          <para>Arguments passed to <varname>${destroot.cmd}</varname> to
     2319          install correctly into the destroot.</para>
     2320
     2321          <itemizedlist>
     2322            <listitem>
     2323              <para>Default: <literal>DESTDIR=${destroot}</literal></para>
     2324            </listitem>
     2325
     2326            <listitem>
     2327              <para>Example:</para>
     2328
     2329              <programlisting>destroot.destdir    prefix=${destroot}${prefix}</programlisting>
     2330            </listitem>
     2331          </itemizedlist>
    19542332
    19552333          <note>
     
    19652343
    19662344      <varlistentry>
     2345        <term>destroot.umask</term>
     2346
     2347        <listitem>
     2348          <para>Umask to use during destroot.</para>
     2349
     2350          <itemizedlist>
     2351            <listitem>
     2352              <para>Default: <literal>022</literal></para>
     2353            </listitem>
     2354
     2355            <listitem>
     2356              <para>Example:</para>
     2357
     2358              <programlisting>destroot.umask      002</programlisting>
     2359            </listitem>
     2360          </itemizedlist>
     2361        </listitem>
     2362      </varlistentry>
     2363
     2364      <varlistentry>
    19672365        <term>destroot.keepdirs</term>
    19682366
     
    19712369          upon destroot completion.</para>
    19722370
    1973           <programlisting>destroot.keepdirs \
    1974               ${destroot}${prefix}/var/run \
    1975               ${destroot}${prefix}/var/log \
    1976               ${destroot}${prefix}/var/cache/mrtg</programlisting>
     2371          <itemizedlist>
     2372            <listitem>
     2373              <para>Default: ???</para>
     2374            </listitem>
     2375
     2376            <listitem>
     2377              <para>Example:</para>
     2378
     2379              <programlisting>destroot.keepdirs   ${destroot}${prefix}/var/run \
     2380                    ${destroot}${prefix}/var/log \
     2381                    ${destroot}${prefix}/var/cache/mrtg</programlisting>
     2382            </listitem>
     2383          </itemizedlist>
    19772384        </listitem>
    19782385      </varlistentry>
     
    19832390        <listitem>
    19842391          <para>MacPorts tests for compliance to the common directory
    1985           structure in ${prefix}; the default is "no". If a port is not
     2392          structure in <varname>${prefix}</varname>. If a port is not
    19862393          compliant with the standard, set it to "yes".</para>
    19872394
    1988           <programlisting>destroot.violate_mtree    yes</programlisting>
     2395          <!-- TODO: add a link to the standard -->
     2396
     2397          <itemizedlist>
     2398            <listitem>
     2399              <para>Default: <option>no</option></para>
     2400            </listitem>
     2401
     2402            <listitem>
     2403              <para>Example:</para>
     2404
     2405              <programlisting>destroot.violate_mtree      yes</programlisting>
     2406            </listitem>
     2407          </itemizedlist>
    19892408        </listitem>
    19902409      </varlistentry>
  • trunk/doc-new/guide/xml/portfile-startupitem.7.xml

    r31622 r31828  
    2727  <note>
    2828    <para>The variable <varname>startupitem_type</varname> in
    29     ${prefix}/etc/macports/macports.conf may be set to
     29    <filename>${prefix}/etc/macports/macports.conf</filename> may be set to
    3030    <option>none</option> to globally override all StartupItem keywords
    3131    found in Portfiles; this prevents StartupItems from being
  • trunk/doc-new/guide/xml/portfileref.xml

    r31622 r31828  
    2424              xmlns:xi="http://www.w3.org/2001/XInclude" />
    2525
    26 
     26<!--
    2727  <section id="reference.portgroup">
    2828    <title>PortGroup</title>
     
    480480    <para></para>
    481481  </section>
     482-->
    482483</chapter>
Note: See TracChangeset for help on using the changeset viewer.