[PATCH 0/3] dpkg/Debian related terminology improvements/fixes

[PATCH 0/3] dpkg/Debian related terminology improvements/fixes

[Guillem Jover]

From: Guillem Jover <guillem@hadrons.org>

Hi!

This series includes some fixes/improvements to dpkg/Debian adjacent
information and terminology.

Thanks,
Guillem

Guillem Jover (3):
  */: Say OpenPGP instead of PGP
  man/man7/suffixes.7: Add xz suffixes
  man/man7/suffixes.7: Clarify Debian artifacts description

 CONTRIBUTING.d/mail             |  8 ++++----
 CONTRIBUTING.d/patches/sendmail |  2 +-
 man/man7/suffixes.7             | 10 ++++++----
 3 files changed, 11 insertions(+), 9 deletions(-)

-- 
2.53.0

[PATCH 1/3] */: Say OpenPGP instead of PGP

[Guillem Jover]

From: Guillem Jover <guillem@hadrons.org>

The IETF draft is called OpenPGP, where PGP is the original
implementation from where the specification was based on. For file
artifacts «.pgp» is the correct short term to use though, which can
be considered the more implementation neutral name to use.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 CONTRIBUTING.d/mail             | 8 ++++----
 CONTRIBUTING.d/patches/sendmail | 2 +-
 man/man7/suffixes.7             | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/CONTRIBUTING.d/mail b/CONTRIBUTING.d/mail
index f900c0a1b..84c8fbcfb 100644
--- a/CONTRIBUTING.d/mail
+++ b/CONTRIBUTING.d/mail
@@ -41,18 +41,18 @@ Description
              it, go to
              <https://subspace.kernel.org/vger.kernel.org.html>.
 
-   Sign your emails with PGP
+   Sign your emails with OpenPGP
         We encourage that you sign all of your emails sent to the
         mailing list, (especially) including the ones containing
-        patches, with your PGP key.  This helps establish trust between
+        patches, with your OpenPGP key.  This helps establish trust between
         you and other contributors of this project, and prevent others
         impersonating you.  If you don't have a key, it's not mandatory
         to sign your email, but you're encouraged to create and start
-        using a PGP key.  See also:
+        using a OpenPGP key.  See also:
         <https://www.gnupg.org/faq/gnupg-faq.html#use_pgpmime>
 
         If you use mutt(1), we recommend the following configuration for
-        PGP:
+        OpenPGP:
 
             set crypt_autosign = yes
             set crypt_protected_headers_write = yes
diff --git a/CONTRIBUTING.d/patches/sendmail b/CONTRIBUTING.d/patches/sendmail
index f0a91f993..9f2c8f554 100644
--- a/CONTRIBUTING.d/patches/sendmail
+++ b/CONTRIBUTING.d/patches/sendmail
@@ -32,7 +32,7 @@ Description
 		  ├─> [PATCH v3 02] ...
 		  └─> [PATCH v3 03] ...
 
-    Sign the email containing patches with PGP
+    Sign the email containing patches with OpenPGP
 	See <CONTRIBUTING.d/mail> for more details on signing your mail
 	to the list.  See also <CONTRIBUTING.d/git> for instructions for
 	configuring git-send-email(1) to use neomutt(1) as a driver.
diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
index 3e17afc77..4c8b3f27a 100644
--- a/man/man7/suffixes.7
+++ b/man/man7/suffixes.7
@@ -46,7 +46,7 @@ Suffix	File type
 \&.am	\f[B]automake\f[](1) input file
 \&.arc	\f[B]arc\f[](1) archive
 \&.arj	\f[B]arj\f[](1) archive
-\&.asc	PGP ASCII-armored data
+\&.asc	OpenPGP ASCII-armored data
 \&.asm	(GNU) assembler source file
 \&.au	Audio sound file
 \&.aux	LaTeX auxiliary file
@@ -177,7 +177,7 @@ T}
 \&.pfa	PostScript font definition files, ASCII format
 \&.pfb	PostScript font definition files, binary format
 \&.pgm	portable greymap format
-\&.pgp	PGP binary data
+\&.pgp	OpenPGP binary data
 \&.ph	Perl header file
 \&.php	PHP program file
 \&.php3	PHP3 program file
-- 
2.53.0

Re: [PATCH 1/3] */: Say OpenPGP instead of PGP

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 3750 bytes --]

Hi Guillem,

On 2026-05-09T20:50:20+0200, Guillem Jover wrote:
> From: Guillem Jover <guillem@hadrons.org>
> 
> The IETF draft is called OpenPGP, where PGP is the original
> implementation from where the specification was based on. For file

I've changed the inter-sentence space to 2.
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING.d/patches/description#n44>

> artifacts «.pgp» is the correct short term to use though, which can

And I've changed the quotes to ASCII ones ("), to avoid making the
commit messages unnecessarily unreadable for those still using for
example the C locale.

> be considered the more implementation neutral name to use.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Thanks!  I've applied the patch.


Cheers,
Alex

> ---
>  CONTRIBUTING.d/mail             | 8 ++++----
>  CONTRIBUTING.d/patches/sendmail | 2 +-
>  man/man7/suffixes.7             | 4 ++--
>  3 files changed, 7 insertions(+), 7 deletions(-)
> 
> diff --git a/CONTRIBUTING.d/mail b/CONTRIBUTING.d/mail
> index f900c0a1b..84c8fbcfb 100644
> --- a/CONTRIBUTING.d/mail
> +++ b/CONTRIBUTING.d/mail
> @@ -41,18 +41,18 @@ Description
>               it, go to
>               <https://subspace.kernel.org/vger.kernel.org.html>.
>  
> -   Sign your emails with PGP
> +   Sign your emails with OpenPGP
>          We encourage that you sign all of your emails sent to the
>          mailing list, (especially) including the ones containing
> -        patches, with your PGP key.  This helps establish trust between
> +        patches, with your OpenPGP key.  This helps establish trust between
>          you and other contributors of this project, and prevent others
>          impersonating you.  If you don't have a key, it's not mandatory
>          to sign your email, but you're encouraged to create and start
> -        using a PGP key.  See also:
> +        using a OpenPGP key.  See also:
>          <https://www.gnupg.org/faq/gnupg-faq.html#use_pgpmime>
>  
>          If you use mutt(1), we recommend the following configuration for
> -        PGP:
> +        OpenPGP:
>  
>              set crypt_autosign = yes
>              set crypt_protected_headers_write = yes
> diff --git a/CONTRIBUTING.d/patches/sendmail b/CONTRIBUTING.d/patches/sendmail
> index f0a91f993..9f2c8f554 100644
> --- a/CONTRIBUTING.d/patches/sendmail
> +++ b/CONTRIBUTING.d/patches/sendmail
> @@ -32,7 +32,7 @@ Description
>  		  ├─> [PATCH v3 02] ...
>  		  └─> [PATCH v3 03] ...
>  
> -    Sign the email containing patches with PGP
> +    Sign the email containing patches with OpenPGP
>  	See <CONTRIBUTING.d/mail> for more details on signing your mail
>  	to the list.  See also <CONTRIBUTING.d/git> for instructions for
>  	configuring git-send-email(1) to use neomutt(1) as a driver.
> diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
> index 3e17afc77..4c8b3f27a 100644
> --- a/man/man7/suffixes.7
> +++ b/man/man7/suffixes.7
> @@ -46,7 +46,7 @@ Suffix	File type
>  \&.am	\f[B]automake\f[](1) input file
>  \&.arc	\f[B]arc\f[](1) archive
>  \&.arj	\f[B]arj\f[](1) archive
> -\&.asc	PGP ASCII-armored data
> +\&.asc	OpenPGP ASCII-armored data
>  \&.asm	(GNU) assembler source file
>  \&.au	Audio sound file
>  \&.aux	LaTeX auxiliary file
> @@ -177,7 +177,7 @@ T}
>  \&.pfa	PostScript font definition files, ASCII format
>  \&.pfb	PostScript font definition files, binary format
>  \&.pgm	portable greymap format
> -\&.pgp	PGP binary data
> +\&.pgp	OpenPGP binary data
>  \&.ph	Perl header file
>  \&.php	PHP program file
>  \&.php3	PHP3 program file
> -- 
> 2.53.0
> 
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 2/3] man/man7/suffixes.7: Add xz suffixes

[Guillem Jover]

From: Guillem Jover <guillem@hadrons.org>

These are very common nowadays, for example by default Debian source
packages use this compression method.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man/man7/suffixes.7 | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
index 4c8b3f27a..8487bb5a1 100644
--- a/man/man7/suffixes.7
+++ b/man/man7/suffixes.7
@@ -216,6 +216,7 @@ T}
 \&.tar.Z	\f[B]tar\f[](1) archive compressed with \f[B]compress\f[](1)
 \&.tar.bz2	\f[B]tar\f[](1) archive compressed with \f[B]bzip2\f[](1)
 \&.tar.gz	\f[B]tar\f[](1) archive compressed with \f[B]gzip\f[](1)
+\&.tar.xz	\f[B]tar\f[](1) archive compressed with \f[B]xz\f[](1)
 \&.taz	\f[B]tar\f[](1) archive compressed with \f[B]compress\f[](1)
 \&.tcl	tcl source code
 \&.tex	TeX or LaTeX source
@@ -246,6 +247,7 @@ T}
 \&.xpm	X11 pixmap source
 \&.xs	Perl xsub file produced by h2xs
 \&.xsl	XSL stylesheet
+\&.xz	file compressed with \f[B]xz\f[](1)
 \&.y	\f[B]yacc\f[](1) or \f[B]bison\f[](1) (parser generator) files
 \&.z	T{
 File compressed using
-- 
2.53.0

Re: [PATCH 2/3] man/man7/suffixes.7: Add xz suffixes

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1339 bytes --]

