diff options
| author | David Kalnischkies <david@kalnischkies.de> | 2015-07-10 00:07:37 +0200 |
|---|---|---|
| committer | David Kalnischkies <david@kalnischkies.de> | 2015-08-10 17:27:17 +0200 |
| commit | c2a4a8dded2dfb56dbcab9689b6cb4b96c9999b6 (patch) | |
| tree | ee4679a839124bd5ea0f487dd2d3408b9d57a173 /doc/apt-get.8.xml | |
| parent | 0d5b9da9f597fecae9b912d37d4e58bc903bdd4f (diff) | |
rename 'apt-get files' to 'apt-get indextargets'
'files' is a bit too generic as a name for a command usually only used
programmatically (if at all) by developers, so instead of "wasting" this
generic name for this we use "indextargets" which is actually the name
of the datastructure the displayed data is stored in.
Along with this rename the config options are renamed accordingly.
Diffstat (limited to 'doc/apt-get.8.xml')
| -rw-r--r-- | doc/apt-get.8.xml | 24 |
1 files changed, 11 insertions, 13 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index b0fe390df..81a9036c4 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -239,9 +239,9 @@ </listitem> </varlistentry> - <varlistentry><term><option>files</option></term> + <varlistentry><term><option>indextargets</option></term> <listitem><para>Displays by default a deb822 formatted listing of - information about all data files <command>apt-get + information about all data files (aka index targets) <command>apt-get update</command> would download. Supports a <option>--format</option> option to modify the output format as well as accepts lines of the default output to filter the records @@ -327,17 +327,15 @@ <term><option>--dry-run</option></term> <term><option>--recon</option></term> <term><option>--no-act</option></term> - <listitem><para>No action; perform a simulation of events that would occur but do not - actually change the system. - Configuration Item: <literal>APT::Get::Simulate</literal>.</para> - - <para>Simulated runs performed as a user will automatically deactivate locking - (<literal>Debug::NoLocking</literal>), and if the option - <literal>APT::Get::Show-User-Simulation-Note</literal> is set - (as it is by default) a notice will also be displayed indicating that - this is only a simulation. Runs performed as root do not trigger either - NoLocking or the notice - superusers should know what they are doing - without further warnings from <literal>apt-get</literal>.</para> + <listitem><para>No action; perform a simulation of events that would occur + based on the current system state but do not actually change the + system. Locking will be disabled (<option>Debug::NoLocking</option>) + so the system state could change while <command>apt-get</command> is + running. Simulations can also be executed by non-root users which might + not have read access to all apt configuration distorting the simulation. + A notice expressing this warning is also shown by default for non-root + users (<option>APT::Get::Show-User-Simulation-Note</option>). + Configuration Item: <literal>APT::Get::Simulate</literal>.</para> <para>Simulated runs print out a series of lines, each representing a <command>dpkg</command> operation: configure (<literal>Conf</literal>), remove (<literal>Remv</literal>) |