From 26be2d1a77fdf404b9061bc6f4a2e25d7e4cbab0 Mon Sep 17 00:00:00 2001 From: Harumi Kuno Date: Mon, 30 Aug 2021 01:43:06 -0700 Subject: [PATCH] skip empty description Don't print the description of a command as a subtitle when generating a manpage if the description is empty. This commit addresses sphinx-doc#9430 Signed-off-by: Harumi Kuno --- sphinx/writers/manpage.py | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/sphinx/writers/manpage.py b/sphinx/writers/manpage.py index 90f3accbfd7..29d93aa84f5 100644 --- a/sphinx/writers/manpage.py +++ b/sphinx/writers/manpage.py @@ -113,8 +113,9 @@ def __init__(self, document: nodes.document, builder: Builder) -> None: def header(self) -> str: tmpl = (".TH \"%(title_upper)s\" \"%(manual_section)s\"" " \"%(date)s\" \"%(version)s\" \"%(manual_group)s\"\n" - ".SH NAME\n" - "%(title)s \\- %(subtitle)s\n") + ".SH NAME\n") + if self._docinfo['subtitle']: + tmpl += "%(title)s \\- %(subtitle)s\n" return tmpl % self._docinfo def visit_start_of_file(self, node: Element) -> None: