[Aptitude-svn-commit] r3922 - in branches/aptitude-0.3/aptitude: .
doc/en doc/en/images
Daniel Burrows
dburrows at costa.debian.org
Fri Aug 19 18:02:50 UTC 2005
Author: dburrows
Date: Fri Aug 19 18:02:46 2005
New Revision: 3922
Added:
branches/aptitude-0.3/aptitude/doc/en/images/solution-story-snapshot.png (contents, props changed)
Modified:
branches/aptitude-0.3/aptitude/ChangeLog
branches/aptitude-0.3/aptitude/doc/en/aptitude.xml
Log:
Write more documentation.
Modified: branches/aptitude-0.3/aptitude/ChangeLog
==============================================================================
--- branches/aptitude-0.3/aptitude/ChangeLog (original)
+++ branches/aptitude-0.3/aptitude/ChangeLog Fri Aug 19 18:02:46 2005
@@ -4,7 +4,8 @@
Extend the tutorial on managing packages with notes about broken
dependencies, and document the new styles corresponding to
- solutions.
+ solutions. Needs more work (but I've realized that the code is
+ actually wrong now).
* src/solution_fragment.cc:
Modified: branches/aptitude-0.3/aptitude/doc/en/aptitude.xml
==============================================================================
--- branches/aptitude-0.3/aptitude/doc/en/aptitude.xml (original)
+++ branches/aptitude-0.3/aptitude/doc/en/aptitude.xml Fri Aug 19 18:02:46 2005
@@ -1072,7 +1072,7 @@
basis to keep your system up-to-date.
</para>
- <section>
+ <section id='tutorialBroken'>
<title>Managing Broken Packages</title>
<para>
@@ -1218,6 +1218,7 @@
</mediaobject>
</screenshot>
+ <!-- Move to the reference manual? -->
<para>
In addition to the basic solution navigation commands, you
can press <keycap>r</keycap> to <quote>reject</quote>
@@ -3124,6 +3125,191 @@
</note>
</section>
+ <section id='secResolver'>
+ <title>Solving Dependency Problems</title>
+
+ <para>
+ If a dependency problem arises, &aptitude; can assist you in
+ resolving it. As soon as a problem occurs, a red bar will
+ appear at the bottom of the screen with a summary of
+ &aptitude;'s suggestion about how to fix it. For instance,
+ in the following screenshot, &aptitude; is indicating that
+ it can resolve the situation by keeping two packages at
+ their current versions.
+ </para>
+
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref='images/broken-snapshot.png' format='PNG'/>
+ </imageobject>
+
+ <textobject role='text'>
+<screen> Actions Undo Package Search Options Views Help
+f10: Menu ?: Help q: Quit u: Update g: Download/Install/Remove Pkgs
+aptitude 0.3.3 #Broken: 1 Will free 1335kB of disk space
+ --- admin - Administrative utilities (install software, manage users, etc)
+ --- base - The Debian base system
+ --- devel - Utilities and programs for software development
+ --- doc - Documentation and specialized programs for viewing documentation
+ --- games - Games, toys, and fun programs
+ --\ gnome - The GNOME Desktop System
+ --\ main - The main Debian archive
+i grip 3.3.1-2 3.3.1-4
+ipA sound-juicer -1245kB 2.10.1-2 2.10.1-3
+GNOME 2 CD Ripper
+sound-juicer will be removed.
+
+
+The following packages depend on sound-juicer and will be broken by its
+removal:
+
+
+ * gnome-desktop-environment depends on sound-juicer (>= 2.10.1)
+
+[1/...] Suggest 2 keeps
+e: Examine !: Apply .: Next ,: Previous</screen>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+
+ <para>
+ As indicated at the bottom of the screen, you can view
+ additional solutions by pressing <keycap>.</keycap> and
+ <keycap>,</keycap>, apply the current solution by pressing
+ <keycap>!</keycap>, and examine the solution in more detail
+ by pressing <keycap>e</keycap>. Examining a solution will
+ display a screen like this:
+ </para>
+
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref='images/solution-screen-snapshot.png' format='PNG'/>
+ </imageobject>
+
+ <textobject role='text'>
+ <screen> Actions Undo Package Search Options Views Help
+f10: Menu ?: Help q: Quit u: Update g: Download/Install/Remove Pkgs
+ Packages Resolve Dependencies
+ --\ Keep the following packages at their current version:
+ gstreamer0.8-cdparanoia [0.8.10-1 (unstable, now)]
+ sound-juicer [2.10.1-2 (now)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+[1/...] Suggest 2 keeps
+e: Examine !: Apply .: Next ,: Previous</screen>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+
+ <para>
+ For a more detailed explanation of why &aptitude; made the
+ decisions that it did, press <keycap>o</keycap>. This will
+ re-order the list according to dependencies, showing which
+ dependency triggered each action in the list.
+ </para>
+
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref='images/solution-story-snapshot.png' format='PNG'/>
+ </imageobject>
+
+ <textobject role='text'>
+ <screen> Actions Undo Package Search Options Views Help
+f10: Menu ?: Help q: Quit u: Update g: Download/Install/Remove Pkgs
+ Packages Resolve Dependencies
+ --\ gnome-desktop-environment depends upon sound-juicer (>= 2.10.1)
+ -> Cancel the removal of sound-juicer
+ --\ sound-juicer depends upon gstreamer0.8-cdparanoia
+ -> Cancel the removal of gstreamer0.8-cdparanoia
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+[1/...] Suggest 2 keeps
+e: Examine !: Apply .: Next ,: Previous</screen>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+
+ <para>
+ In order to more efficiently find a solution that you
+ approve of, you can direct &aptitude; to display only
+ solutions which satisfy conditions that you choose.
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ To force aptitude to ignore solutions containing a
+ particular action, highlight the action and press
+ <keycap>r</keycap> to <quote>reject</quote> that action.
+ Once you reject a particular action, any new solutions
+ that you generate (i.e., solutions that have not yet
+ been displayed) will not contain that action.
+ </para>
+
+ <para>
+ To cancel the rejection of an action, highlight the
+ action again and press <keycap>r</keycap>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ To force aptitude to only generate solutions containing
+ a particular action, highlight the action and press
+ <keycap>a</keycap> to <quote>accept</quote> that action.
+ Once you accept a particular action, any new solutions
+ that you generate will contain that action.
+ </para>
+
+ <para>
+ To cancel the acceptance of an action, highlight the
+ action again and press <keycap>a</keycap>.
+ </para>
+
+ <note>
+ <para>
+ Rejecting one action does not affect whether other
+ actions are rejected or not. However, the same is not
+ true when accepting an action. Accepting an action
+ will automatically reject all alternatives to the
+ action, even if those alternatives were previously
+ unrejected or even accepted.
+ </para>
+ </note>
+ </listitem>
+ </itemizedlist>
+ </section>
+
<section id='secInstallRun'>
<title>Downloading, installing, and removing packages</title>
Added: branches/aptitude-0.3/aptitude/doc/en/images/solution-story-snapshot.png
==============================================================================
Binary file. No diff available.
More information about the Aptitude-svn-commit
mailing list