On Wed, 06 Feb 2013 14:51:44 +0100 Markus Armbruster <arm...@redhat.com> wrote:
> Back to your question, namely how to document enumeration DataFormat. > Perhaps: > > ## > # @DataFormat: > # > # An enumeration of data format. > # > # @utf8: Data is a UTF-8 string (RFC 3629) > # > # @base64: Data is a Base64 encoded binary (RFC 3548) > # > # Since: 1.4 > ## > > This omits the fact that data itself is a JSON string, because that's > "obvious". Hmm. Let me try -v: That looks good to me.