Re: Avis de grand vent sur dpkg
On Wed, Sep 17, 2003 at 10:35:30AM +0200, Martin Quinson wrote:
> Doogie est parti a debugger un peu dpkg et faire du propre parmis les
> quelques centaines de raports de bogue.
>
> C'est le moment de soumettre les pages de man qui trainent en raport de
> bogue, avec un titre contenant "[INTL:fr]" ou equivalent.
Philippe, voici les modifications qui ont été faites dans les pages de man.
D'autre part, je t'avais signalé il y a longtemps que les lignes du dernier
paragraphe de deb-control.5 sont trop longues, je ne sais pas si tu as fait
un rapport de bogue.
> En fait, il vient de sortir la 1.10.11 sans corriger le moindre bug de l10n,
> et je lui ai demande des comptes sur -dpkg. S'il repond pas ou s'il repond
> qu'il s'en tape, je passe sur -devel, et on va assister a une nouvelle
> empoignade. C'est fatiguant....
Mais non mais non, c'est vivifiant.
Au fait j'ai honte de ne pas m'être occupé du fr.po de dpkg, et ne compte
pas m'en occuper dans les jours qui viennent. Toute aide est la bienvenue.
> Qui a le droit de commit dans le cvs de dpkg ? Tous les mainteneurs, ou
> seulement doogie et wichert ?
Eux seuls.
Denis
Index: dpkg-architecture.1.pod
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg-architecture.1.pod,v
retrieving revision 1.1
diff -u -r1.1 dpkg-architecture.1.pod
--- dpkg-architecture.1.pod 15 Oct 2002 22:25:11 -0000 1.1
+++ dpkg-architecture.1.pod 17 Sep 2003 21:28:14 -0000
@@ -127,7 +127,7 @@
also show how you can improve the cross compilation support in your
package:
-Instead:
+Instead of:
ARCH=`dpkg --print-architecture`
configure $(ARCH)-linux
@@ -137,9 +137,9 @@
DEB_BUILD_GNU_TYPE := $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
DEB_HOST_GNU_TYPE := $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
-configure --build=$(DEB_BUILD_GNU_TYPE) --host=$(DEB_BUILD_GNU_SYSTEM)
+configure --build=$(DEB_BUILD_GNU_TYPE) --host=$(DEB_HOST_GNU_TYPE)
-Instead:
+Instead of:
ARCH=`dpkg --print-architecture`
ifeq ($(ARCH),alpha)
Index: dpkg-query.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg-query.8,v
retrieving revision 1.1
diff -u -r1.1 dpkg-query.8
--- dpkg-query.8 15 Oct 2002 22:25:11 -0000 1.1
+++ dpkg-query.8 17 Sep 2003 21:28:14 -0000
@@ -41,7 +41,9 @@
.TP
\fB-S\fP | \fB--search\fP \fIfilename-search-pattern\fP ...
Search for a filename from installed packages. All standard shell
-wildchars can be used in the pattern.
+wildchars can be used in the pattern. This command will not list
+extra files created by maintainer scripts, nor will it list
+alternatives.
.TP
\fB-p\fP |\fB--print-avail\fP package
Display details about \fIpackage\fP, as found in
Index: dpkg-scanpackages.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg-scanpackages.8,v
retrieving revision 1.1
diff -u -r1.1 dpkg-scanpackages.8
--- dpkg-scanpackages.8 15 Oct 2002 22:25:11 -0000 1.1
+++ dpkg-scanpackages.8 17 Sep 2003 21:28:14 -0000
@@ -29,8 +29,8 @@
.B dpkg-scanpackages
sorts through a tree of Debian binary packages and creates a Packages
file, used by
-.BR dselect (8)
-to tell the user what packages are available for installation. These
+.BR dselect (8),
+etc, to tell the user what packages are available for installation. These
Packages files are the same as those found on Debian archive sites
and CD-ROMs. You might use
.B dpkg-scanpackages
Index: dpkg-scansources.8.pod
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg-scansources.8.pod,v
retrieving revision 1.1
diff -u -r1.1 dpkg-scansources.8.pod
--- dpkg-scansources.8.pod 7 Nov 2002 10:59:00 -0000 1.1
+++ dpkg-scansources.8.pod 17 Sep 2003 21:28:14 -0000
@@ -1,6 +1,6 @@
=head1 NAME
-dpkg-scansources - prog
+dpkg-scansources - search for '.dsc' files and build the 'Sources' index
=head1 SYNOPSIS
Index: dpkg-source.1
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg-source.1,v
retrieving revision 1.1
diff -u -r1.1 dpkg-source.1
--- dpkg-source.1 15 Oct 2002 22:25:11 -0000 1.1
+++ dpkg-source.1 17 Sep 2003 21:28:15 -0000
@@ -1,5 +1,5 @@
.\" Authors: Ian Jackson
-.TH DPKG\-SOURCE 1 "Januari 2000" "Debian Project" "dpkg utilities"
+.TH DPKG\-SOURCE 1 "January 2000" "Debian Project" "dpkg utilities"
.SH NAME
dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges,
dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog
@@ -623,7 +623,8 @@
.TP
.B -I<filename>
Passed unchanged to
-.BR dpkg-source . May be repeated multiple times.
+.BR dpkg-source .
+May be repeated multiple times.
.TP
.B -D
Check build dependencies and conflicts; abort if unsatisfied.
@@ -632,7 +633,7 @@
Do not check build dependencies and conflicts.
.TP
.B -nc
-Do not clean the source tree(imlies -b).
+Do not clean the source tree(implies -b).
.SH DPKG-DISTADDFILE ARGUMENTS
.B dpkg-distaddfile
does not take any non-common options. It takes three non-option
Index: dpkg.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dpkg.8,v
retrieving revision 1.1
diff -u -r1.1 dpkg.8
--- dpkg.8 15 Oct 2002 22:25:11 -0000 1.1
+++ dpkg.8 17 Sep 2003 21:28:15 -0000
@@ -169,10 +169,6 @@
\fB3.\fP Run \fIpostrm\fP script
.br
.TP
-.BI "dpkg -p|--print-avail " package
-Display details about \fIpackage\fP, as found in
-\fI/var/lib/dpkg/available\fP.
-.TP
\fBdpkg --update-avail\fP | \fB--merge-avail\fP \fIPackages-file\fP
Update \fBdpkg\fP's and \fBdselect\fP's idea of which packages are
available. With action \fB--merge-avail\fP, old information is
@@ -194,17 +190,6 @@
.B dpkg --clear-avail
Erase the existing information about what packages are available.
.TP
-\fBdpkg -l\fP | \fB--list\fP \fIpackage-name-pattern\fP ...
-List packages matching given pattern. If no \fIpackage-name-pattern\fP
-is given, list all packages in \fI/var/lib/dpkg/available\fP. Normal
-shell wildchars are allowed in \fIpackage-name-pattern\fP. (You will
-probably have to quote \fIpackage-name-pattern\fP to prevent the shell
-from performing filename expansion. For example, \fBdpkg -l 'libc5*'\fP will list all the package names starting with "libc5".)
-.TP
-\fBdpkg -s\fP | \fB--status\fP \fIpackage-name\fP ...
-Report status of specified package. This just displays the entry in
-the installed package status database.
-.TP
\fBdpkg -C\fP | \fB--audit\fP
Searches for packages that have been installed only partially on your
system. \fBdpkg\fP will suggest what to do with them to get them
@@ -220,14 +205,6 @@
Searches for packages selected for installation, but which for some
reason still haven't been installed.
.TP
-\fBdpkg -L\fP | \fB--listfiles\fP \fIpackage\fP ...
-List files installed to your system from \fBpackage\fP.
-However, note that files created by package-specific
-installation-scripts are not listed.
-.TP
-\fBdpkg -S\fP | \fB--search\fP \fIfilename-search-pattern\fP ...
-Search for a filename from installed packages. All standard shell
-wildchars can be used in the pattern.
.TP
.B dpkg --print-architecture
Print target architecture (for example, "i386"). This option uses
@@ -294,6 +271,26 @@
package.
.fi
+.TP
+\fBdpkg-query-actions\fP
+See \fBdpkg-query\fP(1) for more information about the following actions.
+
+.nf
+
+\fBdpkg -l\fP | \fB--list\fP \fIpackage-name-pattern\fP ...
+ List packages matching given pattern.
+\fBdpkg -s\fP | \fB--status\fP \fIpackage-name\fP ...
+ Report status of specified package.
+\fBdpkg -L\fP | \fB--listfiles\fP \fIpackage\fP ...
+ List files installed to your system from \fBpackage\fP.
+\fBdpkg -S\fP | \fB--search\fP \fIfilename-search-pattern\fP ...
+ Search for a filename from installed packages.
+\fBdpkg -p\fP | \fB--print-avail\fP \fIpackage\fP
+ Display details about \fIpackage\fP, as found in \fI/var/lib/dpkg/available\fP.
+.fi
+
+
+
.SH OPTIONS
All options can be specified both on the commandline and in the \fBdpkg\fP
configuration file \fI/etc/dpkg/dpkg.cfg\fP. Each line in the configuration
@@ -348,6 +345,13 @@
\fBdowngrade\fP(*):
Install a package, even if newer version of it is already installed.
+\fIWarning: At present dpkg does not do any dependency
+checking on downgrades and therefore will not warn you
+if the downgrade breaks the dependency of some other
+package. This can have serious side effects, downgrading
+essential system components can even make your whole
+system unusable. Use with care.\fP
+
\fBconfigure-any\fP:
Configure also any unpacked but unconfigured packages on which the current
package depends.
@@ -427,7 +431,7 @@
Don't read or check contents of control file while building a package.
This is a \fBdpkg-deb\fP(1) option.
.TP
-.B --no-act
+\fB--no-act\fP | \fB--dry-run\fP | \fB--simulate\fP
Do everything which is supposed to be done, but don't write any
changes. This is used to see what would happen with the specified
action, without actually modifying anything.
@@ -568,7 +572,7 @@
Note that this will not actually install or remove anything, but just
set the selection state on the requested packages. You will need some
other application to actually download and install the requested
-packages.
+packages. For example, run \fBdselect\fP and choose "Install".
Ordinarily, you will find that \fBdselect\fP(8) provides a more
convenient way to modify the package selection states.
@@ -586,6 +590,6 @@
.SH AUTHORS
.nf
-See \fB/usr/share/doc/dpkg/THANKS\fP for the list of people who have
+See \fB/usr/share/doc/dpkg/THANKS.gz\fP for the list of people who have
contributed to \fBdpkg\fP .
.fi
Index: dselect.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/dselect.8,v
retrieving revision 1.1
diff -u -r1.1 dselect.8
--- dselect.8 15 Oct 2002 22:25:11 -0000 1.1
+++ dselect.8 17 Sep 2003 21:28:16 -0000
@@ -8,8 +8,8 @@
[\-\-colour | \-\-color screenpart:[foreground],[background][:attr[+attr+..]]]
.SH DESCRIPTION
.B dselect
-is the primary user interface for managing packages on a Debian system.
-At the \fBdselect\fP main menu, the system administrator can:
+is one of the primary user interfaces for managing packages on a Debian
+system. At the \fBdselect\fP main menu, the system administrator can:
\- Update the list of available package versions,
\- View the status of installed and available packages,
\- Alter package selections and manage dependencies,
@@ -414,9 +414,6 @@
.B dselect
package selection interface is confusing to some new users.
Reportedly, it even makes seasoned kernel developers cry.
-.sp
-.B dselect
-doesn't handle Recommends: field very well.
.sp
The documentation is lacking.
.sp
Index: start-stop-daemon.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/start-stop-daemon.8,v
retrieving revision 1.1
diff -u -r1.1 start-stop-daemon.8
--- start-stop-daemon.8 15 Oct 2002 22:25:11 -0000 1.1
+++ start-stop-daemon.8 17 Sep 2003 21:28:16 -0000
@@ -82,6 +82,9 @@
or
.IR uid .
.TP
+\fB-g\fP|\fB--group\fP \fIgroup\fP|\fIgid\fP
+Change to \fIgroup\fP or \fIgid\fP when starting the process.
+.TP
\fB-n\fP|\fB--name\fP \fIprocess-name\fP
Check for processes with the name
.I process-name
@@ -193,7 +196,7 @@
make no sense forking on their own, or where it's not feasible to add the
code for it to do this itself.
.TP
-.BR -N | --nicelevel
+\fB-N\fP|\fB--nicelevel\fP \fIint\fP
This alters the prority of the process before starting it.
.TP
.BR -m | --make-pidfile
Index: update-alternatives.8
===================================================================
RCS file: /cvs/debian-doc/manpages/english/dpkg/update-alternatives.8,v
retrieving revision 1.1
diff -u -r1.1 update-alternatives.8
--- update-alternatives.8 15 Oct 2002 22:25:11 -0000 1.1
+++ update-alternatives.8 17 Sep 2003 21:28:16 -0000
@@ -24,6 +24,15 @@
.PP
.B update-alternatives
.RI [ options ]
+.B --remove-all
+.I name
+.PP
+.B update-alternatives
+.RI [ options ]
+.B --all
+.PP
+.B update-alternatives
+.RI [ options ]
.B --auto
.I name
.PP
@@ -41,6 +50,11 @@
.RI [ options ]
.B --config
.I name
+.PP
+.B update-alternatives
+.RI [ options ]
+.B --set
+.I name path
.SH DESCRIPTION
.B update-alternatives
creates, removes, maintains and displays information about the symbolic
@@ -156,6 +170,10 @@
mode. You will need to use the
.I --auto
option in order to return to the automatic state.
+.PP
+If you want to configure non-interactivily you can use the
+.I --set
+option instead (see below).
.SH TERMINOLOGY
Since the activities of
.B update-alternatives
@@ -210,6 +228,42 @@
When a link group is in manual mode,
the alternatives system will not make any changes
to the system administrator's settings.
+.SH EXAMPLES
+There are several packages which provide a text editor compatible
+with
+.BR vi ,
+for example
+.BR nvi " and " vim .
+Which one is used is controlled by the link group
+.BR vi ,
+which includes links for the program itself and the associated manpage.
+.PP
+To display the available packages which provide
+.B vi
+and the current setting for it, use the
+.I --display
+action:
+.RS
+.PP
+update-alternatives --display vi
+.RE
+.PP
+To choose a particular
+.B vi
+implementation, use this command as root and then select a number
+from the list:
+.RS
+.PP
+update-alternatives --config vi
+.RE
+.PP
+To go back to having the
+.B vi
+implementation chosen automatically, do this as root:
+.RS
+.PP
+update-alternatives --auto vi
+.RE
.SH OPTIONS
Exactly one action must be specified if
.B update-alternatives
@@ -281,6 +335,15 @@
any other installed alternatives for this group,
the symlinks will be updated to point to the newly added alternatives.
.TP
+\fB--set\fR \fIname path\fR
+Set the program
+.I path
+as alternative for
+.I name.
+This is equivalent to
+.IB --config
+but is non-interactive and thus scriptable.
+.TP
\fB--remove\fR \fIname path\fR
Remove an alternative and all of its associated slave links.
.I name
@@ -301,6 +364,14 @@
no links are changed;
only the information about the alternative is removed.
.TP
+\fB--remove-all\fR \fIname\fR
+Remove all alternatives and all of their associated slave links.
+.I name
+is a name in the alternatives directory.
+.TP
+.B --all
+Call \fB--config\fP on all alternatives.
+.TP
\fB--auto\fR \fIlink\fR
Switch the master symlink
.I link
@@ -321,6 +392,13 @@
.TP
\fB--list\fR \fIlink\fR
Display all targets of the link group.
+.TP
+\fB--config\fR \fIlink\fR
+Show available alternatives for a link group and allow the user to
+interactively select which one to use. The link group is updated
+and taken out of
+.I auto
+mode.
.SH FILES
.TP
.I /etc/alternatives/
Index: deb-control.5
===================================================================
RCS file: /cvs/debian-doc/manpages/french/dpkg/deb-control.5,v
retrieving revision 1.1
diff -u -r1.1 deb-control.5
--- deb-control.5 15 Oct 2002 22:26:13 -0000 1.1
+++ deb-control.5 17 Sep 2003 21:36:01 -0000
@@ -199,16 +199,17 @@
Provides: rgrep
Conflicts: rgrep
Description: GNU grep, egrep and fgrep.
- Il se peut que le grep de la famille GNU des utilitaires grep soit le plus
- rapide de l'ouest ! Le grep de GNU est fondé sur un mécanisme rapide de mise
- en correspondance déterministe d'états simples (environ deux fois plus rapide
- que le « egrep » standard d'Unix), modifié par une recherche de type
- Boyer-Moore-Gosper qui cherche une chaîne donnée en empêchant que les textes
- impossibles soient analysés par le mécanisme de mise en correspondance
- d'expressions régulières et sans avoir nécessairement besoin de voir chaque
- caractère. C'est beaucoup plus rapide que les « grep » ou « egrep » d'Unix.
- (Des expressions régulières contenant des références circulaires ralentissent
- cependant le programme.)
+ Il se peut que le grep de la famille GNU des utilitaires grep soit le
+ plus rapide de l'ouest ! Le grep de GNU est fondé sur un mécanisme
+ rapide de mise en correspondance déterministe d'états simples (environ
+ deux fois plus rapide que le « egrep » standard d'Unix), modifié par une
+ recherche de type Boyer-Moore-Gosper qui cherche une chaîne donnée en
+ empêchant que les textes impossibles soient analysés par le mécanisme de
+ mise en correspondance d'expressions régulières et sans avoir
+ nécessairement besoin de voir chaque caractère. C'est beaucoup plus
+ rapide que les « grep » ou « egrep » d'Unix. (Des expressions
+ régulières contenant des références circulaires ralentissent cependant
+ le programme.)
.fi
.\" .RE
.SH VOIR AUSSI
Reply to: