X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/dbf8fc0419831c83e83165de8c434782165aa400..51c4e07f4cba0615ff269b5a8d04dfd3d1313b00:/doc/apt-get.8.xml diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 6ccd9e5ec..81a9036c4 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -1,13 +1,9 @@ -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -38,7 +34,7 @@ Description apt-get is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT - library. Several "front-end" interfaces exist, such as &dselect;, + library. Several "front-end" interfaces exist, such as &aptitude;, &synaptic; and &wajig;. Unless the , or option is given, one of the @@ -215,10 +211,7 @@ clean clears out the local repository of retrieved package files. It removes everything but the lock file from &cachedir;/archives/ and - &cachedir;/archives/partial/. When APT is used as a - &dselect; method, clean is run automatically. - Those who do not use dselect will likely want to run apt-get clean - from time to time to free up disk space. + &cachedir;/archives/partial/. @@ -237,19 +230,30 @@ - changelog downloads a package changelog and displays - it through sensible-pager. The server name and base - directory is defined in the APT::Changelogs::Server - variable (e.g. packages.debian.org/changelogs for - Debian or changelogs.ubuntu.com/changelogs for - Ubuntu). - By default it displays the changelog for the version that is - installed. However, you can specify the same options as for - the command. - + changelog tries to download the + changelog of a package and displays it through + sensible-pager. By default it + displays the changelog for the version that is installed. + However, you can specify the same options as for the + command. + + Displays by default a deb822 formatted listing of + information about all data files (aka index targets) apt-get + update would download. Supports a + option to modify the output format as + well as accepts lines of the default output to filter the records + by. The command is mainly used as an interface for external tools + working with APT to get information as well as filenames for + downloaded files so they can use them as well instead of + downloading them again on their own. Detailed documentation is + omitted here and can instead be found in the source tree in + doc/acquire-additional-files.txt. + + + @@ -282,7 +286,7 @@ running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention - (which usually means using &dselect; or dpkg --remove to eliminate some of + (which usually means using dpkg --remove to eliminate some of the offending packages). Use of this option together with may produce an error in some situations. Configuration Item: APT::Get::Fix-Broken. @@ -323,17 +327,15 @@ - No action; perform a simulation of events that would occur but do not - actually change the system. - Configuration Item: APT::Get::Simulate. - - Simulated runs performed as a user will automatically deactivate locking - (Debug::NoLocking), and if the option - APT::Get::Show-User-Simulation-Note 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 apt-get. + 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 () + so the system state could change while apt-get 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 (). + Configuration Item: APT::Get::Simulate. Simulated runs print out a series of lines, each representing a dpkg operation: configure (Conf), remove (Remv) @@ -372,7 +374,18 @@ by apt-get source --compile and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by APT::Architecture). - Configuration Item: APT::Get::Host-Architecture + Configuration Item: APT::Get::Host-Architecture. + + + + + + This option controls the activated build profiles for which + a source package is built by apt-get source --compile and + how build dependencies are satisfied. By default no build profile is active. + More than one build profile can be activated at a time by concatenating them + with a comma. + Configuration Item: APT::Build-Profiles. @@ -516,11 +529,31 @@ - Ignore if packages can't be authenticated and don't prompt about it. - This is useful for tools like pbuilder. - Configuration Item: APT::Get::AllowUnauthenticated. + Ignore if packages can't be authenticated and don't prompt + about it. This can be useful while working with local repositories, + but is a huge security risk if data authenticity isn't ensured in + another way by the user itself. The usage of the + option for &sources-list; entries should + usually be preferred over this global override. Configuration Item: + APT::Get::AllowUnauthenticated. - + + + Forbid the update command to acquire unverifiable + data from configured sources. Apt will fail at the update command + for repositories without valid cryptographically signatures. + + Configuration Item: Acquire::AllowInsecureRepositories. + + + + Show user friendly progress information in the + terminal window when packages are installed, upgraded or + removed. For a machine parsable version of this data see + README.progress-reporting in the apt doc directory. + Configuration Item: Dpkg::Progress and Dpkg::Progress-Fancy. + + &apt-commonoptions; @@ -538,7 +571,7 @@ See Also - &apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, + &apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.