man: minor addition to coredumpctl example

[elogind.git] / man / coredumpctl.xml

diff --git a/man/coredumpctl.xml b/man/coredumpctl.xml
index 0cd3fe558d1eee49fa5251330d65061db41ad6cb..ed84621d3798dcaeb1faee0529373aee49bdff91 100644 (file)
--- a/man/coredumpctl.xml
+++ b/man/coredumpctl.xml
@@ -45,8 +45,6 @@
 
         <refnamediv>
                 <refname>coredumpctl</refname>
-                <refname>systemd-coredumpctl</refname>
-
                 <refpurpose>Retrieve coredumps from the journal</refpurpose>
         </refnamediv>
 
@@ -65,10 +63,6 @@
                 <para><command>coredumpctl</command> may be used to
                 retrieve coredumps from
                 <citerefentry><refentrytitle>systemd-journald</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
-
-                <para><command>systemd-coredumpctl</command> is a
-                depracated alias for
-                <command>coredumpctl</command>.</para>
         </refsect1>
 
         <refsect1>
@@ -126,7 +120,7 @@
                                 <listitem><para>List coredumps
                                 captured in the journal matching
                                 specified characteristics. If no
-                                command is specified this is the
+                                command is specified, this is the
                                 implied default.</para></listitem>
                         </varlistentry>
 
@@ -213,11 +207,41 @@
                 </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, matching by its PID 6654</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>
+                        <citerefentry><refentrytitle>systemd-coredump</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+                        <citerefentry><refentrytitle>coredump.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                         <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
-                        <citerefentry><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                        <citerefentry project='man-pages'><refentrytitle>gdb</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                 </para>
         </refsect1>