Revision: 76677 http://trac.macports.org/changeset/76677 Author: jmr@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>‑‑follow‑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>‑‑follow‑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>