Changeset 30993 for trunk/doc-new


Ignore:
Timestamp:
Nov 13, 2007, 9:49:14 AM (12 years ago)
Author:
markd@…
Message:

Refine MacPorts install section; add uninstall section.

File:
1 edited

Legend:

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

    r29713 r30993  
    123123  </section>
    124124
    125   <section id="installing.binary">
    126     <title>Install MacPorts - Binary</title>
    127 
    128     <para>If you wish to install MacPorts to a path other than
    129     <filename>/opt/local</filename> do not install the MacPorts binary —skip
    130     this section and <link linkend="installing.source">install MacPorts from
    131     the source code</link>. The MacPorts binary installer will only install to
    132     <filename>/opt/local</filename>.</para>
    133 
    134     <orderedlist>
    135       <listitem>
    136         <para>Download the latest MacPorts .dmg disk image from the <ulink
    137         url="http://svn.macports.org/repository/macports/downloads/">MacPorts
    138         download directory</ulink>.</para>
    139       </listitem>
    140 
    141       <listitem>
    142         <para>Run the binary installer.</para>
    143       </listitem>
    144 
    145       <listitem>
    146         <para>Perform the default “easy” install.</para>
    147       </listitem>
    148     </orderedlist>
    149 
    150     <note>
    151       <para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
    152       operation will automatically update to the latest release if the binary
    153       .dmg image is behind the latest released tarball.</para>
    154     </note>
    155   </section>
    156 
    157   <section id="installing.source">
    158     <title>Install MacPorts - Source</title>
    159 
    160     <para>If you installed MacPorts using the binary installer, skip this
    161     section. Installing from source on Mac OS X is only necessary if you wish
    162     to install to a path other than <filename>/opt/local</filename>, or if you
    163     wish to install a non-release version of MacPorts base. You must also
    164     install MacPorts from source if you wish to install MacPorts on a platform
    165     other than Mac OS X.</para>
    166 
    167     <orderedlist>
    168       <listitem>
    169         <para>Download and unzip the latest MacPorts tarball from the <ulink
    170         url="http://svn.macports.org/repository/macports/downloads/">MacPorts
    171         download directory</ulink>.</para>
    172       </listitem>
    173 
    174       <listitem>
    175         <para>Perform these commands in a terminal window, substituting a real
    176         path for NEW_PREFIX if you wish to use a path other than
    177         <filename>/opt/local/</filename>.</para>
    178 
    179         <programlisting><prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
     125  <section>
     126    <title>Install MacPorts</title>
     127
     128    <para>If you are using OS X, you should install MacPorts using the OS X
     129    package installer unless you do not wish to install it to
     130    <filename>/opt/local/</filename>, the default MacPorts location, or if you
     131    wish to install a pre-release version of MacPorts. However, if you wish to
     132    install <ulink url="installing.source.multiple">multiple copies of
     133    MacPorts</ulink> or install MacPorts on another OS platform, you must
     134    <link linkend="installing.source">install MacPorts from the source
     135    code</link>.</para>
     136
     137    <section id="installing.binary">
     138      <title>OS X Package Install</title>
     139
     140      <para>To install MacPorts with the OS X package installer, follow these
     141      steps.</para>
     142
     143      <orderedlist>
     144        <listitem>
     145          <para>Download the latest MacPorts .dmg disk image from the <ulink
     146          url="http://svn.macports.org/repository/macports/downloads/">MacPorts
     147          download directory</ulink>.</para>
     148        </listitem>
     149
     150        <listitem>
     151          <para>Double-click the .pkg package installer on the disk
     152          image.</para>
     153        </listitem>
     154
     155        <listitem>
     156          <para>Perform the default “easy” install.</para>
     157        </listitem>
     158      </orderedlist>
     159
     160      <note>
     161        <para>Use the MacPorts <link
     162        linkend="installing.selfupdate">selfupdate</link> operation
     163        immediately after installing MacPorts. If a newer MacPorts base point
     164        revision has been released before a new package installer has been
     165        made, it is automatically upgraded.</para>
     166      </note>
     167    </section>
     168
     169    <section id="installing.source">
     170      <title>Source Install</title>
     171
     172      <para>If you installed MacPorts using the package installer, skip this
     173      section. To install MacPorts from the source code, follow these
     174      steps.</para>
     175
     176      <orderedlist>
     177        <listitem>
     178          <para>Download and unzip the latest MacPorts tarball from the <ulink
     179          url="http://svn.macports.org/repository/macports/downloads/">MacPorts
     180          download directory</ulink>.</para>
     181        </listitem>
     182
     183        <listitem>
     184          <para>Perform these commands in a terminal window, substituting a
     185          real path for NEW_PREFIX if you wish to use a path other than
     186          <filename>/opt/local/</filename>.</para>
     187
     188          <programlisting><prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
    180189<prompt>%%</prompt> <userinput>./configure</userinput> --prefix=NEW_PREFIX  (setting prefix is optional)
    181190<prompt>%%</prompt> <userinput>make</userinput>
    182191<prompt>%%</prompt> <userinput>sudo make install</userinput></programlisting>
    183       </listitem>
    184     </orderedlist>
    185 
    186     <section id="installing.source.multiple">
    187       <title>Multiple MacPorts Installs</title>
    188 
    189       <para>Occasionally a MacPorts developer may wish to install more than
    190       one copy of MacPorts on the same host, possibly to test two different
    191       versions of MacPorts. But only one copy of MacPorts may use the default
    192       MacPorts Tcl library path <filename>/Library/Tcl</filename>, so for a
    193       second installation use the <literal>--with-tclpackage</literal> switch
    194       set to any newly created (empty) directory, say
    195       /Library/Tcl/macports-new. Also, the standard MacPorts binary path must
    196       not be present during the installation of the second instance. To
    197       install a second instance of MacPorts, follow these steps.</para>
    198 
    199       <programlisting><prompt>%%</prompt> <userinput>export PATH=/bin:/sbin:/usr/bin:/usr/sbin</userinput>
     192        </listitem>
     193      </orderedlist>
     194
     195      <section id="installing.source.multiple">
     196        <title>Install Multiple MacPorts Copies</title>
     197
     198        <para>Occasionally a MacPorts developer may wish to install more than
     199        one copy of MacPorts on the same host, possibly to test two different
     200        versions of MacPorts. But only one copy of MacPorts may use the
     201        default MacPorts Tcl library path <filename>/Library/Tcl/</filename>,
     202        so for a second installation use the
     203        <literal>--with-tclpackage</literal> switch set to any newly created
     204        (empty) directory, say /Library/Tcl/macports-new. Also, the standard
     205        MacPorts binary path must not be present during the installation of
     206        the second instance. To install a second instance of MacPorts, follow
     207        these steps.</para>
     208
     209        <programlisting><prompt>%%</prompt> <userinput>export PATH=/bin:/sbin:/usr/bin:/usr/sbin</userinput>
    200210<prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
    201211<prompt>%%</prompt> <userinput>./configure --prefix=NEW_PREFIX --with-tcl-package=NEW_TCLPACKAGE</userinput>
     
    203213<prompt>%%</prompt> <userinput>sudo make install</userinput>
    204214</programlisting>
     215      </section>
    205216    </section>
     217  </section>
     218
     219  <section>
     220    <title>Uninstall MacPorts</title>
     221
     222    <para>To uninstall MacPorts from the default location
     223    <filename>/opt/local/</filename>, perform these commands from a terminal
     224    window.</para>
     225
     226    <programlisting>%% <userinput>sudo rm -rf /opt/local/</userinput>
     227%% <userinput>sudo rm -rf /Applications/MacPorts/</userinput>
     228%% <userinput>sudo rm -rf /Library/Tcl/macports1.0/</userinput>
     229%% <userinput>sudo rm -rf /Library/LaunchDaemons/org.macports.*</userinput></programlisting>
    206230  </section>
    207231
Note: See TracChangeset for help on using the changeset viewer.