Modified: trunk/doc-new/guide/xml/using.xml (76676 => 76677)

--- 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>