From c3e0ca1a20b5028bf90712bd4bf37caf95e05422 Mon Sep 17 00:00:00 2001
From: Chenxiong Qi <cqi@fedoraproject.org>
Date: Jun 12 2018 01:26:27 +0000
Subject: Merge #229 `Use refactored man from pyrpkg`


---

diff --git a/doc/fedpkg_man_page.py b/doc/fedpkg_man_page.py
index 424fd80..70e4086 100755
--- a/doc/fedpkg_man_page.py
+++ b/doc/fedpkg_man_page.py
@@ -8,146 +8,6 @@ import datetime
 from six.moves.configparser import ConfigParser
 
 
-# We could substitute the "" in .TH with the fedpkg version if we knew it
-man_header = """\
-.\\" man page for fedpkg
-.TH fedpkg 1 "%(today)s" "" "RPM packager"
-.SH "NAME"
-fedpkg \\- RPM Packaging utility
-.SH "SYNOPSIS"
-.B "fedpkg"
-[
-.I global_options
-]
-.I "command"
-[
-.I command_options
-]
-[
-.I command_arguments
-]
-.br
-.B "fedpkg"
-.B "help"
-.br
-.B "fedpkg"
-.I "command"
-.B "\\-\\-help"
-.SH "DESCRIPTION"
-.B "fedpkg"
-is a script to interact with the RPM Packaging system.
-"""
-
-man_footer = """\
-.SH "SEE ALSO"
-.UR "https://pagure.io/fedora\\-packager/"
-.BR "https://pagure.io/fedora\\-packager/"
-"""
-
-
-class ManFormatter(object):
-
-    def __init__(self, man):
-        self.man = man
-
-    def write(self, data):
-        # print("MF: %r" % data)
-        for line in data.split('\n'):
-            # print('MFL: %s' % line)
-            self.man.write('  %s\n' % line)
-
-
-def strip_usage(s):
-    """Strip "usage: " string from beginning of string if present"""
-    if s.startswith('usage: '):
-        return s.replace('usage: ', '', 1)
-    else:
-        return s
-
-
-def man_constants():
-    """Global constants for man file templates"""
-    today = datetime.date.today()
-    today_manstr = today.strftime(r'%Y\-%m\-%d')
-    return {'today': today_manstr}
-
-
-def generate(parser, subparsers):
-    """\
-    Generate the man page on stdout
-
-    Given the argparse based parser and subparsers arguments, generate
-    the corresponding man page and write it to stdout.
-    """
-
-    # Not nice, but works: Redirect any print statement output to
-    # stderr to avoid clobbering the man page output on stdout.
-    man_file = sys.stdout
-    sys.stdout = sys.stderr
-
-    mf = ManFormatter(man_file)
-
-    choices = subparsers.choices
-    k = sorted(choices.keys())
-
-    man_file.write(man_header % man_constants())
-
-    helptext = parser.format_help()
-    helptext = strip_usage(helptext)
-    helptextsplit = helptext.split('\n')
-    helptextsplit = [line for line in helptextsplit
-                     if not line.startswith('  -h, --help')]
-
-    man_file.write('.SS "%s"\n' % ("Global Options",))
-
-    outflag = False
-    for line in helptextsplit:
-        if line == "optional arguments:":
-            outflag = True
-        elif line == "":
-            outflag = False
-        elif outflag:
-            man_file.write("%s\n" % line)
-
-    help_texts = {}
-    for pa in subparsers._choices_actions:
-        help_texts[pa.dest] = getattr(pa, 'help', None)
-
-    man_file.write('.SH "COMMAND OVERVIEW"\n')
-
-    for command in k:
-        cmdparser = choices[command]
-        if not cmdparser.add_help:
-            continue
-        usage = cmdparser.format_usage()
-        usage = strip_usage(usage)
-        usage = ''.join(usage.split('\n'))
-        usage = ' '.join(usage.split())
-        if help_texts[command]:
-            man_file.write('.TP\n.B "%s"\n%s\n' % (usage, help_texts[command]))
-        else:
-            man_file.write('.TP\n.B "%s"\n' % (usage))
-
-    man_file.write('.SH "COMMAND REFERENCE"\n')
-    for command in k:
-        cmdparser = choices[command]
-        if not cmdparser.add_help:
-            continue
-
-        man_file.write('.SS "%s"\n' % cmdparser.prog)
-
-        help = help_texts[command]
-        if help and not cmdparser.description:
-            if not help.endswith('.'):
-                help = "%s." % help
-            cmdparser.description = help
-
-        h = cmdparser.format_help()
-        mf.write(h)
-
-    man_file.write(man_footer)
-
-
 if __name__ == '__main__':
     module_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
     sys.path.insert(0, module_path)
@@ -156,10 +16,14 @@ if __name__ == '__main__':
     config.read(
         os.path.join(module_path, 'conf', 'etc', 'rpkg', 'fedpkg.conf'))
 
+    import pyrpkg.man_gen
     try:
         import fedpkg
     except ImportError:
         sys.path.append('src/')
         import fedpkg
     client = fedpkg.cli.fedpkgClient(config=config, name='fedpkg')
-    generate(client.parser, client.subparsers)
+    pyrpkg.man_gen.generate(client.parser,
+                            client.subparsers,
+                            identity='fedpkg',
+                            sourceurl='https://pagure.io/fedpkg/')