[30993] trunk/doc-new/guide/xml/installing.xml
source_changes at macosforge.org
source_changes at macosforge.org
Tue Nov 13 01:49:15 PST 2007
Revision: 30993
http://trac.macosforge.org/projects/macports/changeset/30993
Author: markd at macports.org
Date: 2007-11-13 01:49:14 -0800 (Tue, 13 Nov 2007)
Log Message:
-----------
Refine MacPorts install section; add uninstall section.
Modified Paths:
--------------
trunk/doc-new/guide/xml/installing.xml
Modified: trunk/doc-new/guide/xml/installing.xml
===================================================================
--- trunk/doc-new/guide/xml/installing.xml 2007-11-13 09:38:08 UTC (rev 30992)
+++ trunk/doc-new/guide/xml/installing.xml 2007-11-13 09:49:14 UTC (rev 30993)
@@ -122,89 +122,113 @@
</section>
</section>
- <section id="installing.binary">
- <title>Install MacPorts - Binary</title>
+ <section>
+ <title>Install MacPorts</title>
- <para>If you wish to install MacPorts to a path other than
- <filename>/opt/local</filename> do not install the MacPorts binary —skip
- this section and <link linkend="installing.source">install MacPorts from
- the source code</link>. The MacPorts binary installer will only install to
- <filename>/opt/local</filename>.</para>
+ <para>If you are using OS X, you should install MacPorts using the OS X
+ package installer unless you do not wish to install it to
+ <filename>/opt/local/</filename>, the default MacPorts location, or if you
+ wish to install a pre-release version of MacPorts. However, if you wish to
+ install <ulink url="installing.source.multiple">multiple copies of
+ MacPorts</ulink> or install MacPorts on another OS platform, you must
+ <link linkend="installing.source">install MacPorts from the source
+ code</link>.</para>
- <orderedlist>
- <listitem>
- <para>Download the latest MacPorts .dmg disk image from the <ulink
- url="http://svn.macports.org/repository/macports/downloads/">MacPorts
- download directory</ulink>.</para>
- </listitem>
+ <section id="installing.binary">
+ <title>OS X Package Install</title>
- <listitem>
- <para>Run the binary installer.</para>
- </listitem>
+ <para>To install MacPorts with the OS X package installer, follow these
+ steps.</para>
- <listitem>
- <para>Perform the default “easy” install.</para>
- </listitem>
- </orderedlist>
+ <orderedlist>
+ <listitem>
+ <para>Download the latest MacPorts .dmg disk image from the <ulink
+ url="http://svn.macports.org/repository/macports/downloads/">MacPorts
+ download directory</ulink>.</para>
+ </listitem>
- <note>
- <para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
- operation will automatically update to the latest release if the binary
- .dmg image is behind the latest released tarball.</para>
- </note>
- </section>
+ <listitem>
+ <para>Double-click the .pkg package installer on the disk
+ image.</para>
+ </listitem>
- <section id="installing.source">
- <title>Install MacPorts - Source</title>
+ <listitem>
+ <para>Perform the default “easy” install.</para>
+ </listitem>
+ </orderedlist>
- <para>If you installed MacPorts using the binary installer, skip this
- section. Installing from source on Mac OS X is only necessary if you wish
- to install to a path other than <filename>/opt/local</filename>, or if you
- wish to install a non-release version of MacPorts base. You must also
- install MacPorts from source if you wish to install MacPorts on a platform
- other than Mac OS X.</para>
+ <note>
+ <para>Use the MacPorts <link
+ linkend="installing.selfupdate">selfupdate</link> operation
+ immediately after installing MacPorts. If a newer MacPorts base point
+ revision has been released before a new package installer has been
+ made, it is automatically upgraded.</para>
+ </note>
+ </section>
- <orderedlist>
- <listitem>
- <para>Download and unzip the latest MacPorts tarball from the <ulink
- url="http://svn.macports.org/repository/macports/downloads/">MacPorts
- download directory</ulink>.</para>
- </listitem>
+ <section id="installing.source">
+ <title>Source Install</title>
- <listitem>
- <para>Perform these commands in a terminal window, substituting a real
- path for NEW_PREFIX if you wish to use a path other than
- <filename>/opt/local/</filename>.</para>
+ <para>If you installed MacPorts using the package installer, skip this
+ section. To install MacPorts from the source code, follow these
+ steps.</para>
- <programlisting><prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
+ <orderedlist>
+ <listitem>
+ <para>Download and unzip the latest MacPorts tarball from the <ulink
+ url="http://svn.macports.org/repository/macports/downloads/">MacPorts
+ download directory</ulink>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Perform these commands in a terminal window, substituting a
+ real path for NEW_PREFIX if you wish to use a path other than
+ <filename>/opt/local/</filename>.</para>
+
+ <programlisting><prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
<prompt>%%</prompt> <userinput>./configure</userinput> --prefix=NEW_PREFIX (setting prefix is optional)
<prompt>%%</prompt> <userinput>make</userinput>
<prompt>%%</prompt> <userinput>sudo make install</userinput></programlisting>
- </listitem>
- </orderedlist>
+ </listitem>
+ </orderedlist>
- <section id="installing.source.multiple">
- <title>Multiple MacPorts Installs</title>
+ <section id="installing.source.multiple">
+ <title>Install Multiple MacPorts Copies</title>
- <para>Occasionally a MacPorts developer may wish to install more than
- one copy of MacPorts on the same host, possibly to test two different
- versions of MacPorts. But only one copy of MacPorts may use the default
- MacPorts Tcl library path <filename>/Library/Tcl</filename>, so for a
- second installation use the <literal>--with-tclpackage</literal> switch
- set to any newly created (empty) directory, say
- /Library/Tcl/macports-new. Also, the standard MacPorts binary path must
- not be present during the installation of the second instance. To
- install a second instance of MacPorts, follow these steps.</para>
+ <para>Occasionally a MacPorts developer may wish to install more than
+ one copy of MacPorts on the same host, possibly to test two different
+ versions of MacPorts. But only one copy of MacPorts may use the
+ default MacPorts Tcl library path <filename>/Library/Tcl/</filename>,
+ so for a second installation use the
+ <literal>--with-tclpackage</literal> switch set to any newly created
+ (empty) directory, say /Library/Tcl/macports-new. Also, the standard
+ MacPorts binary path must not be present during the installation of
+ the second instance. To install a second instance of MacPorts, follow
+ these steps.</para>
- <programlisting><prompt>%%</prompt> <userinput>export PATH=/bin:/sbin:/usr/bin:/usr/sbin</userinput>
+ <programlisting><prompt>%%</prompt> <userinput>export PATH=/bin:/sbin:/usr/bin:/usr/sbin</userinput>
<prompt>%%</prompt> <userinput>cd ~/MacPorts-1.x.x/</userinput>
<prompt>%%</prompt> <userinput>./configure --prefix=NEW_PREFIX --with-tcl-package=NEW_TCLPACKAGE</userinput>
<prompt>%%</prompt> <userinput>make</userinput>
<prompt>%%</prompt> <userinput>sudo make install</userinput>
</programlisting>
+ </section>
</section>
</section>
+ <section>
+ <title>Uninstall MacPorts</title>
+
+ <para>To uninstall MacPorts from the default location
+ <filename>/opt/local/</filename>, perform these commands from a terminal
+ window.</para>
+
+ <programlisting>%% <userinput>sudo rm -rf /opt/local/</userinput>
+%% <userinput>sudo rm -rf /Applications/MacPorts/</userinput>
+%% <userinput>sudo rm -rf /Library/Tcl/macports1.0/</userinput>
+%% <userinput>sudo rm -rf /Library/LaunchDaemons/org.macports.*</userinput></programlisting>
+ </section>
+
<section id="installing.shell">
<title>Set the Bash Shell</title>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071113/c3db01f3/attachment.html
More information about the macports-changes
mailing list