File Manager

Editing File: /usr/share/doc/aptitude/html/en/ch02s05s05.html

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><title>Configuration file reference</title><link rel="stylesheet" type="text/css" href="aptitude.css" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="home" href="index.html" title="aptitude user's manual" /><link rel="up" href="ch02s05.html" title="Customizing aptitude" /><link rel="prev" href="ch02s05s04.html" title="Customizing the display layout" /><link rel="next" href="ch02s05s06.html" title="Themes" /><link rel="preface" href="pr01.html" title="Introduction" /><link rel="chapter" href="ch01.html" title="Chapter 1. Getting started" /><link rel="chapter" href="ch02.html" title="Chapter 2. aptitude reference guide" /><link rel="chapter" href="ch03.html" title="Chapter 3. aptitude frequently asked questions" /><link rel="chapter" href="ch04.html" title="Chapter 4. Credits" /><link rel="reference" href="rn01.html" title="Command-line reference" /><link rel="refentry" href="rn01re01.html" title="aptitude" /><link rel="refentry" href="rn01re02.html" title="aptitude-create-state-bundle" /><link rel="refentry" href="rn01re03.html" title="aptitude-run-state-bundle" /><link rel="subsection" href="ch02s05s05.html#idm6602" title="Configuration file format" /><link rel="subsection" href="ch02s05s05.html#idm6629" title="Locations of configuration files" /><link rel="subsection" href="ch02s05s05.html#idm6659" title="Available configuration options" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Configuration file reference</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s05s04.html"><img src="images/prev.gif" alt="Prev" /></a> </td><th width="60%" align="center">Customizing <span class="command"><strong>aptitude</strong></span></th><td width="20%" align="right"> <a accesskey="n" href="ch02s05s06.html"><img src="images/next.gif" alt="Next" /></a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="secConfigFile"></a>Configuration file reference</h3></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="ch02s05s05.html#idm6602">Configuration file format</a></span></dt><dt><span class="section"><a href="ch02s05s05.html#idm6629">Locations of configuration files</a></span></dt><dt><span class="section"><a href="ch02s05s05.html#idm6659">Available configuration options</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="idm6602"></a>Configuration file format</h4></div></div></div><p>
	    In its basic form, <span class="command"><strong>aptitude</strong></span>'s configuration file is a
	    list of options and their values.  Each line of the file
	    should have the form
	    <span class="quote">“<span class="quote"><em class="replaceable"><code>Option</code></em>
	    <em class="replaceable"><code>Value</code></em><code class="literal">;</code></span>”</span>:
	    for instance, the following line in the configuration file
	    sets the option <code class="literal"><a class="link" href="ch02s05s05.html#configTheme">Aptitude::Theme</a></code> to
	    <span class="quote">“<span class="quote"><code class="literal">Dselect</code></span>”</span>.
	  </p><pre class="screen">Aptitude::Theme "Dselect";</pre><p>
	    An option can <span class="quote">“<span class="quote">contain</span>”</span> other options if they
	    are written in curly braces between the option and the
	    semicolon following it, like this:
	  </p><pre class="screen">Aptitude::UI {
  Package-Status-Format "";
  Package-Display-Format "";
};</pre><p>
	    An option that contains other options is sometimes called
	    a <em class="firstterm">group</em>.  In fact, the double
	    colons that appear in option names are actually a
	    shorthand way of indicating containment: the option
	    <code class="literal">Aptitude::UI::Default-Grouping</code> is
	    contained in the group <code class="literal">Aptitude::UI</code>,
	    which itself is contained in the group
	    <code class="literal">Aptitude</code>.  Thus, if you wanted to, you
	    could set this option to <code class="literal">""</code> as follows:
	  </p><pre class="screen">Aptitude {
  UI {
    Default-Grouping "";
  };
};</pre><p>
	    For more information on the format of the configuration
	    file, see the manual page
	    <span class="citerefentry"><span class="refentrytitle">apt.conf</span>(5)</span>.
	  </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="idm6629"></a>Locations of configuration files</h4></div></div></div><p>
	    <span class="command"><strong>aptitude</strong></span>'s configuration is read from the following
	    sources, in order:
	  </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
                Configuration file options specified on the command-line.
              </p></li><li class="listitem"><p>
		The user's configuration file,
		<code class="filename">~/.aptitude/config</code>.  This file is
		overwritten when the user modifies settings in the
		<a class="link" href="ch02s01s02.html#secOptionsMenu" title="The Options menu">Options menu</a>.
	      </p></li><li class="listitem"><p>
		The system configuration file,
		<code class="filename">/etc/apt/apt.conf</code>.
	      </p></li><li class="listitem"><p>
                The system configuration fragment files,
                <code class="filename">/etc/apt/apt.conf.d/*</code>.
              </p></li><li class="listitem"><p>
                The file specified by the <code class="literal">APT_CONFIG</code>
                environment variable (if any).
              </p></li><li class="listitem"><p>
		Default values stored in
		<code class="filename">/usr/share/aptitude/aptitude-defaults</code>.
	      </p></li><li class="listitem"><p>
		Default values built into <span class="command"><strong>aptitude</strong></span>.
	      </p></li></ol></div><p>
	    When an option is being checked, these sources are
	    searched in order, and the first one that provides a value
	    for the option is used.  For instance, setting an option
	    in <code class="filename">/etc/apt/apt.conf</code> will override
	    <span class="command"><strong>aptitude</strong></span>'s defaults for that option, but will not
	    override user settings in
	    <code class="filename">~/.aptitude/config</code>.
	  </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="idm6659"></a>Available configuration options</h4></div></div></div><p>
	    The following configuration options are used by
	    <span class="command"><strong>aptitude</strong></span>.  Note that these are not the only available
	    configuration options; options used by the underlying
	    <code class="systemitem">apt</code> system are not listed here.  See the manual pages
	    <span class="citerefentry"><span class="refentrytitle">apt</span>(8)</span>
	    and
	    <span class="citerefentry"><span class="refentrytitle">apt.conf</span>(5)</span>
	    for information on <code class="systemitem">apt</code> options.
	  </p><div class="segmentedlist"><div class="seglistitem"><a id="configApt-AutoRemove-RecommendsImportant"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">APT::AutoRemove::RecommendsImportant</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, then
		<span class="command"><strong>aptitude</strong></span> will not consider packages to be unused
		(and thus will not automatically remove them) as long
		as any installed package recommends them, even if
		<code class="literal"><a class="link" href="ch02s05s05.html#configAptInstall-Recommends">APT::Install-Recommends</a></code>
		is <code class="literal">false</code>.  For more information,
		see <a class="xref" href="ch02s02s06.html" title="Managing automatically installed packages">the section called “Managing automatically installed packages”</a>.
	      </div></div><div class="seglistitem"><a id="configApt-AutoRemove-SuggestsImportant"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">APT::AutoRemove::SuggestsImportant</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, then
		<span class="command"><strong>aptitude</strong></span> will not consider packages to be unused
		(and thus will not automatically remove them) as long
		as any installed package suggests them.  For more
		information, see <a class="xref" href="ch02s02s06.html" title="Managing automatically installed packages">the section called “Managing automatically installed packages”</a>.
	      </div></div><div class="seglistitem"><a id="configApt-Get-ListCleanup"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">APT::Get::List-Cleanup</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		A synonym for <code class="literal"><a class="link" href="ch02s05s05.html#configApt-ListCleanup">APT::List-Cleanup</a></code>.
		If either of these options is set to
		<code class="literal">false</code>, <span class="command"><strong>aptitude</strong></span> will not delete
		old package list files after downloading a new set of
		package lists.
	      </div></div><div class="seglistitem"><a id="configApt-ListCleanup"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">APT::List-Cleanup</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		A synonym for <code class="literal"><a class="link" href="ch02s05s05.html#configApt-Get-ListCleanup">APT::Get::List-Cleanup</a></code>.
		If either of these options is set to
		<code class="literal">false</code>, <span class="command"><strong>aptitude</strong></span> will not delete
		old package list files after downloading a new set of
		package lists.
	      </div></div><div class="seglistitem"><a id="configAptInstall-Recommends"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">APT::Install-Recommends</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code> and
		<code class="literal">Aptitude::Auto-Install</code> is
		<code class="literal">true</code>, then whenever you mark a
		package for installation, <span class="command"><strong>aptitude</strong></span> will also mark
		the packages it recommends for installation.
		Furthermore, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will not consider
		packages to be unused (and thus will not automatically
		remove them) as long as any installed package
		reommends them.  For more information, see <a class="xref" href="ch02s02s06.html" title="Managing automatically installed packages">the section called “Managing automatically installed packages”</a> and <a class="xref" href="ch02s03s02.html" title="Immediate dependency resolution">the section called “Immediate dependency resolution”</a>.
	      </div></div><div class="seglistitem"><a id="configAllow-Null-Upgrade"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Allow-Null-Upgrade</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Normally, if you try to start an install run when no
		actions will be performed, <span class="command"><strong>aptitude</strong></span> will print a
		warning and return to the package list.  If this
		option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will
		continue to the preview screen whenever there are
		upgradable packages, rather than displaying a reminder
		about the <span class="guimenu">Actions</span> → <span class="guimenuitem">Mark Upgradable</span> (<span class="shortcut"><strong><span class="keycap"><strong>U</strong></span></strong></span>) command.
	      </div></div><div class="seglistitem"><a id="configAlways-Use-Safe-Resolver"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Always-Use-Safe-Resolver</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, aptitude's
		command-line actions will always use a
		<span class="quote">“<span class="quote">safe</span>”</span> dependency resolver, as if <a class="link" href="rn01re01.html#cmdlineSafeResolver"><code class="literal">--safe-resolver</code></a>
		had been passed on the command line.
	      </div></div><div class="seglistitem"><a id="configAutoclean-After-Update"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Autoclean-After-Update</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will clean
		up obsolete files (see <a class="link" href="ch02s01s02.html#menuCleanObs"><span class="guimenu">Actions</span> → <span class="guimenuitem">Clean obsolete files</span></a>) every time
		you update the package list.

This option is similar to <code class="literal"><a class="link" href="ch02s05s05.html#configClean-After-Install">Aptitude::Clean-After-Install</a></code>.
	      </div></div><div class="seglistitem"><a id="configAuto-Fix-Broken"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Auto-Fix-Broken</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">false</code>,
		<span class="command"><strong>aptitude</strong></span> will ask for permission before
		attempting to fix any broken packages.
	      </div></div><div class="seglistitem"><a id="configAuto-Install"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Auto-Install</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will automatically attempt to fulfill the dependencies
		of a package when you mark a package to be installed
		or upgraded.
	      </div></div><div class="seglistitem"><a id="configAuto-Install-Remove-Ok"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Auto-Install-Remove-Ok</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will automatically remove conflicting packages when
		you mark a package to be installed or upgraded.
		Normally these conflicts are flagged and you must
		handle them manually.
	      </div></div><div class="seglistitem"><a id="configAuto-Upgrade"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Auto-Upgrade</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will automatically flag all
		upgradable packages for upgrade when the program
		starts, as if you had issued the command
		<a class="link" href="ch02s01s02.html#menuUpgrade"><span class="guimenu">Actions</span> → <span class="guimenuitem">Mark Upgradable</span> (<span class="shortcut"><strong><span class="keycap"><strong>U</strong></span></strong></span>)</a>.
	      </div></div><div class="seglistitem"><a id="configClean-After-Install"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Clean-After-Install</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will clean
		up all files in the package cache directory (see <a class="link" href="ch02s01s02.html#menuClean"><span class="guimenu">Actions</span> → <span class="guimenuitem">Clean package cache</span></a>) after successful
		installation of packages (or similar operations).

This option is similar to <code class="literal"><a class="link" href="ch02s05s05.html#configAutoclean-After-Update">Aptitude::Autoclean-After-Update</a></code>.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Always-Prompt"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Always-Prompt</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this is set, <span class="command"><strong>aptitude</strong></span>
		will always prompt before starting to install or
		remove packages, even if the prompt would
		normally be skipped.  This is equivalent to the
		<code class="literal">-P</code> command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Assume-Yes"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Assume-Yes</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will act as
		if the user had answered <span class="quote">“<span class="quote">yes</span>”</span> to
		every prompt, causing most prompts to be
		skipped.  This is equivalent to the
		<code class="literal">-y</code> command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Disable-Columns"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Disable-Columns</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is enabled, the results of command-line
		searches (performed via <code class="literal">aptitude
		search</code>) will not be formatted into
		fixed-width columns or truncated to the screen width.
		This is equivalent to the <a class="link" href="rn01re01.html#cmdlineOptionDisableColumns"><code class="literal">--disable-columns</code></a>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Download-Only"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Download-Only</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will
		download package files but not install them.
		This is equivalent to the <code class="literal">-d</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Fix-Broken"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Fix-Broken</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will be more
		aggressive when attempting to fix the
		dependencies of broken packages.  This is
		equivalent to the <code class="literal">-f</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Versions-Group-By"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Versions-Group-By</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong>
                Set to <code class="literal">auto</code>,
                <code class="literal">none</code>, <code class="literal">package</code>,
                or <code class="literal">source-package</code> to control
                whether and how the output of <a class="link" href="rn01re01.html#cmdlineVersions"><code class="literal">aptitude
                versions</code></a> is grouped.  Equivalent to
                the command-line option <a class="link" href="rn01re01.html#cmdlineGroupBy"><code class="literal">--group-by</code></a>
                (see its documentation for more description of what
                the values mean).
              </div></div><div class="seglistitem"><a id="configCmdLine-Ignore-Trust-Violations"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Ignore-Trust-Violations</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, causes <span class="command"><strong>aptitude</strong></span> to ignore the
		installation of <a class="link" href="ch02s02s05.html" title="Understanding and managing package trust">untrusted
		packages</a>.  This is a synonym for
		<code class="literal">APT::Get::AllowUnauthenticated</code>.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Package-Display-Format"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Package-Display-Format</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">%c%a%M %p# - %d#</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is a format string, as described in <a class="xref" href="ch02s05s01.html#secDisplayFormat" title="Customizing how packages are displayed">the section called “Customizing how packages are displayed”</a>, which is used to
		display the results of a command-line search.
		This is equivalent to the <code class="literal">-F</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Package-Display-Width"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Package-Display-Width</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option gives the width in characters for
		which command-line search results should be
		formatted.  If it is empty (the default; ie,
		<code class="literal">""</code>), search results will be
		formatted for the current terminal size, or for
		an 80-column display if the terminal size cannot
		be determined.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Progress-Percent-On-Right"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Progress::Percent-On-Right</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
                This option controls whether command-line progress
                indicators display the percentage on the left-hand
                side of the screen, in the same style as <span class="command"><strong>apt-get</strong></span>, or
                on the right-hand side (the default).  This option
                does not affect download progress indicators.
              </div></div><div class="seglistitem"><a id="configCmdLine-Progress-Retain-Completed"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Progress::Retain-Completed</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
                If this value is <code class="literal">false</code>, then
                command-line progress indicators will be deleted and
                overwritten once the task they represent is completed.
                If it is <code class="literal">true</code>, then they will be
                left on the terminal.  This option does not affect
                download progress indicators.
              </div></div><div class="seglistitem"><a id="configCmdLine-Request-Strictness"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Request-Strictness</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">10000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		When run in command-line mode, if dependency problems
		are encountered, <span class="command"><strong>aptitude</strong></span> will add this value to the
		problem resolver score of each action that you
		explicitly request.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Resolver-Debug"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Resolver-Debug</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> 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.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Resolver-Dump"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Resolver-Dump</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if it is necessary to resolve
		broken dependencies and this option is set to the name
		of a writable file, the resolver state will be dumped
		to this file before any calculations are undertaken.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Resolver-Show-Steps"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Resolver-Show-Steps</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, then a
		dependency solution will be displayed as a sequence of
		resolutions of individual dependencies; for instance,
		<span class="quote">“<span class="quote"><code class="literal">wesnoth depends upon wesnoth-data (=
		1.2.4-1) -&gt; installing wesnoth-data 1.2.4-1
		(unstable)</code></span>”</span>.  To toggle between the
		two display modes, press <span class="keycap"><strong>o</strong></span> at the
		prompt <span class="quote">“<span class="quote"><code class="literal">Accept this solution?</code></span>”</span>.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Show-Deps"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Show-Deps</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will display
		a brief summary of the dependencies (if any)
		relating to a package's state.  This is
		equivalent to the <code class="literal">-D</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Show-Size-Changes"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Show-Size-Changes</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will display
		the expected change in the amount of space used
		by each package.  This is equivalent to the
		<code class="literal">-Z</code> command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Show-Summary"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Show-Summary</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">no-summary</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option sets the default value of the command-line
		argument <a class="link" href="rn01re01.html#cmdlineOptionShowSummary"><code class="literal">--show-summary</code></a>.
		See the documentation of <a class="link" href="rn01re01.html#cmdlineOptionShowSummary"><code class="literal">--show-summary</code></a>
		for a list of the allowed values of this option and
		their meanings.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Show-Versions"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Show-Versions</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will display
		the version of a package that is being installed
		or removed.  This is equivalent to the
		<code class="literal">-V</code> command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Show-Why"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Show-Why</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, if this option is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will display the
		manually installed packages that require each
		automatically installed package, or the manually
		installed packages that cause a conflict with each
		automatically removed package.  This is equivalent to
		the <code class="literal">-W</code> command-line option and
		displays the same information you can access via
		<code class="literal">aptitude why</code> or by pressing
		<span class="keycap"><strong>i</strong></span> in a package list.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Version-Display-Format"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Version-Display-Format</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">%c%a%M %p# %t %i</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is a format string, as described in <a class="xref" href="ch02s05s01.html#secDisplayFormat" title="Customizing how packages are displayed">the section called “Customizing how packages are displayed”</a>, which is used to display
		the output of <code class="literal">aptitude versions</code>.
		This is equivalent to the <code class="literal">-F</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Versions-Show-Package-Names"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Versions-Show-Package-Names</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong>
                Set to <code class="literal">always</code>,
                <code class="literal">auto</code>, or <code class="literal">never</code>
                to control when package names are displayed in the
                output of <a class="link" href="rn01re01.html#cmdlineVersions"><code class="literal">aptitude
                versions</code></a>.  Equivalent to the
                command-line option <a class="link" href="rn01re01.html#cmdlineShowPackageNames"><code class="literal">--show-package-names</code></a>
                (see its documentation for more description of what
                the values mean).
              </div></div><div class="seglistitem"><a id="configSafe-Resolver-Show-Resolver-Actions"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Safe-Resolver::Show-Resolver-Actions</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is enabled, then when the
		<span class="quote">“<span class="quote">safe</span>”</span> dependency resolver has been
		activated via <a class="link" href="rn01re01.html#cmdlineSafeResolver"><code class="literal">--safe-resolver</code></a>
		or because the command-line action is <a class="link" href="rn01re01.html#manpageSafeUpgrade"><code class="literal">safe-upgrade</code></a>,
		it will display a summary of the actions taken by the
		resolver before showing the installation preview.
		Equivalent to the command-line option <a class="link" href="rn01re01.html#cmdlineOptionShowResolverActions"><code class="literal">--show-resolver-actions</code></a>.
	      </div></div><div class="seglistitem"><a id="configScreenshotIncrementalLoadLimit"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Screenshot::IncrementalLoadLimit</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">16384</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The minimum size in bytes at which <span class="command"><strong>aptitude</strong></span> will begin
		to display screenshots incrementally.  Below this
		size, screenshots will not appear until they are fully
		downloaded.
	      </div></div><div class="seglistitem"><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Screenshot::Cache-Max</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">4194304</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The maximum number of bytes of screenshot data that
		<span class="command"><strong>aptitude</strong></span> will store in memory for screenshots that are
		not currently being displayed.  The default is four
		megabytes.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Simulate"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Simulate</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		<span class="emphasis"><em>This option is deprecated; use
		<code class="literal"><a class="link" href="ch02s05s05.html#configSimulate">Aptitude::Simulate</a></code>
		instead.</em></span> In command-line mode, causes
		<span class="command"><strong>aptitude</strong></span> to just display the actions that would be
		performed (rather than actually performing them); in
		the visual interface, causes <span class="command"><strong>aptitude</strong></span> to start in
		read-only mode regardless of whether you are <code class="systemitem">root</code> or
		not.  This is equivalent to the <code class="literal">-s</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Verbose"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Verbose</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">0</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This controls how verbose the command-line mode
		of <span class="command"><strong>aptitude</strong></span> is.  Every occurrence of the
		<code class="literal">-v</code> command-line option adds 1
		to this value.
	      </div></div><div class="seglistitem"><a id="configCmdLine-Visual-Preview"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::CmdLine::Visual-Preview</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will enter its visual interface to display the preview
		of an installation run and to download packages.
	      </div></div><div class="seglistitem"><a id="configDelete-Unused"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Delete-Unused</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		automatically installed packages which are no
		longer required will be automatically removed.
		For more information, see <a class="xref" href="ch02s02s06.html" title="Managing automatically installed packages">the section called “Managing automatically installed packages”</a>.
	      </div></div><div class="seglistitem"><a id="configDelete-Unused-Pattern"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Delete-Unused-Pattern</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Deprecated alias for <code class="literal"><a class="link" href="ch02s05s05.html#configKeep-Unused-Pattern">Aptitude::Keep-Unused-Pattern</a></code>.
		If <code class="literal">Aptitude::Keep-Unused-Pattern</code> is
		unset or set to an empty string, the value of this
		configuration option will override it.  Otherwise,
		<code class="literal">Aptitude::Delete-Unused-Pattern</code> is
		ignored.
	      </div></div><div class="seglistitem"><a id="configDisplay-Planned-Action"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Display-Planned-Action</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will display a preview screen before
		actually carrying out the actions you have
		requested.
	      </div></div><div class="seglistitem"><a id="configForget-New-On-Install"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Forget-New-On-Install</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will clear the list of new packages
		whenever you install, upgrade, or remove
		packages, as if you had issued the command
		<span class="guimenu">Actions</span> → <span class="guimenuitem">Forget new packages</span> (<span class="shortcut"><strong><span class="keycap"><strong>f</strong></span></strong></span>).
	      </div></div><div class="seglistitem"><a id="configForget-New-On-Update"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Forget-New-On-Update</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will clear the list of new packages
		whenever the package list is updated, as if you
		had issued the command <span class="guimenu">Actions</span> → <span class="guimenuitem">Forget new packages</span> (<span class="shortcut"><strong><span class="keycap"><strong>f</strong></span></strong></span>).
	      </div></div><div class="seglistitem"><a id="configGet-Root-Command"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Get-Root-Command</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">su:/bin/su</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option sets the external command that <span class="command"><strong>aptitude</strong></span>
		will use to switch to the <code class="systemitem">root</code> user (see <a class="xref" href="ch02s01s04.html" title="Becoming root">the section called “Becoming <code class="systemitem">root</code>”</a>).  It has the form
		<code class="literal"><em class="replaceable"><code>protocol</code></em>:<em class="replaceable"><code>command</code></em></code>.
		<em class="replaceable"><code>protocol</code></em> must be either
		<code class="literal">su</code> or <code class="literal">sudo</code>; it
		determines how <span class="command"><strong>aptitude</strong></span> invokes the program when it
		wants to gain <code class="systemitem">root</code> privileges.  If
		<em class="replaceable"><code>protocol</code></em> is
		<code class="literal">su</code>, then
		<span class="quote">“<span class="quote"><code class="literal"><em class="replaceable"><code>command</code></em> -c
		<em class="replaceable"><code>arguments</code></em></code></span>”</span> is used
		to become <code class="systemitem">root</code>; otherwise, <span class="command"><strong>aptitude</strong></span> uses
		<span class="quote">“<span class="quote"><code class="literal"><em class="replaceable"><code>command</code></em>
		<em class="replaceable"><code>arguments</code></em></code></span>”</span>.  The
		first word in <em class="replaceable"><code>command</code></em> is
		the name of the program that should be invoked;
		remaining words are treated as arguments to that
		program.
	      </div></div><div class="seglistitem"><a id="configIgnore-Old-Tmp"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Ignore-Old-Tmp</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Old versions of <span class="command"><strong>aptitude</strong></span> created a directory
		<code class="filename">~/.aptitude/.tmp</code> which is no
		longer necessary.  If the directory exists and
		<code class="literal">Aptitude::Ignore-Old-Tmp</code> is
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will ask you
		whether to remove this directory.  This option is
		automatically set to <code class="literal">true</code> after you
		reply.  On the other hand, if the directory does not
		exist, this option is set to <code class="literal">false</code>
		so that you will be notified if it reappears.
	      </div></div><div class="seglistitem"><a id="configIgnore-Recommends-Important"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Ignore-Recommends-Important</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In previous versions of <span class="command"><strong>aptitude</strong></span>, the setting
		<code class="literal">Aptitude::Recommends-Important</code>
		caused recommendations to be installed automatically,
		the same way that <code class="literal"><a class="link" href="ch02s05s05.html#configAptInstall-Recommends">APT::Install-Recommends</a></code>
		does today.  If this option is set to
		<code class="literal">false</code> and
		<code class="literal">Aptitude::Recommends-Important</code> is
		also set to <code class="literal">false</code>, <span class="command"><strong>aptitude</strong></span> will
		set <code class="literal"><a class="link" href="ch02s05s05.html#configAptInstall-Recommends">APT::Install-Recommends</a></code>
		to <code class="literal">false</code> and set
		<code class="literal">Aptitude::Ignore-Recommends-Important</code>
		to <code class="literal">true</code> on startup.
	      </div></div><div class="seglistitem"><a id="configKeep-Recommends"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Keep-Recommends</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is an obsolete option; use <code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-RecommendsImportant">APT::AutoRemove::RecommendsImportant</a></code>
		instead.  Setting this option to
		<code class="literal">true</code> has the same effect as setting
		<code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-RecommendsImportant">APT::AutoRemove::RecommendsImportant</a></code>
		to <code class="literal">true</code>.
	      </div></div><div class="seglistitem"><a id="configKeep-Suggests"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Keep-Suggests</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is an obsolete option; use <code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-SuggestsImportant">APT::AutoRemove::SuggestsImportant</a></code>
		instead.  Setting this option to
		<code class="literal">true</code> has the same effect as setting
		<code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-SuggestsImportant">APT::AutoRemove::SuggestsImportant</a></code>
		to <code class="literal">true</code>.
	      </div></div><div class="seglistitem"><a id="configKeep-Unused-Pattern"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Keep-Unused-Pattern</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If <code class="literal"><a class="link" href="ch02s05s05.html#configDelete-Unused">Aptitude::Delete-Unused</a></code>
		is <code class="literal">true</code>, only unused packages which
		do not match this pattern (see
		<a class="xref" href="ch02s04.html" title="Search patterns">the section called “Search patterns”</a>) will be removed.
		If this option is set to an empty string (the
		default), all unused packages will be removed.
	      </div></div><div class="seglistitem"><a id="configLockFile"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::LockFile</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="filename">/var/lock/aptitude</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		A file that will be fcntl-locked to ensure that at
		most one <span class="command"><strong>aptitude</strong></span> process can modify the cache at
		once.  In normal circumstances, you should never need
		to modify this; it may be useful for debugging.
		<span class="emphasis"><em>Note</em></span>: if <span class="command"><strong>aptitude</strong></span> complains
		that it cannot acquire a lock, this is
		<span class="emphasis"><em>not</em></span> because the lock file needs
		to be deleted.  fcntl locks are managed by the kernel
		and will be destroyed when the program holding them
		terminates; failure to acquire the lock means that
		another running program is using it!
	      </div></div><div class="seglistitem"><a id="configLocalizeLog"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Localize-Log</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is enabled, <span class="command"><strong>aptitude</strong></span> will use the user's locale
		for messages and dates in the log file; otherwise it is written
		in the "classic" locale, to avoid having the log file written in
		different languages (depending on the locales of the users
		running the program).
	      </div></div><div class="seglistitem"><a id="configLog"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Log</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="filename">/var/log/aptitude</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this is set to a nonempty string, <span class="command"><strong>aptitude</strong></span> will
		log the package installations, removals, and upgrades
		that it performs.  If the value of
		<code class="literal">Aptitude::Log</code> begins with a pipe
		character (ie, <span class="quote">“<span class="quote"><code class="literal">|</code></span>”</span>),
		the remainder of its value is used as the name of a
		command into which the log will be piped: for
		instance, <code class="literal">|mail -s 'Aptitude install run'
		root</code> will cause the log to be emailed to
		<code class="systemitem">root</code>.  To log to multiple files or commands, you may
		set this option to a list of log targets.
	      </div></div><div class="seglistitem"><a id="configLoggingFile"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Logging::File</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="filename"></code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this is set to a nonempty string, <span class="command"><strong>aptitude</strong></span> will
		write logging messages to it; setting it to
		<span class="quote">“<span class="quote"><code class="literal">-</code></span>”</span> causes logging
		messages to be printed to standard output.  This
		differs from the setting <a class="link" href="ch02s05s05.html#configLog"><code class="literal">Aptitude::Log</code></a>:
		that file is used to log installations and removals,
		whereas this file is used to log program events,
		errors, and debugging messages (if enabled).  This
		option is equivalent to the command-line argument
		<a class="link" href="rn01re01.html#cmdlineOptionLogFile"><code class="literal">--log-file</code></a>.
		See also <a class="link" href="ch02s05s05.html#configLoggingLevels"><code class="literal">Aptitude::Logging::Levels</code></a>.
	      </div></div><div class="seglistitem"><a id="configLoggingLevels"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Logging::Levels</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong>(empty)</div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option is a group whose members control which log
		messages are written.  Each entry is either
		<span class="quote">“<span class="quote"><em class="replaceable"><code>level</code></em></span>”</span>, to
		set the global log level (the log level of the root
		logger) to the given <em class="replaceable"><code>level</code></em>,
		or
		<span class="quote">“<span class="quote"><code class="literal"><em class="replaceable"><code>category</code></em>:<em class="replaceable"><code>level</code></em></code></span>”</span>,
		where <em class="replaceable"><code>category</code></em> is the
		category of messages to modify (such as
		<code class="literal">aptitude.resolver.hints.match</code>) and
		<em class="replaceable"><code>level</code></em> is the lowest log
		level of messages in that category that should be
		displayed.  Valid log levels are
		<span class="quote">“<span class="quote"><code class="literal">fatal</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">error</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">warn</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">info</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">debug</code></span>”</span>, and
		<span class="quote">“<span class="quote"><code class="literal">trace</code></span>”</span>.  The
		command-line option <a class="link" href="rn01re01.html#cmdlineOptionLogLevel"><code class="literal">--log-level</code></a>
		can be used to set or override any log level.
	      </div></div><div class="seglistitem"><a id="configParseDescriptionBullets"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Parse-Description-Bullets</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is enabled, <span class="command"><strong>aptitude</strong></span> will attempt
		to automatically detect bulleted lists in package
		descriptions.   This will generally improve how
		descriptions are displayed, but it is not entirely
		backwards-compatible; some descriptions might be
		formatted less attractively when this option is
		<code class="literal">true</code> than when it is
		<code class="literal">false</code>.
	      </div></div><div class="seglistitem"><a id="configPkg-Display-Limit"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Pkg-Display-Limit</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The default filter applied to the package list;
		see <a class="xref" href="ch02s04.html" title="Search patterns">the section called “Search patterns”</a> for
		details about its format.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Allow-Break-Holds"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Allow-Break-Holds</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to <code class="literal">true</code>, the
		problem resolver will consider breaking package holds
		or installing forbidden versions in order to resolve a
		dependency.  If it is set to <code class="literal">false</code>,
		these actions will be rejected by default, although
		you can always enable them manually (see <a class="xref" href="ch02s03s03.html" title="Resolving Dependencies Interactively">the section called “Resolving Dependencies Interactively”</a>).
	      </div></div><div class="seglistitem"><a id="configProblemResolver-BreakHoldScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::BreakHoldScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-300</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much to reward or penalize solutions that change
		the state of a held package or install a forbidden
		version.  Note that unless <a class="link" href="ch02s05s05.html#configProblemResolver-Allow-Break-Holds"><code class="literal">Aptitude::ProblemResolver::Allow-Break-Holds</code></a>
		is set to true, the resolver will never break a hold
		or install a forbidden version unless it has explicit
		permission from the user.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Break-Hold-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Break-Hold-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">50000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to actions that break a hold
		set by the user (by upgrading a held package or by
		installing a forbidden version of a package).  See
		<a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a>
		for a description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-BrokenScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::BrokenScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-100</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		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.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-CancelRemovalScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::CancelRemovalScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-300</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to not remove
		or purge a package requested to be removed or purged.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-DefaultResolutionScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::DefaultResolutionScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">400</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much to reward or penalize prospective solutions
		based on how many <span class="quote">“<span class="quote">default</span>”</span> resolutions
		for currently unsatisfied dependencies they install.
		The default resolution is the resolution that
		<span class="quote">“<span class="quote"><code class="literal">apt-get install</code></span>”</span> or
		the <span class="quote">“<span class="quote"><a class="link" href="ch02s03s02.html" title="Immediate dependency resolution">immediate dependency
		resolver</a></span>”</span> would pick.  The score is only
		applied for dependencies and recommendations whose
		targets are not currently installed.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-DiscardNullSolution"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Discard-Null-Solution</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will never suggest cancelling all of your proposed
		actions in order to resolve a dependency problem.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-EssentialRemoveScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::EssentialRemoveScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-100000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much to reward or penalize solutions that remove
		an Essential package.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Remove-Essential-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Remove-Essential-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">60000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to actions that remove an
		Essential package.  See <a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a> for a
		description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-ExtraScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::ExtraScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">0</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Any version of a package whose Priority is
		<span class="quote">“<span class="quote">extra</span>”</span> will have this many points added
		to its score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-FullReplacementScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::FullReplacementScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">500</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Removing a package and installing another package that
		fully replaces it (i.e., conflicts with it, replaces
		it, and provides it) is assigned this score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-FutureHorizon"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::FutureHorizon</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">50</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How many <span class="quote">“<span class="quote">steps</span>”</span> the resolver should run
		after finding the first solution.  Although <span class="command"><strong>aptitude</strong></span>
		attempts to generate better solutions before worse
		solutions, sometimes it is unable to do so; this
		setting causes the resolver to briefly continue
		searching for a better solution before displaying its
		results, rather than stopping immediately after it
		finds the first solution.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Hints"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Hints</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong>(empty)</div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option is a group whose members are used to
		configure the problem resolver.  Each item in the
		group is a string describing an action that should be
		applied to one or more packages.  The syntax for each
		hint, and the effect that hints have, may be found in
		<a class="xref" href="ch02s03s05.html#secDependencyResolutionHints" title="Configuring resolver hints">the section called “Configuring resolver hints”</a>.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-ImportantScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::ImportantScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">4</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Any version of a package whose Priority is
		<span class="quote">“<span class="quote">important</span>”</span> will have this many points
		added to its score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Infinity"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Infinity</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">1000000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		A <span class="quote">“<span class="quote">maximum</span>”</span> score for potential
		solutions.  If a set of actions has a score worse than
		<em class="replaceable"><code>-Infinity</code></em>, it will be
		discarded immediately.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-InstallScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::InstallScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-20</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		installing a package, if the package is not already
		going to be installed.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Keep-All-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Keep-All-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">10000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to the single solution that
		cancels all of the actions selected by the user.  See
		<a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a>
		for a description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-KeepScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::KeepScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">0</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		keeping a package in its current state, if that
		package is not already going to be kept in its current
		state.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-NonDefaultScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::NonDefaultScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-40</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		installing a non-default version of the package (one
		that is not the current version and not the
		<span class="quote">“<span class="quote">candidate version</span>”</span>).
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Non-Default-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Non-Default-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">50000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to actions that install
		non-default versions of a package.  For instance, if
		version 5 of a package is installed, versions 6, 7,
		and 8 are available, and version 7 is the default
		version, then versions 6 and 8 will be given a safety
		cost that is at least this high.  See <a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a> for a
		description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-OptionalScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::OptionalScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">1</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Any version of a package whose Priority is
		<span class="quote">“<span class="quote">optional</span>”</span> will have this many points
		added to its score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-PreserveAutoScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::PreserveAutoScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">0</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		preserving automatic installations or removals.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-PreserveManualScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::PreserveManualScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">20</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		preserving explicit user selections.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-RemoveObsoleteScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::RemoveObsoleteScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">310</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to removing an
		obsolete package (if it is not already marked for removal).  It
		should at least counter RemoveScore, because it will still be
		applied.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-RemoveScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::RemoveScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-300</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		removing a package (if it is not already marked for
		removal).
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Remove-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Remove-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">10000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to actions that remove a
		package.  See <a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a> for a
		description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-RequiredScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::RequiredScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">8</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Any version of a package whose Priority is
		<span class="quote">“<span class="quote">required</span>”</span> will have this many points
		added to its score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-ResolutionScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::ResolutionScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">50</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In addition to all other scoring factors, proposed
		solutions that actually resolve all unsatisfied
		dependencies are awarded this many extra points.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Safe-Level"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Safe-Level</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">10000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The safety cost assigned to actions that install the
		default version of a package, upgrade a package to its
		default version, or cancel installing or upgrading a
		package.  Solutions assigned this cost could be
		generated by <a class="link" href="rn01re01.html#manpageSafeUpgrade"><code class="literal">aptitude
		safe-upgrade</code></a>.  See <a class="xref" href="ch02s03s04.html#secDependencyResolutionCostsSafetyCosts" title="Safety costs">the section called “Safety costs”</a> for
		a description of safety costs.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-SolutionCost"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::SolutionCost</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">safety,priority</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
                Describes how to determine the cost of a solution.
                See <a class="xref" href="ch02s03s04.html" title="Costs in the interactive dependency resolver">the section called “Costs in the interactive dependency resolver”</a> for
                a description of what solution costs are, what they
                do, and the syntax used to specify them.  If the cost
                cannot be parsed, an error is issued and the default
                cost is used instead.
              </div></div><div class="seglistitem"><a id="configProblemResolver-StandardScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::StandardScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">2</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Any version of a package whose Priority is
		<span class="quote">“<span class="quote">standard</span>”</span> will have this many points
		added to its score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-StepLimit"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::StepLimit</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">5000</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The maximum number of <span class="quote">“<span class="quote">steps</span>”</span> which
		should be performed by the problem resolver on each
		attempt to find a solution to a dependency problem.
		Decreasing this number will make <span class="command"><strong>aptitude</strong></span>
		<span class="quote">“<span class="quote">give up</span>”</span> sooner; increasing it will
		permit the search for a solution to consume much more
		time and memory before it is aborted.  Setting
		<code class="literal">StepLimit</code> to 0 will disable the
		problem resolver entirely.  The default value is large
		enough to accomodate commonly encountered situations,
		while preventing <span class="command"><strong>aptitude</strong></span> from <span class="quote">“<span class="quote">blowing
		up</span>”</span> if an overly complicated problem is
		encountered.  (note: this applies only to command-line
		searches; in the visual interface, the resolver will
		continue working until it reaches a solution)
	      </div></div><div class="seglistitem"><a id="configProblemResolver-StepScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::StepScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-10</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much to reward or penalize prospective solutions
		based on their length.  For each action performed by a
		solution, these many points are added to its score.
		The larger this value is, the more the resolver tends
		to stick with its first choice rather than considering
		alternatives; this will cause it to produce a solution
		more quickly, but the solution might be of slightly
		lower quality than it would otherwise be.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Trace-Directory"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Trace-Directory</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this value is set, then each time the problem
		resolver produces a solution, a stripped-down version
		of the package state sufficient to reproduce that
		solution is written to the given file.  If
		<code class="literal">Aptitude::ProblemResolver::Trace-File</code>
		is also set, the same information will also be written
		to the trace file.  Trace directories are more
		transparent than trace files, and are more suitable
		for, e.g., including in source trees as test cases.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-Trace-File"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::Trace-File</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this value is set, then each time the problem
		resolver produces a solution, a stripped-down version
		of the package state sufficient to reproduce that
		solution is written to the given file.  If
		<code class="literal">Aptitude::ProblemResolver::Trace-Directory</code>
		is also set, the same information will also be written
		to the trace directory.  A trace file is simply a
		compressed archive of a trace directory; it will take
		less space than the trace directory and is suitable
		for transmission over a network.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-UndoFullReplacementScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::UndoFullReplacementScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-500</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Installing a package and removing another package that
		fully replaces it (i.e., conflicts with it, replaces
		it, and provides it) is assigned this score.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-UnfixedSoftScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::UnfixedSoftScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">-200</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much to reward or penalize leaving a Recommends
		relationship unresolved.  This should typically be
		less than RemoveScore, or <span class="command"><strong>aptitude</strong></span> will tend to
		remove packages rather than leaving their
		Recommendations unfixed.  See <a class="xref" href="ch02s03s03.html" title="Resolving Dependencies Interactively">the section called “Resolving Dependencies Interactively”</a> for details.
	      </div></div><div class="seglistitem"><a id="configProblemResolver-UpgradeScore"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::ProblemResolver::UpgradeScore</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">30</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		How much weight the problem resolver should give to
		upgrading (or downgrading) a package to its candidate
		version, if the package was not already going to be
		upgraded.
	      </div></div><div class="seglistitem"><a id="configPurge-Unused"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Purge-Unused</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code> and
		<code class="literal"><a class="link" href="ch02s05s05.html#configDelete-Unused">Aptitude::Delete-Unused</a></code>
		is also <code class="literal">true</code>, then packages which
		are unused will be <span class="emphasis"><em>purged</em></span> from
		the system, removing their configuration files and
		perhaps other important data.  For more information
		about which packages are considered to be
		<span class="quote">“<span class="quote">unused</span>”</span>, see <a class="xref" href="ch02s02s06.html" title="Managing automatically installed packages">the section called “Managing automatically installed packages”</a>.  <span class="emphasis"><em>THIS OPTION CAN
		CAUSE DATA LOSS!  DO NOT ENABLE IT UNLESS YOU KNOW
		WHAT YOU ARE DOING!</em></span>
	      </div></div><div class="seglistitem"><a id="configRecommends-Important"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Recommends-Important</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is an obsolete configuration option that has been
		superseded by <a class="link" href="ch02s05s05.html#configAptInstall-Recommends"><code class="literal">APT::Install-Recommends</code></a>.
		On startup, <span class="command"><strong>aptitude</strong></span> will copy
		<code class="literal">Aptitude::Recommends-Important</code> (if
		it exists) to
		<code class="literal">APT::Install-Recommends</code> and then
		clear
		<code class="literal">Aptitude::Recommends-Important</code> in
		your user configuration file.
	      </div></div><div class="seglistitem"><a id="configSafe-Resolver-No-New-Installs"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Safe-Resolver::No-New-Installs</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, then when
		the <span class="quote">“<span class="quote">safe</span>”</span> dependency resolver has been
		activated via <a class="link" href="rn01re01.html#cmdlineSafeResolver"><code class="literal">--safe-resolver</code></a>
		or by using the <a class="link" href="rn01re01.html#manpageSafeUpgrade"><code class="literal">safe-upgrade</code></a>
		command-line action, the resolver will not be allowed
		to install packages that are not currently installed.
	      </div></div><div class="seglistitem"><a id="configSafe-Resolver-No-New-Upgrades"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Safe-Resolver::No-New-Upgrades</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is enabled, then when the
		<span class="quote">“<span class="quote">safe</span>”</span> dependency resolver has been
		activated via <a class="link" href="rn01re01.html#cmdlineSafeResolver"><code class="literal">--safe-resolver</code></a>
		or by using the <a class="link" href="rn01re01.html#manpageSafeUpgrade"><code class="literal">safe-upgrade</code></a>
		command-line action, the resolver will not be allowed
		to resolve dependencies by upgrading packages.
	      </div></div><div class="seglistitem"><a id="configDescriptions"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Sections::Descriptions</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong>See <code class="literal">$prefix/share/aptitude/section-descriptions</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option is a group whose members define the
		descriptions displayed for each section when using the
		<span class="quote">“<span class="quote"><code class="literal">section</code></span>”</span> package
		hierarchy grouping policy.  Descriptions are assigned
		to section trees based on the last component of the
		name: for instance, a member of this group named
		<span class="quote">“<span class="quote"><code class="literal">games</code></span>”</span> will be used
		to describe the Sections
		<span class="quote">“<span class="quote"><code class="literal">games</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">non-free/games</code></span>”</span>, and
		<span class="quote">“<span class="quote"><code class="literal">non-free/desktop/games</code></span>”</span>.
		Within the text of section descriptions, the string
		<span class="quote">“<span class="quote"><code class="literal">\n</code></span>”</span> will be replaced
		by a line-break, and the string
		<span class="quote">“<span class="quote"><code class="literal">''</code></span>”</span> will be replaced
		by a double-quote character.
	      </div></div><div class="seglistitem"><a id="configTop-Sections"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Sections::Top-Sections</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">"main"; "contrib"; "non-free"; "non-US";</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		A configuration group whose elements are the names of
		the top-level archive sections.  The
		<span class="quote">“<span class="quote"><code class="literal">topdir</code></span>”</span>,
		<span class="quote">“<span class="quote"><code class="literal">subdir</code></span>”</span>, and
		<span class="quote">“<span class="quote"><code class="literal">subdirs</code></span>”</span> grouping
		policies use this list to interpret Section fields: if
		the first path element of a package's Section is
		<span class="emphasis"><em>not</em></span> contained in this list, or if
		its Section has only one element, then the package
		will be grouped using the first member of this list as
		its first path element.  For example, if the first
		member of <code class="literal">Top-Sections</code> is
		<span class="quote">“<span class="quote"><code class="literal">main</code></span>”</span>, then a package
		whose Section is
		<span class="quote">“<span class="quote"><code class="literal">games/arcade</code></span>”</span> will be
		treated as if its Section field were
		<span class="quote">“<span class="quote"><code class="literal">main/games/arcade</code></span>”</span>.
	      </div></div><div class="seglistitem"><a id="configSimulate"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Simulate</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		In command-line mode, causes <span class="command"><strong>aptitude</strong></span> to just
		display the actions that would be performed (rather
		than actually performing them); in the visual
		interface, causes <span class="command"><strong>aptitude</strong></span> to start in read-only
		mode regardless of whether you are <code class="systemitem">root</code> or not.
		This is equivalent to the <code class="literal">-s</code>
		command-line option.
	      </div></div><div class="seglistitem"><a id="configSpin-Interval"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Spin-Interval</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">500</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The number of milliseconds to delay in between
		updating the <span class="quote">“<span class="quote">spinner</span>”</span> that appears while
		the problem resolver is running.
	      </div></div><div class="seglistitem"><a id="configSuggests-Important"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Suggests-Important</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is an obsolete option; use <code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-SuggestsImportant">APT::AutoRemove::SuggestsImportant</a></code>
		instead.  Setting this option to
		<code class="literal">true</code> has the same effect as setting
		<code class="literal"><a class="link" href="ch02s05s05.html#configApt-AutoRemove-SuggestsImportant">APT::AutoRemove::SuggestsImportant</a></code>
		to <code class="literal">true</code>.
	      </div></div><div class="seglistitem"><a id="suppressReadOnlyWarning"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Suppress-Read-Only-Warning</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">false</code>, <span class="command"><strong>aptitude</strong></span>
		will display a warning the first time that you attempt
		to modify package states while <span class="command"><strong>aptitude</strong></span> is in
		read-only mode.
	      </div></div><div class="seglistitem"><a id="configTheme"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Theme</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The theme that <span class="command"><strong>aptitude</strong></span> should use; see <a class="xref" href="ch02s05s06.html" title="Themes">the section called “Themes”</a> for more information.
	      </div></div><div class="seglistitem"><a id="configTrack-Dselect-State"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Track-Dselect-State</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will attempt
		to detect when a change to a package's state has
		been made using <span class="command"><strong>dselect</strong></span> or
		<span class="command"><strong>dpkg</strong></span>: for instance, if you
		remove a package using <span class="command"><strong>dpkg</strong></span>,
		<span class="command"><strong>aptitude</strong></span> will not try to reinstall it.  Note
		that this may be somewhat buggy.
	      </div></div><div class="seglistitem"><a id="configAdvance-On-Action"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Advance-On-Action</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">true</code>, changing a package's
		state (for instance, marking it for
		installation) will cause <span class="command"><strong>aptitude</strong></span> to advance
		the highlight to the next package in the current
		group.
	      </div></div><div class="seglistitem"><a id="configAuto-Show-Reasons"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Auto-Show-Reasons</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">true</code>, selecting a package
		which is broken or which appears to be causing
		other packages to be broken will cause the
		information area to automatically display some
		reasons why the breakage might be occuring.
	      </div></div><div class="seglistitem"><a id="configDefault-Grouping"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Default-Grouping</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">filter(missing),status,section(subdirs,passthrough),section(topdir)</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Sets the default grouping policy used for
		package lists.  See <a class="xref" href="ch02s05s01.html#secGroupingPolicy" title="Customizing the package hierarchy">the section called “Customizing the package hierarchy”</a> for additional
		information on grouping policies.
	      </div></div><div class="seglistitem"><a id="configDefault-Package-View"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Default-Package-View</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option is a group whose members define the
		default layout of <span class="command"><strong>aptitude</strong></span>'s display.  See
		<a class="xref" href="ch02s05s04.html" title="Customizing the display layout">the section called “Customizing the display layout”</a> for more
		information.
	      </div></div><div class="seglistitem"><a id="configDefault-Preview-Grouping"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Default-Preview-Grouping</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">action</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		Sets the default grouping policy used for
		preview screens.  See <a class="xref" href="ch02s05s01.html#secGroupingPolicy" title="Customizing the package hierarchy">the section called “Customizing the package hierarchy”</a> for additional
		information on grouping policies.
	      </div></div><div class="seglistitem"><a id="configDefault-Sorting"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Default-Sorting</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">name</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The default sorting policy of package views.  See
		<a class="xref" href="ch02s05s01.html#secSortingPolicy" title="Customizing how packages are sorted">the section called “Customizing how packages are sorted”</a> for more
		information.
	      </div></div><div class="seglistitem"><a id="configDescription-Visible-By-Default"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Description-Visible-By-Default</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		When a package list is first displayed, the
		information area (which typically contains the
		long description of the current package) will be
		visible if this option is
		<code class="literal">true</code> and hidden if it is
		<code class="literal">false</code>.
	      </div></div><div class="seglistitem"><a id="configExit-On-Last-Close"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Exit-On-Last-Close</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		closing all the active views will quit
		<span class="command"><strong>aptitude</strong></span>; otherwise, <span class="command"><strong>aptitude</strong></span> will not exit
		until you issue the command <span class="guimenu">Actions</span> → <span class="guimenuitem">Quit</span> (<span class="shortcut"><strong><span class="keycap"><strong>Q</strong></span></strong></span>).  See
		<a class="xref" href="ch02s01s03.html" title="Working with multiple views">the section called “Working with multiple views”</a> for more information.
	      </div></div><div class="seglistitem"><a id="configFill-Text"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Fill-Text</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will format descriptions so that each
		line is exactly the width of the screen.
	      </div></div><div class="seglistitem"><a id="configFlat-View-As-First-View"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Flat-View-As-First-View</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will display a flat view on startup
		instead of the default view.
	      </div></div><div class="seglistitem"><a id="configHelpBar"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::HelpBar</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, a
		line of information about important keystrokes
		will be displayed at the top of the screen.
	      </div></div><div class="seglistitem"><a id="configIncremental-Search"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Incremental-Search</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will perform
		<span class="quote">“<span class="quote">incremental</span>”</span> searches: as you type
		the search pattern, it will search for the next
		package matching what you have typed so far.
	      </div></div><div class="seglistitem"><a id="configUIInfoAreaTabs"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::InfoAreaTabs</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will display tabs at the top of the information area
		(the pane at the bottom of the screen) describing the
		different modes the area can be set to.
	      </div></div><div class="seglistitem"><a id="configKeybindings"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Keybindings</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is a group whose members define the
		connections between keystrokes and commands in
		<span class="command"><strong>aptitude</strong></span>.  For more information, see <a class="xref" href="ch02s05s02.html" title="Customizing keybindings">the section called “Customizing keybindings”</a>.
	      </div></div><div class="seglistitem"><a id="configMenubar-Autohide"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Menubar-Autohide</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">true</code>, the menu bar will be
		hidden while it is not in use.
	      </div></div><div class="seglistitem"><a id="configMinibuf-Download-Bar"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Minibuf-Download-Bar</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span> will use a
		less obtrusive mechanism to display the progress
		of downloads: a bar at the bottom of the screen
		will appear which displays the current download
		status.  While the download is active, pressing
		<span class="keycap"><strong>q</strong></span> will abort it.
	      </div></div><div class="seglistitem"><a id="configMinibuf-Prompts"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Minibuf-Prompts</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">false</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, some
		prompts (such as yes/no and multiple-choice
		prompts) will be displayed at the bottom of the
		screen instead of in dialog boxes.
	      </div></div><div class="seglistitem"><a id="configNew-Package-Commands"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::New-Package-Commands</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to
		<code class="literal">false</code>, commands such as
		<span class="guimenu">Package</span> → <span class="guimenuitem">Install</span> (<span class="shortcut"><strong><span class="keycap"><strong>+</strong></span></strong></span>) will have the same deprecated
		behavior that they did in antique versions of
		<span class="command"><strong>aptitude</strong></span>.
	      </div></div><div class="seglistitem"><a id="configPackage-Display-Format"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Package-Display-Format</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">%c%a%M %p %Z %v %V</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option controls the format string used to
		display packages in package lists.  For more
		information on format strings, see <a class="xref" href="ch02s05s01.html#secDisplayFormat" title="Customizing how packages are displayed">the section called “Customizing how packages are displayed”</a>.
	      </div></div><div class="seglistitem"><a id="configPackage-Header-Format"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Package-Header-Format</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">%N %n @ %H #%B %u %o</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option controls the format string used to
		display the header line of package lists (ie,
		the line that appears between the package list
		and the menu bar).  For more
		information on format strings, see <a class="xref" href="ch02s05s01.html#secDisplayFormat" title="Customizing how packages are displayed">the section called “Customizing how packages are displayed”</a>.
	      </div></div><div class="seglistitem"><a id="configPackage-Status-Format"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Package-Status-Format</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">%d</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This option controls the format string used to
		display the status line of package lists (ie,
		the line that appears between the package list
		and the information area).  For more
		information on format strings, see <a class="xref" href="ch02s05s01.html#secDisplayFormat" title="Customizing how packages are displayed">the section called “Customizing how packages are displayed”</a>.
	      </div></div><div class="seglistitem"><a id="configPause-After-Download"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Pause-After-Download</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">OnlyIfError</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>, <span class="command"><strong>aptitude</strong></span>
		will display a message after it finishes downloading
		packages, asking you if you want to continue with the
		installation.  If it is
		<code class="literal">OnlyIfError</code>, a message will only be
		displayed if a download failed.  Otherwise, if the
		option is set to <code class="literal">false</code>, <span class="command"><strong>aptitude</strong></span>
		will immediately proceed to the next screen after
		completing a download.
	      </div></div><div class="seglistitem"><a id="configPreview-Limit"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Preview-Limit</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The default filter applied to the preview screen;
		see <a class="xref" href="ch02s04.html" title="Search patterns">the section called “Search patterns”</a> for
		details about its format.
	      </div></div><div class="seglistitem"><a id="configPrompt-On-Exit"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Prompt-On-Exit</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will display a confirmation prompt
		before shutting down.
	      </div></div><div class="seglistitem"><a id="configColors"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::Styles</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This is a configuration group whose contents define
		what textual styles <span class="command"><strong>aptitude</strong></span> uses to display
		information.  For more information, see <a class="xref" href="ch02s05s03.html" title="Customizing text colors and styles">the section called “Customizing text colors and styles”</a>.
	      </div></div><div class="seglistitem"><a id="viewTabs"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::UI::ViewTabs</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is set to <code class="literal">false</code>,
		<span class="command"><strong>aptitude</strong></span> will not display <span class="quote">“<span class="quote">tabs</span>”</span>
		describing the currently active views at the top of
		the screen.
	      </div></div><div class="seglistitem"><a id="configWarn-Not-Root"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Aptitude::Warn-Not-Root</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">true</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		If this option is <code class="literal">true</code>,
		<span class="command"><strong>aptitude</strong></span> will detect when you need <code class="systemitem">root</code>
		privileges to do something, and ask you whether
		you want to switch to the <code class="systemitem">root</code> account if you
		aren't <code class="systemitem">root</code> already.  See <a class="xref" href="ch02s01s04.html" title="Becoming root">the section called “Becoming <code class="systemitem">root</code>”</a> for more
		information.
	      </div></div><div class="seglistitem"><a id="configDebTags-Vocabulary"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">DebTags::Vocabulary</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">/usr/share/debtags/vocabulary</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The location of the <code class="literal">debtags</code>
		vocabulary file; used to load in the package tag
		metadata.
	      </div></div><div class="seglistitem"><a id="configDir-Aptitude-State"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Dir::Aptitude::state</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="filename">/var/lib/aptitude</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		The directory in which <span class="command"><strong>aptitude</strong></span>'s persistent
		state information is stored.
	      </div></div><div class="seglistitem"><a id="configQuiet"></a><div class="seg"><strong><span class="segtitle">Option: </span></strong><code class="literal">Quiet</code></div><div class="seg"><strong><span class="segtitle">Default: </span></strong><code class="literal">0</code></div><div class="seg"><strong><span class="segtitle">Description: </span></strong>
		This controls the quietness of the command-line mode.
		Setting it to a higher value will disable more
		progress indicators.
	      </div></div></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s05s04.html"><img src="images/prev.gif" alt="Prev" /></a> </td><td width="20%" align="center"><a accesskey="u" href="ch02s05.html"><img src="images/up.gif" alt="Up" /></a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s05s06.html"><img src="images/next.gif" alt="Next" /></a></td></tr><tr><td width="40%" align="left" valign="top">Customizing the display layout </td><td width="20%" align="center"><a accesskey="h" href="index.html"><img src="images/home.gif" alt="Home" /></a></td><td width="40%" align="right" valign="top"> Themes</td></tr></table></div></body></html>

Back to Directory File Manager