[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