wireproto: document possible return type

The wireprotocole command use a small set of class as return value. We document
the meaning of each of them.

AS my knowledge of wire protocol is fairly shallow, the documentation can
probably use improvement. But this is a better than nothing.

--HG--
extra : rebase_source : 4985358ff2b491f792fe4745e27f62136d767119
extra : amend_source : 21b80c9768cfac9cb4944e41dfe37303ffa73192
wireproto: introduce an abstractserverproto class

sshserver and webproto now inherit from an abstractserverproto class. This class
is introduced for documentation purpose.

--HG--
extra : rebase_source : fc31f80546c74f91e03a539a33e8f9d090a38378
wireproto: document protocol specific function of wirepeer

Those function are explicitly declared and documented now.

--HG--
extra : rebase_source : 58e2aac7935514440bb224938c6be11e8b5b2696
wireproto: drop the _decompress method in favor a new call type

We already have multiple call function for multiple return type. The
`_decompress` function is only used for http and seems like a layer violation.
We drop it in favor of a new call type dedicated to "stream that may be useful to
compress".

--HG--
extra : rebase_source : 8abba2b439ddec5e918dcf2b1b87cd224549f8b1
extra : amend_source : 3032dbef4833d59d8ec988f6b18898ca928a4ece
wireproto: add decorator for wire protocol command

Move move in the same direction we took for command line commands. each wire
protocol function will be decorated with its name and arguments.

Beside beside easier to read, this open the road to easily adding more metadata
(like security level or return type)

--HG--
extra : rebase_source : 51e5dfe6b37fd5114847e629422f09702a90506b
wireproto: use decorator for the batch command

--HG--
extra : rebase_source : baf6f1cdbe78be12ac4498f4139f5fd33bf2d46d
wireproto: use decorator for the between command

--HG--
extra : rebase_source : adf4998ad77e205382343f0271dd22c286a53dda
wireproto: use decorator for the branchmap command

--HG--
extra : rebase_source : 160763fe06ce8f17238925c2ec3023450664ee8e
wireproto: use decorator for the branches command

--HG--
extra : rebase_source : 296599c5899e25abdffa83006177e747aa4146c0
wireproto: use decorator for the capabilities command

--HG--
extra : rebase_source : beb7b5572e5c32524ba1f9c0f19963293575671d
wireproto: use decorator for the changegroup command

--HG--
extra : rebase_source : 9fa604c2bff040ba48f462c5caabadc1d6e916d7
wireproto: use decorator for the changegroupsubset command

--HG--
extra : rebase_source : 1613f9ce56329c7132d17508c75a96e5e1ee8a2d
wireproto: use decorator for the debugwireargs command

--HG--
extra : rebase_source : 460c283d101c19c1a43aa42dbddb6a3b5c337ed4
wireproto: use decorator for the getbundle command

--HG--
extra : rebase_source : 01fa4522c6f855931ab1ae7ded8ae395869c1f4e
wireproto: use decorator for the heads command

--HG--
extra : rebase_source : abbdc77b08f948a4c8adbc926cbe22ee0fb17590
wireproto: use decorator for the hello command

--HG--
extra : rebase_source : 3d972c108981b704730c48a5623a177bbd62d58b
wireproto: use decorator for the known command

--HG--
extra : rebase_source : c0bd70ec086cbff42a318fa2f9741568aa904fac
wireproto: use decorator for the listkeys command

--HG--
extra : rebase_source : b66a0b5559239e68cb066a84d0390c1300625211
wireproto: use decorator for the lookup command

--HG--
extra : rebase_source : ae2bebdad1df261c3fe57161b2f47d9dc811ba76
wireproto: use decorator for the pushkey command

--HG--
extra : rebase_source : 3f5998d8de3a02b73acbc5aa038837df971928a8