summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Hartwig <mandyke@gmail.com>2012-06-20 17:22:11 +0800
committerDaniel Hartwig <mandyke@gmail.com>2012-06-20 17:22:11 +0800
commit2f544c3c351591f0f30e9f3bdf2cc905f54b906a (patch)
tree730dba9d73ae88b95e487d6d52e33c384bf7e4b3 /doc
parenta88745bf22c3e83e5d78331a69f813e451c895a0 (diff)
downloadaptitude-2f544c3c351591f0f30e9f3bdf2cc905f54b906a.tar.gz
Do not do FixMissing automatically for command-line actions
When a package is not available or fails to download incorrectly aptitude would try to continue without it. This made it hard to detect errors automatically using the exit status. This behaviour is no longer the default, instead if there are missing packages an error will be displayed and the program exit with failure (100). If the user wishes to continue anyway, they can use --fix-missing or configure Aptitude::CmdLine::Fix-Missing in apt.conf. * [cmdline]: An install run will no longer proceed if any package was unavailable or failed to download correctly, instead an error will be shown and exit with non-zero status (100). (Closes: #121313, #302784) The old behaviour can be obtained with the new --fix-missing option or setting Aptitude::CmdLine::Fix-Missing. Closes: #121313 Closes: #302784
Diffstat (limited to 'doc')
-rw-r--r--doc/en/aptitude.xml15
-rw-r--r--doc/en/manpage.xml27
2 files changed, 42 insertions, 0 deletions
diff --git a/doc/en/aptitude.xml b/doc/en/aptitude.xml
index cb673b39..3c3711b5 100644
--- a/doc/en/aptitude.xml
+++ b/doc/en/aptitude.xml
@@ -10804,6 +10804,21 @@ e: Examine !: Apply .: Next ,: Previous</screen>
</seg>
</seglistitem>
+ <seglistitem id='configCmdLine-Fix-Missing'>
+ <seg><literal>Aptitude::CmdLine::Fix-Missing</literal></seg>
+ <seg><literal>false</literal></seg>
+ <seg>
+ In command-line mode, if a package is unavailable of
+ fails to download to correctly and this option is
+ <literal>true</literal>, &aptitude; will try to
+ continue installing other packages without it. The
+ package will still be marked for later installation,
+ as though <literal>--schedule-only</literal> had been
+ used. Command-line Option: <literal><link
+ linkend='cmdlineOptionFixMissing'>--fix-missing</link></literal>.
+ </seg>
+ </seglistitem>
+
<seglistitem id='configCmdLine-Versions-Group-By'>
<seg><literal>Aptitude::CmdLine::Versions-Group-By</literal></seg>
diff --git a/doc/en/manpage.xml b/doc/en/manpage.xml
index 8b03d591..c6933eb6 100644
--- a/doc/en/manpage.xml
+++ b/doc/en/manpage.xml
@@ -1533,6 +1533,33 @@ libdbix-fulltextsearch-perl 0.73-10</screen>
</listitem>
</varlistentry>
+ <varlistentry id='cmdlineOptionFixMissing'>
+ <term>
+ <literal>-m</literal>, <literal>--ignore-missing</literal>,
+ <literal>--fix-missing</literal>
+ </term>
+
+ <listitem>
+ <para>
+ If a package is unavailable or fails to download correctly
+ try to continue installing packages without it. The
+ package will still be marked for later installation, as
+ though <literal>--schedule-only</literal> had been used.
+ Configuration Item: <literal><link
+ linkend='configCmdLine-Fix-Missing'>Aptitude::CmdLine::Fix-Missing</link></literal>.
+ </para>
+
+ <note>
+ <para>
+ This was the default behaviour in previous versions of
+ &aptitude; however it caused problems when trying to
+ detect errors using the exit status and was prone to
+ resulting in undesired effects.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+
<varlistentry id='cmdlineOptionNoNewInstalls'>
<term>
<literal>--no-new-installs</literal>