[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Request for Review: APT manpages



Hi english-deities,

You might still remember the last time we talked about apt manpages:
That was more than 3 years ago! In the meantime we have worked at least
on some of them enough to warrant a new look and this is the official
request for it.

The pages in question would be (direct link to the current git version
in docbook format as attaching all probably kills the mail):
https://anonscm.debian.org/cgit/apt/apt.git/plain/doc/apt.8.xml
https://anonscm.debian.org/cgit/apt/apt.git/plain/doc/apt-secure.8.xml
https://anonscm.debian.org/cgit/apt/apt.git/plain/doc/sources.list.5.xml
https://anonscm.debian.org/cgit/apt/apt.git/plain/doc/apt-mark.8.xml

The first one is 'new', the other three cover areas which were basically
rewritten in code, so the manpages followed suite (more or less).  [The
other manpages are still more or less as cobwebby as last time, but we
will deal with them eventually… no need to look just yet – oh, and don't
trust the last-update fields in the manpages… I have just noticed that
they are talking more about the moment the field was last updated than
about the manpage itself really…].


We have practically no constrains in regards of possible changes this
time around, so feel free to criticise each and every aspect. :)


And finally to whet your appetite I attached a pseudo-po file which
contains some program strings we have recently added/changed in src:apt
where a review wouldn't hurt either.


Best regards

David Kalnischkies
#: apt-private/private-cmndline.cc
#, c-format
msgid "See %s for more information about the available commands."
msgstr ""

#: apt-private/private-cmndline.cc
msgid ""
"Configuration options and syntax is detailed in apt.conf(5).\n"
"Information about how to configure sources can be found in sources.list(5).\n"
"Package and version choices can be expressed via apt_preferences(5).\n"
"Security details are available in apt-secure(8).\n"
msgstr ""

#: apt-private/private-download.cc apt-private/private-install.cc
msgid ""
"--force-yes is deprecated, use one of the options starting with --allow "
"instead."
msgstr ""

#: apt-private/private-install.cc
msgid ""
"Held packages were changed and -y was used without --allow-change-held-"
"packages."
msgstr ""

#: cmdline/apt-cache.cc
msgid ""
"Usage: apt-cache [options] command\n"
"       apt-cache [options] show pkg1 [pkg2 ...]\n"
"\n"
"apt-cache queries and displays available information about installed\n"
"as well as installable packages. It works exclusively on the data\n"
"acquired via the 'update' command of e.g. apt-get to the local cache.\n"
"The displayed information can therefore be outdated if the last update\n"
"is too long ago, but in exchange apt-cache works independently of the\n"
"availability of the configured sources (e.g. offline).\n"
msgstr ""

#: cmdline/apt.cc
msgid ""
"Usage: apt [options] command\n"
"\n"
"apt is a commandline package manager and provides commands for\n"
"searching and managing as well as querying information about packages.\n"
"It provides the same functionality as the specialized APT tools,\n"
"like apt-get and apt-cache, but enables options more suitable for\n"
"interactive use by default.\n"
msgstr ""

#: cmdline/apt-cdrom.cc
msgid ""
"Usage: apt-cdrom [options] command\n"
"\n"
"apt-cdrom is used to add CDROM's, USB flashdrives and other removable\n"
"media types as package sources to APT. The mount point and device\n"
"information is taken from apt.conf(5), udev(7) and fstab(5).\n"
msgstr ""

#: cmdline/apt-config.cc
msgid ""
"Usage: apt-config [options] command\n"
"\n"
"apt-config is an interface to the configuration settings used by\n"
"all APT tools to be used mainly in debugging and shell scripting.\n"
msgstr ""

#: methods/server.cc
#, c-format
msgid ""
"Automatically disabled %s due to incorrect response from server/proxy. (man "
"5 apt.conf)"
msgstr ""

#: cmdline/apt-sortpkgs.cc
msgid ""
"Usage: apt-sortpkgs [options] file1 [file2 ...]\n"
"\n"
"apt-sortpkgs is a simple tool to sort package information files.\n"
"It sorts by default by binary package information, but the -s option\n"
"can be used to switch to source package ordering instead.\n"
msgstr ""

#: apt-pkg/acquire.cc
#, c-format
msgid ""
"Can't drop privileges for downloading as file '%s' couldn't be accessed by "
"user '%s'."
msgstr ""

#: apt-pkg/acquire-item.cc
msgid ""
"Updating such a repository securily is impossible and therefore disabled by "
"default."
msgstr ""

#: apt-pkg/acquire-item.cc
msgid ""
"Data from such a repository can not be authenticated and is therefore "
"potentially dangerous to use."
msgstr ""

#: apt-pkg/acquire-item.cc
msgid ""
"See apt-secure(8) manpage for repository creation and user configuration "
"details."
msgstr ""

#: apt-pkg/acquire-item.cc
msgid ""
"This is normally not allowed, but the option Acquire::"
"AllowDowngradeToInsecureRepositories was given to override it."
msgstr ""

#. TRANSLATOR: an identifier like Packages; Releasefile key indicating
#. a file like main/binary-amd64/Packages; another identifier like Contents;
#. filename and linenumber of the sources.list entry currently parsed
#: apt-pkg/deb/debmetaindex.cc
#, c-format
msgid "Target %s wants to acquire the same file (%s) as %s from source %s"
msgstr ""

#. TRANSLATOR: an identifier like Packages; Releasefile key indicating
#. a file like main/binary-amd64/Packages; filename and linenumber of
#. two sources.list entries
#: apt-pkg/deb/debmetaindex.cc
#, c-format
msgid "Target %s (%s) is configured multiple times in %s and %s"
msgstr ""

#. TRANSLATOR: The first is an option name from sources.list manpage, the other two URI and Suite
#: apt-pkg/deb/debmetaindex.cc
#, c-format
msgid "Conflicting values set for option %s concerning source %s %s"
msgstr ""

#: apt-pkg/deb/debmetaindex.cc
#, c-format
msgid "Invalid value set for option %s concerning source %s %s (%s)"
msgstr ""

#: apt-pkg/policy.cc
#, c-format
msgid "%s: Value %s is outside the range of valid pin priorities (%d to %d)"
msgstr ""

#: apt-pkg/sourcelist.cc
#, c-format
msgid "Unsupported file %s given on commandline"
msgstr ""

#: cmdline/apt-get.cc
msgid ""
"Usage: apt-get [options] command\n"
"       apt-get [options] install|remove pkg1 [pkg2 ...]\n"
"       apt-get [options] source pkg1 [pkg2 ...]\n"
"\n"
"apt-get is a command line interface for retrieval of packages\n"
"and information about them from authenticated sources and\n"
"for installation, upgrade and removal of packages together\n"
"with their dependencies.\n"
msgstr ""

#: cmdline/apt-helper.cc
msgid ""
"Usage: apt-helper [options] command\n"
"       apt-helper [options] download-file uri target-path\n"
"\n"
"apt-helper bundles a variety of commands for shell scripts to use\n"
"e.g. the same proxy configuration or acquire system as APT would do.\n"
msgstr ""

#: cmdline/apt-mark.cc
msgid ""
"Usage: apt-mark [options] {auto|manual} pkg1 [pkg2 ...]\n"
"\n"
"apt-mark is a simple command line interface for marking packages\n"
"as manually or automatically installed. It is also possible to\n"
"manipulate the dpkg(1) selection states of packages with it.\n"
"It can also list all packages with or without a certain marking.\n"
msgstr ""

#: cmdline/apt-extracttemplates.cc
msgid ""
"Usage: apt-extracttemplates file1 [file2 ...]\n"
"\n"
"apt-extracttemplates is used to extract config and template files\n"
"from debian packages. It is used mainly by debconf(1) to prompt for\n"
"configuration questions before installation of packages.\n"
msgstr ""

#: cmdline/apt-internal-solver.cc
msgid ""
"Usage: apt-internal-solver\n"
"\n"
"apt-internal-solver is an interface to use the current internal\n"
"like an external resolver for the APT family for debugging or alike.\n"
msgstr ""

#. No Release file was present, or verification failed, so fall
#. back to queueing Packages files without verification
#. only allow going further if the users explicitely wants it
#: apt-pkg/acquire-item.cc
#, c-format
msgid "The repository '%s' is not signed."
msgstr ""

#. No Release file was present so fall
#. back to queueing Packages files without verification
#. only allow going further if the users explicitely wants it
#: apt-pkg/acquire-item.cc
#, c-format
msgid "The repository '%s' does not have a Release file."
msgstr ""

#: apt-pkg/acquire-item.cc
#, c-format
msgid "The repository '%s' is no longer signed."
msgstr ""

#: apt-pkg/contrib/cmndline.cc
#, c-format
msgid ""
"Command line option '%c' [from %s] is not understood in combination with the "
"other options."
msgstr ""

#: apt-pkg/contrib/cmndline.cc
#, c-format
msgid ""
"Command line option %s is not understood in combination with the other "
"options"
msgstr ""

Attachment: signature.asc
Description: PGP signature


Reply to: