[30029] trunk/www
source_changes at macosforge.org
source_changes at macosforge.org
Thu Oct 18 11:40:45 PDT 2007
Revision: 30029
http://trac.macosforge.org/projects/macports/changeset/30029
Author: jmpp at macports.org
Date: 2007-10-18 11:40:44 -0700 (Thu, 18 Oct 2007)
Log Message:
-----------
* www/contact.php:
Provide an 'id' identifier to the "Mailing Lists" section in order to link directly to it;
Whitespace changes.
* www/install.php:
Cleanup the link to the panther dmg;
Clarify that 'selfupdate' is run automatically by the pkg installer, adapt recommendations;
Cleaup the "Help" section by linking to the contact.php page rather than explaining stuff here, link directly to the latter's "Mailing Lists" section, remove related comment;
Provide URL to our svn branches in the "SVN Sources" section;
Whitespace and some style tweaks.
(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?)
* www/ports.php:
Whitespace cleanups.
Modified Paths:
--------------
trunk/www/contact.php
trunk/www/install.php
trunk/www/ports.php
Modified: trunk/www/contact.php
===================================================================
--- trunk/www/contact.php 2007-10-18 17:49:51 UTC (rev 30028)
+++ trunk/www/contact.php 2007-10-18 18:40:44 UTC (rev 30029)
@@ -9,13 +9,15 @@
<div id="content">
+
<h2 class="hdr">Getting in Touch With Us</h2>
<p>There are a number of ways in which you can get in contact with the MacPorts project, either the core developers
and ports maintainers behind it and/or members of its broad user base.</p>
- <h3 class="subhdr">Mailing Lists</h3>
+ <h3 class="subhdr" id="lists">Mailing Lists</h3>
+
<p>The MacPorts project hosts a number of purpose specific mailing lists you can freely subscribe to:</p>
<ul>
@@ -53,6 +55,7 @@
(A.K.A. “portmgr”), in case you have any administrative request or if you wish to discuss anything you mightd
feel is of private nature (like the interaction between MacPorts and NDA'd software).</p>
+
<h3 class="subhdr">Bug Tracker</h3>
<p>We use the popular <a href="http://trac.edgewall.org/">Trac</a> web-based tool for our <a href="<?php print $trac_url .
@@ -73,6 +76,7 @@
<p>Viewing existing tickets through the facilities of predefined and custom <a href="<?php print $trac_url . 'report'; ?>">
reports</a> that allow you to customize queries is also available.</p>
+
<h3 class="subhdr">IRC</h3>
<p>For a more real-time discussion of any MacPorts related topic, the <a href="irc://chat.freenode.net/#MacPorts">#MacPorts</a>
@@ -85,6 +89,7 @@
<p>The language of choice for the IRC channel is also English, for obvious reasons of universality, so sticking to it is
appreciated.</p>
+
<h3 class="subhdr">Other</h3>
<p>Other miscellaneous venues you can use to learn about the MacPorts project and its activities are the <a href="<?php print
Modified: trunk/www/install.php
===================================================================
--- trunk/www/install.php 2007-10-18 17:49:51 UTC (rev 30028)
+++ trunk/www/install.php 2007-10-18 18:40:44 UTC (rev 30029)
@@ -6,12 +6,9 @@
print_header('MacPorts -- Download & Installation', 'utf-8');
?>
-<!--
- *) Amend "help" section with references to 'contact.php';
--->
-
<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
@@ -31,35 +28,36 @@
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
+ ?>">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>
- <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>
-
+ <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
+ step manually on a regular basis to to keep your MacPorts system always current:</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>
+ <p>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>
+ 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>
<pre>cd MacPorts-<?php print $mp_version_major . "\n"; ?>
./configure && make && sudo make install</pre>
@@ -90,11 +88,12 @@
<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 as a result
- some experimental support exists for other POSIX compliant platforms such as FreeBSD and GNU/Linux.</p>
+ some experimental support does exist for other POSIX compliant platforms such as FreeBSD and GNU/Linux.</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>
@@ -107,6 +106,7 @@
<li><a href="http://www.openssl.org/">OpenSSL</a> or <a href="http://martin.hinner.info/libmd/">libmd</a> for checksums</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
@@ -114,18 +114,13 @@
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>
+ that are fielded often on our <a href="contact.php#lists">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>All of our documentation is a work in progress, so if you spot an error or have any quesitons about some part of the
+ the <a href="<?php print $guide_url; ?>">Guide</a> and/or this website please do let us known, there are many ways to
+ <a href="contact.php">contact us</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,
@@ -136,9 +131,11 @@
<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>
+ <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>
<?php
Modified: trunk/www/ports.php
===================================================================
--- trunk/www/ports.php 2007-10-18 17:49:51 UTC (rev 30028)
+++ trunk/www/ports.php 2007-10-18 18:40:44 UTC (rev 30029)
@@ -10,6 +10,8 @@
?>
<div id="content">
+
+
<h2 class="hdr">MacPorts Portfiles</h2>
<p>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071018/c716d5b1/attachment-0001.html
More information about the macports-changes
mailing list