Hi! On Mon, 2021-05-17 at 22:14:24 +0200, Fabrice Bauzac-Stehly wrote: > I am puzzled. > > dpkg/man/dpkg.pod: > The primary and more user-friendly > front-end for B<dpkg> is B<aptitude>(8). > > dpkg/README: > The primary interface for the dpkg suite is the ‘dselect’ program; > a more low-level and less user-friendly interface is available in > the form of the ‘dpkg’ command. > > Aren't these statements contradictory? Which one is correct?
The intention was for one to be user-facing, and for the other to be developer-facing (as in describing the dpkg suite contents), but I see how these are confusing. What about the attached changes? Thanks, Guillem
diff --git i/README w/README index dd5a70fac..9cff838c9 100644 --- i/README +++ w/README @@ -1,8 +1,18 @@ dpkg - Debian's package maintenance system -The primary interface for the dpkg suite is the ‘dselect’ program; -a more low-level and less user-friendly interface is available in -the form of the ‘dpkg’ command. +This is the dpkg suite of programs that form the foundation of the Debian's +package management system; on the lower layer there are ‘dpkg-deb’ and +‘dpkg-split’ programs handling the binary formats, and ‘dpkg-source’ program +handling the source formats; there is a collection of tools to handle building +source packages into binary packages; there is the medium-level and less +user-friendly command-line interface (CLI) in the form of the ‘dpkg’ command; +and then there is the terminal user interface (TUI) ‘dselect’ program (which +has gone out of preference in favor of the apt (CLI) and aptitude (TUI) +programs). + +The dpkg suite also includes some other programs currently maintained +on external repositories, namely ‘dpkg-repack’, ‘dpkg-www’, ‘dupload’ +and ‘debsig-verify’. Releases diff --git i/man/dpkg.pod w/man/dpkg.pod index 712f4608f..864de4a91 100644 --- i/man/dpkg.pod +++ w/man/dpkg.pod @@ -47,9 +47,12 @@ packages are particularly inadequate. =head1 DESCRIPTION -B<dpkg> is a tool to install, build, remove and manage -Debian packages. The primary and more user-friendly -front-end for B<dpkg> is B<aptitude>(8). B<dpkg> itself is +B<dpkg> is a medium-level tool to install, build, remove and manage +Debian packages. +The primary and more user-friendly front-end for B<dpkg> +as a CLI (command-line interface) is B<apt>(8> and +as a TUI (terminal user interface) is B<aptitude>(8). +B<dpkg> itself is controlled entirely via command line parameters, which consist of exactly one action and zero or more options. The action-parameter tells B<dpkg> what to do and options control the behavior of the action in some way.