On 2026-05-09T20:50:21+0200, Guillem Jover wrote:
> From: Guillem Jover <guillem@hadrons.org>
> 
> These are very common nowadays, for example by default Debian source
> packages use this compression method.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Patch applied; thanks!


Cheers,
Alex

> ---
>  man/man7/suffixes.7 | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
> index 4c8b3f27a..8487bb5a1 100644
> --- a/man/man7/suffixes.7
> +++ b/man/man7/suffixes.7
> @@ -216,6 +216,7 @@ T}
>  \&.tar.Z	\f[B]tar\f[](1) archive compressed with \f[B]compress\f[](1)
>  \&.tar.bz2	\f[B]tar\f[](1) archive compressed with \f[B]bzip2\f[](1)
>  \&.tar.gz	\f[B]tar\f[](1) archive compressed with \f[B]gzip\f[](1)
> +\&.tar.xz	\f[B]tar\f[](1) archive compressed with \f[B]xz\f[](1)
>  \&.taz	\f[B]tar\f[](1) archive compressed with \f[B]compress\f[](1)
>  \&.tcl	tcl source code
>  \&.tex	TeX or LaTeX source
> @@ -246,6 +247,7 @@ T}
>  \&.xpm	X11 pixmap source
>  \&.xs	Perl xsub file produced by h2xs
>  \&.xsl	XSL stylesheet
> +\&.xz	file compressed with \f[B]xz\f[](1)
>  \&.y	\f[B]yacc\f[](1) or \f[B]bison\f[](1) (parser generator) files
>  \&.z	T{
>  File compressed using
> -- 
> 2.53.0
> 
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[PATCH 3/3] man/man7/suffixes.7: Clarify Debian artifacts description

[Guillem Jover]

From: Guillem Jover <guillem@hadrons.org>

The terminology for these artifacts was "recently" updated to make
them consistent and more clear, where both dpkg and the Debian Policy
now have matching terminology. Refer to the dpkg man pages for further
information and format description.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
---
 man/man7/suffixes.7 | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
index 8487bb5a1..8408aaadd 100644
--- a/man/man7/suffixes.7
+++ b/man/man7/suffixes.7
@@ -79,7 +79,7 @@ Suffix	File type
 \&.csh	\f[B]csh\f[](1) shell script
 \&.cxx	equivalent to \f[I].cc\f[]
 \&.dat	data file
-\&.deb	Debian software package
+\&.deb	Debian binary package (\f[B]deb\f[](5))
 \&.def	Modula-2 source for definition modules
 \&.def	other definition files
 \&.desc	initial part of mail message unpacked with
@@ -91,7 +91,7 @@ command output)
 T}
 \&.dir	dbm data base directory file
 \&.doc	documentation file
-\&.dsc	Debian Source Control (source package)
+\&.dsc	Debian source package control file (\f[B]dsc\f[](5))
 \&.dtx	LaTeX package source file
 \&.dvi	TeX's device independent output
 \&.el	Emacs-Lisp source
-- 
2.53.0

Re: [PATCH 3/3] man/man7/suffixes.7: Clarify Debian artifacts description

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1546 bytes --]

Hi Guillem,

On 2026-05-09T20:50:22+0200, Guillem Jover wrote:
> From: Guillem Jover <guillem@hadrons.org>
> 
> The terminology for these artifacts was "recently" updated to make
> them consistent and more clear, where both dpkg and the Debian Policy
> now have matching terminology. Refer to the dpkg man pages for further

I've changed inter-sentence space to 2.

> information and format description.
> 
> Signed-off-by: Guillem Jover <guillem@hadrons.org>

Thanks!  I've applied the patch.


Cheers,
Alex

> ---
>  man/man7/suffixes.7 | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/man/man7/suffixes.7 b/man/man7/suffixes.7
> index 8487bb5a1..8408aaadd 100644
> --- a/man/man7/suffixes.7
> +++ b/man/man7/suffixes.7
> @@ -79,7 +79,7 @@ Suffix	File type
>  \&.csh	\f[B]csh\f[](1) shell script
>  \&.cxx	equivalent to \f[I].cc\f[]
>  \&.dat	data file
> -\&.deb	Debian software package
> +\&.deb	Debian binary package (\f[B]deb\f[](5))
>  \&.def	Modula-2 source for definition modules
>  \&.def	other definition files
>  \&.desc	initial part of mail message unpacked with
> @@ -91,7 +91,7 @@ command output)
>  T}
>  \&.dir	dbm data base directory file
>  \&.doc	documentation file
> -\&.dsc	Debian Source Control (source package)
> +\&.dsc	Debian source package control file (\f[B]dsc\f[](5))
>  \&.dtx	LaTeX package source file
>  \&.dvi	TeX's device independent output
>  \&.el	Emacs-Lisp source
> -- 
> 2.53.0
> 
> 

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]