[76677] trunk/doc-new/guide/xml/using.xml

[jmr at macports.org]

Revision: 76677
          http://trac.macports.org/changeset/76677
Author:   jmr at macports.org
Date:     2011-03-04 22:46:39 -0800 (Fri, 04 Mar 2011)
Log Message:
-----------
guide: document uninstall actionflags, and reword discussion of force uninstall

Modified Paths:
--------------
    trunk/doc-new/guide/xml/using.xml

Modified: trunk/doc-new/guide/xml/using.xml
===================================================================
--- trunk/doc-new/guide/xml/using.xml	2011-03-05 06:08:18 UTC (rev 76676)
+++ trunk/doc-new/guide/xml/using.xml	2011-03-05 06:46:39 UTC (rev 76677)
@@ -218,12 +218,16 @@
       <programlisting><prompt>%%</prompt> <userinput>sudo port uninstall vile</userinput></programlisting>
 
       <note>
-        <para>If a port as installed as a dependency of another port,
-        uninstall will not remove it unless you remove the dependent ports
+        <para>To also recursively uninstall the ports that the given port depends on,
+        use the <option>&#x2011;&#x2011;follow&#x2011;dependencies</option> flag. This will not uninstall
+        dependencies that are marked as requested or that have other dependents.</para>
+        <para>To recursively uninstall all ports that depend on the given port before uninstalling
+        the port itself, use the <option>&#x2011;&#x2011;follow&#x2011;dependents</option> flag.</para>
+        <para>If a port is a dependency of another installed port,
+        uninstall will not remove it unless you remove the dependent port(s)
         first. To override this behavior, use the <option>-f</option> (force)
-        switch. But some ports need to be rebuilt if dependencies change, so
-        you should know what you are doing if you force uninstall
-        ports.</para>
+        switch. This will obviously break the dependents. Don't force uninstall ports
+        unless you know what you are doing.</para>
 
         <programlisting><prompt>%%</prompt> <userinput>sudo port -f uninstall vile</userinput></programlisting>
       </note>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20110304/f2cd2c68/attachment.html>