Changes between Version 6 and Version 7 of howto/RunningMaster

Timestamp:

Jul 25, 2008, 12:50:08 AM (16 years ago)

Author:

ryandesign (Ryan Carsten Schmidt)

Comment:

--

howto/RunningMaster

@@ -12 +12 @@
 == Installation ==
 
-=== Step 1: '''Checkout MacPorts trunk''' ===
+=== Step 1: '''Check out MacPorts trunk''' ===
 
-Pick a location to store MacPorts; for this HOWTO {{{/opt/mports}}} will be used (change to suit); run
+Pick a location to store a working copy of the MacPorts code. For this HOWTO {{{/opt/mports}}} will be used (change to suit). Run:
 {{{
+mkdir -p /opt/mports
 cd /opt/mports
 svn co http://svn.macports.org/repository/macports/trunk
 }}}
-which will create {{{/opt/mports/trunk}}} containing everything needed for MacPorts.
+This will create {{{/opt/mports/trunk}}} containing everything needed for MacPorts.
 
 === Step 2: '''Build and Install MacPorts''' ===
 
-Build and install MacPorts with:
+Build and install MacPorts:
 {{{
 cd /opt/mports/trunk/base
-./configure
+./configure --enable-readline
 make
 sudo make install
@@ -37 +38 @@
 === Step 3: '''Configure MacPorts to use port information from subversion''' ===
 
-Open {{{/opt/local/etc/macports/sources.conf}}} in a text editor.  Change the last line which should look like
+Open {{{/opt/local/etc/macports/sources.conf}}} in a text editor.  The last line which should look like this:
 {{{
 rsync://rsync.macports.org/release/ports/
 }}}
-to point to the stuff you already checked out:
+Change it to point to the working copy you checked out:
 {{{
 file:///opt/mports/trunk/dports
 }}}
 
-Now MacPorts will look in the subversion checkout for port information.
+Now MacPorts will look for portfiles in the working copy.
 
 === Step 4: '''Update PATH''' ===
@@ -58 +59 @@
 === '''Subversion update''' ===
 
-The official release of MacPorts has two commands {{{sync}}} and {{{selfupdate}}}, used to update all the port information ({{{sync}}}) and to update the base MacPorts installation when necessary ({{{selfupdate}}}).  Instead of using these, update the subversion files:
+MacPorts has two commands used to keep itself current: {{{sync}}}, used to update the ports tree, and {{{selfupdate}}}, to update the MacPorts base code. When compiling MacPorts yourself instead of using a released MacPorts package, you can continue to use {{{sync}}} to update the ports tree, or you can update the working copy manually like this:
 {{{
-cd /opt/mports/trunk
-svn update
+svn update /opt/mports/trunk
 }}}
-does what {{{port sync}}} would do.  You do need to update the base install manually however, when and/or if needed, with the same commands listed in step 2 above.
+You should not use {{{selfupdate}}} anymore because it would downgrade you to the latest released version of MacPorts. Instead you should {{{svn update}}} as above and then repeat the steps listed in step 2 above.
 
 == Using MacPorts ==
@@ -77 +77 @@
 Error: Status 1 encountered during processing.
 }}} 
-It was never really intended to be used in portfiles, and it got removed because of it was considered confusing for it's side-effects. See #12914 for a few more details and Ryan Schmidt's explanation on the dev list [http://lists.macosforge.org/pipermail/macports-dev/2008-July/005652.html in this mail]. If you encounter this problem with a port, please file a bug against this port which still uses {{{cd}}}. 
+It was never really intended to be used in portfiles, and it got removed because the side-effects of using it can be confusing. See #12914 for more details and Ryan Schmidt's explanation on the dev list [http://lists.macosforge.org/pipermail/macports-dev/2008-July/005652.html in this mail]. If you encounter this problem with a port, please file a bug against this port which still uses {{{cd}}}. 
 
 [wiki:howto <- Back to the HOWTO section]