tree 89228ad712bf3bbdeece8383d44085e1346a7534
parent df4e56f8fab65ba714ec18f4e7338a966a1620ad
author Andrea Bolognani <abologna@redhat.com> 1555331471 +0200
committer Daniel P. Berrangé <berrange@redhat.com> 1555332047 +0100

keymap-gen: Name sections in pod output

Properly formatted man pages have at least a NAME section,
which tools like apropos(1) parse and index.

The current implementation of PodLanguageGenerator doesn't
generate this section, and even if the user were to try and
work around the limitation by passing --varname=NAME, there
would still be nothing in the section to actually parse.

Change the generator so that varname will be used as the
contents of the NAME section, add a DESCRIPTION section in
which values are listed.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>