Changeset 120903 for trunk/doc-new


Ignore:
Timestamp:
Jun 11, 2014, 11:26:31 AM (5 years ago)
Author:
cal@…
Message:

guide: using: rework selfupdate section

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/using.xml

    r105189 r120903  
    11<?xml version="1.0" encoding="UTF-8"?>
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
     3"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
     4<!ENTITY macports-prev-version "2.2.1">
     5<!ENTITY macports-version "2.3.0">
     6]>
    47<chapter id="using">
    58  <title>Using MacPorts</title>
     
    4043
    4144      <note>
    42         <para>Selfupdate runs only on Mac OS X. If you are running MacPorts on
    43         another platform, you must use the <link
    44         linkend="using.port.sync">sync</link> action to update the ports tree; to
    45         update MacPorts base you must manually install a newer version from
    46         source.</para>
     45        <para>Selfupdate is only tested on OS X. If you are running MacPorts on
     46          another platform, <option>selfupdate</option> may not work correctly.
     47          In this case, you should use the <link
     48            linkend="using.port.sync">sync</link> action to update the ports
     49          tree; to update MacPorts base you must manually install a newer
     50          version from source.</para>
    4751      </note>
    4852
    4953      <programlisting><prompt>%%</prompt> <userinput>sudo port selfupdate</userinput></programlisting>
    5054
    51       <para>Use the debug flag for verbose output.</para>
     55      <screen>
     56--->  Updating MacPorts base sources using rsync
     57MacPorts base version &macports-version; installed,
     58MacPorts base version &macports-version; downloaded.
     59--->  Updating the ports tree
     60--->  MacPorts base is already the latest version
     61</screen>
     62
     63      <para>As always, you can use the debug flag for verbose output. This is
     64        useful to debug problems with <option>selfupdate</option>.</para>
    5265
    5366      <programlisting><prompt>%%</prompt> <userinput>sudo port -d selfupdate</userinput></programlisting>
    5467
    55       <screen>DEBUG: Rebuilding the MacPorts base system if needed.
    56 DEBUG: Synchronizing ports tree(s)
    57 Synchronizing from rsync://rsync.macports.org/release/ports/
    58 DEBUG: /usr/bin/rsync -rtzv --delete-after rsync://rsync.macports.org/release/ports/
    59 receiving file list ... done
    60 
    61 [ ... trimmed ... ]
    62 
    63 
    64 The MacPorts installation is not outdated and so was not updated
    65 DEBUG: Setting ownership to root
    66 selfupdate done!</screen>
    67 
    68       <para>If selfupdate detects that a newer version of MacPorts base is
    69       available, it automatically updates the installed copy of MacPorts base
    70       to the latest released version. In that case, you will see the upgrade
    71       Makefile execute, and when it finishes you will see this message:</para>
    72 
    73       <screen>DEBUG: Updating using rsync
    74 receiving file list ... done
    75 
    76 Congratulations, you have successfully installed the MacPorts system.</screen>
     68      <para>If <option>selfupdate</option> detects that a newer version of
     69      MacPorts base is available, it automatically updates the installed copy
     70      of MacPorts base to the latest released version. In that case, you will
     71      see this message:</para>
     72
     73      <screen>
     74--->  Updating MacPorts base sources using rsync
     75MacPorts base version &macports-prev-version; installed,
     76MacPorts base version &macports-version; downloaded.
     77--->  Updating the ports tree
     78--->  MacPorts base is outdated, installing new version &macports-version;
     79Installing new MacPorts release in /opt/local as root:admin; permissions 755
     80</screen>
     81
     82      <para>If the <option>selfupdate</option> procedure fails you'll see
     83      a message like this:</para>
     84
     85      <screen>Error installing new MacPorts base: command execution failed</screen>
     86
     87      <para>Re-run <option>selfupdate</option> with the <option>-d</option>
     88      flag to see all output generated by the build system. The output may give
     89      you an idea why the build failed. If it doesn't, please <link
     90        linkend="project.tickets">file a ticket</link> and attach the output
     91      generated by <command>sudo port -d selfupdate</command>.</para>
    7792    </section>
    7893
Note: See TracChangeset for help on using the changeset viewer.