[106783] trunk/base/doc/sources.conf

[larryv at macports.org]

Revision: 106783
          https://trac.macports.org/changeset/106783
Author:   larryv at macports.org
Date:     2013-06-07 22:16:07 -0700 (Fri, 07 Jun 2013)
Log Message:
-----------
sources.conf: Rewrite comments.

Modified Paths:
--------------
    trunk/base/doc/sources.conf

Modified: trunk/base/doc/sources.conf
===================================================================
--- trunk/base/doc/sources.conf	2013-06-08 03:57:41 UTC (rev 106782)
+++ trunk/base/doc/sources.conf	2013-06-08 05:16:07 UTC (rev 106783)
@@ -1,31 +1,29 @@
-#  MacPorts system wide sources configuration file
-#  $Id$
+# $Id$
 
-#  To setup a local ports repository, insert a "file://" entry following
-#  the example below that points to your local ports directory:
-#  Example: file:///Users/landonf/misc/MacPorts/ports
+# MacPorts system-wide configuration file for ports tree sources.
 
-#  The default MacPorts repository should always be tagged [default]
-#  for proper functionality of various resources (port groups, mirror
-#  sites, etc).  If you switch it from the rsync:// URL, be sure to keep
-#  it tagged [default].
+# To add a local source, add a "file://" entry.
+#
+#   Example: file:///Users/landonf/misc/MacPorts/ports
+#
+# To prevent a source from synchronizing when `port sync` is used,
+# append [nosync] at the end.
+#
+#   Example: file:///Users/landonf/misc/MacPorts/ports [nosync]
+#
+# Note that MacPorts parses source URLs in order; when a port appears in
+# multiple sources, it installs the first occurrence. For local sources
+# to shadow remote ones, "file://" URLs must come before other URLs.
 
-#  To prevent a source from synchronizing when `port sync` is used,
-#  append [nosync] at the end as shown in this example:
-#  Example: file:///Users/landonf/misc/MacPorts/ports [nosync]
+# A list of rsync mirrors is available at
+# https://trac.macports.org/wiki/Mirrors#Portfiles.
+#
+# If an "rsync://" URL points to a .tar file, a signed .rmd160 file must
+# exist in the same directory on the server and will be used to verify
+# its integrity.
+#
+# For proper functionality of various resources (port groups, mirror
+# sites, etc.), the primary MacPorts source must always be tagged
+# [default], even if it switched from the default "rsync://" URL.
 
-#  NOTE: The port command parses source URLs in order and installs the
-#        first occurrance when a port appears in multiple repositories.
-#        So keep "file://" URLs above other URL types.
-
-
-#  To get the ports tree from the master MacPorts server in California, USA use:
-#      rsync://rsync.macports.org/release/ports/
-#  To get it from the mirror in Trondheim, Norway use:
-#      rsync://trd.no.rsync.macports.org/release/ports/
-#  A current list of mirrors is available at https://trac.macports.org/wiki/Mirrors
-
-# If an rsync URL points to a .tar file, a signed .rmd160 must exist next to
-# it on the server and will be used to verify its integrity.
-
 rsync://rsync.macports.org/release/tarballs/ports.tar [default]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20130607/235a14bb/attachment.html>