Changeset 120836 for trunk/doc-new


Ignore:
Timestamp:
Jun 9, 2014, 4:13:42 PM (5 years ago)
Author:
cal@…
Message:

guide/installing: Remove section on X11 since it was outdated, update Xcode installation instructions, replace links to connect.apple.com

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/installing.xml

    r120835 r120836  
    77  <title>Installing MacPorts</title>
    88
    9   <para>This chapter shows you how to install MacPorts and its prerequisites
    10   step-by-step. Note that the sections about <link
    11   linkend="installing.x11">installing X11</link> and <link
    12   linkend="installing.xcode">installing Xcode</link> are Mac OS X
    13   specific. If you wish to install MacPorts on another platform, first make
    14   sure you have X11 and gcc installed, and then skip ahead to <link
    15   linkend="installing.macports.source">installing MacPorts from source</link>
    16   and continue to the end of the chapter.</para>
    17 
    18   <section id="installing.x11">
    19     <title>Install X11</title>
    20 
    21     <para>
    22       X11.app allows you to run applications using the X Window System, which
    23       is the traditional display server on most other UNIX like systems. Additionally, the
    24       <ulink url="http://xquartz.macosforge.org/trac/wiki"> Xquartz</ulink>
    25       project provides an updated version of the X server.
    26     </para>
    27 
    28     <note>
    29       <para>
    30       As of Mac OS X 10.5 Leopard, X11.app is included in the default
    31       installation. You can just <link linkend="installing.xcode">skip this
    32       section</link> for any later version of Mac OS X.
    33       </para>
    34     </note>
    35 
    36     <orderedlist>
    37       <listitem>
    38         <para>Insert the <quote>Mac OS X Install Disk</quote> and run the
    39         package named <quote>Optional Installs</quote>.</para>
    40       </listitem>
    41 
    42       <listitem>
    43         <para>At the software selection window expand the
    44         <guilabel>Applications</guilabel> category and click the check box
    45         beside <guilabel>X11</guilabel> (and nothing else).</para>
    46       </listitem>
    47 
    48       <listitem>
    49         <para>Click <guibutton>Install</guibutton> to install X11.</para>
    50       </listitem>
    51     </orderedlist>
    52 
    53     <para>Before launching an X11 application on Mac OS X 10.4, you must open X11.app
    54     and start an xterm session. Later OS versions should launch X11.app automatically when
    55     an X11 application is run from the Terminal.</para>
    56 
    57     <programlisting><prompt>%%</prompt> <userinput>xterm</userinput></programlisting>
    58 
    59     <para>After the X11 session window opens, you may launch X11 apps from
    60     another terminal window. See <link
    61     linkend="installing.x11.settings">Optional X11 Settings</link> if you wish
    62     to launch X11 applications from an X11 session window.</para>
    63 
    64     <note>
    65       <para>X11 and the X11SDK (from Xcode Tools) are both required for X11
    66       apps. To verify the presence of both, check for files
    67       <filename>com.apple.pkg.X11User.bom</filename> &amp;
    68       <filename>com.apple.pkg.X11SDKLeo.bom</filename> in
    69       <filename>/Library/Receipts/boms/</filename>. On Mac OS X 10.4, look for
    70       files <filename>X11User.pkg</filename> &amp;
    71       <filename>X11SDK.pkg</filename> in
    72       <filename>/Library/Receipts/</filename>.</para>
    73     </note>
    74 
    75     <section id="installing.x11.settings">
    76       <title>Optional X11 Settings</title>
    77 
    78       <para>To launch X11 applications directly from an X11 window (instead of
    79       a regular terminal window), you need to make it so X11 sessions opened
    80       using the menu bar respect your <filename>.profile</filename>
    81       file.</para>
    82 
    83       <orderedlist>
    84         <listitem>
    85           <para>Open X11 and select <guimenuitem>Customize Menu
    86           ...</guimenuitem> from the <guimenu>Applications</guimenu>
    87           menu.</para>
    88         </listitem>
    89 
    90         <listitem>
    91           <para>Double-click the menu item <guimenuitem>Terminal</guimenuitem>
    92           and change: <quote>xterm</quote> to <quote>xterm -ls</quote></para>
    93         </listitem>
    94 
    95         <listitem>
    96           <para>Click <guibutton>Done</guibutton> to save the change.</para>
    97         </listitem>
    98       </orderedlist>
    99     </section>
    100   </section>
     9  <para>This chapter shows you how to install MacPorts and its prerequisites step-by-step. Note that the section about
     10  <link linkend="installing.xcode">installing Xcode</link> is Mac OS X-specific. If you wish to install MacPorts on
     11  another platform, first make sure you have a working C compiler installed, skip ahead to <link
     12    linkend="installing.macports.source">installing MacPorts from source</link>, and continue to the end of the
     13  chapter.</para>
    10114
    10215  <section id="installing.xcode">
     
    10417
    10518    <para>
    106       <ulink url="https://developer.apple.com/xcode/">Xcode</ulink>
    107       is a package provided by Apple containing compilers, libraries and
    108       additional tools required to develop applications for Mac OS X.
     19      <ulink url="https://developer.apple.com/xcode/">Xcode</ulink> is a package provided by Apple containing compilers,
     20      libraries and additional tools required to develop applications for Mac OS X.
    10921    </para>
    11022
    11123    <note>
    112       <para>Always make sure to install the latest available version of Xcode
    113       for your Mac OS X release; using outdated versions of Xcode
    114       may cause port install failures. Also note that Xcode is not
    115       updated via Mac OS X's Software Update utility on OS versions prior
    116       to 10.6, and is updated via the Mac App Store on 10.7.</para>
     24      <para>Always make sure to install the latest available version of Xcode for your Mac OS X release; using outdated
     25        versions of Xcode may cause port install failures. Also note that Xcode is not updated via Mac OS X's Software
     26        Update utility on OS versions prior to 10.6, and is updated via the Mac App Store starting with 10.7.</para>
    11727    </note>
    11828
     
    12333
    12434      <para>
    125         Download the latest version of Xcode <ulink
    126         url="https://developer.apple.com/downloads/index.action"> from the
    127         Apple developer website</ulink> or get it <ulink
    128         url="http://itunes.apple.com/us/app/xcode/id497799835">
    129         using the Mac App Store</ulink>.
     35        Download the latest version of Xcode <ulink url="https://developer.apple.com/downloads/index.action">from the
     36          Apple developer website</ulink> or get it <ulink url="http://itunes.apple.com/us/app/xcode/id497799835">using
     37          the Mac App Store</ulink>.
    13038      </para>
    131      
    13239      <para>
    133         Once you have Xcode installed, open a terminal and run
    134         <userinput>xcode-select --install</userinput>.
     40        Once you have Xcode installed, open a terminal, run <userinput>xcode-select --install</userinput>, and click the
     41        Install button to install the required command line developer tools. Don't worry if you see a message telling
     42        you the software cannot be installed because it is not currently available from the Software Update Server. This
     43        usually means you already have the latest version installed. You can also get the command line tools from <ulink
     44          url="https://developer.apple.com/downloads/index.action">the Apple developer website</ulink>.
    13545      </para>
    13646    </section>
     
    14050
    14151      <para>
    142         Download the latest version of Xcode <ulink
    143           url="https://developer.apple.com/downloads/index.action">from the Apple developer
    144           website</ulink> or get it <ulink
    145           url="http://itunes.apple.com/us/app/xcode/id497799835">using the Mac
    146           App Store</ulink>.
     52        Download the latest version of Xcode <ulink url="https://developer.apple.com/downloads/index.action">from the
     53          Apple developer website</ulink> or get it <ulink url="http://itunes.apple.com/us/app/xcode/id497799835">using
     54          the Mac App Store</ulink>.
    14755      </para>
    14856
     
    15058        <title>Xcode 4.3 and later</title>
    15159        <para>
    152           Xcode 4.3 and later do not automatically install the command line tools, but
    153           MacPorts requires them. To install them, open the Xcode application, go to the
    154           Preferences window, to the Downloads section, and click the Install button
    155           next to Command Line Tools. Be sure to return to this window after every Xcode
    156           upgrade to ensure that the command line tools are also upgraded.
     60          Xcode 4.3 and later do not automatically install the command line tools, but MacPorts requires them. To
     61          install them, open the Xcode application, go to the Preferences window, to the Downloads section, and click
     62          the Install button next to Command Line Tools. Be sure to return to this window after every Xcode upgrade to
     63          ensure that the command line tools are also upgraded.
    15764        </para>
    15865        <para>
    159           If you wish to create Installer packages with <userinput>port pkg</userinput>,
    160           you will also need to install PackageMaker, which is in the <quote>Auxiliary
    161           Tools for Xcode</quote> package as of Xcode 4.3. The download page for this package
    162           can be opened via the Xcode -> Open Developer Tool -> More Developer Tools...
    163           menu item. After downloading and mounting the disk image, drag the PackageMaker
    164           application to your /Applications directory.
     66          If you wish to create Installer packages with <userinput>port pkg</userinput>, you will also need to install
     67          PackageMaker, which is in the <quote>Auxiliary Tools for Xcode</quote> package as of Xcode 4.3. The download
     68          page for this package can be opened via the Xcode -> Open Developer Tool -> More Developer Tools... menu item.
     69          After downloading and mounting the disk image, drag the PackageMaker application to your /Applications
     70          directory.
    16571        </para>
    16672      </section>
     
    17076      <title>Install Xcode on Mac OS X 10.6 Snow Leopard</title>
    17177
    172       <para>If you are using Mac OS X 10.6, there are two branches of Xcode
    173         which could be considered to be the latest, 3.2.x and 4.x. Xcode 4
    174         costs money, but Xcode 3 is still available free of charge. There are
    175         two options for downloading it:
     78      <para>
     79        If you are using Mac OS X 10.6, there are two branches of Xcode which could be considered to be the latest,
     80        3.2.x and 4.x. Xcode 4 costs money, but Xcode 3 is still available free of charge. There are two options for
     81        downloading it:
    17682        <orderedlist>
    17783          <listitem>
    17884            <para>
    179               <ulink url="https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20588">
    180                 Xcode 3.2.2</ulink> - smaller download, but you will need to run Software Update after installing to
    181               get the latest version.
     85              Xcode 3.2 - smaller download, but you will need to run Software Update after installing to get the latest
     86              version. Note that Apple might at some point discontinue providing these updates via their update servers.
    18287            </para>
    18388          </listitem>
    18489          <listitem>
    18590            <para>
    186               <ulink url="https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20792">
    187                 Xcode 3.2.6 and iOS SDK 4.3</ulink> - includes iOS SDK which is not needed for MacPorts.
     91              Xcode 3.2.6 and iOS SDK 4.3 - includes the iOS SDK which is not needed for MacPorts.
    18892            </para>
    18993          </listitem>
    19094        </orderedlist>
    191         You may also be able to install Xcode 3.2 from your Mac OS X 10.6 DVD and then run Software Update to get
    192         the latest version.
     95        Both are available from the <ulink url="https://developer.apple.com/downloads/index.action">Apple developer
     96          website</ulink>. You may also be able to install Xcode 3.2 from your Mac OS X 10.6 DVD and then run Software
     97        Update to get the latest version.
    19398      </para>
    19499
    195       <para>Ensure that those of the following options that are available in the
    196       installer for your version of Xcode are selected:
    197       <itemizedlist>
    198           <listitem>
    199               <guibutton>UNIX Development</guibutton>
    200           </listitem>
    201           <listitem>
    202               <guibutton>System Tools</guibutton>
    203           </listitem>
    204           <listitem>
    205               <guibutton>X11 SDK</guibutton>
    206           </listitem>
    207           <listitem>
    208               <guibutton>Command Line Support</guibutton>
     100      <para>
     101        Ensure that those of the following options that are available in the installer for your version of Xcode are
     102        selected:
     103        <itemizedlist>
     104          <listitem>
     105            <guibutton>UNIX Development</guibutton>
     106          </listitem>
     107          <listitem>
     108            <guibutton>System Tools</guibutton>
     109          </listitem>
     110          <listitem>
     111            <guibutton>X11 SDK</guibutton>
     112          </listitem>
     113          <listitem>
     114            <guibutton>Command Line Support</guibutton>
    209115          </listitem>
    210116        </itemizedlist>
     
    216122
    217123      <para>
    218         If you have an earlier release of Mac OS X, you may download
    219         the latest version of Xcode
    220         <ulink
    221           url="http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20491">for OS X 10.5 (v3.1.4)</ulink>
    222         or
    223         <ulink
    224           url="http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907">for 10.4 (v2.5)</ulink>.
     124        If you have an earlier release of Mac OS X, you may download the latest version of Xcode for OS X 10.5 (Xcode
     125        3.0 and Xcode 3.1 Developer Tools) or 10.4 (Xcode 2.4.1 and Xcode 2.5 Developer Tools) from the <ulink
     126          url="https://developer.apple.com/downloads/index.action">Apple developer website</ulink>.
    225127      </para>
    226128
    227       <para>Ensure that those of the following options that are available in the
    228       installer for your version of Xcode are selected:
    229       <itemizedlist>
    230           <listitem>
    231               <guibutton>UNIX Development</guibutton>
    232           </listitem>
    233           <listitem>
    234               <guibutton>System Tools</guibutton>
    235           </listitem>
    236           <listitem>
    237               <guibutton>X11 SDK</guibutton>
    238           </listitem>
    239           <listitem>
    240               <guibutton>Command Line Support</guibutton>
     129      <para>
     130        Ensure that those of the following options that are available in the installer for your version of Xcode are
     131        selected:
     132        <itemizedlist>
     133          <listitem>
     134            <guibutton>UNIX Development</guibutton>
     135          </listitem>
     136          <listitem>
     137            <guibutton>System Tools</guibutton>
     138          </listitem>
     139          <listitem>
     140            <guibutton>X11 SDK</guibutton>
     141          </listitem>
     142          <listitem>
     143            <guibutton>Command Line Support</guibutton>
    241144          </listitem>
    242145        </itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.