Re: [Libguestfs] [libnbd PATCH v2 1/8] python: Improve doc comments for nbd.py

2022-06-07 Thread Richard W.M. Jones
On Mon, Jun 06, 2022 at 09:08:26PM -0500, Eric Blake wrote: > PEP257 recommends that doc comments start with a one line summary and > be a complete sentence. Tweak our existing comments to comply. It > also recommends the use of """ strings, and for u""" when a string > contains Unicode;

[Libguestfs] [libnbd PATCH v2 1/8] python: Improve doc comments for nbd.py

2022-06-06 Thread Eric Blake
PEP257 recommends that doc comments start with a one line summary and be a complete sentence. Tweak our existing comments to comply. It also recommends the use of """ strings, and for u""" when a string contains Unicode; however, for since it is easier to write ' than " in OCaml pr statements,