[29593] trunk/www
source_changes at macosforge.org
source_changes at macosforge.org
Mon Oct 1 16:04:37 PDT 2007
Revision: 29593
http://trac.macosforge.org/projects/macports/changeset/29593
Author: jmpp at macports.org
Date: 2007-10-01 16:04:37 -0700 (Mon, 01 Oct 2007)
Log Message:
-----------
* Rename the getmp.php page to a better suited install.php, update references;
* Provide extra information in the new install.php, which I believe should be
somewhat merged with the new guide efforts (next to be discussed on macports-dev@).
Modified Paths:
--------------
trunk/www/includes/header.inc
trunk/www/index.php
Added Paths:
-----------
trunk/www/install.php
Removed Paths:
-------------
trunk/www/getmp.php
Deleted: trunk/www/getmp.php
===================================================================
--- trunk/www/getmp.php 2007-10-01 22:56:13 UTC (rev 29592)
+++ trunk/www/getmp.php 2007-10-01 23:04:37 UTC (rev 29593)
@@ -1,112 +0,0 @@
-<?php
- /* $Id$ */
- $MPWEB = $_SERVER['DOCUMENT_ROOT'] . dirname($_SERVER['SCRIPT_NAME']);
- include_once("$MPWEB/includes/common.inc");
- print_header('MacPorts -- Download & Installation', 'utf-8');
-?>
-
-<div id="content">
-
- <h2 class="hdr">Get MacPorts</h2>
-
- <p>MacPorts version <?php print "$mp_version_major"; ?> is available in binary form as a dmg disk image for <a
- href="<?php print $tiger_dmg; ?>"> Tiger (Universal)</a> or <a href="<?php print $panther_dmg; ?>"> Panther</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>To get a files listing of all our available downloads checkout the <a href="<?php print $downloads; ?>">
- downloads section</a> of the site.</p>
-
- <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 installation CDs/DVD.</p>
-
- <p>If you want to use MacPorts on a platform other than Mac OS X, please be aware of the following requirements
- (we assume that you have 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>
- <li><a href="http://rsync.samba.org/">rsync</a></li>
- <li><a href="http://curl.haxx.se/">cURL</a></li>
- <li><a href="http://www.openssl.org/">OpenSSL</a> or <a href="http://martin.hinner.info/libmd/">libmd</a></li>
- </ul>
-
- <h3 class="subhdr">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 <a href="<?php print $panther_dmg; ?>"> one for Panther</a> and running Installer.app
- on the pkg contained therein by double clicking on them, 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. You may need to open a new shell for these changes to take effect.</p>
-
- <p>Although not strictly necessary, it is still recommended that you synchronize your recent installation with our
- rsync server to ensure you have the latest release available of the MacPorts infrastructure and of the “Portfiles”
- containing the instructions employed in the building and installation of ports. To accomplish this simply execute:</p>
-
- <pre>sudo port -d selfupdate</pre>
-
- <p>It is also recommended to run the above command on a regular basis to keep your installation always current.
- At this point you should be ready to enjoy MacPorts!</p>
-
- <h3 class="subhdr">Source Installation</h3>
-
- <p>If on the other hand you decide to install from source, there are still a couple of things you will need to
- do once you've downloaded the tarball before you can install a port with the MacPorts system, 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>
-
-<pre>cd MacPorts-<?php print $mp_version_major; ?>
-
-./configure && make && sudo make install</pre>
-
- <p>Optionally:</p>
-
-<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. 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 adapt your shell's configuration files to find the binaries installed by MacPorts.
- Lastly, you need to synchronize your recent 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
- command on a regular basis to keep your installation current.</p>
-
- <h3 class="subhdr">Help</h3>
-
- <p>Help is also available through our <a href="<?php print $trac_url; ?>">Trac portal</a> should you need it.</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 out of the MacPorts anonymous subversion repository:</p>
-
-<pre>svn co <?php print $svn_url . '/trunk'; ?></pre>
-
- <p>If you do not want to bother with fetching from SVN, you can download a nightly updated
- <a href="/macports/downloads/macports-nightly-svn-snapshot.tar.gz"> SVN-snapshot</a>. Once extracted,
- you can keep it up to date with the usual “<kbd>svn update</kbd>” commands.</p>
-
- <p>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 browser</a>.</p>
-
-</div>
-
-<?php
- print_footer();
-?>
Modified: trunk/www/includes/header.inc
===================================================================
--- trunk/www/includes/header.inc 2007-10-01 22:56:13 UTC (rev 29592)
+++ trunk/www/includes/header.inc 2007-10-01 23:04:37 UTC (rev 29593)
@@ -9,7 +9,7 @@
</h1>
<p class="accessibility"><a href="#content">Skip to Content</a></p>
<div id="header">
- <a id="download" href="getmp.php"><span class="accessibility">Download MacPorts</span></a>
+ <a id="download" href="install.php"><span class="accessibility">Download MacPorts</span></a>
<span class="accessibility">View site in</span>
<span><a href="#" id="language"><img src="img/en-enabled.png" alt="English" width="30" height="48" /></a></span>
<span id="languages">
@@ -25,7 +25,7 @@
<?php
$pages = array (
'Home' => 'index.php',
- 'Get MacPorts' => 'getmp.php',
+ 'Install MacPorts' => 'install.php',
'Available Ports' => 'ports.php',
'Documentation' => $guide_url,
'Support & Development' => $trac_url
Modified: trunk/www/index.php
===================================================================
--- trunk/www/index.php 2007-10-01 22:56:13 UTC (rev 29592)
+++ trunk/www/index.php 2007-10-01 23:04:37 UTC (rev 29593)
@@ -17,7 +17,7 @@
with more being added on a regular basis. You can track recently added ports by subscribing to the
<a href="http://lists.macosforge.org/mailman/listinfo/macports-changes">macports-changes</a> mailing list.</p>
- <p>For more information on obtaining and installing MacPorts, please see the <a href="getmp.php">Get MacPorts</a>
+ <p>For more information on obtaining and installing MacPorts, please see the <a href="install.php">installing MacPorts</a>
section of this site. Also be sure to check out the <a href="http://geeklair.net/new_macports_guide/">documentation</a>,
and if and if you have questions or run into problems, you can get help at our <a href="help.php">help section</a>.
The <a href="<?php print $trac_url . 'wiki'; ?>">MacPorts Wiki</a> is also a good resource for general and
@@ -32,7 +32,7 @@
please consult the <a href="http://geeklair.net/new_macports_guide/#project.membership">relevant documentation</a>
detailing our membership requirements and resulting duties & benefits from holding a MacPorts account.</p>
- <p><b>Current MacPorts <a href="getmp.php">release</a>: <?php print "$mp_version_latest"; ?></b></p>
+ <p><b>Current MacPorts <a href="install.php">release</a>: <?php print "$mp_version_latest"; ?></b></p>
<div id="news">
<h2 class="hdr">Project News</h2>
Copied: trunk/www/install.php (from rev 29490, trunk/www/getmp.php)
===================================================================
--- trunk/www/install.php (rev 0)
+++ trunk/www/install.php 2007-10-01 23:04:37 UTC (rev 29593)
@@ -0,0 +1,141 @@
+<?php
+ /* $Id$ */
+ $MPWEB = $_SERVER['DOCUMENT_ROOT'] . dirname($_SERVER['SCRIPT_NAME']);
+ include_once("$MPWEB/includes/common.inc");
+ print_header('MacPorts -- Download & Installation', 'utf-8');
+?>
+
+<div id="content">
+
+ <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</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>To get a files listing of all our available downloads checkout the <a href="<?php print $downloads; ?>">
+ downloads section</a> of the site.</p>
+
+ <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
+ 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>
+
+ <h3 class="subhdr">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 <a href="<?php print $panther_dmg; ?>"> one 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>
+
+ <p>Although not strictly necessary, it's recommended that you synchronize your recent installation with our rsync
+ server to ensure you have the latest available release of the MacPorts infrastructure and of the “Portfiles”
+ that contain the instructions employed in the building and installation of ports. To accomplish this simply open up a
+ terminal window and execute:</p>
+
+ <pre>sudo port -d selfupdate</pre>
+
+ <p>It is also recommended to run this command on a regular basis to keep your MacPorts installation always current.
+ At this point you should be ready to enjoy MacPorts!</p>
+
+ <h3 class="subhdr">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 once you've downloaded 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>
+
+<pre>cd MacPorts-<?php print $mp_version_major . "\n"; ?>
+./configure && make && sudo make install</pre>
+
+ <p>Optionally:</p>
+
+<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. 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>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
+ command on a regular basis to keep your installation current.</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
+ is not an actively pursued development goal. Nevertheless, it is not an actively discouraged goal either and therefore
+ some experimental support exists for other POSIX complaint platforms such as FreeBSD.</p>
+
+ <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>
+ <li><a href="http://rsync.samba.org/">rsync</a></li>
+ <li><a href="http://curl.haxx.se/">cURL</a></li>
+ <li><a href="http://www.openssl.org/">OpenSSL</a> or <a href="http://martin.hinner.info/libmd/">libmd</a></li>
+ </ul>
+
+ <h3 class="subhdr">Help</h3>
+
+ <p>Help on a wide variety of topics is also available in the project <a href="<?php print $guide_url; ?>">Guide</a> and
+ through our <a href="<?php print $trac_url; ?>">Trac portal</a> should you run into any problems installing and/or using
+ MacPorts. Of particular relevance are the <a href="<?php print $guide_url . '#installing'; ?>">installation</a> & <a
+ href="<?php print $guide_url . '#using'; ?>">usage</a> sections of the former and the <a href="<?php print $trac_url .
+ 'wiki/FAQ'; ?>">FAQ</a> section of the <a href="<?php print $trac_url . 'wiki'; ?>">Wiki</a>, where track of quesitons
+ that are fielded often on our <a href="<?php print $trac_url . 'wiki/MailingLists'; ?>">mailing lists</a> is kept.</p>
+
+ <p>All of our documentation is a work in progress, so if you spot an error or have a quesiton about some part of the
+ the <a href="<?php print $guide_url; ?>">Guide</a> and/or this website please do <a href="<?php print $guide_url .
+ '#project.tickets'; ?>">let us known</a>!</p>
+
+ <p>For more real-time discussion, the #MacPorts channel on the <a href="http://freenode.net/">Freenode IRC network</a> is
+ generally where we hang out. Though it is generally helpful, please keep in mind that no one is obligated to help or even
+ answer your question if you join the channel. Do not take it personally, simply ask your question on the <a href="<?php
+ print $trac_url . 'wiki/MailingLists'; ?>">mailing lists</a> instead.</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>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 browser</a>.</p>
+
+</div>
+
+<?php
+ print_footer();
+?>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071001/94d31f5c/attachment.html
More information about the macports-changes
mailing list