From mboxrd@z Thu Jan  1 00:00:00 1970
From: Danilo Cesar Lemes de Paula <danilo.cesar@collabora.co.uk>
Subject: [PATCH] scripts/kernel-doc Allow struct arguments
	documentation in struct body
Date: Fri, 31 Jul 2015 18:06:45 -0300
Message-ID: <1438376805-8964-1-git-send-email-danilo.cesar@collabora.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <intel-gfx-bounces@lists.freedesktop.org>
List-Unsubscribe: <http://lists.freedesktop.org/mailman/options/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <http://lists.freedesktop.org/archives/intel-gfx>
List-Post: <mailto:intel-gfx@lists.freedesktop.org>
List-Help: <mailto:intel-gfx-request@lists.freedesktop.org?subject=help>
List-Subscribe: <http://lists.freedesktop.org/mailman/listinfo/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=subscribe>
Errors-To: intel-gfx-bounces@lists.freedesktop.org
Sender: "Intel-gfx" <intel-gfx-bounces@lists.freedesktop.org>
To: linux-doc@vger.kernel.org
Cc: Michal Marek <mmarek@suse.cz>, Herbert Xu <herbert@gondor.apana.org.au>, Danilo Cesar Lemes de Paula <danilo.cesar@collabora.co.uk>, Jonathan Corbet <corbet@lwn.net>, Stephan Mueller <smueller@chronox.de>, Daniel Vetter <daniel.vetter@ffwll.ch>, intel-gfx <intel-gfx@lists.freedesktop.org>, Randy Dunlap <rdunlap@infradead.org>, linux-kernel@vger.kernel.org, dri-devel <dri-devel@lists.freedesktop.org>, Laurent Pinchart <laurent.pinchart@ideasonboard.com>
List-Id: dri-devel@lists.freedesktop.org

