[devscripts/prepare_manpage] Fix description strings starting with dash (Closes #10273)

devscripts/prepare_manpage.py

@@ -54,17 +54,21 @@ def filter_options(readme):
 
         if in_options:
             if line.lstrip().startswith('-'):
-                option, description = re.split(r'\s{2,}', line.lstrip())
+                split = re.split(r'\s{2,}', line.lstrip())
-                split_option = option.split(' ')
+                # Description string may start with `-` as well. If there is
-
+                # only one piece then it's a description bit not an option.
-                if not split_option[-1].startswith('-'):  # metavar
+                if len(split) > 1:
-                    option = ' '.join(split_option[:-1] + ['*%s*' % split_option[-1]])
+                    option, description = split
-
+                    split_option = option.split(' ')
-                # Pandoc's definition_lists. See http://pandoc.org/README.html
+
-                # for more information.
+                    if not split_option[-1].startswith('-'):  # metavar
-                ret += '\n%s\n:   %s\n' % (option, description)
+                        option = ' '.join(split_option[:-1] + ['*%s*' % split_option[-1]])
-            else:
+
-                ret += line.lstrip() + '\n'
+                    # Pandoc's definition_lists. See http://pandoc.org/README.html
+                    # for more information.
+                    ret += '\n%s\n:   %s\n' % (option, description)
+                    continue
+            ret += line.lstrip() + '\n'
         else:
             ret += line + '\n'