From c53e8b9de624f50b353f23ba25bb52f81c2d8a21 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
Date: Tue, 2 Mar 2021 09:35:22 +0100
Subject: [PATCH 1/2] man: add note about "SIG" prefix

---
 man/systemd-coredump.xml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml
index 8ddb8ef3ca..98d4af57e4 100644
--- a/man/systemd-coredump.xml
+++ b/man/systemd-coredump.xml
@@ -238,8 +238,14 @@ COREDUMP_FILENAME=/var/lib/systemd/coredump/core.Web….552351.….zst
         <term><varname>COREDUMP_SIGNAL_NAME=</varname></term>
         <term><varname>COREDUMP_SIGNAL=</varname></term>
 
-        <listitem><para>The terminating signal name and numerical value. (Both are included because signal
-        numbers vary by architecture.)</para>
+        <listitem><para>The terminating signal name (with the <literal>SIG</literal> prefix
+        <footnote><para><citerefentry
+        project='man-pages'><refentrytitle>kill</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+        expects signal names <emphasis>without</emphasis> the prefix; <citerefentry
+        project='man-pages'><refentrytitle>kill</refentrytitle><manvolnum>2</manvolnum></citerefentry> uses
+        the prefix; all systemd tools accept signal names both with and without the prefix.
+        </para></footnote>) and numerical value. (Both are included because signal numbers vary by
+        architecture.)</para>
         </listitem>
       </varlistentry>
 

From 33360f35a121cef7cb000662f25daf993f890563 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
Date: Tue, 2 Mar 2021 09:37:49 +0100
Subject: [PATCH 2/2] man: reword sentence about lone coredumps

Let's make it clear that they are not as useful as the full thing.
---
 man/systemd-coredump.xml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml
index 98d4af57e4..56f4bba009 100644
--- a/man/systemd-coredump.xml
+++ b/man/systemd-coredump.xml
@@ -57,9 +57,8 @@
     few days by default; see <filename>/usr/lib/tmpfiles.d/systemd.conf</filename> for details. Note that the
     removal of core files from the file system and the purging of journal entries are independent, and the
     core file may be present without the journal entry, and journal entries may point to since-removed core
-    files. Metadata is attached to core files in the form of extended attributes, so the core files may be
-    useful even without the full metadata available in the journal entry.
-    </para>
+    files. Some metadata is attached to core files in the form of extended attributes, so the core files are
+    useful for some purposes even without the full metadata available in the journal entry.</para>
 
     <refsect2>
       <title>Invocation of <command>systemd-coredump</command></title>