From c086ac18511ce648a0ed88ab470965470bd422c5 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Sun, 20 May 2012 18:24:23 +0200 Subject: * doc/*.xml: - add a few translator notes and reword some paragraphs to ensure that translators and users alike can better understand them (Closes: #669409) --- doc/apt-cache.8.xml | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) (limited to 'doc/apt-cache.8.xml') diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 42d700c82..dd0ea6e9d 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -46,13 +46,11 @@ gencaches - gencaches performs the same operation as - apt-get check. It builds the source and package caches from - the sources in &sources-list; and from - /var/lib/dpkg/status. + gencaches creates APT's package cache. This is done + implicitly by all commands needing this cache if it is missing or outdated. - showpkg pkg(s) + showpkg &synopsis-pkg; showpkg displays information about the packages listed on the command line. Remaining arguments are package names. The available versions and reverse dependencies of each package listed are listed, as @@ -141,7 +139,7 @@ Reverse Provides: - showsrc pkg(s) + showsrc &synopsis-pkg; showsrc displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a Binary. @@ -162,13 +160,13 @@ Reverse Provides: package cache. - show pkg(s) + show &synopsis-pkg; show performs a function similar to dpkg --print-avail; it displays the package records for the named packages. - search regex [ regex ... ] + search &synopsis-regex; search performs a full text search on all available package lists for the POSIX regex pattern given, see regex @@ -186,17 +184,17 @@ Reverse Provides: are and'ed together. - depends pkg(s) + depends &synopsis-pkg; depends shows a listing of each dependency a package has and all the possible other packages that can fulfill that dependency. - rdepends pkg(s) + rdepends &synopsis-pkg; rdepends shows a listing of each reverse dependency a package has. - pkgnames [ prefix ] + pkgnames [ &synopsis-prefix; ] This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated @@ -207,7 +205,7 @@ Reverse Provides: - dotty pkg(s) + dotty &synopsis-pkg; dotty takes a list of packages on the command line and generates output suitable for use by dotty from the GraphViz @@ -225,19 +223,19 @@ Reverse Provides: Caution, dotty cannot graph larger sets of packages. - xvcg pkg(s) + xvcg &synopsis-pkg; The same as dotty, only for xvcg from the VCG tool. - policy [ pkg(s) ] + policy [ &synopsis-pkg;… ] policy is meant to help debug issues relating to the preferences file. With no arguments it will print out the priorities of each source. Otherwise it prints out detailed information about the priority selection of the named package. - madison [ pkg(s) ] + madison &synopsis-pkg; apt-cache's madison command attempts to mimic the output format and a subset of the functionality of the Debian archive management tool, madison. It displays -- cgit v1.2.3 From 2b9b27c395d75a0c06e7eca65746e5567e459dac Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 21 May 2012 04:40:48 +0200 Subject: in mark all options with - gencaches + gencaches creates APT's package cache. This is done implicitly by all commands needing this cache if it is missing or outdated. - showpkg &synopsis-pkg; + showpkg displays information about the packages listed on the command line. Remaining arguments are package names. The available versions and reverse dependencies of each package listed are listed, as @@ -84,7 +84,7 @@ Reverse Provides: is best to consult the apt source code. - statsstats displays some statistics about the cache. + stats displays some statistics about the cache. No further arguments are expected. Statistics reported are: Total package names is the number of package names found @@ -139,34 +139,34 @@ Reverse Provides: - showsrc &synopsis-pkg; + showsrc displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a Binary. - dump + dump shows a short listing of every package in the cache. It is primarily for debugging. - dumpavail + dumpavail prints out an available list to stdout. This is suitable for use with &dpkg; and is used by the &dselect; method. - unmet + unmet displays a summary of all unmet dependencies in the package cache. - show &synopsis-pkg; + show performs a function similar to dpkg --print-avail; it displays the package records for the named packages. - search &synopsis-regex; + search performs a full text search on all available package lists for the POSIX regex pattern given, see regex @@ -184,17 +184,17 @@ Reverse Provides: are and'ed together. - depends &synopsis-pkg; + depends shows a listing of each dependency a package has and all the possible other packages that can fulfill that dependency. - rdepends &synopsis-pkg; + rdepends shows a listing of each reverse dependency a package has. - pkgnames [ &synopsis-prefix; ] + &synopsis-prefix; This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated @@ -205,7 +205,7 @@ Reverse Provides: - dotty &synopsis-pkg; + dotty takes a list of packages on the command line and generates output suitable for use by dotty from the GraphViz @@ -223,19 +223,19 @@ Reverse Provides: Caution, dotty cannot graph larger sets of packages. - xvcg &synopsis-pkg; + The same as dotty, only for xvcg from the VCG tool. - policy [ &synopsis-pkg;… ] + &synopsis-pkg; policy is meant to help debug issues relating to the preferences file. With no arguments it will print out the priorities of each source. Otherwise it prints out detailed information about the priority selection of the named package. - madison &synopsis-pkg; + apt-cache's madison command attempts to mimic the output format and a subset of the functionality of the Debian archive management tool, madison. It displays -- cgit v1.2.3 From 45fb8bf7f0b3f1e5b69b37a2f9a07a6864448f03 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 21 May 2012 06:13:03 +0200 Subject: auto-generate the correct translation --- doc/apt-cache.8.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/apt-cache.8.xml') diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 3029512db..f36347107 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -18,7 +18,7 @@ &apt-email; &apt-product; - 04 February 2011 + 2012-05-21T00:00:00Z -- cgit v1.2.3