Changeset 105464 for trunk/doc-new


Ignore:
Timestamp:
Apr 21, 2013, 7:06:53 PM (7 years ago)
Author:
mk@…
Message:

Guide: add a few more useful macports.conf options from man pages

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/macports.conf.xml

    r105189 r105464  
    139139
    140140      <varlistentry>
     141        <term>buildfromsource</term>
     142
     143        <listitem>
     144          <para>Controls whether ports are built from source or downloaded as pre-built
     145          archives. Setting to 'always' will never use archives, 'never' will always try
     146          to use an archive and fail if one is not available. 'ifneeded' will try to fetch
     147          an archive and fall back to building from source if that isn't possible.</para>
     148
     149          <para>Default: <option>ifneeded</option></para>
     150        </listitem>
     151      </varlistentry>
     152
     153      <varlistentry>
    141154        <term>portarchivetype</term>
    142155
    143156        <listitem>
    144           <para>Type of archive to use for port images.
    145           Available types are: tgz, tar, tbz, tbz2, tlz, xar, zip, cpgz,
    146           cpio.</para>
     157          <para>Format of archives in which to store port images. This controls both the
     158          type of archive created locally after building from source, and the type to
     159          request from remote servers. Changing this will not affect the usability of
     160          already installed archives; they can be of any supported type. Supported types
     161          are: tgz, tar, tbz, tbz2, tlz, txz, xar, zip, cpgz, cpio</para>
    147162
    148163          <para>Default: <filename>tbz2</filename></para>
     
    277292            advanced users.</para>
    278293          </note>
     294        </listitem>
     295      </varlistentry>
     296
     297      <varlistentry>
     298        <term>host_blacklist</term>
     299
     300        <listitem>
     301          <para>Space separated list of download hosts that should not be used.</para>
     302         
     303          <para>Default: none</para>
     304         
     305          <note>
     306            <para>This feature is especially useful if a host turns out to be consistently
     307            slow and therefore should be excluded for MacPorts' actions.</para>
     308          </note>
     309        </listitem>
     310      </varlistentry>
     311
     312      <varlistentry>
     313        <term>preferred_hosts</term>
     314
     315        <listitem>
     316          <para>Space separated list of download hosts that should be used preferentially.</para>
     317         
     318          <para>Default: none</para>
     319        </listitem>
     320      </varlistentry>
     321
     322      <varlistentry>
     323        <term>revupgrade_autorun</term>
     324
     325        <listitem>
     326          <para>Controls whether the rev-upgrade action will be run automatically after
     327          upgrading ports.</para>
     328         
     329          <para>Default: yes</para>
     330        </listitem>
     331      </varlistentry>
     332
     333      <varlistentry>
     334        <term>revupgrade_mode</term>
     335
     336        <listitem>
     337          <para>Controls the rev-upgrade functionality which checks for broken linking and
     338          can rebuild ports to fix it. 'rebuild' means ports will automatically be rebuilt
     339          when broken linking is detected in their files, while 'report' means broken
     340          files will be scanned for and reported but the ports will not be rebuilt.</para>
     341         
     342          <para>Default: rebuild</para>
     343        </listitem>
     344      </varlistentry>
     345
     346      <varlistentry>
     347        <term>default_compiler</term>
     348
     349        <listitem>
     350          <para>Default value for configure.compiler. This can be a space-separated list.
     351          Later entries will be used if earlier entries are unavailable or blacklisted by
     352          a port. Setting this is unsupported.</para>
     353         
     354          <para>Default: none (internal list based on Xcode version is normally used)</para>
    279355        </listitem>
    280356      </varlistentry>
Note: See TracChangeset for help on using the changeset viewer.