[MacPorts] FAQ modified

[MacPorts]

Page "FAQ" was changed by cal at macports.org
Diff URL: <https://trac.macports.org/wiki/FAQ?action=diff&version=135>
Revision 135
Comment: Mention trace mode in #buildfails, clean up and streamline, provide a search field by port name
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: FAQ
=========================================================================
--- FAQ (version: 134)
+++ FAQ (version: 135)
@@ -6,23 +6,25 @@
 
 === A port fails to build. What should I do? === #buildfails
 
-Before filing a ticket in the issue tracker, please make sure you have the latest version of MacPorts and of the ports tree by running
-
-{{{
-sudo port selfupdate
-}}}
-
-Also, make sure you have the latest version of Xcode. Old versions of Xcode are known to make certain ports fail. Then run
-{{{
-sudo port clean <portname>
-}}}
-to clean the work directory for the port that failed to build, followed by
-{{{
-sudo port upgrade outdated
-}}}
-to upgrade your installed ports to the latest available versions. Then you can try your original command again.
-
-If this does not help, check ProblemHotlist (and SnowLeopardProblems if you are on Mac OS X 10.6) and see if your issue is mentioned. If not, [search:] for an existing ticket. If there does not appear to be one, you can then [http://guide.macports.org/#project.tickets create a new ticket].
+ 1. First, make sure you have the latest version of MacPorts and the ports tree. To do that, run `sudo port selfupdate`.
+ 1. Make sure you have the latest version of Xcode. Old versions of Xcode sometimes make certain ports fail.
+ 1. Clean the port. Run `sudo port clean <portname>`.
+ 1. Try again. If you have files in `/usr/local` or also use other package managers such as fink, homebrew, or pkgsrc, also try trace mode (`-t`):
+{{{
+sudo port install <portname> # without trace mode, or
+sudo port -t install <portname> # with trace mode
+}}}
+ 1. If this does not help, check ProblemHotlist and see if your issue is mentioned.\\
+    If not, [search:] for an existing ticket. Enter the name of the failing port in this field to see all tickets filed for this port:
+{{{#!html
+<form action="/report/16" method="get">
+  <div>
+    <input type="text" name="PORT" value="" />
+    <input type="submit" value="Search"/>
+  </div>
+</form>
+}}}
+    If there are no matching tickets, please file one. Please respect our guide on [http://guide.macports.org/#project.tickets how to properly create a new ticket].
 
 === I get the error "C compiler cannot create executables" or "ld: library not found for -lcrt1.10.6.o" or "can't read "build.cmd": Failed to locate 'make' in path" when I try to install a port. Why? === #missingxcode
 
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/FAQ>
MacPorts <http://www.macports.org/>
Ports system for OS X

This is an automated message. Someone added your email address to be
notified of changes on 'FAQ' page.
If it was not you, please report to .