[30323] trunk/www/install.php
source_changes at macosforge.org
source_changes at macosforge.org
Wed Oct 24 13:36:38 PDT 2007
Revision: 30323
http://trac.macosforge.org/projects/macports/changeset/30323
Author: jmpp at macports.org
Date: 2007-10-24 13:36:38 -0700 (Wed, 24 Oct 2007)
Log Message:
-----------
RRI: Revise, Reorganize, Itemize.
Modified Paths:
--------------
trunk/www/install.php
Modified: trunk/www/install.php
===================================================================
--- trunk/www/install.php 2007-10-24 20:35:09 UTC (rev 30322)
+++ trunk/www/install.php 2007-10-24 20:36:38 UTC (rev 30323)
@@ -13,36 +13,49 @@
<h2 class="hdr">Installing MacPorts</h2>
- <p>MacPorts version <?php print $mp_version_major; ?> is available in binary form as dmg disk images for <a
- href="<?php print $tiger_dmg; ?>"> Tiger (Universal)</a> and <a href="<?php print $panther_dmg; ?>"> Panther (PowerPC)</a>,
- both containing a pkg installer, or in source form as either a <a href="<?php print $bz2_tarball ?>">tar.bz2</a>
- package or a <a href="<?php print $gz_tarball; ?>">tar.gz</a> one. Checksums for all these are contained in the
- <a href="<?php print $checksums; ?>">checksums file</a>.</p>
+ <p>MacPorts version <?php print $mp_version_major; ?> is available in various formats for download and installation:</p>
- <p>To get a files listing of all our available downloads checkout the <a href="<?php print $downloads; ?>">
- downloads section</a> of the site.</p>
+ <ul>
+ <li>“dmg” disk images for both <a href="<?php print $tiger_dmg; ?>">Tiger (Universal)</a> and
+ <a href="<?php print $panther_dmg; ?>">Panther (PowerPC)</a>, both containing <a href="#pkg">a pkg installer</a>.</li>
+ <li>In <a href="#source">source form</a> as either a <a href="<?php print $bz2_tarball ?>">tar.bz2</a> package
+ or a <a href="<?php print $gz_tarball; ?>">tar.gz</a> one.</li>
+ <li><a href="#svn">SVN checkout</a>.</li>
+ </ul>
-<!-- (NOTE: I still need to investigate whether X11 installation is optional or default on Tiger/Leopard and how dev
- tools installation reacts to X11User being installed or not - that is, is X11SDK default/optional based on X11User presence?) -->
- <p>Please note that in order to install and run MacPorts on Mac OS X you must have Apple's Developer Tools
- package installed, found at the <a href="http://developer.apple.com/tools/xcode/">Apple Developer site</a>
- or on your Mac OS X installation CDs/DVD. It is also strongly recommended to have the X11 windowing environment (X11 User)
- and its related SDK package (X11 SDK) installed if you wish to install ports that depend on the functionality
- they provide to compile and run. While the former is part of the base Mac OS X installation process, the latter
- is an optional installation in the Developer Tools package, so you need to add it explicitly through the
- “Customize” button of the corresponding installer.</p>
+ <p>Checksums for all our <a href="<?php print $downloads; ?>">downloads</a> are contained in the <a href="<?php print
+ $checksums; ?>">checksums file</a>.</p>
+ <p>Please note that in order to install and run MacPorts on Mac OS X your system must have installations of the
+ following components:</p>
- <h3 class="subhdr">Mac OS X Package (.pkg) Installer</h3>
+ <ol>
+ <li>Apple's Developer Tools, found at the <a href="http://developer.apple.com/tools/xcode/">
+ Apple Developer site</a> or on your Mac OS X installation CDs/DVD.</li>
+ <li>The X11 windowing environment (A.K.A. “X11 User”) and its related SDK package (“X11 SDK”)
+ for ports that depend on the functioanlity they provide to compile and run.
+ <ul>
+ <li>on Panther and Tiger, the “X11 User” package is an optional installation on your system
+ CDs/DVD (enabled through the “Customize” button of the installer), whereas it is included by
+ default on Leopard.</li>
+ <li>the “X11 SDK” package on each OS specific Developer Tools installer reacts to included or
+ optional depending on whether “X11 User” is installed or not.</li>
+ </ul>
+ </li>
+ </ol>
+
+ <h3 class="subhdr" id="pkg">Mac OS X Package (.pkg) Installer</h3>
+
<p>The easiest way to install MacPorts on a Mac OS X system is by downloading the <a href="<?php print $tiger_dmg;
?>">dmg for Tiger</a> or the one <a href="<?php print $panther_dmg; ?>">for Panther</a> respectively and running
the system's Installer by double clicking on the pkg contained therein, following the on-screen instructions until
- completion. This procedure will place a fully functional and default MacPorts installation on your host system,
- ready for usage. If needed your shell configuration files will be adapted by the installer to include the necessary
- settings to run MacPorts and the programs it installs. You may need to open a new shell for these changes to take
- effect.</p>
+ completion.</p>
+ <p>This procedure will place a fully functional and default MacPorts installation on your host system, ready for usage.
+ If needed your shell configuration files will be adapted by the installer to include the necessary settings to run MacPorts
+ and the programs it installs, but you may need to open a new shell for these changes to take effect.</p>
+
<p>The MacPorts “<kbd>selfupdate</kbd>” command will be run for you by the installer to ensure you have
our latest available release and the latest revisions to the “Portfiles” that contain the instructions
employed in the building and installation of ports. After installation is done, it is recommended that you run this
@@ -53,46 +66,72 @@
<p>At this point you should be ready to enjoy MacPorts!</p>
- <h3 class="subhdr">Source Installation</h3>
+ <h3 class="subhdr" id="source">Source Installation</h3>
- <p>If on the other hand you decide to install MacPorts from source, there are still a couple of things you will need to
- do after downloading the tarball before you can start installing ports, namely compiling and installing MacPorts itself.
- “<kbd>cd</kbd>” into the directory where you downloaded the package and run “<kbd>tar xjvf <a href=
- "<?php print $bz2_tarball; ?>">MacPorts-<?php print $mp_version_major; ?>.tar.bz2 </a></kbd>” or “<kbd>tar
- xzvf <a href="<?php print $gz_tarball; ?>">MacPorts-<?php print $mp_version_major; ?>.tar.gz</a></kbd>”, depending
- on whether you downloaded the bz2 tarball or the gz one, respectively. This will unpack the MacPorts sources that you will
- proceed to build and install. To do so, execute the following:</p>
+ <p>If on the other hand you decide to install MacPorts from source, there are still a couple of things you will need
+ to do after downloading the tarball before you can start installing ports, namely compiling and installing MacPorts
+ itself:</p>
-<pre>cd MacPorts-<?php print $mp_version_major . "\n"; ?>
-./configure && make && sudo make install</pre>
- <p>Optionally:</p>
+ <ol>
+ <li>“<kbd>cd</kbd>” into the directory where you downloaded the package and run “<kbd>tar xjvf
+ <a href="<?php print $bz2_tarball; ?>">MacPorts-<?php print $mp_version_major; ?>.tar.bz2</a></kbd>” or
+ “<kbd>tar xzvf <a href="<?php print $gz_tarball; ?>">MacPorts-<?php print $mp_version_major; ?>.tar.gz</a></kbd>”,
+ depending on whether you downloaded the bz2 tarball or the gz one, respectively.</li>
+ <li>Build and install the recently unpacked sources:
+ <ul>
+ <li><kbd>cd MacPorts-<?php print $mp_version_major; ?></kbd></li>
+ <li><kbd>./configure && make && sudo make install</kbd></li>
+ </ul>
+ Optionally:
+ <ul>
+ <li><kbd>cd ../</kbd></li>
+ <li><kbd>rm -rf MacPorts-<?php print $mp_version_major; ?>*</kbd></li>
+ </ul>
+
+ </li>
+ </ol>
-<pre>cd ../
-rm -rf MacPorts-<?php print $mp_version_major; ?>*</pre>
+ <p>These steps need to be perfomed from an administrator account, for which “<kbd>sudo</kbd>” will ask the
+ password upon installation. This procedure will install a pristine MacPorts system and, if the optional steps are taken,
+ remove the as of now unnecessary MacPorts-<?php print $mp_version_major; ?> source directory and corresponding tarball.</p>
- <p>These steps need to be perfomed from an administrator account, for which “<kbd>sudo</kbd>”
- will ask the password upon installation. This procedure will install a pristine MacPorts system and, if the
- optional steps are taken, remove the as of now unnecessary MacPorts-<?php print $mp_version_major; ?> source
- directory and corresponding tarball. To customize your installation you should read the output of
- “<kbd>./configure --help | more</kbd>” and pass the appropriate options for the settings you wish to
- tweak to the configuration script in the steps detailed above.</p>
+ <p>To customize your installation you should read the output of “<kbd>./configure --help | more</kbd>”
+ and pass the appropriate options for the settings you wish to tweak to the configuration script in the steps detailed above.</p>
- <p>You will need to manually adapt your shell's configuration files to find the binaries installed by MacPorts,
- adding <kbd>${prefix}/bin</kbd> and <kbd>${prefix}/sbin</kbd> to the start of your <kbd>PATH</kbd> environment
- variable so that they take precedence over equally named system provided programs. The <kbd>${prefix}</kbd> variable
- stands for the path you chose to install MacPorts onto through <kbd>configure</kbd>'s <kbd>--prefix</kbd> flag,
- defaulting to <kbd>/opt/local</kbd> if no custom value is used. Adding an appropriate X11 <kbd>DISPLAY</kbd>
- environment variable is also recommended if you wish to run X11 dependent programs.</p>
+ <p>You will need to manually adapt your shell's environment to work with MacPorts and your chosen installation <kbd>prefix</kbd>
+ (the value passed to <kbd>configure</kbd>'s <kbd>--prefix</kbd> flag, defaulting to <kbd>/opt/local</kbd>):</p>
+ <ul>
+ <li><kbd>Add ${prefix}/bin</kbd> and <kbd>${prefix}/sbin</kbd> to the start of your <kbd>PATH</kbd> environment variable so
+ that MacPorts installed programs take precedence over equally named system provided programs.</li>
+ <li>Add an appropriate X11 <kbd>DISPLAY</kbd> environment variable to run X11 dependent programs.</li>
+ </ul>
+
<p>Lastly, you need to synchronize your installation with the MacPorts rsync server:</p>
<pre>sudo port -d selfupdate</pre>
- <p>Upon completion MacPorts will be ready to install ports. Again, it is recommended to run the above
+ <p>Upon completion MacPorts will be ready to install ports! Again, it is recommended to run the above
command on a regular basis to keep your installation current.</p>
+ <h3 class="subhdr" id="svn">SVN Sources</h3>
+
+ <p>If you are developer or a user with a taste for the bleeding edge and wish for the latest changes and feature additions,
+ you may acquire the MacPorts sources through SVN.</p>
+
+ <p>Use the following command to check the project's trunk out of the MacPorts anonymous subversion repository, containing
+ all of our source modules (MacPorts' “base”, the ports tree and all of our documentation in raw form):</p>
+
+ <pre>svn co <?php print $svn_url . 'trunk'; ?></pre>
+
+ <p>Purpose specific branches are also available at the <kbd><?php print $svn_url . 'branches'; ?></kbd> url.</p>
+
+ <p>Alternatively, if you'd simply like to view the SVN repository without checking it out, you can do so via the
+ <a href="http://trac.macports.org/projects/macports/browser">Trac source browser</a>.</p>
+
+
<h3 class="subhdr">Other Platforms</h3>
<p>Running on platforms other than Mac OS X is not the main focus of the MacPorts project, so remaining cross-platform
@@ -101,7 +140,7 @@
<p>The full list of requirements to run MacPorts on these other platforms is as follows (we assume you have the
basics such as GCC and X11):</p>
-
+
<ul>
<li><a href="http://www.tcl.tk/">Tcl</a> (8.3 or 8.4), with threads</li>
<li><a href="http://gnustep.org/">GNUstep</a> (Base), for Foundation</li>
@@ -124,21 +163,6 @@
to <a href="contact.php">contact us</a>!</p>
- <h3 class="subhdr">SVN Sources</h3>
-
- <p>If you are developer or a user with a taste for the bleeding edge and wish for the latest changes and feature additions,
- you may acquire the MacPorts sources through SVN.</p>
-
- <p>Use the following command to check the project's trunk out of the MacPorts anonymous subversion repository, containing
- all of our source modules (MacPorts' “base”, the ports tree and all of our documentation in raw form):</p>
-
-<pre>svn co <?php print $svn_url . 'trunk'; ?></pre>
-
- <p>Purpose specific branches are also available at the <kbd><?php print $svn_url . 'branches'; ?></kbd> url.</p>
-
- <p>Alternatively, if you'd simply like to view the SVN repository without checking it out, you can do so via the
- <a href="http://trac.macports.org/projects/macports/browser">Trac source browser</a>.</p>
-
</div>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071024/9858662b/attachment.html
More information about the macports-changes
mailing list