/usr/share/doc/aptitude/html/en/ch02s05s05.html is in aptitude-doc-en 0.8.10-6ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 | <?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 V1.79.1" /><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) -> 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>
|