From 99e2ea7cdd89d389c6c66eea3aa86a3db0ab1180 Mon Sep 17 00:00:00 2001
From: Heiko Schaefer <heiko@schaefer.name>
Date: Tue, 19 Dec 2023 15:45:07 +0100
Subject: [PATCH] Expand glossary entries for inline signatures forms.

---
 book/source/glossary.md | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/book/source/glossary.md b/book/source/glossary.md
index d07f4dc..e804683 100644
--- a/book/source/glossary.md
+++ b/book/source/glossary.md
@@ -224,7 +224,14 @@ Initial Introducer
     An {term}`OpenPGP Certificate` explicitly {term}`delegated<Delegation>` to from a {term}`Trust Anchor`.
 
 Inline Signature
-    A {term}`Data Signature` which exists encapsulated alongside the data it was created for in an OpenPGP container. See [](forms-of-data-signatures).
+    An [inline signature](inline-signature) is a type of {term}`OpenPGP message` which stores a {term}`Data Signature` alongside the message it signs. Both the message and the signature are stored in a shared OpenPGP container.
+     
+    The standard defines two variant formats for inline signatures:
+     
+    - {term}`One-pass signed Message`: This format is now commonly used.
+    - {term}`Prefixed signed Message`: This is a historical format. It is still supported, but rarely used.
+      
+    For more context, see [](forms-of-data-signatures).
 
 Issuer
     An entity, that created an {term}`OpenPGP Signature Packet` using an {term}`Transferable Secret Key`.
@@ -316,7 +323,9 @@ One-pass Signature Packet
     One or more {term}`packets<Packet>` before the actual data in a {term}`Data Signature` which contain information to allow a receiving {term}`implementation<OpenPGP Implementation>` to create {term}`hashes<Hash Digest>` required for signature verification. See [RFC 5.4](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#one-pass-sig) for more details.
 
 One-pass signed Message
-    A {term}`OpenPGP Message` signed using one or more {term}`One-pass signatures<One-pass Signature Packet>`.
+    The commonly used form of an OpenPGP {term}`Inline Signature`. It combines an {term}`OpenPGP Message` with {term}`signature packets<OpenPGP Signature Packet>` and accompanying auxiliary {term}`One-pass signatures<One-pass Signature Packet>`.
+    
+    For details see [](one-pass-signature).
 
 OpenPGP Certificate
     An OpenPGP certificate contains public key material, identity claims and third party certifications (but no private key material)
@@ -409,7 +418,9 @@ Preferred AEAD Ciphersuites Subpacket
     See [RFC 5.2.3.15](https://www.ietf.org/archive/id/draft-ietf-openpgp-crypto-refresh-12.html#name-preferred-aead-ciphersuites)
 
 Prefixed signed Message
-    An {term}`OpenPGP Message` with one or more prefixed {term}`signature packets<OpenPGP Signature Packet>`.
+    A type of {term}`Inline Signature`. This form of {term}`Inline Signature` is historical and now rarely used. Superseded by {term}`One-pass signed Message`.
+     
+     For details see [](prefixed-signature).
 
 Primary Component Key
     See {term}`OpenPGP Primary Key`.