[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 &amp; 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 &ldquo;Portfiles&rdquo;
-    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. &ldquo;<kbd>cd</kbd>&rdquo; into the directory where you downloaded the package
-    and run &ldquo;<kbd>tar xjvf <a href="<?php print $bz2_tarball; ?>">MacPorts-<?php print "$mp_version_major"; ?>.tar.bz2
-    </a></kbd>&rdquo; or &ldquo;<kbd>tar xzvf <a href="<?php print $gz_tarball; ?>">MacPorts-<?php print "$mp_version_major";
-    ?>.tar.gz</a></kbd>&rdquo;, 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 &amp;&amp; make &amp;&amp; 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 &ldquo;<kbd>sudo</kbd>&rdquo;
-    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
-    &ldquo;<kbd>./configure --help | more</kbd>&rdquo; 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 &ldquo;<kbd>svn update</kbd>&rdquo; 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 &amp; 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 &amp; 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 &amp; 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
+    &ldquo;Customize&rdquo; 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 &ldquo;Portfiles&rdquo;
+    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. &ldquo;<kbd>cd</kbd>&rdquo; into the directory where you downloaded the package
+    and run &ldquo;<kbd>tar xjvf <a href="<?php print $bz2_tarball; ?>">MacPorts-<?php print "$mp_version_major"; ?>.tar.bz2
+    </a></kbd>&rdquo; or &ldquo;<kbd>tar xzvf <a href="<?php print $gz_tarball; ?>">MacPorts-<?php print "$mp_version_major";
+    ?>.tar.gz</a></kbd>&rdquo;, 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 &amp;&amp; make &amp;&amp; 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 &ldquo;<kbd>sudo</kbd>&rdquo;
+    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
+    &ldquo;<kbd>./configure --help | more</kbd>&rdquo; 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> &amp; <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' &ldquo;base&rdquo;, 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