+Thu May 6 23:23:10 BST 2004 Scott James Remnant <scott@netsplit.com>
+
+ * utils/md5sum.1, man/es/md5sum.1, man/de/md5sum.1, men/ja/md5sum.1:
+ Correct "et al" to "et al."
+ * main/main.c, man/en/dpkg.8.sgml: Correct description of
+ --compare-versions command to describe versions as "empty" rather
+ than "missing" or "no version" as "" has to be passed.
+ * man/en/dpkg.8.sgml: Add dpkg-reconfigure(8) to SEE ALSO section.
+ * utils/start-stop-daemon.8: Move documentation of --retry to the
+ paragraph about --stop where it belongs.
+ * scripts/update-alternatives.8: Remove strange " usage and
+ replace with appropriate .BR.
+
Sun May 2 10:22:25 CEST 2004 Tollef Fog Heen <tfheen@debian.org>
* scripts/dpkg-scanpackages.pl: Give proper case for Origin and
* Add amd64 support. Closes: #238483, #241938.
* Add i?86-gnu support. Closes: #216695, #236331.
- * Stop hardcoding the list of manual page languages in debian/rules,
- so we include Spanish, Russian and Brazilian Portugese. Closes: #245994.
- * Correct dpkg manpage to refer to --force-remove-reinstreq instead of
- non-existant --force-reinstreq option. Closes: #232831.
* Fix dpkg-source (actually controllib.pl) to output the field name
properly again. Closes: #246595.
* Make dpkg-scanpackages output Origin and Bugs fields with proper
casing. Closes: #154422.
+ * Stop hardcoding the list of manual page languages in debian/rules,
+ so we include Spanish, Russian and Brazilian Portugese. Closes: #245994.
+ * Correct dpkg manpage to refer to --force-remove-reinstreq instead of
+ non-existant --force-reinstreq option. Closes: #232831.
+ * Correct usage of "et al" to "et al.". Closes: #230751.
+ * Correct documentation of --compare-versions arguments. Closes: #232317.
+ * Correct documentation of start-stop-daemon manpage to refer to --retry
+ alongside --stop. Closes: #204691.
+ * Correct invalid use of " within update-alternatives(8) with .BR.
+ Closes: #244624.
+ * Add dpkg-reconfigure(8) to SEE ALSO section of dpkg(8). Closes: #233282.
* Updated Translations:
- Catalan (Jordi Mallach).
- Spanish manpages (Ruben Porras). Closes: #246158, #246159, #246160,
<refnamediv>
<refname>dpkg</refname>
- <refpurpose>medium-level package manager for Debian</refpurpose>
+ <refpurpose>a medium-level package manager for Debian</refpurpose>
</refnamediv>
packages. The descriptions of what <command>dpkg</command> does when
installing and removing packages are particularly inadequate.
</para>
-
- <para>
- For information about this, please refer to sections regarding the
- Debian packaging system in the Debian FAQ or in the Debian Reference.
- </para>
</refsect1>
<para>
<command>dpkg</command> is a medium-level tool to install, build, remove
- and manage Debian packages. <command>dpkg</command>
+ and manage Debian packages. The primary and more user-friendly front-end
+ for <command>dpkg</command> is <command>dselect</command> (see
+ <citerefentry><refentrytitle>dselect</refentrytitle>
+ <manvolnum>8</manvolnum></citerefentry>). <command>dpkg</command> itself
is controlled entirely via command line parameters, which consist of
exactly one action and zero or more options. The action-parameter tells
<command>dpkg</command> what to do and options control the behavior of
<manvolnum>1</manvolnum> </citerefentry> for information about these
actions.
</para>
-
- <note>
- <para>
- The primary and more user-friendly front-end for
- <command>dpkg</command> is <command>dselect</command> (see
- <citerefentry><refentrytitle>dselect</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry>). There are other front-ends
- such as those based on <citerefentry><refentrytitle>apt</refentrytitle>
- <manvolnum>8</manvolnum></citerefentry>.
- </para>
- </note>
</refsect1>
<refsect1>
operator. <command>dpkg</command> returns success (zero result) if
the specified condition is satisfied, and failure (nonzero result)
otherwise. There are two groups of operators, which differ in how
- they treat a missing <option>ver1</option> or <option>ver2</option>.
- These treat no version as earlier than any version:
- <emphasis>lt le eq ne ge gt</emphasis>. These treat no version as
- later than any version: <emphasis>lt-nl le-nl ge-nl gt-nl</emphasis>.
+ they treat an empty <option>ver1</option> or <option>ver2</option>.
+ These treat an empty version as earlier than any version:
+ <emphasis>lt le eq ne ge gt</emphasis>. These treat an empty version
+ as later than any version:
+ <emphasis>lt-nl le-nl ge-nl gt-nl</emphasis>.
These are provided only for compatibility with
<filename>control</filename> file syntax: <emphasis>< <<
<= = >= >> ></emphasis>.
</term>
<listitem><para>
- Display the usage instructions.
+ Display a brief help message.
</para></listitem>
</varlistentry>
<arg choice="plain">
<group choice="req">
<arg>--licence</arg>
- <arg>--license</arg>
+ <arg>--license </arg>
</group>
</arg>
</cmdsynopsis>
</term>
<listitem><para>
- Display <command>dpkg</command> copyright and licence information.
+ Display <command>dpkg</command> licence.
</para></listitem>
</varlistentry>
<screen>(*)</screen> are forced by default.
</para>
- <warning>
+ <note>
<para>
- These options are mostly intended to be used by experts only.
- Using them without fully understanding their effects may break
- your whole system.
+ <emphasis>Warning: These options are mostly intended to be used
+ by experts only. Using them without fully understanding their
+ effects may break your whole system.</emphasis>
</para>
- </warning>
+ </note>
<variablelist>
<varlistentry>
(e.g. <screen>dpkg --purge foo --no-act</screen> will first
purge package foo and then try to <command>purge</command>
package --no-act, even though you probably expected it to
- actually do nothing!)
+ actually do nothing)
</para>
</listitem>
</varlistentry>
<title>Examples</title>
<para>
- To list packages containing the string `vi' in their name:
+ To list packages related to the editor vi:
<Screen><command>dpkg</command> <option>-l</option> '*vi*'</Screen>
</para>
<para>
- To see the entries in <filename>/var/lib/dpkg/available</filename> on
- several packages:
+ To see the entries in <filename>/var/lib/dpkg/available</filename> on two
+ packages
+
+ <Screen><command>dpkg</command> <option>--print-avail</option> elvis vim</Screen>
+ </para>
+
+ <para>
+ To search the listing of packages yourself:
- <Screen><command>dpkg</command> <option>--print-avail</option> base-files login xfree86-common | pager</Screen>
+ <Screen><command>less</command> <filename>/var/lib/dpkg/available</filename></Screen>
</para>
<para>
- To remove an installed package named "emacs":
+ To remove an installed emacs package:
<Screen><command>dpkg</command> <option>-r</option> emacs</Screen>
</para>
<title>See Also</title>
<para>
+ <citerefentry>
+ <refentrytitle>dselect</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>,
+
<citerefentry>
<refentrytitle>dpkg-deb</refentrytitle>
<manvolnum>1</manvolnum>
<citerefentry>
<refentrytitle>deb-control</refentrytitle>
<manvolnum>5</manvolnum>
- </citerefentry>,
-
- <citerefentry>
- <refentrytitle>dselect</refentrytitle>
- <manvolnum>8</manvolnum>
- </citerefentry>,
+ </citerefentry>
<citerefentry>
- <refentrytitle>apt</refentrytitle>
+ <refentrytitle>dpkg-reconfigure</refentrytitle>
<manvolnum>8</manvolnum>
- </citerefentry>.
+ </citerefentry>
</para>
</refsect1>
</refentry>
projects / dpkg / commitdiff