dctrl-tools 2.20.1: Please translate the documentation of dctrl-tools
Dear Debian I18N people,
I would like to know if some of you would be interested in translating
documentation of dctrl-tools.
The deadline might be a bit short for a new documentation translation,
but we'll be pleased to make an upload later (before Wheezy freezes) to
include your translation when it's ready.
dctrl-tools already includes de.po fr.po.
So do not translate it to these languages (the translators will be
contacted separately).
language translated fuzzy untranslated
-----------------------------------------------------
de 326 5 4
fr 326 5 4
Please send the updated file to me, or submit it as a wishlist bug
against dctrl-tools.
The deadline for receiving the updated translation is
Sat, 17 Dec 2011 18:17:55 -0400.
If you have read so far, please find the POT file in attachment.
Thanks in advance,
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2011-12-07 18:13-0400\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: TH
#: man/grep-dctrl.1.cp:1
#, no-wrap
msgid "GREP-DCTRL"
msgstr ""
#. type: TH
#: man/grep-dctrl.1.cp:1
#, no-wrap
msgid "2011-11-13"
msgstr ""
#. type: TH
#: man/grep-dctrl.1.cp:1 man/sort-dctrl.1:1 man/sync-available.8:1 man/tbl-dctrl.1:1
#, no-wrap
msgid "Debian Project"
msgstr ""
#. type: TH
#: man/grep-dctrl.1.cp:1 man/sort-dctrl.1:1
#, no-wrap
msgid "Debian user's manual"
msgstr ""
#. Copyright (C) 2005, 2010 Antti-Juhani Kaijanaho <ajk@debian.org>
#. This program is free software; you can redistribute it and/or modify
#. it under the terms of the GNU General Public License as published by
#. the Free Software Foundation; either version 2 of the License, or
#. (at your option) any later version.
#. This program is distributed in the hope that it will be useful,
#. but WITHOUT ANY WARRANTY; without even the implied warranty of
#. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#. GNU General Public License for more details.
#. You should have received a copy of the GNU General Public License
#. along with this program; see the file COPYING. If not, write to
#. the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
#. Boston, MA 02111-1307, USA.
#. type: SH
#: man/grep-dctrl.1.cp:18 man/join-dctrl.1:17 man/sort-dctrl.1:17 man/sync-available.8:17 man/tbl-dctrl.1:17
#, no-wrap
msgid "NAME"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:20
msgid ""
"grep-dctrl, grep-status, grep-available, grep-aptavail, grep-debtags - grep "
"Debian control files"
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:20 man/join-dctrl.1:19 man/sort-dctrl.1:19 man/sync-available.8:19 man/tbl-dctrl.1:19
#, no-wrap
msgid "SYNOPSIS"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:23
msgid "I<command> B<--copying>|B<-C> | B<--help>|B<-h> | B<--version>|B<-V>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:25
msgid "I<command> [I<options>] I<filter> [ I<file>... ]"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:35
msgid ""
"where I<command> is one of B<grep-dctrl>, B<grep-status>, B<grep-available>, "
"B<grep-aptavail> and B<grep-debtags>."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:35 man/join-dctrl.1:32 man/sort-dctrl.1:28 man/sync-available.8:25 man/tbl-dctrl.1:36
#, no-wrap
msgid "DESCRIPTION"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:47
msgid ""
"The B<grep-dctrl> program can answer such questions as I<What is the Debian "
"package foo?>, I<Which version of the Debian package bar is now current?>, "
"I<Which Debian packages does John Doe maintain?>, I<Which Debian packages "
"are somehow related to the Scheme> I<programming language?>, and with some "
"help, I<Who maintain the essential packages of a Debian system?>, given a "
"useful input file."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:67
msgid ""
"The programs B<grep-available>, B<grep-status>, B<grep-aptavail> and "
"B<grep-debtags> are aliases of (actually, symbolic links to) "
"B<grep-dctrl>. In the shipped configuration, these aliases use as their "
"default input the B<dpkg>(1) I<available> and I<status> files, the "
"B<apt-cache dumpavail> output and the B<debtags dumpavail> output, "
"respectively."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:86
msgid ""
"B<grep-dctrl> is a specialised B<grep> program that is meant for processing "
"any file which has the general format of a Debian package I<control> file, "
"as described in the Debian Policy. These include the B<dpkg> I<available> "
"file, the B<dpkg> I<status> file, and the I<Packages> files on a "
"distribution medium (such as a Debian CD-ROM or an FTP site carrying "
"Debian)."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:105
msgid ""
"You must give a I<filter> expression on the command line. The I<filter> "
"defines which kind of paragraphs (aka package records) are output. A simple "
"I<filter> is a search pattern along with any options that modify it. "
"Possible modifiers are B<--eregex>, B<--field>, B<--ignore-case>, B<--regex> "
"and B<--exact-match>, along with their single-letter equivalents. By "
"default, the search is a case-sensitive fixed substring match on each "
"paragraph (in other words, package record) in the input. With suitable "
"modifiers, this can be changed: the search can be case-insensitive and the "
"pattern can be seen as an extended POSIX regular expression."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:113
msgid ""
"I<Filter>s can be combined to form more complex I<filter>s using the "
"connectives B<--and>, B<--or> and B<--not>. Parentheses (which usually need "
"to be escaped for the shell) can be used for grouping."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:118
msgid ""
"By default, the full matching paragraphs are printed on the standard output; "
"specific fields can be selected for output with the B<-s> option."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:148
msgid ""
"After the I<filter> expression comes zero or more I<file> names. If no "
"I<file> names are specified, the I<file> name is searched in configuration "
"files. The input I<file> in association with the correct program name is "
"used. The program names are matched with the base form of the name of the "
"current program (the 0'th command line argument, if you will). The I<file> "
"name B<-> is taken to mean the standard input stream. The I<file>s are "
"searched in order but separately; they are B<not> concatenated together. In "
"other words, the end of a I<file> always implies the end of the current "
"paragraph."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:153
msgid ""
"There is one exception to the above: if the program name is B<grep-dctrl>, "
"the default input source is always standard input; this cannot be overridden "
"by the configuration file."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:153 man/join-dctrl.1:60 man/sort-dctrl.1:74 man/sync-available.8:47 man/tbl-dctrl.1:99
#, no-wrap
msgid "OPTIONS"
msgstr ""
#. type: SS
#: man/grep-dctrl.1.cp:154
#, no-wrap
msgid "Specifying the search pattern"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:155
#, no-wrap
msgid "B<--pattern=>I<pattern>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:167
msgid ""
"Specify a I<pattern> to be searched. This switch is not generally needed, as "
"the I<pattern> can be given by itself. However, I<pattern>s that start with "
"a dash (B<->) must be given using this switch, so that they wouldn't be "
"mistaken for switches."
msgstr ""
#. type: SS
#: man/grep-dctrl.1.cp:167
#, no-wrap
msgid "Modifiers of simple filters"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:168
#, no-wrap
msgid "B<-F >I<field>,I<field>, ... | B<--field=>I<field>,I<field>, ..."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:187
msgid ""
"Restrict pattern matching to the I<field>s given. Multiple I<field> names "
"in one B<-F> option and multiple B<-F> options in one simple I<filter> are "
"allowed. The search named by the filter will be performed among all the "
"I<field>s named, and as soon as any one of them matches, the whole simple "
"I<filter> is considered matching."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:196
msgid ""
"A I<field> specification can contain a colon (B<:>). In such a case, the "
"part up to the colon is taken as the name of the field to be searched in, "
"and the part after the colon is taken as the name of the field whose content "
"is to be used if the field to search in is empty."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:196
#, no-wrap
msgid "B<-P>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:199
msgid "Shorthand for B<-FPackage>."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:199
#, no-wrap
msgid "B<-S>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:202
msgid "Shorthand for B<-FSource:Package>."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:202
#, no-wrap
msgid "B<-e>, B<--eregex>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:205
msgid ""
"Regard the pattern of the current simple filter as an extended POSIX regular "
"expression"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:205
#, no-wrap
msgid "B<-r>, B<--regex>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:207
msgid ""
"Regard the pattern of the current simple filter as a standard POSIX regular "
"expression."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:207
#, no-wrap
msgid "B<-i>, B<--ignore-case>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:209
msgid "Ignore case when looking for a match in the current simple filter."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:209
#, no-wrap
msgid "B<-X>, B<--exact-match>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:212
msgid ""
"Do an exact match (as opposed to a substring match) in the current simple "
"filter."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:212
#, no-wrap
msgid "B<-w>, B<--whole-pkg>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:220
msgid ""
"Do an extended regular expression match on whole package names, assuming the "
"syntax of inter-package relationship fields such as "
"B<Depends>,B<Recommends>, ... When this flag is given you should not worry "
"about sub-package names such as \"libpcre3\" also matching "
"\"libpcre3-dev\". This flag implies (and is incompatible with) B<-e>."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:220
#, no-wrap
msgid "B<--eq>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:226
msgid ""
"Do an equality comparison under the Debian version number system. If the "
"pattern or the field to be searched in is not a valid Debian version number, "
"the paragraph is regarded as not matching. As a special case, this is "
"capable of comparing simple nonnegative integers for equality."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:226
#, no-wrap
msgid "B<--lt>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:232
msgid ""
"Do an strictly-less-than comparison under the Debian version number system. "
"If the pattern or the field to be searched in is not a valid Debian version "
"number, the paragraph is regarded as not matching. As a special case, this "
"is capable of comparing simple nonnegative integers."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:232
#, no-wrap
msgid "B<--le>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:238
msgid ""
"Do an less-than-or-equal comparison under the Debian version number system. "
"If the pattern or the field to be searched in is not a valid Debian version "
"number, the paragraph is regarded as not matching. As a special case, this "
"is capable of comparing simple nonnegative integers."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:238
#, no-wrap
msgid "B<--gt>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:244
msgid ""
"Do an strictly-greater-than comparison under the Debian version number "
"system. If the pattern or the field to be searched in is not a valid Debian "
"version number, the paragraph is regarded as not matching. As a special "
"case, this is capable of comparing simple nonnegative integers."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:244
#, no-wrap
msgid "B<--ge>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:250
msgid ""
"Do an greater-than-or-equal comparison under the Debian version number "
"system. If the pattern or the field to be searched in is not a valid Debian "
"version number, the paragraph is regarded as not matching. As a special "
"case, this is capable of comparing simple nonnegative integers."
msgstr ""
#. type: SS
#: man/grep-dctrl.1.cp:250
#, no-wrap
msgid "Combining filters"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:251
#, no-wrap
msgid "B<-!>, B<--not>, B<!>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:255
msgid "Match if the following filter does B<not> match."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:255
#, no-wrap
msgid "B<-o>, B<--or>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:258
msgid "Match if either one or both of the preceding and following filters matches."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:258
#, no-wrap
msgid "B<-a>, B<--and>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:260
msgid "Match if both the preceding and the following filter match."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:260
#, no-wrap
msgid "B<(> ... B<)>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:263
msgid ""
"Parentheses can be used for grouping. Note that they need to be escaped for "
"most shells."
msgstr ""
#. type: SS
#: man/grep-dctrl.1.cp:263
#, no-wrap
msgid "Output format modifiers"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:264
#, no-wrap
msgid "B<-s >I<field>,I<field>, ... | B<--show-field=>I<field>,I<field>, ..."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:279
msgid ""
"Show only the body of these I<field>s from the matching paragraphs. The "
"I<field> names must not include any colons or commas. Commas are used to "
"delimit I<field> names in the argument to this option. The I<field>s are "
"shown in the order given here. See also the option B<-I>. Note that in the "
"absence of the B<--ensure--dctrl> option, if only one field is selected, no "
"paragraph separator is output."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:279
#, no-wrap
msgid "B<-I>, B<--invert-show>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:288
msgid ""
"Invert the meaning of option B<-s>: show only the fields that have B<not> "
"been named using a B<-s> option. As an artefact of the implementation, the "
"order of the fields in the original paragraph is not preserved."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:295
msgid ""
"A I<field> specification can contain a colon. In such a case, the part up to "
"the colon is taken as the name of the field to be shown, and the part after "
"the colon is taken as the name of the field whose content is to be used if "
"the field to be shown is empty."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:295
#, no-wrap
msgid "B<-d>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:313
msgid ""
"Show only the first line of the B<Description> field from the matching "
"paragraphs. If no B<-s> option is specified, this option also effects B<-s "
"Description>; if there is a B<-s> option but it does not include the "
"B<Description> field name, one is appended to the option. Thus the "
"B<Description> field's location in the output is determined by the B<-s> "
"option, if any, the last field being the default."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:313
#, no-wrap
msgid "B<-n>, B<--no-field-names>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:318
msgid ""
"Suppress field names when showing specified fields, only their bodies are "
"shown. Each field is printed in its original form without the field name, "
"the colon after it and any whitespace preceding the start of the body."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:318
#, no-wrap
msgid "B<-v>, B<--invert-match>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:323
msgid ""
"Instead of showing all the paragraphs that match, show those paragraphs that "
"do B<not> match."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:323
#, no-wrap
msgid "B<-c>, B<--count>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:328
msgid ""
"Instead of showing the paragraphs that match (or, with B<-v>, that don't "
"match), show the count of those paragraphs."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:328 man/sort-dctrl.1:95
#, no-wrap
msgid "B<-q>, B<--quiet>, B<--silent>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:331 man/sort-dctrl.1:98
msgid ""
"Output nothing to the standard output stream. Instead, exit immediately "
"after finding the first match."
msgstr ""
#. type: SS
#: man/grep-dctrl.1.cp:331
#, no-wrap
msgid "Miscellaneous"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:332
#, no-wrap
msgid "B<--ensure-dctrl>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:340
msgid ""
"Ensure that the output is in dctrl format, specifically that there always is "
"an empty line separating paragraphs. This option is not honored if the "
"B<-n> option has been selected, as that option deliberately requests a "
"non-dctrl format for the output. In a future version, this option may be "
"made the default behaviour."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:340
#, no-wrap
msgid "B<--compat>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:344
msgid "Override any B<--ensure-dctrl> option given earlier on the command line."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:344
#, no-wrap
msgid "B<--ignore-parse-errors>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:348
msgid ""
"Ignore errors in parsing input. A paragraph which cannot be parsed is "
"ignored in its entirety, and the next paragraph is assumed to start after "
"the first newline since the location of the error."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:348
#, no-wrap
msgid "B<--config-file=>I<filename>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:352
msgid "Use I<filename> as the config file instead of the defaults."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:352
#, no-wrap
msgid "B<--debug-optparse>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:354
msgid "Show how the current command line has been parsed."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:354 man/join-dctrl.1:128 man/sort-dctrl.1:98 man/tbl-dctrl.1:106
#, no-wrap
msgid "B<-l >I<level>, B<--errorlevel=>I<level>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:368 man/join-dctrl.1:142 man/sort-dctrl.1:112 man/tbl-dctrl.1:120
msgid ""
"Set log level to I<level>. I<level> is one of B<fatal>, B<important>, "
"B<informational> and B<debug>, but the last may not be available, depending "
"on the compile-time options. These categories are given here in order; "
"every message that is emitted when B<fatal> is in effect, will be emitted in "
"the B<important> error level, and so on. The default is B<important>."
msgstr ""
#. type: TP
#: man/grep-dctrl.1.cp:368 man/join-dctrl.1:142 man/sort-dctrl.1:112 man/tbl-dctrl.1:120
#, no-wrap
msgid "B<-V>, B<--version>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:370 man/join-dctrl.1:145 man/sort-dctrl.1:114 man/tbl-dctrl.1:123
msgid "Print out version information."
msgstr ""
#. type: TP
#: man/grep-dctrl.1.cp:370 man/join-dctrl.1:145 man/sort-dctrl.1:114 man/tbl-dctrl.1:123
#, no-wrap
msgid "B<-C>, B<--copying>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:373 man/join-dctrl.1:149 man/sort-dctrl.1:117 man/tbl-dctrl.1:127
msgid ""
"Print out the copyright license. This produces much output; be sure to "
"redirect or pipe it somewhere (such as your favourite pager)."
msgstr ""
#. type: TP
#: man/grep-dctrl.1.cp:373 man/join-dctrl.1:149 man/sort-dctrl.1:117 man/tbl-dctrl.1:127
#, no-wrap
msgid "B<-h>, B<--help>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:375 man/join-dctrl.1:152 man/sort-dctrl.1:119 man/tbl-dctrl.1:130
msgid "Print out a help summary."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:375 man/join-dctrl.1:218 man/sort-dctrl.1:119 man/tbl-dctrl.1:202
#, no-wrap
msgid "EXAMPLES"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:378
msgid ""
"The following example queries assume that the default configuration is in "
"effect."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:387
msgid ""
"The almost simplest use of this program is to print out the status or "
"available record of a package. In this respect, B<grep-dctrl> is like "
"B<dpkg -s> or B<dpkg --print-avail>. To print out the status record of the "
"package \"mixal\", do"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:389
#, no-wrap
msgid "% grep-status -PX mixal\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:391
msgid "and to get its available record, use"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:393
#, no-wrap
msgid "% grep-available -PX mixal\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:400
msgid ""
"In fact, you can ask for the record of the \"mixal\" package from any Debian "
"control file. Say, you have the Debian 6.0 CD-ROM's I<Packages> file in the "
"current directory; now you can do a"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:402
#, no-wrap
msgid "% grep-dctrl -PX mixal Packages\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:412
msgid ""
"But B<grep-dctrl> can do more than just emulate B<dpkg>. It can "
"more-or-less emulate B<apt-cache>! That program has a search feature that "
"searches package descriptions. But we can do that too:"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:414
#, no-wrap
msgid "% grep-available -F Description foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:417
msgid ""
"searches for the string \"foo\" case-sensitively in the descriptions of all "
"available packages. If you want case-insensitivity, use"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:419
#, no-wrap
msgid "% grep-available -F Description -i foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:424
msgid ""
"Truth to be told, B<apt-cache> searches package names, too. We can "
"separately search in the names; to do so, do"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:426
#, no-wrap
msgid "% grep-available -F Package foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:428 man/grep-dctrl.1.cp:438
msgid "or"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:430
#, no-wrap
msgid "% grep-available -P foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:434
msgid ""
"which is pretty much the same thing. We can also search in both "
"descriptions and names; if match is found in either, the package record is "
"printed:"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:436
#, no-wrap
msgid "% grep-available -P -F Description foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:440
#, no-wrap
msgid "% grep-available -F Package -F Description foo\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:444
msgid "This kind of search is the exactly same that B<apt-cache> does."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:456
msgid ""
"Here's one thing neither B<dpkg> nor B<apt-cache> do. Search for a string "
"in the whole I<status> or I<available> file (or any Debian control file, for "
"that matter) and print out all package records where we have a match. Try"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:458
#, no-wrap
msgid "% grep-available dpkg\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:462
msgid "sometime and watch how thoroughly B<dpkg> has infiltrated Debian."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:469
msgid ""
"All the above queries were based on simple substring searches. But "
"B<grep-dctrl> can handle regular expressions in the search pattern. For "
"example, to see the status records of all packages with either \"apt\" or "
"\"dpkg\" in their names, use"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:471
#, no-wrap
msgid "% grep-status -P -e 'apt|dpkg'\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:478
msgid ""
"Now that we have seen all these fine and dandy queries, you might begin to "
"wonder whether it is necessary to always see the whole paragraph. You may "
"be, for example, interest only in the dependency information of the packages "
"involved. Fine. To show the depends lines of all packages maintained by "
"me, do a"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:480
#, no-wrap
msgid "% grep-available -F Maintainer -s Depends 'ajk@debian.org'\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:482
msgid "If you want to see the packages' names, too, use"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:485
#, no-wrap
msgid ""
"% grep-available -F Maintainer -s Package,Depends \\e\n"
" 'ajk@debian.org'\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:489
msgid "Note that there must be no spaces in the argument to the B<-s> switch."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:492
msgid ""
"More complex queries are also possible. For example, to see the list of "
"packages maintained by me and depending on libc6, do"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:495
#, no-wrap
msgid ""
"% grep-available -F Maintainer 'ajk@debian.org' \\e\n"
" -a -F Depends libc6 -s Package,Depends\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:502
msgid ""
"Remember that you can use other UNIX filters to help you, too. Ever "
"wondered, who's the most active Debian developer based on the number of "
"source packages being maintained? Easy. You just need to have a copy of the "
"most recent I<Sources> file from any Debian mirror."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:505
#, no-wrap
msgid ""
"% grep-dctrl -n -s Maintainer '' Sources | sort | \\e\n"
" uniq -c | sort -nr\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:510
msgid ""
"This example shows a neat trick: if you want to selectively show only some "
"field of I<all> packages, just supply an empty pattern."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:516
msgid ""
"The term \"bogopackage\" means the count of the packages that a Debian "
"developer maintains. To get the bogopackage count for the maintainer of "
"B<dctrl-tools>, say"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:519
#, no-wrap
msgid ""
"% grep-available -c -FMaintainer \\e\n"
" \"`grep-available -sMaintainer -n -PX dctrl-tools`\"\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:525
msgid ""
"Sometimes it is useful to output the data of several fields on the same "
"line. For example, the following command outputs the list of installed "
"packages, sorted by their B<Installed-Size>."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:529
#, no-wrap
msgid ""
"% grep-status -FStatus -sInstalled-Size,Package -n \\e\n"
" \"install ok installed\" -a -FInstalled-Size --gt 0 \\e\n"
" | paste -sd \" \\en\" | sort -n\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:531
msgid "Note that there should be exactly 2 spaces in the \" \\en\" string."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:534
msgid ""
"Another usual use-case is looking for packages that have another one as "
"build dependency:"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:537
#, no-wrap
msgid ""
"% grep-dctrl -s Package -F Build-Depends,Build-Depends-Indep \\e\n"
" quilt /var/lib/apt/lists/*Sources\n"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:542
msgid ""
"These examples cover a lot of typical uses of this utility, but not all "
"possible uses. Use your imagination! The building blocks are there, and if "
"something's missing, let me know."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:542
#, no-wrap
msgid "DIAGNOSTICS"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:558
msgid ""
"In the absence of errors, the exit code B<0> is used if at least one match "
"was found, and the exit code B<1> is used if no matches were found. If "
"there were errors, the exit code is B<2>, with one exception. If the B<-q>, "
"B<--quiet> or B<--silent> options are used, the exit code B<0> is used when "
"a match is found regardless of whether there have been non-fatal errors."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:563
msgid ""
"These messages are emitted in log levels B<fatal> and B<important>. "
"Additional messages may be provided by the system libraries. B<This list is "
"incomplete.>"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:563
#, no-wrap
msgid "B<A pattern is mandatory>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:565
msgid "You must specify a pattern to be searched for."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:565
#, no-wrap
msgid "B<malformed filter>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:567
msgid "No filter was specified, but one is required."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:567
#, no-wrap
msgid "B<cannot find enough memory>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:570
msgid ""
"More memory was needed than was available. This error may be transient, "
"that is, if you try again, all may go well."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:570
#, no-wrap
msgid "B<cannot suppress field names when showing whole paragraphs>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:580
msgid ""
"When you do not use the B<-s> switch, B<grep-dctrl> just passes the matching "
"paragraphs through, not touching them any way. This means, for example, "
"that you can only use B<-n> when you use B<-s>."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:580
#, no-wrap
msgid "B<inconsistent modifiers of simple filters>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:586
msgid ""
"Conflicting modifiers of simple filters were used; for example, perhaps both "
"B<-X> and B<-e> were specified for the same simple filter."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:586
#, no-wrap
msgid "B<missing ')' in command line>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:589
msgid "There were more opening than closing parentheses in the given filter."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:589
#, no-wrap
msgid "B<no such log level>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:593
msgid "The argument to B<-l> was invalid."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:593
#, no-wrap
msgid "B<read failure or out of memory>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:597
msgid ""
"There was a problem reading the configuration file. Maybe there was a "
"transput error; maybe memory was exhausted. This error may be transient, "
"that is, if you try again, all may go well."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:597
#, no-wrap
msgid "B<syntax error: need a executable name>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:599 man/grep-dctrl.1.cp:601
msgid "There is a problem in the configuration file. Look, and you shall find it."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:599
#, no-wrap
msgid "B<syntax error: need an input file name>"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:601
#, no-wrap
msgid "B<too many file names>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:604
msgid ""
"The number of file names specified in the command line exceeded a "
"compile-time limit."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:604
#, no-wrap
msgid "B<too many output fields>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:609
msgid ""
"The argument to B<-s> had too many field names in it. This number is "
"limited to 256."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:609
#, no-wrap
msgid "B<unexpected ')' in command line>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:612
msgid ""
"There was no opening parenthesis that would match some closing parenthesis "
"in the command line."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:612
#, no-wrap
msgid "COMPATIBILITY"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:618
msgid ""
"If you use B<grep-dctrl> in a Debian package, it should depend on the "
"B<dctrl-tools> package and heed the following compatibility notes:"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:619
#, no-wrap
msgid "Always call only the B<grep-dctrl> executable"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:623
msgid ""
"Although the B<grep-status> and B<grep-available> symlinks are installed by "
"default, this may change in the future. Those symlinks are meant for manual "
"and not scripted use."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:623
#, no-wrap
msgid "Always specify an explicit file name"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:629
msgid ""
"Don't rely on the implicit file name feature. The system administrator may "
"have changed the default file name. You should always specify the B<-> "
"file, too."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:629
#, no-wrap
msgid "Not all features have been with us in every version"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:634
msgid ""
"Check if any of the features you use is mentioned in the changelog. Use a "
"versioned dependency on B<dctrl-tools>, if it is necessary."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:634
#, no-wrap
msgid "FILES"
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:635
#, no-wrap
msgid "I<SYSCONF/grep-dctrl.rc>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:637
msgid "See the next file."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:637
#, no-wrap
msgid "I<~/.grep-dctrlrc>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:646
msgid ""
"These files are the default configuration files for B<grep-dctrl>. The "
"format is line-based, with `B<#>' introducing a comment that lasts to the "
"end of the line. Each line defines one association between a program name "
"and a default input file. These two things are listed in the line in order, "
"separated by whitespace. Empty lines are ignored."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:657
msgid ""
"If the default input file name starts with two at (B<@>) signs, one of them "
"is ignored. This allows specifying a file name that starts with an at "
"sign. If it starts with the string B<@exec>, the rest of the name is "
"interpreted as a command name that is fed to B</bin/sh> B<-c>, and the "
"standard output stream is used as the default input."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:657
#, no-wrap
msgid "I</var/lib/dpkg/available>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:661
msgid ""
"The default input file of B<grep-available> when the shipped configuration "
"is in effect."
msgstr ""
#. type: IP
#: man/grep-dctrl.1.cp:661
#, no-wrap
msgid "I</var/lib/dpkg/status>"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:665
msgid ""
"The default input file of B<grep-status> when the shipped configuration is "
"in effect."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:665 man/join-dctrl.1:240 man/sort-dctrl.1:151 man/sync-available.8:56 man/tbl-dctrl.1:210
#, no-wrap
msgid "AUTHOR"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:672
msgid ""
"The program and this manual page were written by Antti-Juhani Kaijanaho "
"E<lt>I<gaia@iki.fi>E<gt>. Bill Allombert E<lt>I<ballombe@debian.org>E<gt> "
"provided one of the examples in the manual page."
msgstr ""
#. type: SH
#: man/grep-dctrl.1.cp:672 man/join-dctrl.1:244 man/sort-dctrl.1:154 man/sync-available.8:59 man/tbl-dctrl.1:214
#, no-wrap
msgid "SEE ALSO"
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:677 man/sort-dctrl.1:159
msgid ""
"Debian Policy Manual. Published as the Debian package B<debian-policy>. "
"Also available in the Debian website."
msgstr ""
#. type: Plain text
#: man/grep-dctrl.1.cp:683
msgid "B<apt-cache>(1), B<ara>(1), B<dpkg-awk>(1), B<sgrep>(1), B<dpkg>(8)"
msgstr ""
#. type: TH
#: man/join-dctrl.1:1
#, no-wrap
msgid "join-dctrl"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:19
msgid "join-dctrl - perform relational join on data in dctrl format"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:26
msgid "B<join-dctrl> [ I<options> ] I<filename> I<filename>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:29
msgid "B<join-dctrl> B<--version>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:32
msgid "B<join-dctrl> B<--help>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:36
msgid ""
"B<join-dctrl> performs a relational join operation on data given to it in "
"Debian control file format."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:45
msgid ""
"A I<join field> must be specified using either the switches B<-1> and B<-2> "
"or the switch B<-j>."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:51
msgid ""
"Conceptually, the program creates all ordered pairs of records that can be "
"formed by having a record from the first file as the first member of the "
"pair and having a record from the second file as the second member of the "
"pair; and then it deletes all such pairs where the join fields are not "
"equal."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:53
msgid ""
"Effectively, each of the input files is treated as a relational database "
"table."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:56
msgid ""
"Every input file must be in ascending order on its join field; this allows "
"the program to work fast."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:60
msgid "The B<sort-dctrl>(1) program can be used to make it so."
msgstr ""
#. type: IP
#: man/join-dctrl.1:61
#, no-wrap
msgid "B<-1 >I<field>, B<--1st-join-field=>I<field>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:65
msgid "Specify the join I<field> of the first input file."
msgstr ""
#. type: IP
#: man/join-dctrl.1:65
#, no-wrap
msgid "B<-2 >I<field>, B<--2nd-join-field=>I<field>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:69
msgid "Specify the join I<field> of the second input file."
msgstr ""
#. type: IP
#: man/join-dctrl.1:69
#, no-wrap
msgid "B<-j >I<field>, B<--join-field=>I<field>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:73
msgid "Specify a common join I<field> for all files."
msgstr ""
#. type: IP
#: man/join-dctrl.1:73
#, no-wrap
msgid "B<-a >I<fileno>, B<--unpairable-from=>I<fileno>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:80
msgid ""
"Specify that unmatched paragraphs from the first (if B<1> is given) or the "
"second (if B<2> is given) file are printed."
msgstr ""
#. type: IP
#: man/join-dctrl.1:80
#, no-wrap
msgid "B<-o >I<fieldspec>, B<--output-fields=>I<fieldspec>"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:82
msgid "Specify which fields are included in the output."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:87
msgid ""
"Fields are separated by commas (more than one B<-o> option can be used, "
"too)."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:98
msgid ""
"Each field is specified in the format I<fileno>B<.>I<field> in which "
"I<fileno> is the ordinal number of the input file from which the field is "
"drawn (either B<1> or B<2>), and I<field> gives the name of the field to "
"use."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:104
msgid ""
"As a special case, simple B<0> can be used instead of I<fileno>B<.>I<field> "
"to refer to the common value of the join fields."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:107
msgid ""
"The name of the field (not including the file number) is used in the output "
"as the name of the field."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:111
msgid ""
"However, a different name for output purposes can be specified by suffixing "
"the field specification by a colon and the preferred visible name."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:123
msgid ""
"For example, the option B<-o 0,1.Version:Old-Version,2.Version> specifies "
"that the first field in any output record should be the join field, the "
"second field should be B<Old-Version> drawing its data from the B<Version> "
"field of the first input file, and the third field should be B<Version> "
"drawing its data from the field with the same name in the second input file, "
"and these are the only fields in an output record."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:128
msgid ""
"If no B<-o> option is given, all fields of all the records being joined are "
"included in the output."
msgstr ""
#. type: SH
#: man/join-dctrl.1:152 man/tbl-dctrl.1:130
#, no-wrap
msgid "OPERANDS"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:156
msgid ""
"B<join-dctrl> will treat each file named on the command line as a relational "
"database table."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:160 man/tbl-dctrl.1:138
msgid "A file called B<-> represents the program's standard input stream."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:162
msgid "Currently, exactly two files must be named."
msgstr ""
#. type: SH
#: man/join-dctrl.1:162 man/tbl-dctrl.1:143
#, no-wrap
msgid "STDIN"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:167 man/tbl-dctrl.1:148
msgid ""
"The standard input stream may be used as input as specified above in the "
"B<OPERANDS> section."
msgstr ""
#. type: SH
#: man/join-dctrl.1:167 man/tbl-dctrl.1:148
#, no-wrap
msgid "INPUT FILES"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:171
msgid "All input to B<join-dctrl> is in the format of a Debian control file."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:174 man/sort-dctrl.1:35 man/tbl-dctrl.1:155
msgid ""
"A Debian control (dctrl) file is a semistructured single-table database "
"stored in a machine-parseable text file."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:177 man/sort-dctrl.1:39 man/tbl-dctrl.1:158
msgid ""
"Such a database consists of a set of records; each record is a mapping from "
"field names to field content."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:180 man/sort-dctrl.1:43 man/tbl-dctrl.1:161
msgid ""
"Textually, records are separated by empty lines, while each field is encoded "
"as one or more nonempty lines inside a record."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:183 man/sort-dctrl.1:46 man/tbl-dctrl.1:164
msgid ""
"A field starts with its name, followed by a colon, followed by the field "
"content."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:186 man/sort-dctrl.1:49 man/tbl-dctrl.1:167
msgid ""
"The colon must reside on the first line of the field, and the first line "
"must start with no whitespace."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:189 man/sort-dctrl.1:52 man/tbl-dctrl.1:170
msgid ""
"Subsequent lines, in contrast, always start with linear whitespace (one or "
"more space or tab characters)."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:191
msgid "Each input file must be in the ascending order of its join field."
msgstr ""
#. type: SH
#: man/join-dctrl.1:191 man/tbl-dctrl.1:173
#, no-wrap
msgid "ENVIRONMENT VARIABLES"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:195 man/tbl-dctrl.1:177
msgid ""
"The standard locale environment, specifically its character set setting, "
"affects the interpretation of input and output as character streams."
msgstr ""
#. type: SH
#: man/join-dctrl.1:195 man/tbl-dctrl.1:177
#, no-wrap
msgid "ASYNCHRONOUS EVENTS"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:197 man/tbl-dctrl.1:179
msgid "Standard UNIX signals have their usual meaning."
msgstr ""
#. type: SH
#: man/join-dctrl.1:197 man/tbl-dctrl.1:179
#, no-wrap
msgid "STDOUT"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:199 man/tbl-dctrl.1:181
msgid "All output is sent to the standard output stream."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:204
msgid ""
"The output is in the format of a Debian control file, described above in the "
"B<INPUT FILES> section."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:207
msgid ""
"The output will be in the ascending order of the join field, if that field "
"is included in the output."
msgstr ""
#. type: SH
#: man/join-dctrl.1:207 man/tbl-dctrl.1:191
#, no-wrap
msgid "OUTPUT FILES"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:209 man/tbl-dctrl.1:193
msgid "There are no output files."
msgstr ""
#. type: SH
#: man/join-dctrl.1:209 man/sync-available.8:42 man/tbl-dctrl.1:193
#, no-wrap
msgid "EXIT STATUS"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:214 man/tbl-dctrl.1:198
msgid ""
"This utility exits with B<0> when successful. It uses a nonzero exit code "
"inconsistently when an error is noticed (this is a bug)."
msgstr ""
#. type: SH
#: man/join-dctrl.1:214 man/tbl-dctrl.1:198
#, no-wrap
msgid "CONSEQUENCES OF ERRORS"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:218 man/tbl-dctrl.1:202
msgid ""
"In case of errors in the input, the output will be partially or completely "
"garbage. In case of errors in invocation, the program will refuse to "
"function."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:224
msgid ""
"Suppose that a file containing data about binary packages for the AMD64 "
"architecture contained in the Debian squeeze (6.0) release, section B<main>, "
"is in the current directory and named I<Packages>."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:226
msgid "Suppose that we are currently on a Debian system."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:229
msgid ""
"Suppose further that the current directory does not contain files named "
"I<stat> and I<pkg>."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:233
msgid ""
"The following commands gives, for each package currently installed and "
"available in Debian squeeze (6.0), its currently installed version (as "
"Old-Version) and the version in squeeze (as New-Version):"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:239
#, no-wrap
msgid ""
"$ sort-dctrl -kPackage /var/lib/dpkg/status E<gt> stat\n"
"$ sort-dctrl -kPackage Packages E<gt> pkg\n"
"$ join-dctrl -j Package \\e\n"
" -o 0,1.Version:Old-Version,2.Version:New-Version \\e\n"
" stat pkg\n"
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:244
msgid ""
"The B<join-dctrl> program and this manual page were written by Antti-Juhani "
"Kaijanaho."
msgstr ""
#. type: Plain text
#: man/join-dctrl.1:248
msgid "B<grep-dctrl>(1), B<sort-dctrl>(1), B<tbl-dctrl>(1)"
msgstr ""
#. type: TH
#: man/sort-dctrl.1:1
#, no-wrap
msgid "SORT-DCTRL"
msgstr ""
#. type: TH
#: man/sort-dctrl.1:1
#, no-wrap
msgid "2005-06-08"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:19
msgid "sort-dctrl - sort Debian control files"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:25
msgid "B<sort-dctrl> [options] [ I<file> ... ]"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:28
msgid "B<sort-dctrl> --copying | --help | --version | -ChV"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:32
msgid ""
"The B<sort-dctrl> program sorts Debian control files according to specified "
"criteria."
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:65
msgid ""
"The B<sort-dctrl> program recognizes two field types: string fields and "
"version fields. Version fields act also as numeric fields. String fields "
"are compared according to strict lexicographical octet-by-octet comparison, "
"after ignoring any initial whitespace after the colon. Version fields are "
"parsed and compared as Debian version numbers. When comparing version "
"numbers, if a field content does not in fact conform to the version number "
"syntax, it compares less than any field content that does conform, and equal "
"to any other nonconforming field content. The B<sort-dctrl> program assumes "
"all fields are string fields unless told otherwise."
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:74
msgid ""
"You can specify arbitrary number of keys for sorting, using the B<-k> "
"option. The keys are interpreted in a descending order of priority: the "
"first key specified is primary, the second key specified is secondary, and "
"so on. If two records compare equal under the primary key, then they are "
"compared under the secondary key, and so on. If no keys are specified, a "
"default key is assumed (the \"Package\" field with no modifiers)."
msgstr ""
#. type: IP
#: man/sort-dctrl.1:75
#, no-wrap
msgid "B<-k >I<keyspec>, B<--key-spec=>I<keyspec>"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:83
msgid ""
"Specify one or more keys for sorting. You may specify this option any "
"number of times. The I<keyspec> argument consists of a comma-separated list "
"of key specifications. Each key specification consists of the name of the "
"field that serves as the key, optionally followed by a colon and key "
"modifiers. The following key modifiers are supported:"
msgstr ""
#. type: TP
#: man/sort-dctrl.1:84
#, no-wrap
msgid "B<r>"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:87
msgid "Invert the comparison for this key, reversing the sorting order."
msgstr ""
#. type: TP
#: man/sort-dctrl.1:87
#, no-wrap
msgid "B<v>"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:90
msgid "Treat this field as a version number field."
msgstr ""
#. type: TP
#: man/sort-dctrl.1:90
#, no-wrap
msgid "B<n>"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:94
msgid "Treat this field as numeric, which currently is synonymous with B<v>."
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:121
msgid "Here are some sample invocations of the program:"
msgstr ""
#. type: IP
#: man/sort-dctrl.1:121
#, no-wrap
msgid "sort-dctrl /var/lib/dpkg/available"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:126
msgid "Output the B<dpkg> I<available> file sorted by the package name."
msgstr ""
#. type: IP
#: man/sort-dctrl.1:126
#, no-wrap
msgid "sort-dctrl -k Version:v /var/lib/dpkg/available"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:132
msgid ""
"Output the B<dpkg> I<available> file sorted in ascending order of version "
"numbers."
msgstr ""
#. type: IP
#: man/sort-dctrl.1:132
#, no-wrap
msgid "sort-dctrl -k Version:vr /var/lib/dpkg/available"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:138
msgid ""
"Output the B<dpkg> I<available> file sorted in descending order of version "
"numbers."
msgstr ""
#. type: IP
#: man/sort-dctrl.1:138
#, no-wrap
msgid "sort-dctrl -k Package,Version:v /var/lib/dpkg/available"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:144
msgid ""
"Output the B<dpkg> I<available> file sorted primarily in ascending order of "
"package names and secondarily in descending order of version numbers."
msgstr ""
#. type: IP
#: man/sort-dctrl.1:144
#, no-wrap
msgid "sort-dctrl -k Installed-Size:n,Size:nr /var/lib/dpkg/available"
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:151
msgid ""
"Output the B<dpkg> I<available> file sorted primarily in ascending order of "
"installation sizes and secondarily in descending order of package sizes."
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:154 man/sync-available.8:59
msgid ""
"The program and this manual page were written by Antti-Juhani Kaijanaho "
"E<lt>ajk@debian.orgE<gt>."
msgstr ""
#. type: Plain text
#: man/sort-dctrl.1:161
msgid "B<grep-dctrl>(1)"
msgstr ""
#. type: TH
#: man/sync-available.8:1
#, no-wrap
msgid "SYNC-AVAILABLE"
msgstr ""
#. type: TH
#: man/sync-available.8:1
#, no-wrap
msgid "2005-07-11"
msgstr ""
#. type: TH
#: man/sync-available.8:1 man/tbl-dctrl.1:1
#, no-wrap
msgid "Debian administrator's manual"
msgstr ""
#. type: Plain text
#: man/sync-available.8:19
msgid "sync-available - sync dpkg's available database with apt's database"
msgstr ""
#. type: Plain text
#: man/sync-available.8:21
msgid "B<sync-available>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:23
msgid "B<sync-available --version>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:25
msgid "B<sync-available --help>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:34
msgid ""
"This program updates the B<dpkg>(8) I<available> database with the data in "
"the B<apt>(8) package database. This is required for B<grep-available>(1) "
"and other similar programs to give up-to-date results."
msgstr ""
#. type: Plain text
#: man/sync-available.8:42
msgid ""
"The same functionality is available through B<dselect>(8), when it is "
"configured to use B<apt>(8) as its acquisition method. However, this "
"program does not require that B<dselect>(8) is installed."
msgstr ""
#. type: Plain text
#: man/sync-available.8:47
msgid ""
"The program exits with status code B<0> if all went well, and a non-zero "
"status code otherwise."
msgstr ""
#. type: IP
#: man/sync-available.8:48
#, no-wrap
msgid "B<--version>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:50
msgid "Output the name and version of the program onto standard output stream."
msgstr ""
#. type: IP
#: man/sync-available.8:50
#, no-wrap
msgid "B<--help>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:52
msgid "Give a brief usage statement on the standard output stream."
msgstr ""
#. type: SH
#: man/sync-available.8:52
#, no-wrap
msgid "ENVIRONMENT"
msgstr ""
#. type: IP
#: man/sync-available.8:53
#, no-wrap
msgid "B<TMPDIR>"
msgstr ""
#. type: Plain text
#: man/sync-available.8:56
msgid ""
"The name of the directory where temporary files are created. Default is "
"I</tmp>."
msgstr ""
#. type: Plain text
#: man/sync-available.8:63
msgid "B<grep-available>(1), B<apt>(8), B<dpkg>(8), B<dselect>(8)"
msgstr ""
#. type: TH
#: man/tbl-dctrl.1:1
#, no-wrap
msgid "tbl-dctrl"
msgstr ""
#. type: TH
#: man/tbl-dctrl.1:1
#, no-wrap
msgid "2006-04-02"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:19
msgid "tbl-dctrl - generate tabular representations of data in dctrl format"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:30
msgid ""
"B<tbl-dctrl> [ I<options> ] [ B<-c> I<column-specification> ... ] [ "
"I<filename> ] ..."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:33
msgid "B<tbl-dctrl> B<--version>"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:36
msgid "B<tbl-dctrl> B<--help>"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:40
msgid ""
"B<tbl-dctrl> creates tabular representations of data given to it in Debian "
"control file format."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:47
msgid ""
"By default, B<tbl-dctrl> reads the whole database, looking for the longest "
"entry in each requested column; it then outputs a table, with borders and "
"column titles, where each column is just wide enough to fit the longest "
"entry."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:49
msgid "Most of this behaviour can be customized as described below."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:53
msgid ""
"A column is requested by specifying the B<-c> (B<--column>) switch with a "
"column specification."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:56
msgid ""
"The simplest kind of a column specification consists solely of the name of a "
"field."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:61
msgid ""
"In such a case, B<tbl-dctrl> will include in the output a column whose title "
"is the literal column specification and whose data is drawn from fields with "
"that name."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:67
msgid ""
"If no B<-c> options are given, B<tbl-dctrl> will use all fields in the input "
"in the order in which they first appear."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:70
msgid "There are two optional additions one can make to a column specification."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:77
msgid ""
"Prefixing the field name with some text followed by an equality sign (for "
"example, B<-c 'Package name=Package'>) modifies the column in such a way "
"that the text before the equality sign is used as the column title, while "
"the text after the equality sign is used as the name of the field from which "
"data is drawn."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:81
msgid ""
"One can also append a colon followed by a positive whole number to the field "
"name. In such a case, the number after the colon specifies the width of the "
"column."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:83
msgid "These two additions can be used separately or together."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:85
msgid "If there are more than one colon, the last one is significant."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:87
msgid "If there are more than one equals sign, the first one is significant."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:89
msgid "Other colons and equals signs are used simply as data."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:94
msgid ""
"Note that the whole column specification must be given to B<tbl-dctrl> as "
"one argument, so if it contains spaces, it must be quoted for the shell."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:99
msgid ""
"If all requested columns have a specified width, B<tbl-dctrl> will produce "
"output immediately, not waiting for the whole input to be read in."
msgstr ""
#. type: IP
#: man/tbl-dctrl.1:100
#, no-wrap
msgid "B<-d >I<delimiter>, B<--delimiter=>I<delimiter>"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:104
msgid ""
"Instead of drawing nice borders to the table, use the specified I<delimiter> "
"string to delimit columns in a row."
msgstr ""
#. type: IP
#: man/tbl-dctrl.1:104
#, no-wrap
msgid "B<-H>, B<--no-heading>"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:106
msgid "Do not print a table heading (column titles)."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:134
msgid ""
"B<tbl-dctrl> will read its input from the files named on the command line, "
"in the specified order."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:143
msgid ""
"If no files are named, the program behaves as if B<-> alone had been named, "
"that is, input is read from the standard input stream."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:152
msgid "All input to B<tbl-dctrl> is in the format of a Debian control file."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:173
msgid ""
"When input is read from multiple files, a record separator is implicit "
"between two adjacent files."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:191
msgid ""
"The output is a tabular representation of the input database restricted to "
"the specified fields. Logically, the output is a table; when the B<-d> "
"option is used, this table is represented simply by separating columns in "
"each row by the specified I<delimiter>; when the option is not used, a frame "
"is drawn around the table. The order of the columns is the same as the "
"order of the column specifications on the command line."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:206
msgid ""
"The following command line pipe outputs a table of all packages, with their "
"maintainer data, sorted by the maintainer data, that have no content:"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:209
#, no-wrap
msgid ""
"% grep-available -FInstalled-Size --eq 0 | sort-dctrl -kMaintainer - \\e\n"
" | tbl-dctrl -cPackage -cMaintainer\n"
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:214
msgid ""
"The B<tbl-dctrl> program and this manual page were written by Antti-Juhani "
"Kaijanaho."
msgstr ""
#. type: Plain text
#: man/tbl-dctrl.1:222
msgid ""
"B<apt-cache>(1), B<ara>(1), B<dpkg-awk>(1), B<dpkg-query>(1), "
"B<grep-dctrl>(1), B<sort-dctrl>(1), B<dpkg>(8)"
msgstr ""
Reply to: