|
From: | John Snow |
Subject: | Re: [PATCH v2 18/38] qapi/events.py: Move comments into docstrings |
Date: | Fri, 25 Sep 2020 11:55:31 -0400 |
User-agent: | Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.11.0 |
On 9/25/20 8:19 AM, Markus Armbruster wrote:
What about: Generate a QAPI struct variable holding the event parameters, initialized with the function's arguments.
Line length and style-guide limitations; docstrings need a one-liner summary.
(Consistency is the hobgoblin, blah blah blah.) I am writing: """ Generate a QAPI struct variable with an initializer. The QAPI struct describes the event parameters, and the initializer references the function arguments defined in `gen_event_send`. """
[Prev in Thread] | Current Thread | [Next in Thread] |