From 00d4f6270e576d759e6881c903c9c5ab5c436849 Mon Sep 17 00:00:00 2001
From: Andrej Shadura <andrew.shadura@collabora.co.uk>
Date: Thu, 10 Dec 2020 16:28:20 +0100
Subject: [PATCH] Add a manpage

---
 debian/dwarf2sources.1        | 37 ++++++++++++++++++++++++++++
 debian/dwarf2sources.manpages |  1 +
 debian/dwarf2sources.md       | 45 +++++++++++++++++++++++++++++++++++
 3 files changed, 83 insertions(+)
 create mode 100644 debian/dwarf2sources.1
 create mode 100644 debian/dwarf2sources.manpages
 create mode 100644 debian/dwarf2sources.md

diff --git a/debian/dwarf2sources.1 b/debian/dwarf2sources.1
new file mode 100644
index 0000000..6b2edce
--- /dev/null
+++ b/debian/dwarf2sources.1
@@ -0,0 +1,37 @@
+.\" Automatically generated by Pandoc 2.9.2.1
+.\"
+.TH "dwarf2sources" "1" "" "" ""
+.hy
+.SH NAME
+.PP
+dwarf2sources - list the source files for a given binary
+.SH SYNOPSIS
+.PP
+dwarf2sources [\f[B]-o\f[R] \f[I]output.json\f[R]] [\f[B]-s\f[R]
+\f[I]strip-prefix\f[R]] [\f[I]file\f[R]]...
+.SH DESCRIPTION
+.PP
+dwarf2sources lists the source files that were used to create a given
+binary in JSON format.
+The input files must not be stripped and must contain debugging
+information in DWARF format.
+.TP
+\f[B]-h\f[R], \f[B]--help\f[R]
+Prints help information
+.TP
+\f[B]-V\f[R], \f[B]--version\f[R]
+Prints version information
+.TP
+\f[B]-o\f[R], \f[B]--output\f[R] <output>
+File to write JSON output to
+.TP
+\f[B]-s\f[R], \f[B]--strip-prefix\f[R] <strip-prefix>
+Strip given prefix from comp_dir paths
+.SH AUTHORS
+.PP
+This program was written by Sjoerd Simons based on the gimli 0.16.1
+dwarfdump.rs example by Nick Fitzgerald, Philip Craig and other
+rust-dwarf developers.
+.SH SEE ALSO
+.PP
+\f[B]objdump\f[R](1), \f[B]strip\f[R](1)
diff --git a/debian/dwarf2sources.manpages b/debian/dwarf2sources.manpages
new file mode 100644
index 0000000..730d35f
--- /dev/null
+++ b/debian/dwarf2sources.manpages
@@ -0,0 +1 @@
+debian/dwarf2sources.1
diff --git a/debian/dwarf2sources.md b/debian/dwarf2sources.md
new file mode 100644
index 0000000..3e60faf
--- /dev/null
+++ b/debian/dwarf2sources.md
@@ -0,0 +1,45 @@
+% dwarf2sources(1)
+
+NAME
+====
+
+dwarf2sources - list the source files for a given binary
+
+
+SYNOPSIS
+========
+
+dwarf2sources \[**-o** *output.json*\] \[**-s** *strip-prefix*\] \[*file*\]\...
+
+DESCRIPTION
+===========
+
+dwarf2sources lists the source files that were
+used to create a given binary in JSON format. The input files
+must not be stripped and must contain debugging information in DWARF format.
+
+**-h**, **\--help**
+
+:   Prints help information
+
+**-V**, **\--version**
+
+:   Prints version information
+
+**-o**, **\--output** \<output\>
+
+:   File to write JSON output to
+
+**-s**, **\--strip-prefix** \<strip-prefix\>
+
+:   Strip given prefix from comp\_dir paths
+
+AUTHORS
+=======
+
+This program was written by Sjoerd Simons based on the gimli 0.16.1 dwarfdump.rs example by Nick Fitzgerald, Philip Craig and other rust-dwarf developers.
+
+SEE ALSO
+========
+
+**objdump**(1), **strip**(1)
-- 
GitLab