[100539] branches/new-help-system/base/doc/macports.conf.5.txt

raimue at macports.org raimue at macports.org
Fri Dec 14 17:54:26 PST 2012


Revision: 100539
          https://trac.macports.org/changeset/100539
Author:   raimue at macports.org
Date:     2012-12-14 17:54:26 -0800 (Fri, 14 Dec 2012)
Log Message:
-----------
Update macports.conf(5)

Modified Paths:
--------------
    branches/new-help-system/base/doc/macports.conf.5.txt

Modified: branches/new-help-system/base/doc/macports.conf.5.txt
===================================================================
--- branches/new-help-system/base/doc/macports.conf.5.txt	2012-12-15 01:34:40 UTC (rev 100538)
+++ branches/new-help-system/base/doc/macports.conf.5.txt	2012-12-15 01:54:26 UTC (rev 100539)
@@ -27,34 +27,22 @@
 The following keys are used by *port* itself:
 
 prefix::
-    Sets the directory where ports are installed. Any path may be used but those with
-    spaces and/or non ascii characters should be avoided, as this can break some
-    ports. This key is often referred to as '$\{prefix\}'. +
+    Sets the directory where ports are installed. Any path may be used but those
+    with spaces and/or non ascii characters should be avoided, as this can break
+    some ports. This key is often referred to as '$\{prefix\}'. +
     **Default:** /opt/local
 
 portdbpath::
-    Directory where MacPorts keeps working data such as downloaded sources, installed
-    ports' receipts and the main registry. The same path restrictions apply as for
-    '$\{prefix\}'. +
+    Directory where MacPorts keeps working data such as downloaded sources,
+    installed ports' receipts and the main registry. The same path restrictions
+    apply as for '$\{prefix\}'. +
     *Default:* $\{prefix\}/var/macports
 
 portdbformat::
-    Storage type to use for the MacPorts registry. The preferred format is "sqlite",
-    with "flat" also available as a legacy format. +
+    Storage type to use for the MacPorts registry. The preferred format is
+    "sqlite", with "flat" also available as a legacy format. +
     *Default:* sqlite
 
-portinstalltype::
-    Sets the mode in which ports are installed by MacPorts. Supported values are
-    'direct' or 'image'.  The 'direct' mode is often used on systems that do not sup-
-    port 'image' due to limitations in their installed version of Tcl. In 'direct'
-    mode ports are installed directly into '$\{prefix\}' and only one flavor of a port
-    can be installed at any given time. In 'image' mode multiple flavors of a port
-    (i.e., different versions and/or any possible combination of its variants) can be
-    installed concurrently into '$\{portdbpath\}/software/$\{portname\}' and only one can
-    be "activated" onto '$\{prefix\}' via soft or hard links from the former to the lat-
-    ter. +
-    *Default:* image
-
 applications_dir::
     Directory containing Applications installed from ports. +
     *Default:* /Applications/MacPorts
@@ -74,28 +62,35 @@
     should be used in all installed ports if available. +
     *Default:* $\{prefix\}/etc/macports/variants.conf
 
-portarchivemode::
-    Key governing the creation of binary archives of installed ports for
-    installa- tion/reinstallation ease. +
-    *Default:* yes
+buildfromsource::
+    Controls whether ports are built from source or downloaded as pre-built
+    archives. Setting to 'always' will never use archives, 'never' will always
+    try to use an archive and fail if one is not available. 'ifneeded' will try
+    to fetch an archive and fall back to building from source if that isn't
+    possible. +
+    *Default:* ifneeded
 
-portarchivepath::
-    Location to store ports' binary archive files when archive mode is active. +
-    *Default:* $\{portdbpath\}/packages
-
 portarchivetype::
-    Colon or comma separated, space free list of supported formats of archives
-    to cre- ate or read from when '$\{archivemode\}' is set to 'yes'. Use of
-    multiple types will cause archive creation to build all the specified types
-    in one step. Unarchive uses multiple types as a search list to locate any
-    existing archive, with the first found match being used. +
-    *Supported types are:* tgz, tar, tbz, tbz2, tlz, txz, xar, zip, cpgz, cpio +
-    *Default:* tgz
+    Format of archives in which to store port images. This controls both the
+    type of archive cre- ated locally after building from source, and the type
+    to request from remote servers. Changing this will not affect the usability
+    of already installed archives; they can be of any supported type. +
+    *Supported types:* tgz, tar, tbz, tbz2, tlz, txz, xar, zip, cpgz, cpio +
+    *Default:* tbz2
 
 configureccache::
     Use ccache (C/C++ compiler cache). Requires that ccache has been installed. +
     *Default:* no
 
