dlopen-notes: generate man page using argparse-manpage

Setting this up is a bit annoying, but then with luck we won't
have to edit raw roff when new options are added.

Author: keszybz

.gitignore

@@ -11,3 +11,4 @@
 !/debian/rules
 !/debian/source/format
 __pycache__/
+/dlopen-notes.1

Makefile

@@ -1,5 +1,13 @@
 all:
 
+dlopen-notes.1: dlopen-notes.py docs/dlopen-description.man Makefile
+	argparse-manpage 	\
+		--output=$@ 	\
+		--pyfile=$< 	\
+		--function=make_parser \
+		--project-name=package-notes \
+		--include=docs/dlopen-description.man
+
 install:
 	install -m 755 -D dlopen-notes.py $(DESTDIR)/usr/bin/dlopen-notes
 

dlopen-notes.py

@@ -118,7 +118,7 @@ def group_by_feature(filenames, notes):
 
     return features
 
-def parse_args():
+def make_parser():
     p = argparse.ArgumentParser(
         description=__doc__,
         allow_abbrev=False,
@@ -145,8 +145,10 @@ def parse_args():
     p.add_argument('-h', '--help',
                    action='help',
                    help='Show this help message and exit')
+    return p
 
-    args = p.parse_args()
+def parse_args():
+    args = make_parser().parse_args()
 
     if not args.raw and args.features is None and not args.sonames:
         # Make --raw the default if no action is specified.

docs/dlopen-description.man

@@ -0,0 +1,11 @@
+/report the contents/
+.PP
+ELF binaries store link-time dependencies in their headers, which can be parsed
+by various tools. There is no machine-readable metadata about dependencies
+loaded at build time via
+.BR \%dlopen (3)
+available by default. The ELF Dlopen Metadata specification aims to fill this
+gap, by defining a common format.
+.PP
+This tool allows parsing such a note, and printing out the result in various
+formats.