wireproto: improve docstring for @wireprotocommand
authorGregory Szorc <gregory.szorc@gmail.com>
Tue, 30 Jan 2018 15:21:59 -0800
changeset 35980 b4976912a6ef
parent 35979 ae79cf6f9c82
child 35981 ef683a0fd21f
wireproto: improve docstring for @wireprotocommand I'm about to add more arguments and want them to be documented. Plus, good documentation is nice to have. Differential Revision: https://phab.mercurial-scm.org/D1997
mercurial/wireproto.py
--- a/mercurial/wireproto.py	Wed Jan 31 10:06:39 2018 -0800
+++ b/mercurial/wireproto.py	Tue Jan 30 15:21:59 2018 -0800
@@ -638,7 +638,13 @@
 commands = {}
 
 def wireprotocommand(name, args=''):
-    """decorator for wire protocol command"""
+    """Decorator to declare a wire protocol command.
+
+    ``name`` is the name of the wire protocol command being provided.
+
+    ``args`` is a space-delimited list of named arguments that the command
+    accepts. ``*`` is a special value that says to accept all arguments.
+    """
     def register(func):
         commands[name] = (func, args)
         return func