[134965] trunk/base/doc/port-sync.1.txt

[cal at macports.org]

Revision: 134965
          https://trac.macports.org/changeset/134965
Author:   cal at macports.org
Date:     2015-04-12 12:05:22 -0700 (Sun, 12 Apr 2015)
Log Message:
-----------
base: document port sync, #44530

Added Paths:
-----------
    trunk/base/doc/port-sync.1.txt

Copied: trunk/base/doc/port-sync.1.txt (from rev 133158, trunk/base/doc/port-selfupdate.1.txt)
===================================================================
--- trunk/base/doc/port-sync.1.txt	                        (rev 0)
+++ trunk/base/doc/port-sync.1.txt	2015-04-12 19:05:22 UTC (rev 134965)
@@ -0,0 +1,50 @@
+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
+port-sync(1)
+============
+$Id$
+
+NAME
+----
+port-sync - Update the port definition files
+
+SYNOPSIS
+--------
+[cmdsynopsis]
+*port* [*-qvd*] *sync*
+
+DESCRIPTION
+-----------
+*port sync* updates the local port definitions (the so-called ports tree) to the
+latest state so you have the latest versions of ports available. You should
+normally not run *port sync* directly, but use *port selfupdate*, which updates
+MacPorts itself and then proceeds to do the same operation as *sync* does. You
+can, however, use *port sync* if you know that *selfupdate* does not work on
+your system or in your network environment, for example because your network
+administrator blocks outbound rsync connections and you have changed your
+man:sources.conf[5] to use a different method of obtaining the ports tree.
+
+Running *sync* is required to get updated software with bug fixes and new
+features.
+
+[WARNING]
+====
+When you use *port sync*, it is your responsibility to check whether new updates
+are available for MacPorts itself, and update them, when necessary. The MacPorts
+project will start to use new features in port definitions one week after the
+release of the new version, and you may run into problems when your MacPorts
+version has not been updated.
+====
+
+include::global-flags.txt[]
+
+*-q*::
+    Supress status output, be as silent as possible.
+
+SEE ALSO
+--------
+man:port[1], man:port-selfupdate[1]
+
+AUTHORS
+-------
+ (C) 2015 The MacPorts Project
+ Clemens Lang <cal at macports.org>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20150412/eb614f0a/attachment.html>