X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/f0599b9c2ee704f97dbea17262107c55f527bbf0..851d681d0af7f3346d77738e4708b21ed6e2cc98:/doc/apt-get.8.xml diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index b87e17247..9d901b492 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -5,6 +5,9 @@ %aptent; + +%aptverbatiment; + ]> @@ -46,20 +49,19 @@ - - - - target_release_name - - - target_release_number_expression - - - target_release_codename - - + + + target_release + + + + + + default_architecture + + update upgrade @@ -73,10 +75,7 @@ =pkg_version_number - /target_release_name - - - /target_release_codename + /target_release @@ -92,10 +91,7 @@ =pkg_version_number - /target_release_name - - - /target_release_codename + /target_release @@ -126,7 +122,7 @@ 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;, - &aptitude;, &synaptic;, &gnome-apt; and &wajig;. + &aptitude;, &synaptic; and &wajig;. Unless the , or option is given, one of the commands below must be present. @@ -253,7 +249,7 @@ fetch. It will then find and download into the current directory the newest available version of that source package while respect the default release, set with the option APT::Default-Release, - the option or per package with with the + the option or per package with the pkg/release syntax, if possible. Source packages are tracked separately @@ -263,10 +259,12 @@ you will properly get another (newer, older or none) source version than the one you have installed or could install. - If the options is specified + If the option is specified then the package will be compiled to a binary .deb using - dpkg-buildpackage, if - is specified then the source package will not be unpacked. + dpkg-buildpackage for the architecture as + defined by the --host-architecture option. + If is specified then the source package + will not be unpacked. A specific source version can be retrieved by postfixing the source name with an equals and then the version to fetch, similar to the mechanism @@ -281,7 +279,9 @@ build-dep build-dep causes apt-get to install/remove packages in an - attempt to satisfy the build dependencies for a source package. + attempt to satisfy the build dependencies for a source package. By default the dependencies are + satisfied to build the package nativly. If desired a host-architecture can be specified + with the option instead. check @@ -289,6 +289,12 @@ for broken dependencies. + download + download will download the given + binary package into the current directory. + + + clean clean clears out the local repository of retrieved package files. It removes everything but the lock file from @@ -313,6 +319,23 @@ autoremove is used to remove packages that were automatically installed to satisfy dependencies for some package and that are no more needed. + + changelog + 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. http://packages.debian.org/changelogs for + Debian or http://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. + + + + + + @@ -325,6 +348,11 @@ Configuration Item: APT::Install-Recommends. + + Consider suggested packages as a dependency for installing. + Configuration Item: APT::Install-Suggests. + + Download only; package files are only retrieved, not unpacked or installed. Configuration Item: APT::Get::Download-Only. @@ -333,8 +361,8 @@ Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages - to permit APT to deduce a likely solution. Any Package that are specified - must completely correct the problem. The option is sometimes necessary when + to permit APT to deduce a likely solution. If packages are specified, + these have to completely correct the problem. The option is sometimes necessary when 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 @@ -384,14 +412,14 @@ Configuration Item: APT::Get::Simulate. Simulation run as user will deactivate locking (Debug::NoLocking) - automatical. Also a notice will be displayed indicating that this is only a simulation, - if the option APT::Get::Show-User-Simulation-Note is set (Default: true) - Neigther NoLocking nor the notice will be triggered if run as root (root should know what + automatic. Also a notice will be displayed indicating that this is only a simulation, + if the option APT::Get::Show-User-Simulation-Note is set (Default: true). + Neither NoLocking nor the notice will be triggered if run as root (root should know what he is doing without further warnings by apt-get). Simulate prints out a series of lines each one representing a dpkg operation, Configure (Conf), - Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with + Remove (Remv), Unpack (Inst). Square brackets indicate broken packages and empty set of square brackets meaning breaks that are of no consequence (rare). @@ -416,20 +444,22 @@ Configuration Item: APT::Get::Show-Versions. + + + This option controls the architecture packages are built for + by apt-get source --compile and how cross-builddependencies + are satisfied. By default is 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 + + + Compile source packages after downloading them. Configuration Item: APT::Get::Compile. - - Also install recommended packages. - - - - Do not install recommended packages. - - Ignore package Holds; This causes apt-get to ignore a hold placed on a package. This may be useful in conjunction with @@ -444,6 +474,13 @@ Configuration Item: APT::Get::Upgrade. + + Do not install new packages; When used in conjunction with install, + only-upgrade will prevent packages on the command line + from being upgraded if they are not already installed. + Configuration Item: APT::Get::Only-Upgrade. + + Force yes; This is a dangerous option that will cause apt to continue without prompting if it is doing something potentially harmful. It @@ -466,7 +503,7 @@ Use purge instead of remove for anything that would be removed. An asterisk ("*") will be displayed next to packages which are - scheduled to be purged. is equivalent for + scheduled to be purged. is equivalent to the command. Configuration Item: APT::Get::Purge. @@ -558,50 +595,11 @@ Files - /etc/apt/sources.list - Locations to fetch packages from. - Configuration Item: Dir::Etc::SourceList. - - - /etc/apt/apt.conf - APT configuration file. - Configuration Item: Dir::Etc::Main. - - - /etc/apt/apt.conf.d/ - APT configuration file fragments. - Configuration Item: Dir::Etc::Parts. - - - /etc/apt/preferences - Version preferences file. - This is where you would specify "pinning", - i.e. a preference to get certain packages - from a separate source - or from a different version of a distribution. - Configuration Item: Dir::Etc::Preferences. - - - &cachedir;/archives/ - Storage area for retrieved package files. - Configuration Item: Dir::Cache::Archives. - - - &cachedir;/archives/partial/ - Storage area for package files in transit. - Configuration Item: Dir::Cache::Archives (implicit partial). - - - &statedir;/lists/ - Storage area for state information for each package resource specified in - &sources-list; - Configuration Item: Dir::State::Lists. - - - &statedir;/lists/partial/ - Storage area for state information in transit. - Configuration Item: Dir::State::Lists (implicit partial). - + &file-sourceslist; + &file-aptconf; + &file-preferences; + &file-cachearchives; + &file-statelists;