[MacPorts] FAQ modified

[MacPorts]

Changed page "FAQ" by blb at macports.org from 97.112.137.159*
Page URL: <http://trac.macports.org/wiki/FAQ>
Diff URL: <http://trac.macports.org/wiki/FAQ?action=diff&version=84>
Revision 84
Comment: Update force information for MacPorts 1.8

-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: FAQ
=========================================================================
--- FAQ (version: 83)
+++ FAQ (version: 84)
@@ -201,13 +201,7 @@
 
 === When should I use the force option (-f) === #whentoforce
 
-Use of the force option (-f) is rarely necessary, but some suggestions in the past have recommended its use quite frequently.  One of the few useful applications of it is in forcing a reinstall of an already-installed port to add a new variant, for example
-{{{
-sudo port -fn upgrade mysql5 +server
-}}}
-will install a new version of the mysql5 port with the current variants plus +server.  Note the use of the -n (don't follow dependencies) option, which is important in this case (otherwise ports depended on by mysql5 will be upgraded as well even when it isn't needed).
-
-One of the other times -f is needed is when you run into a stray file in your MacPorts prefix, not owned by a port, but blocks the install of one.  This is seen with an error message from port similar to
+Use of the force option (-f) is rarely necessary, but some suggestions in the past have recommended its use quite frequently.  The most common need for -f now is  when you run into a stray file in your MacPorts prefix, not owned by a port, but blocks the install of one.  This is seen with an error message from port similar to
 {{{
 Error: Activating some-port @1.0_0 failed: Image error: /opt/local/path/to/stray/file already exists and does not belong to a registered port.  Unable to activate port some-port.
 }}}
@@ -215,7 +209,13 @@
 {{{
 sudo port -f activate some-port
 }}}
-Outside of `-fn upgrade` and `-f activate` force can be extremely dangerous, and should be avoided unless you know precisely how port is going to act.
+
+Prior to MacPorts 1.8, -f was also used to force an upgrade of a port to add new variants.  This has now been replaced with the {{{--enforce-variants}}} option to upgrade:
+{{{
+sudo port upgrade --enforce-variants curl +ssl
+}}}
+This will install the curl port again, adding the +ssl variant.
+
 
 == Portfile Development and Maintenance Questions ==
 

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