Changeset 33638

Timestamp:

02/01/2008 18:25:51 (4 years ago)

Author:

markd@…

Message:

Add details to the selfupdate section.

Files:

• trunk/doc-new/guide/xml/using.xml (modified) (6 diffs)

trunk/doc-new/guide/xml/using.xml

@@ -48 +48 @@
 [ ... trimmed ... ]
 
-Downloaded MacPorts base version 1.5
+
 The MacPorts installation is not outdated and so was not updated
 DEBUG: Setting ownership to root
 selfupdate done!</screen>
+
+      <para>If selfupdate detects that a newer version of MacPorts base is
+      available, it automatically updates the installed copy of MacPorts base
+      to the latest released version. In that case, you will see the upgrade
+      Makefile execute, and when it finishes you will see this message:</para>
+
+      <screen>DEBUG: Updating using rsync
+receiving file list ... done
+
+Congratulations, you have successfully installed the MacPorts system.</screen>
     </section>
 
@@ -60 +70 @@
       <option>selfupdate</option> actions. It synchronizes the ports tree, as
       does <option>selfupdate</option>, but it does not check for upgrades to
-      MacPorts base. On Mac OS X, unless there is a special reason not to do so,
-      you should run <link
+      MacPorts base. On Mac OS X, unless there is a special reason not to do
+      so, you should run <link
       linkend="using.port.selfupdate">selfupdate</link>.</para>
 
@@ -249 +259 @@
       <programlisting><prompt>%%</prompt> <userinput>port outdated</userinput></programlisting>
 
-      <screen><![CDATA[apr                            1.2.8_0 < 1.2.9_0
-autoconf                       2.61_0 < 2.61_1
-gimp                           2.2.14_0 < 2.2.16_0
-libtool                        1.5.22_0 < 1.5.24_0
-pkgconfig                      0.21_0 < 0.22_0]]></screen>
+      <screen>apr                            1.2.8_0 &lt; 1.2.9_0
+autoconf                       2.61_0 &lt; 2.61_1
+gimp                           2.2.14_0 &lt; 2.2.16_0
+libtool                        1.5.22_0 &lt; 1.5.24_0
+pkgconfig                      0.21_0 &lt; 0.22_0</screen>
     </section>
 
@@ -417 +427 @@
       <para>Debug output is shown below.</para>
 
-      <screen><![CDATA[--->  Creating logrotate-3.7_0.i386.tgz
+      <screen>---&gt;  Creating logrotate-3.7_0.i386.tgz
 
 [ ... trimmed ... ]
@@ -437 +447 @@
 ./opt/local/sbin/
 ./opt/local/sbin/logrotate
---->  Archive logrotate-3.7_0.i386.tgz packaged
+---&gt;  Archive logrotate-3.7_0.i386.tgz packaged
 DEBUG: Executing archive_finish
---->  Archive for logrotate 3.7_0 packaged]]></screen>
+---&gt;  Archive for logrotate 3.7_0 packaged</screen>
 
       <para>Binary archive files are placed in
@@ -486 +496 @@
   </section>
 
-<!--
+  <!--
   <section id="using.rsync-replication">
     <title>Rsync Replication Servers</title>