[88730] trunk/base/doc

[jmr at macports.org]

Revision: 88730
          http://trac.macports.org/changeset/88730
Author:   jmr at macports.org
Date:     2012-01-09 14:33:02 -0800 (Mon, 09 Jan 2012)
Log Message:
-----------
document revupgrade_mode and buildfromsource settings

Modified Paths:
--------------
    trunk/base/doc/macports.conf.5
    trunk/base/doc/macports.conf.in

Modified: trunk/base/doc/macports.conf.5
===================================================================
--- trunk/base/doc/macports.conf.5	2012-01-09 22:33:00 UTC (rev 88729)
+++ trunk/base/doc/macports.conf.5	2012-01-09 22:33:02 UTC (rev 88730)
@@ -92,6 +92,14 @@
 .br
 .Ic Default:
 ${prefix}/etc/macports/variants.conf
+.It Va 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.
+.br
+.Ic Default:
+ifneeded
 .It Va portarchivetype
 Format of archives in which to store port images. This controls both the type
 of archive created locally after building from source, and the type to request
@@ -211,6 +219,15 @@
 ${prefix}/bin:${prefix}/sbin:/bin:/sbin:/usr/bin:/usr/sbin
 .It Va extra_env
 List of extra environment variables MacPorts should keep in the user's environment when sanitizing it.
+.It Va revupgrade_mode
+Controls the rev-upgrade functionality which checks for broken linking and
+rebuilds ports to fix it. 'rebuild' means ports will automatically be rebuilt
+when broken linking is detected in their files, 'report' means broken files
+will be scanned for and reported but the ports will not be rebuilt, and 'off'
+means linking will not be checked at all.
+.br
+.Ic Default:
+rebuild
 .El
 .Sh FILES
 .Bl -tag -width

Modified: trunk/base/doc/macports.conf.in
===================================================================
--- trunk/base/doc/macports.conf.in	2012-01-09 22:33:00 UTC (rev 88729)
+++ trunk/base/doc/macports.conf.in	2012-01-09 22:33:02 UTC (rev 88730)
@@ -29,6 +29,11 @@
 # Where to find global variants definition file (optional)
 variants_conf		@MPCONFIGDIR_EXPANDED@/variants.conf
 
+# When to build ports from source. Default is 'ifneeded', which downloads an
+# archive if available or builds from source otherwise. 'always' has the same
+# effect as -s on the command line, and 'never' is likewise the same as -b.
+#buildfromsource    ifneeded
+
 # Type of archives to use for port images
 #
 # Supported types: tgz, tar, tbz, tbz2 (default), tlz, txz, xar, zip, cpgz, cpio
@@ -131,3 +136,7 @@
 # hosts not to go through the proxy (comma-separated, applies to HTTP, HTTPS,
 # and FTP, but not rsync):
 #proxy_skip            internal1, internal2, internal3
+
+# Option controlling rev-upgrade, which checks for broken linking and rebuilds
+# affected ports. Possible values are 'rebuild' (default), 'report', or 'off'.
+#revupgrade_mode rebuild
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20120109/bc551454/attachment.html>