[Libguestfs] [PATCH 7/8] python: PEP 8: avoid whitespace-only lines in docstrings

Tweak the docstring generation to avoid lines with only indentation spaces. No functional changes, only whitespaces removals. --- generator/python.ml | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/generator/python.ml b/generator/python.ml index d577ef1..70dc076 100644 --- a/generator/python.ml +++ b/generator/python.ml @@ -836,7 +836,25 @@ class GuestFS(object): doc ^ sprintf "\n\nThis function depends on the feature C<%s>. See also C<g.feature-available>." opt in let doc = pod2text ~width:60 f.name doc in let doc = List.map (fun line -> replace_str line "\\" "\\\\") doc in - let doc = String.concat "\n " doc in + let doc = + match doc with + | [] -> "" + | [line] -> line + | hd :: tl -> + let endpos = List.length tl - 1 in + (* Add indentation spaces, but only if the line is not empty or + * it is not the last one (since there will be the 3 dobule-quotes + * at the end. + *) + let lines = + mapi ( + fun lineno line -> + if line = "" && lineno <> endpos then + "" + else + " " ^ line + ) tl in + hd ^ "\n" ^ (String.concat "\n" lines) in pr " \"\"\"%s\"\"\"\n" doc; ); (* Callers might pass in iterables instead of plain lists; -- 2.5.5