This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=52875a3198334eb1e184288c78df4d929c69b7da commit 52875a3198334eb1e184288c78df4d929c69b7da Author: Guillem Jover <[email protected]> AuthorDate: Tue May 18 11:46:29 2021 +0200 doc: Improve description of dpkg suite Describe the dpkg suite in the developer oriented README without giving the impression that dselect is a preferred user interface, and mention both apt and aptitude in the dpkg(1) man page. Prompted-by: Fabrice Bauzac-Stehly <[email protected]> --- README | 16 +++++++++++++--- man/dpkg.pod | 9 ++++++--- 2 files changed, 19 insertions(+), 6 deletions(-) diff --git a/README b/README index dd5a70fac..9cff838c9 100644 --- a/README +++ b/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 a/man/dpkg.pod b/man/dpkg.pod index d55cc6c17..50e181c64 100644 --- a/man/dpkg.pod +++ b/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. -- Dpkg.Org's dpkg
