[44116] trunk/doc-new/guide/xml/installing.xml

[wsiegrist at apple.com]

Revision: 44116
          http://trac.macports.org/changeset/44116
Author:   wsiegrist at apple.com
Date:     2008-12-21 19:41:10 -0800 (Sun, 21 Dec 2008)
Log Message:
-----------
Add an install procedure for running from subversion trunk, based on the HOWTO. Also fix a misplaced section tag.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/installing.xml

Modified: trunk/doc-new/guide/xml/installing.xml
===================================================================
--- trunk/doc-new/guide/xml/installing.xml	2008-12-22 03:29:10 UTC (rev 44115)
+++ trunk/doc-new/guide/xml/installing.xml	2008-12-22 03:41:10 UTC (rev 44116)
@@ -205,7 +205,83 @@
 <prompt>%%</prompt> <userinput>sudo make install</userinput></programlisting>
         </listitem>
       </orderedlist>
+    
+      </section>
 
+      <section id="installing.macports.subversion">
+        <title>Subversion Install</title>
+
+        <para>
+          If you installed MacPorts using the package installer, skip this                                                   
+          section.
+        </para>
+
+        <para>
+          There are times when some may want to run MacPorts from a version newer 
+          than the current stable release. Maybe there's a new feature that you'd 
+          like to use, or it fixes an issue you've encountered, or you just like 
+          to be on the cutting edge. These steps explain how to run completely from trunk,
+          using only Subversion to keep MacPorts up to date.
+        </para>
+
+        <orderedlist>
+          <listitem>
+            <para>Check out MacPorts source</para>
+            <para>
+              Pick a location to store a working copy of the MacPorts code. For this example, 
+              <filename>/opt/mports</filename> will be used, but you can put the source anywhere.
+              This example will create <filename>/opt/mports/trunk</filename> containing 
+              everything needed for MacPorts.
+            </para>
+            <programlisting><prompt>%%</prompt> <userinput>mkdir -p /opt/mports</userinput>
+<prompt>%%</prompt> <userinput>cd /opt/mports</userinput>
+<prompt>%%</prompt> <userinput>svn checkout http://svn.macports.org/repository/macports/trunk</userinput></programlisting>
+            <note>
+              You only really need the base subdirectory to run MacPorts, so you can avoid checking out 
+              the rest if you don't want to use a Subversion-based ports tree (see Step 3 below). To just get
+              the base directory, append <filename>/base</filename> to the end of the svn checkout command
+              above. The resulting directory will then be <filename>/opt/mports/base</filename>
+            </note>
+          </listitem>
+
+          <listitem>
+            <para>Build and Install MacPorts</para>
+	    <para>
+              MacPorts uses autoconf and makefiles for installation. These commands will build
+              and install MacPorts to <filename>/opt/local</filename>. You can add the 
+              <option>--prefix</option> option to <filename>./configure</filename> to relocate 
+              MacPorts to another directory if needed.
+            </para>
+            <programlisting><prompt>%%</prompt> <userinput>cd /opt/mports/trunk/base</userinput>
+<prompt>%%</prompt> <userinput>./configure --enable-readline</userinput>
+<prompt>%%</prompt> <userinput>make</userinput>
+<prompt>%%</prompt> <userinput>sudo make install</userinput>
+<prompt>%%</prompt> <userinput>make distclean</userinput></programlisting>
+          </listitem>
+
+          <listitem>
+	    <para>(Optional) Configure MacPorts to use port information from Subversion</para>
+            <para>
+              This step is useful if you want to do port development.
+              Open <filename>/opt/local/etc/macports/sources.conf</filename> in a text editor. 
+              The last line which should look like this:
+            </para>
+	    <programlisting>rsync://rsync.macports.org/release/ports/</programlisting>
+	    <para>Change it to point to the working copy you checked out:</para>	    
+	    <programlisting>file:///opt/mports/trunk/dports</programlisting>
+	    <para>Now MacPorts will look for portfiles in the working copy.</para>
+          </listitem>
+
+          <listitem>
+	    <para>Environment</para>
+	    <para>
+              You should setup your PATH and other environment options according to
+              the <link linkend="installing.shell">following section</link>.
+            </para>
+          </listitem>
+        </orderedlist>
+      </section>
+
       <section id="installing.macports.source.multiple">
         <title>Install Multiple MacPorts Copies</title>
 
@@ -263,7 +339,6 @@
     /Library/StartupItems/DarwinPortsStartup \
     /Library/Tcl/darwinports1.0 \
     /Library/Tcl/macports1.0</userinput></programlisting>
-    </section>
   </section>
 
   <section id="installing.shell">
@@ -420,4 +495,4 @@
       <programlisting>export EDITOR=/usr/bin/edit</programlisting>
     </section>
   </section>
-</chapter>
\ No newline at end of file
+</chapter>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20081221/9b20bcf3/attachment.html>