RGVzY3JpYmluZyBhcmd1bWVudHMgYXQgdG9wIG9mIGEgc3RydWN0IGRlZmluaXRpb24gd29ya3Mg
ZmluZQpmb3Igc21hbGwvbWVkaXVtIHNpemUgc3RydWN0cywgYnV0IGl0IGRlZmluaXRlbHkgZG9l
c24ndCB3b3JrIHdlbGwKZm9yIHN0cnVjdCB3aXRoIGEgaHVnZSBsaXN0IG9mIGVsZW1lbnRzLgoK
S2VlcGluZyB0aGUgYXJndW1lbnRzIGxpc3QgaW5zaWRlIHRoZSBzdHJ1Y3QgYm9keSBtYWtlcyBp
dCBlYXNpZXIKdG8gbWFpbnRhaW4gdGhlIGRvY3VtZW50YXRpb24uCmllOgovKioKICogc3RydWN0
IG15X3N0cnVjdCAtIHNob3J0IGRlc2NyaXB0aW9uCiAqIEBhOiBmaXJzdCBtZW1iZXIKICogQGI6
IHNlY29uZCBtZW1iZXIKICoKICogTG9uZ2VyIGRlc2NyaXB0aW9uCiAqLwpzdHJ1Y3QgbXlfc3Ry
dWN0IHsKICAgIGludCBhOwogICAgaW50IGI7CiAgICAvKioKICAgICAqIEBjOiBUaGlzIGlzIGxv
bmdlciBkZXNjcmlwdGlvbiBvZiBDCiAgICAgKgogICAgICogWW91IGNhbiB1c2UgcGFyYWdyYXBo
cyB0byBkZXNjcmliZSBhcmd1bWVudHMKICAgICAqIHVzaW5nIHRoaXMgbWV0aG9kLgogICAgICov
CiAgICBpbnQgYzsKfTsKClRoaXMgcGF0Y2ggYWxsb3dzIHRoZSB1c2Ugb2YgdGhpcyBraW5kIG9m
IHN5bnRheC4gT25seSBvbmUgYXJndW1lbnQKcGVyIGNvbW1lbnQgYW5kIHVzZXIgY2FuIHVzZSBo
b3cgbWFueSBwYXJhZ3JhcGhzIGhlIG5lZWRzLiBJdCBzaG91bGQKc3RhcnQgd2l0aCAvKiosIHdo
aWNoIGlzIGFscmVhZHkgYmVpbmcgdXNlZCBieSBrZXJuZWwtZG9jLiBJZiB0aG9zZQpjb21tZW50
IGRvZXNuJ3QgZm9sbG93IHRob3NlIHJ1bGVzLCBpdCB3aWxsIGJlIGlnbm9yZWQuCgpTaWduZWQt
b2ZmLWJ5OiBEYW5pbG8gQ2VzYXIgTGVtZXMgZGUgUGF1bGEgPGRhbmlsby5jZXNhckBjb2xsYWJv
cmEuY28udWs+CkNjOiBSYW5keSBEdW5sYXAgPHJkdW5sYXBAaW5mcmFkZWFkLm9yZz4KQ2M6IERh
bmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAZmZ3bGwuY2g+CkNjOiBMYXVyZW50IFBpbmNoYXJ0
IDxsYXVyZW50LnBpbmNoYXJ0QGlkZWFzb25ib2FyZC5jb20+CkNjOiBKb25hdGhhbiBDb3JiZXQg
PGNvcmJldEBsd24ubmV0PgpDYzogSGVyYmVydCBYdSA8aGVyYmVydEBnb25kb3IuYXBhbmEub3Jn
LmF1PgpDYzogU3RlcGhhbiBNdWVsbGVyIDxzbXVlbGxlckBjaHJvbm94LmRlPgpDYzogTWljaGFs
IE1hcmVrIDxtbWFyZWtAc3VzZS5jej4KQ2M6IGxpbnV4LWtlcm5lbEB2Z2VyLmtlcm5lbC5vcmcK
Q2M6IGxpbnV4LWRvY0B2Z2VyLmtlcm5lbC5vcmcKQ2M6IGludGVsLWdmeCA8aW50ZWwtZ2Z4QGxp
c3RzLmZyZWVkZXNrdG9wLm9yZz4KQ2M6IGRyaS1kZXZlbCA8ZHJpLWRldmVsQGxpc3RzLmZyZWVk
ZXNrdG9wLm9yZz4KLS0tCiBzY3JpcHRzL2tlcm5lbC1kb2MgfCA4MCArKysrKysrKysrKysrKysr
KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrLS0KIDEgZmlsZSBjaGFuZ2VkLCA3
OCBpbnNlcnRpb25zKCspLCAyIGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL3NjcmlwdHMva2Vy
bmVsLWRvYyBiL3NjcmlwdHMva2VybmVsLWRvYwppbmRleCA5OTIyZTY2Li45YmZhOGI5IDEwMDc1
NQotLS0gYS9zY3JpcHRzL2tlcm5lbC1kb2MKKysrIGIvc2NyaXB0cy9rZXJuZWwtZG9jCkBAIC0x
MzMsNiArMTMzLDMwIEBAIHVzZSBzdHJpY3Q7CiAjCiAjIEFsbCBkZXNjcmlwdGlvbnMgY2FuIGJl
IG11bHRpbGluZSwgZXhjZXB0IHRoZSBzaG9ydCBmdW5jdGlvbiBkZXNjcmlwdGlvbi4KICMKKyMg
Rm9yIHJlYWxseSBsb25ncyBzdHJ1Y3RzLCB5b3UgY2FuIGFsc28gZGVzY3JpYmUgYXJndW1lbnRz
IGluc2lkZSB0aGUKKyMgYm9keSBvZiB0aGUgc3RydWN0LgorIyBlZy4KKyMgLyoqCisjICAqIHN0
cnVjdCBteV9zdHJ1Y3QgLSBzaG9ydCBkZXNjcmlwdGlvbgorIyAgKiBAYTogZmlyc3QgbWVtYmVy
CisjICAqIEBiOiBzZWNvbmQgbWVtYmVyCisjICAqCisjICAqIExvbmdlciBkZXNjcmlwdGlvbgor
IyAgKi8KKyMgc3RydWN0IG15X3N0cnVjdCB7CisjICAgICBpbnQgYTsKKyMgICAgIGludCBiOwor
IyAgICAgLyoqCisjICAgICAgKiBAYzogVGhpcyBpcyBsb25nZXIgZGVzY3JpcHRpb24gb2YgQwor
IyAgICAgICoKKyMgICAgICAqIFlvdSBjYW4gdXNlIHBhcmFncmFwaHMgdG8gZGVzY3JpYmUgYXJn
dW1lbnRzCisjICAgICAgKiB1c2luZyB0aGlzIG1ldGhvZC4KKyMgICAgICAqLworIyAgICAgaW50
IGM7CisjIH07CisjCisjIFRoaXMgc2hvdWxkIGJlIHVzZSBmb3IgYXJndW1lbnRzIG9ubHkuCisj
CiAjIFlvdSBjYW4gYWxzbyBhZGQgYWRkaXRpb25hbCBzZWN0aW9ucy4gV2hlbiBkb2N1bWVudGlu
ZyBrZXJuZWwgZnVuY3Rpb25zIHlvdQogIyBzaG91bGQgZG9jdW1lbnQgdGhlICJDb250ZXh0OiIg
b2YgdGhlIGZ1bmN0aW9uLCBlLmcuIHdoZXRoZXIgdGhlIGZ1bmN0aW9ucwogIyBjYW4gYmUgY2Fs
bGVkIGZvcm0gaW50ZXJydXB0cy4gVW5saWtlIG90aGVyIHNlY3Rpb25zIHlvdSBjYW4gZW5kIGl0
IHdpdGggYW4KQEAgLTI4Nyw5ICszMTEsMTkgQEAgbXkgJGxpbmVwcmVmaXg9IiI7CiAjIDIgLSBz
Y2FubmluZyBmaWVsZCBzdGFydC4KICMgMyAtIHNjYW5uaW5nIHByb3RvdHlwZS4KICMgNCAtIGRv
Y3VtZW50YXRpb24gYmxvY2sKKyMgNSAtIGdhdGhlcmluZyBkb2N1bWVudGF0aW9uIG91dHNpZGUg
bWFpbiBibG9jawogbXkgJHN0YXRlOwogbXkgJGluX2RvY19zZWN0OwogCisjIFNwbGl0IERvYyBT
dGF0ZQorIyAwIC0gSW52YWxpZCAoQmVmb3JlIHN0YXJ0IG9yIGFmdGVyIGZpbmlzaCkKKyMgMSAt
IElzIHN0YXJ0ZWQgKHRoZSAvKiogd2FzIGZvdW5kIGluc2lkZSBhIHN0cnVjdCkKKyMgMiAtIFRo
ZSBAcGFyYW1ldGVyIGhlYWRlciB3YXMgZm91bmQsIHN0YXJ0IGFjY2VwdGluZyBtdWx0aSBwYXJh
Z3JhcGggdGV4dC4KKyMgMyAtIEZpbmlzaGVkICh0aGUgKi8gd2FzIGZvdW5kKQorIyA0IC0gRXJy
b3IgLSBDb21tZW50IHdpdGhvdXQgaGVhZGVyIHdhcyBmb3VuZC4gU3BpdCBhIHdhcm5pbmcgYXMg
aXQncyBub3QKKyMgICAgIHByb3BlciBrZXJuZWwtZG9jIGFuZCBpZ25vcmUgdGhlIHJlc3QuCitt
eSAkc3BsaXRfZG9jX3N0YXRlOworCiAjZGVjbGFyYXRpb24gdHlwZXM6IGNhbiBiZQogIyAnZnVu
Y3Rpb24nLCAnc3RydWN0JywgJ3VuaW9uJywgJ2VudW0nLCAndHlwZWRlZicKIG15ICRkZWNsX3R5
cGU7CkBAIC0zMDQsNiArMzM4LDkgQEAgbXkgJGRvY19kZWNsID0gJGRvY19jb20gLiAnKFx3Kykn
OwogbXkgJGRvY19zZWN0ID0gJGRvY19jb20gLiAnKFsnIC4gJGRvY19zcGVjaWFsIC4gJ10/W1x3
XHNdKyk6KC4qKSc7CiBteSAkZG9jX2NvbnRlbnQgPSAkZG9jX2NvbV9ib2R5IC4gJyguKiknOwog
bXkgJGRvY19ibG9jayA9ICRkb2NfY29tIC4gJ0RPQzpccyooLiopPyc7CitteSAkZG9jX3NwbGl0
X3N0YXJ0ID0gJ15ccyovXCpcKlxzKiQnOworbXkgJGRvY19zcGxpdF9zZWN0ID0gJ1xzKlwqXHMq
KEBbXHdcc10rKTooLiopJzsKK215ICRkb2Nfc3BsaXRfZW5kID0gJ15ccypcKi9ccyokJzsKIAog
bXkgJWNvbnN0YW50czsKIG15ICVwYXJhbWV0ZXJkZXNjczsKQEAgLTIxODEsNiArMjIxOCw3IEBA
IHN1YiByZXNldF9zdGF0ZSB7CiAgICAgJHByb3RvdHlwZSA9ICIiOwogCiAgICAgJHN0YXRlID0g
MDsKKyAgICAkc3BsaXRfZG9jX3N0YXRlID0gMDsKIH0KIAogc3ViIHRyYWNlcG9pbnRfbXVuZ2Uo
JCkgewpAQCAtMjQ1Myw3ICsyNDkxLDYgQEAgc3ViIHByb2Nlc3NfZmlsZSgkKSB7CiAJCX0KIAkJ
JHNlY3Rpb24gPSAkbmV3c2VjdGlvbjsKIAkgICAgfSBlbHNpZiAoLyRkb2NfZW5kLykgewotCiAJ
CWlmICgoJGNvbnRlbnRzIG5lICIiKSAmJiAoJGNvbnRlbnRzIG5lICJcbiIpKSB7CiAJCSAgICBk
dW1wX3NlY3Rpb24oJGZpbGUsICRzZWN0aW9uLCB4bWxfZXNjYXBlKCRjb250ZW50cykpOwogCQkg
ICAgJHNlY3Rpb24gPSAkc2VjdGlvbl9kZWZhdWx0OwpAQCAtMjQ5NCw4ICsyNTMxLDQ3IEBAIHN1
YiBwcm9jZXNzX2ZpbGUoJCkgewogCQlwcmludCBTVERFUlIgIldhcm5pbmcoJHtmaWxlfTokLik6
IGJhZCBsaW5lOiAkXyI7CiAJCSsrJHdhcm5pbmdzOwogCSAgICB9CisJfSBlbHNpZiAoJHN0YXRl
ID09IDUpIHsgIyBzY2FubmluZyBmb3Igc3BsaXQgcGFyYW1ldGVycworCisJICAgICMgRmlyc3Qg
bGluZSAoc3RhdGUgMSkgbmVlZHMgdG8gYmUgYSBAcGFyYW1ldGVyCisJICAgIGlmICgkc3BsaXRf
ZG9jX3N0YXRlID09IDEgJiYgLyRkb2Nfc3BsaXRfc2VjdC9vKSB7CisJICAgICAgICAkc2VjdGlv
biA9ICQxOworCSAgICAgICAgJGNvbnRlbnRzID0gJDI7CisJICAgICAgICBpZiAoJGNvbnRlbnRz
IG5lICIiKSB7CisJICAgIAkgICAgd2hpbGUgKChzdWJzdHIoJGNvbnRlbnRzLCAwLCAxKSBlcSAi
ICIpIHx8CisJICAgICAgICAgICAgICAgICAgICBzdWJzdHIoJGNvbnRlbnRzLCAwLCAxKSBlcSAi
XHQiKSB7CisJICAgIAkgICAgICAgICRjb250ZW50cyA9IHN1YnN0cigkY29udGVudHMsIDEpOwor
CSAgICAgICAgICAgIH0KKwkgICAgICAgICAgICAkY29udGVudHMgLj0gIlxuIjsKKwkgICAgICAg
IH0KKwkgICAgICAgICRzcGxpdF9kb2Nfc3RhdGUgPSAyOworCisJICAgICMgRW5kIGNvbW1lbmQg
Ki8KKwkgICAgfSBlbHNpZiAoLyRkb2Nfc3BsaXRfZW5kLykgeworCSAgICAgICAgaWYgKCgkY29u
dGVudHMgbmUgIiIpICYmICgkY29udGVudHMgbmUgIlxuIikpIHsKKwkgICAgICAgICAgICBkdW1w
X3NlY3Rpb24oJGZpbGUsICRzZWN0aW9uLCB4bWxfZXNjYXBlKCRjb250ZW50cykpOworCSAgICAg
ICAgICAgICRzZWN0aW9uID0gJHNlY3Rpb25fZGVmYXVsdDsKKwkgICAgICAgICAgICAkY29udGVu
dHMgPSAiIjsKKwkgICAgICAgIH0KKwkgICAgICAgICRzdGF0ZSA9IDM7CisJICAgICAgICAkc3Bs
aXRfZG9jX3N0YXRlID0gMDsKKworCSAgICAjIFJlZ3VsYXIgdGV4dAorCSAgICB9IGVsc2lmICgv
JGRvY19jb250ZW50LykgeworCSAgICAJaWYgKCRzcGxpdF9kb2Nfc3RhdGUgPT0gMikgeworCSAg
ICAJICAgICRjb250ZW50cyAuPSAkMSAuICJcbiI7CisJICAgIAl9IGVsc2lmICgkc3BsaXRfZG9j
X3N0YXRlID09IDEpIHsKKwkgICAgCSAgICAkc3BsaXRfZG9jX3N0YXRlID0gNDsKKwkgICAgCSAg
ICBwcmludCBTVERFUlIgIldhcm5pbmcoJHtmaWxlfTokLik6ICI7CisJICAgIAkgICAgcHJpbnQg
U1RERVJSICJJbmNvcnJlY3QgdXNlIG9mIGtlcm5lbC1kb2MgZm9ybWF0OiAkXyI7CisJICAgIAkg
ICAgKyskd2FybmluZ3M7CisJICAgIAl9CisJICAgIH0KIAl9IGVsc2lmICgkc3RhdGUgPT0gMykg
ewkjIHNjYW5uaW5nIGZvciBmdW5jdGlvbiAneycgKGVuZCBvZiBwcm90b3R5cGUpCi0JICAgIGlm
ICgkZGVjbF90eXBlIGVxICdmdW5jdGlvbicpIHsKKwkgICAgaWYgKC8kZG9jX3NwbGl0X3N0YXJ0
LykgeworCSAgICAJICAgICRzdGF0ZSA9IDU7CisJICAgIAkgICAgJHNwbGl0X2RvY19zdGF0ZSA9
IDE7CisJICAgIH0gZWxzaWYgKCRkZWNsX3R5cGUgZXEgJ2Z1bmN0aW9uJykgewogCQlwcm9jZXNz
X3N0YXRlM19mdW5jdGlvbigkXywgJGZpbGUpOwogCSAgICB9IGVsc2UgewogCQlwcm9jZXNzX3N0
YXRlM190eXBlKCRfLCAkZmlsZSk7Ci0tIAoyLjQuNgoKX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4IG1haWxpbmcgbGlzdApJbnRlbC1nZnhA
bGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1h
bi9saXN0aW5mby9pbnRlbC1nZngK