[100540] branches/new-help-system/base/doc

Fri Dec 14 17:55:31 PST 2012

Revision: 100540
          https://trac.macports.org/changeset/100540
Author:   raimue at macports.org
Date:     2012-12-14 17:55:31 -0800 (Fri, 14 Dec 2012)
Log Message:
-----------
Regenerate man pages from sources

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

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

--- branches/new-help-system/base/doc/macports.conf.5	2012-12-15 01:54:26 UTC (rev 100539)
+++ branches/new-help-system/base/doc/macports.conf.5	2012-12-15 01:55:31 UTC (rev 100540)
@@ -1,5 +1,5 @@
 '\" t
-.TH "MACPORTS\&.CONF" "5" "2010\-08\-21" "MacPorts 2\&.1\&.99" "MacPorts Manual"
+.TH "MACPORTS\&.CONF" "5" "2012\-12\-15" "MacPorts 2\&.1\&.99" "MacPorts Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -68,31 +68,6 @@
 sqlite
 .RE
 .PP
-portinstalltype
-.RS 4
-Sets the mode in which ports are installed by MacPorts\&. Supported values are
-\fIdirect\fR
-or
-\fIimage\fR\&. The
-\fIdirect\fR
-mode is often used on systems that do not sup\- port
-\fIimage\fR
-due to limitations in their installed version of Tcl\&. In
-\fIdirect\fR
-mode ports are installed directly into
-\fI${prefix}\fR
-and only one flavor of a port can be installed at any given time\&. In
-\fIimage\fR
-mode multiple flavors of a port (i\&.e\&., different versions and/or any possible combination of its variants) can be installed concurrently into
-\fI${portdbpath}/software/${portname}\fR
-and only one can be "activated" onto
-\fI${prefix}\fR
-via soft or hard links from the former to the lat\- ter\&.
-
-\fBDefault:\fR
-image
-.RE
-.PP
 applications_dir
 .RS 4
 Directory containing Applications installed from ports\&.
@@ -125,34 +100,29 @@
 ${prefix}/etc/macports/variants\&.conf
 .RE
 .PP
-portarchivemode
+buildfromsource
 .RS 4
-Key governing the creation of binary archives of installed ports for installa\- tion/reinstallation ease\&.
+Controls whether ports are built from source or downloaded as pre\-built archives\&. Setting to
+\fIalways\fR
+will never use archives,
+\fInever\fR
+will always try to use an archive and fail if one is not available\&.
+\fIifneeded\fR
+will try to fetch an archive and fall back to building from source if that isn\(cqt possible\&.
 
 \fBDefault:\fR
-yes
+ifneeded
 .RE
 .PP
-portarchivepath
-.RS 4
-Location to store ports\*(Aq binary archive files when archive mode is active\&.
-
-\fBDefault:\fR
-${portdbpath}/packages
-.RE
-.PP
 portarchivetype
 .RS 4
-Colon or comma separated, space free list of supported formats of archives to cre\- ate or read from when
-\fI${archivemode}\fR
-is set to
-\fIyes\fR\&. 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\&.
+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\&.
 
-\fBSupported types are:\fR
+\fBSupported types:\fR
 tgz, tar, tbz, tbz2, tlz, txz, xar, zip, cpgz, cpio
 
 \fBDefault:\fR
-tgz
+tbz2
 .RE
 .PP
 configureccache
@@ -163,6 +133,23 @@
 no
 .RE
 .PP
+ccache_dir
+.RS 4
+Location where ccache stores its files
+.RE
+.PP
+ccache_size
+.RS 4
+Maximum size ccache may use\&. Use
+\fIG\fR,
+\fIM\fR, or
+\fIK\fR
+suffix for giga\-, mega\- or kilobytes\&.
+
+\fBDefault:\fR
+2G
+.RE
+.PP
 configuredistcc
 .RS 4
 Use distcc (distributed compiler)\&. Requires that distcc has been installed\&.
@@ -208,7 +195,7 @@
 Keep logs for ports\&.
 
 \fBDefault:\fR
-yes
+no
 .RE
 .PP
 build_arch
@@ -241,8 +228,11 @@
 .PP
 startupitem_type
 .RS 4
-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\(cqs appropriate to the OS\&. Supported types are: none, System\- Starter, launchd, default, rcNG\&.
+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\(cqs appropriate to the OS\&.
 
+\fBSupported types:\fR
+none, SystemStarter, launchd, default, rcNG\&.
+
 \fBDefault:\fR
 default
 .RE
@@ -289,8 +279,100 @@
 .PP
 extra_env
 .RS 4
-List of extra environment variables MacPorts should keep in the user\(cqs environment when sanitizing it\&.
+List of extra environment variables MacPorts should keep in the user\(cqs environment when sanitizing it\&. Changing this is unsupported\&.
 .RE
+.PP
+proxy_override_env
+.RS 4
+Proxy support\&. Precedence is: env, macports\&.conf, System Preferences\&. That is, if it\(cqs 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\(cqs in the environment\&. Note that System Preferences doesn\(cqt 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
+
+\fBDefault:\fR
+yes
+.RE
+.PP
+proxy_http
+.RS 4
+HTTP proxy
+
+\fBDefault:\fR
+none
+.RE
+.PP
+proxy_https
+.RS 4
+HTTPS proxy
+
+\fBDefault:\fR
+none
+.RE
+.PP
+proxy_ftp
+.RS 4
+FTP proxy
+
+\fBDefault:\fR
+none
+.RE
+.PP
+proxy_rsync
+.RS 4
+rsync proxy
+
+\fBDefault:\fR
+none
+.RE
+.PP
+proxy_skip
+.RS 4
+Hosts not to go through the proxy (comma\-separated, applies to HTTP, HTTPS and FTP, but not rsync)\&.
+
+\fBDefault:\fR
+none
+.RE
+.PP
+host_blacklist
+.RS 4
+Space separated list of download hosts that should not be used\&.
+
+\fBDefault:\fR
+none
+.RE
+.PP
+preferred_hosts
+.RS 4
+Space separated list of download hosts that should be used preferentially\&.
+
+\fBDefault:\fR
+none
+.RE
+.PP
+revupgrade_autorun
+.RS 4
+Controls whether the rev\-upgrade action will be run automatically after upgrading ports\&.
+
+\fBDefault:\fR
+yes
+.RE
+.PP
+revupgrade_mode
+.RS 4
+Controls the rev\-upgrade functionality which checks for broken linking and can rebuild ports to fix it\&.
+\fIrebuild\fR
+means ports will automatically be rebuilt when broken linking is detected in their files, while
+\fIreport\fR
+means broken files will be scanned for and reported but the ports will not be rebuilt\&.
+
+\fBDefault:\fR
+rebuild
+.RE
+.PP
+default_compiler
+.RS 4
+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\&.
+
+\fBDefault:\fR
+none (internal list based on Xcode version is normally used)
+.RE
 .SH "FILES"
 .PP
 ${prefix}/etc/macports/macports\&.conf

Modified: branches/new-help-system/base/doc/port.1
===================================================================
--- branches/new-help-system/base/doc/port.1	2012-12-15 01:54:26 UTC (rev 100539)
+++ branches/new-help-system/base/doc/port.1	2012-12-15 01:55:31 UTC (rev 100540)
@@ -1,5 +1,5 @@
 '\" t
-.TH "PORT" "1" "2010\-07\-17" "MacPorts 2\&.1\&.99" "MacPorts Manual"
+.TH "PORT" "1" "2012\-12\-15" "MacPorts 2\&.1\&.99" "MacPorts Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20121214/da79c4ae/attachment.html>