+ccache_dir::
+    Location where ccache stores its files +
+    *Default:* ${portdbpath}/build/.ccache
+
+ccache_size::
+    Maximum size ccache may use. Use 'G', 'M', or 'K' suffix for giga-, mega- or
+    kilobytes. +
+    *Default:* 2G
+
 configuredistcc::
     Use distcc (distributed compiler). Requires that distcc has been installed. +
     *Default:* no
@@ -122,7 +117,7 @@
 
 keeplogs::
     Keep logs for ports. +
-    *Default:* yes
+    *Default:* no 
 
 build_arch::
     The machine architecture to try to build for in normal use. +
@@ -140,8 +135,8 @@
 startupitem_type::
     Set the default type of startupitems to be generated, overridable by
     Portfiles that explicitly state a startupitem.type key. If set to "default",
-    then a type will be selected that's appropriate to the OS.  Supported types
-    are: none, System- Starter, launchd, default, rcNG. +
+    then a type will be selected that's appropriate to the OS. +
+    *Supported types:* none, SystemStarter, launchd, default, rcNG. +
     *Default:* default
 
 destroot_umask::
@@ -172,9 +167,69 @@
     *Default:* $\{prefix\}/bin:$\{prefix\}/sbin:/bin:/sbin:/usr/bin:/usr/sbin
 
 extra_env::
-    List of extra environment variables MacPorts should keep in the user's environment
-    when sanitizing it.
+    List of extra environment variables MacPorts should keep in the user's
+    environment when sanitizing it. Changing this is unsupported.
 
+proxy_override_env::
+    Proxy support. Precedence is: env, macports.conf, System Preferences. That
+    is, if it's set in the environment, that will be used instead of anything
+    here or in System Preferences. Setting proxy_override_env to yes will cause
+    any proxies set here (or in System Preferences if set there but not here) to
+    override what's in the environment. Note that System Preferences doesn't
+    have an rsync proxy definition. Also note, on 10.5, sudo will clear many
+    environment variables including those for proxy support. Equivalent
+    environment variables: http_proxy, HTTPS_PROXY, FTP_PROXY, RSYNC_PROXY,
+    NO_PROXY +
+    *Default:* yes
+
+proxy_http::
+    HTTP proxy +
+    *Default:* none
+
+proxy_https::
+    HTTPS proxy +
+    *Default:* none
+
+proxy_ftp::
+    FTP proxy +
+    *Default:* none
+
+proxy_rsync::
+    rsync proxy +
+    *Default:* none
+
+proxy_skip::
+    Hosts not to go through the proxy (comma-separated, applies to HTTP, HTTPS
+    and FTP, but not rsync). +
+    *Default:* none
+
+host_blacklist::
+    Space separated list of download hosts that should not be used. +
+    *Default:* none
+
+preferred_hosts::
+    Space separated list of download hosts that should be used preferentially. +
+    *Default:* none
+
+revupgrade_autorun::
+    Controls whether the rev-upgrade action will be run automatically after
+    upgrading ports. +
+    *Default:* yes
+
+revupgrade_mode::
+    Controls the rev-upgrade functionality which checks for broken linking and
+    can rebuild ports to fix it. 'rebuild' means ports will automatically be
+    rebuilt when broken linking is detected in their files, while 'report' means
+    broken files will be scanned for and reported but the ports will not be
+    rebuilt. +
+    *Default:* rebuild
+
+default_compiler::
+    Default value for configure.compiler. This can be a space-separated list.
+    Later entries will be used if earlier entries are unavailable or blacklisted
+    by a port. Setting this is unsupported. +
+    *Default:* none (internal list based on Xcode version is normally used)
+
 FILES
 -----
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20121214/c7457637/attachment-0001.html>


More information about the macports-changes mailing list