On Mon, Oct 24, 2011 at 07:00:24PM +0200, Michael Hanselmann wrote:
> Am 24. Oktober 2011 18:46 schrieb Michael Hanselmann <[email protected]>:
> > These will be used for replacing the tons and tons of boilerplate code
> > in rpc.py.
> 
> Interdiff with a hopefully useful docstring:
> 
> --- a/lib/build/rpc_definitions.py
> +++ b/lib/build/rpc_definitions.py
> @@ -20,6 +20,20 @@
> 
>  """RPC definitions for communication between master and node daemons.
> 
> +RPC definition fields:
> +
> +  - Name as string
> +  - L{SINGLE} for single-node calls, L{MULTI} for multi-node
> +  - Timeout (e.g. L{TMO_NORMAL})
> +  - List of arguments as tuples
> +
> +    - Name as string
> +    - Wrapper code ("%s" is replaced with argument name, see 
> L{OBJECT_TO_DICT})
> +    - Description for docstring (can be C{None})
> +
> +  - Return value wrapper (e.g. for deserializing into L{objects}-based 
> objects)
> +  - Short call description for docstring
> +
>  """

LGTM, alternatively you could "document" this via TH. Err, ht.py.

thanks,
iustin

Reply via email to