[Aptitude-devel] r3222 - in branches/aptitude-0.3/aptitude: . doc/en

[Daniel Burrows]

Author: dburrows
Date: Sun May  1 02:48:41 2005
New Revision: 3222

Modified:
   branches/aptitude-0.3/aptitude/ChangeLog
   branches/aptitude-0.3/aptitude/doc/en/aptitude.xml
Log:
Start documenting the new config-file options.

Modified: branches/aptitude-0.3/aptitude/ChangeLog
==============================================================================
--- branches/aptitude-0.3/aptitude/ChangeLog	(original)
+++ branches/aptitude-0.3/aptitude/ChangeLog	Sun May  1 02:48:41 2005
@@ -1,5 +1,9 @@
 2005-04-30  Daniel Burrows  <dburrows@debian.org>
 
+	* doc/en/aptitude.xml:
+
+	  Start documenting the new configuration options.
+
 	* doc/en/aptitude.xml, doc/en/images/views-tab-bar.png:
 
 	  Document the business with having tab-bars at the top of the

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	Sun May  1 02:48:41 2005
@@ -6693,6 +6693,19 @@
 	      </seg>
 	    </seglistitem>
 
+	    <seglistitem id='configCmdLine-Resolver-Debug'>
+	      <seg><literal>Aptitude::CmdLine::Resolver-Debug</literal></seg>
+	      <seg><literal>false</literal></seg>
+	      <seg>
+		In command-line mode, if this option is
+		<literal>true</literal>, &aptitude; will print
+		extremely verbose information while attempting to
+		resolve broken dependencies.  As the name suggests,
+		this option is primarily meant to aid in debugging the
+		problem resolver.
+	      </seg>
+	    </seglistitem>
+
 	    <seglistitem id='configCmdLine-Download-Only'>
 	      <seg><literal>Aptitude::CmdLine::Download-Only</literal></seg>
 	      <seg><literal>false</literal></seg>
@@ -6943,6 +6956,70 @@
 	      </seg>
 	    </seglistitem>
 
+	    <seglistitem id='configProblemResolver-BrokenScore'>
+	      <seg><literal>Aptitude::ProblemResolver::BrokenScore'></literal></seg>
+	      <seg><literal>-100</literal></seg>
+	      <seg>
+		How much to reward or penalize prospective solutions
+		based on the number of dependencies they break.  For
+		each dependency broken by a possible solution, this
+		many points are added to its score; typically this
+		should be a negative value.
+	      </seg>
+	    </seglistitem>
+
+	    <seglistitem id='configProblemResolver-Infinity'>
+	      <seg><literal>Aptitude::ProblemResolver::Infinity</literal></seg>
+	      <seg><literal>1000000</literal></seg>
+
+	      <seg>
+		A <quote>maximum</quote> score for potential
+		solutions.  If a set of actions has a score worse than
+		<replaceable>-Infinity</replaceable>, it will be
+		discarded immediately.
+	      </seg>
+	    </seglistitem>
+
+	    <seglistitem id='configProblemResolver-MaxSuccessors'>
+	      <seg><literal>Aptitude::ProblemResolver::Max-Successors</literal></seg>
+	      <seg><literal>0</literal></seg>
+	      <seg>
+		When new possible solutions are being generated, this
+		value controls how long the generation procedure
+		lasts.  Successors are generated in discrete bundles,
+		and as soon as at least one and at most
+		<replaceable>Max-Successors</replaceable> nodes have
+		been generated, successor generation terminates.
+		Turning this value up might cause the first few
+		generated solutions to have higher scores; on the
+		other hand, it might cause each resolver
+		<quote>step</quote> to take a long time.
+	      </seg>
+	    </seglistitem>
+
+	    <seglistitem id='configProblemResolver-ResolutionScore'>
+	      <seg><literal>Aptitude::Problem-Resolver::ResolutionScore</literal></seg>
+	      <seg><literal>50</literal></seg>
+
+	      <seg>
+		In addition to all other scoring factors, proposed
+		solutions that actually resolver all unsatisfied
+		dependencies are awarded this many extra points.
+	      </seg>
+	    </seglistitem>
+
+	    <seglistitem id='configProblemResolver-StepScore'>
+	      <seg><literal>Aptitude::ProblemResolver::StepScore</literal></seg>
+	      <seg><literal>-10</literal></seg>
+
+	      <seg>
+		How much to reward or penalize prospective solutions
+		based on their length.  For each action performed by a
+		solution, this many points are added to its score.
+		Typically this should be a negative value.
+	      </seg>
+	    </seglistitem>
+
 	    <seglistitem id='configSuggests-Important'>
 	      <seg><literal>Aptitude::Suggests-Important</literal></seg>