From bb604b2f42e8769947c6cf1c0242760ceb320929 Mon Sep 17 00:00:00 2001
From: Ronny Chevalier <chevalier.ronny@gmail.com>
Date: Sun, 12 Oct 2014 00:37:21 +0200
Subject: [PATCH] man: add examples for coredumpctl

Add examples to clarify how to use coredumpctl

See https://bugs.freedesktop.org/show_bug.cgi?id=83437
---
 man/coredumpctl.xml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/man/coredumpctl.xml b/man/coredumpctl.xml
index a7b8793e51..03552b7d19 100644
--- a/man/coredumpctl.xml
+++ b/man/coredumpctl.xml
@@ -207,6 +207,34 @@
                 </para>
         </refsect1>
 
+        <refsect1>
+                <title>Examples</title>
+
+                <example>
+                        <title>List all the coredumps of a program named foo</title>
+
+                        <programlisting># coredumpctl list foo</programlisting>
+                </example>
+
+                <example>
+                        <title>Invoke gdb on the last coredump</title>
+
+                        <programlisting># coredumpctl gdb</programlisting>
+                </example>
+
+                <example>
+                        <title>Show information about a process that dumped core</title>
+
+                        <programlisting># coredumpctl info 6654</programlisting>
+                </example>
+
+                <example>
+                        <title>Extract the last coredump of /usr/bin/bar to a file named bar.coredump</title>
+
+                        <programlisting># coredumpctl -o bar.coredump dump /usr/bin/bar</programlisting>
+                </example>
+        </refsect1>
+
         <refsect1>
                 <title>See Also</title>
                 <para>