[MacPorts] FAQ modified

[MacPorts]

Changed page "FAQ" by ryandesign at macports.org from 70.114.154.105*
Page URL: <http://trac.macports.org/wiki/FAQ>
Diff URL: <http://trac.macports.org/wiki/FAQ?action=diff&version=64>
Revision 64
Comment: rewrite uninstall instructions to prefer using port uninstall, and remove reference to specific ports violating the mtree (because those don't anymore)

-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: FAQ
=========================================================================
--- FAQ (version: 63)
+++ FAQ (version: 64)
@@ -38,10 +38,20 @@
 
 === How do I remove or uninstall MacPorts? ===
 
-MacPorts can be removed by issuing the following command from within Terminal using the regular `bash` shell (`${prefix}` being the directory onto which you installed MacPorts, `/opt/local` by default):
-
-{{{
-sudo rm -rf ${prefix} \
+Uninstalling MacPorts can be a drastic step, and depending on the issue you're experiencing, you may not need to do so. If you're unsure, ask on the macports-users mailing list first.
+
+If you need to uninstall MacPorts, and your port command is functioning, have it uninstall all the installed ports by typing this in the Terminal:
+
+{{{
+sudo port -f uninstall installed
+}}}
+
+All that will be left in your installation prefix now will be files that were not registered to any port. This includes any configuration files you edited, any databases you created, any files which MacPorts renamed in order to allow a forced installation or upgrade, and the base MacPorts software itself. You may wish to save your configuration files (most are in /opt/local/etc), databases, or any other unique data.
+
+To remove all traces of MacPorts, type this in the Terminal:
+
+{{{
+sudo rm -rf /opt/local \
 /Applications/MacPorts \
 /Applications/DarwinPorts \
 /Library/Tcl/macports1.0 \
@@ -54,16 +64,11 @@
 /etc/paths.d/macports
 }}}
 
-If you use another shell, such as tcsh, you may need to adopt the above to fit the syntax of your shell.
-
-Please note that this command removes all software installed using MacPorts as well as MacPorts itself.  This includes configuration files for any ports which were installed; if you need to keep them, back them up before the rm (they should be in `/opt/local/etc`).
-
-This command does not remove files installed to locations outside the agreed directory tree.  Thus ports that write in other places should be removed manually before removing MacPorts altogether.  This includes at least `xfig` and `transfig`, but probably other X11 ports as well.
-
-{{{
-sudo port uninstall xfig
-sudo port uninstall transfig
-}}}
+Substitute your own MacPorts prefix for /opt/local, if you've installed MacPorts in a different place.
+
+If you use a shell other than bash (perhaps tcsh), you may need to adjust the above to fit your shell's syntax.
+
+Note that depending on which version of MacPorts you have and which ports you've installed, not all of the above paths will exist on your system. This is ok.
 
 === What are the folders in `${prefix}/var/macports/ for and why do they take up so much space? ===
 

-------8<------8<------8<------8<------8<------8<------8<------8<--------

* The IP shown here might not mean anything if the user or the server is
behind a proxy.

--
MacPorts <http://www.macports.org/>
Ports system for Mac OS

This is an automated message. Someone at http://www.macports.org/ added your email
address to be notified of changes on FAQ. If it was not you, please
report to .