[libvirt] [PATCH] docs: Document <sndbuf/>

[Martin Kletzander]

On Thu, Jan 12, 2017 at 04:18:58PM +0100, Michal Privoznik wrote:
>On 01/12/2017 03:33 PM, Martin Kletzander wrote:
>> On Thu, Jan 12, 2017 at 12:49:19PM +0100, Michal Privoznik wrote:
>>> This element has been introduced in fe053dbea7, but isn't
>>> documented yet. After exactly 6 years I guess we can finally
>>> document it.
>>>
>>> Signed-off-by: Michal Privoznik <mprivozn at redhat.com>
>>> ---
>>> docs/formatdomain.html.in | 10 +++++++++-
>>> 1 file changed, 9 insertions(+), 1 deletion(-)
>>>
>>
>> ACK, trivial docs, safe for freeze.  Do we really want to say the
>> version there? =D
>
>Well, I think that everything should say the version it was introduced
>in. IMO by reading docs you should not only know how to enable the
>feature but also whether your software is new enough to support the
>feature in the first place. Another approach would be to have separate
>docs per each release. Then we can drop <since/> entirely.
>

It was rather fun play on the fact that we're adding documentation for
something 107 releases after it was introduced, very specific to this
one.  Of course I agree with the version mentioning in other cases.

>Pushed. With the version mentioned :-) Thanks.
>
>Michal
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20170112/c5c42dc2/attachment-0001.sig>