Changes between Version 134 and Version 135 of FAQ


Ignore:
Timestamp:
May 30, 2014, 1:14:45 AM (10 years ago)
Author:
neverpanic (Clemens Lang)
Comment:

Mention trace mode in #buildfails, clean up and streamline, provide a search field by port name

Legend:

Unmodified
Added
Removed
Modified

  • FAQ

    v134 v135  
    77=== A port fails to build. What should I do? === #buildfails
    88
    9 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
    10 
    11 {{{
    12 sudo port selfupdate
    13 }}}
    14 
    15 Also, make sure you have the latest version of Xcode. Old versions of Xcode are known to make certain ports fail. Then run
    16 {{{
    17 sudo port clean <portname>
    18 }}}
    19 to clean the work directory for the port that failed to build, followed by
    20 {{{
    21 sudo port upgrade outdated
    22 }}}
    23 to upgrade your installed ports to the latest available versions. Then you can try your original command again.
    24 
    25 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].
     9 1. First, make sure you have the latest version of MacPorts and the ports tree. To do that, run `sudo port selfupdate`.
     10 1. Make sure you have the latest version of Xcode. Old versions of Xcode sometimes make certain ports fail.
     11 1. Clean the port. Run `sudo port clean <portname>`.
     12 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`):
     13{{{
     14sudo port install <portname> # without trace mode, or
     15sudo port -t install <portname> # with trace mode
     16}}}
     17 1. If this does not help, check ProblemHotlist and see if your issue is mentioned.\\
     18    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:
     19{{{#!html
     20<form action="/report/16" method="get">
     21  <div>
     22    <input type="text" name="PORT" value="" />
     23    <input type="submit" value="Search"/>
     24  </div>
     25</form>
     26}}}
     27    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].
    2628
    2729=== 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