[Libguestfs] [PATCH libnbd 1/4] generator: Allow long ‘name - shortdesc’ in man pages.

Richard W.M. Jones rjones at redhat.com
Fri Oct 4 19:50:07 UTC 2019


For commands with long names and/or short descriptors, you can end up
going over 72 characters in the first line of the man page (causing
podwrapper to complain).  Wrap these lines.
---
 generator/generator | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/generator/generator b/generator/generator
index 7d3f656..ad1cb6b 100755
--- a/generator/generator
+++ b/generator/generator
@@ -4487,7 +4487,8 @@ let generate_docs_nbd_pod name { args; optargs; ret;
                                  first_version = (major, minor) } () =
   pr "=head1 NAME\n";
   pr "\n";
-  pr "nbd_%s - %s\n" name shortdesc;
+  pr_wrap ' ' (fun () -> pr "nbd_%s - %s" name shortdesc);
+  pr "\n";
   pr "\n";
 
   pr "=head1 SYNOPSIS\n";
-- 
2.23.0




More information about the Libguestfs mailing list