From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: From: Roland Hieber Date: Thu, 4 Apr 2019 18:42:13 +0200 Message-Id: <20190404164214.15165-3-rhi@pengutronix.de> In-Reply-To: <20190404164214.15165-1-rhi@pengutronix.de> References: <20190404164214.15165-1-rhi@pengutronix.de> MIME-Version: 1.0 Subject: [ptxdist] [PATCH 3/4] doc: ref_make_macros: merge parameter macros into a single section List-Id: PTXdist Development Mailing List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: ptxdist@pengutronix.de Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: ptxdist-bounces@pengutronix.de Sender: "ptxdist" To: ptxdist@pengutronix.de Cc: Roland Hieber QWxsIG9mIHRoZXNlIG1hY3JvcyBjYW4gYmUgZXhwbGFpbmVkIGNvbmNpc2VseSB3aXRoIG9uZSB0 YWJsZSBhbmQgb25lCmNvbWJpbmVkIGV4YW1wbGUsIG5vIG5lZWQgdG8gcmVwZWF0IGEgd2hvbGUg c2VjdGlvbiBhbmQgcGFyYWdyYXBoIG9mIHRoZQp0ZXh0IGZvciBlYWNoIG9uZSBvZiB0aGVtIHRo YXQgb25seSBkaWZmZXIgaW4gYSBmZXcgd29yZHMuIEFsc28gbWVudGlvbgpzb21lIHVzZSBjYXNl cywgYW5kIGdpdmUgcmVhbC1saWZlIGV4YW1wbGVzIGZyb20gZXhpc3RpbmcgY29kZSB0byBiZXR0 ZXIKZXhwbGFpbiB0aGUgdXNhZ2UuCgpTaWduZWQtb2ZmLWJ5OiBSb2xhbmQgSGllYmVyIDxyaGlA cGVuZ3V0cm9uaXguZGU+Ci0tLQogZG9jL3JlZl9tYWtlX21hY3Jvcy5pbmMgfCAxNjUgKysrKysr KysrKystLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDQ2IGlu c2VydGlvbnMoKyksIDExOSBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kb2MvcmVmX21ha2Vf bWFjcm9zLmluYyBiL2RvYy9yZWZfbWFrZV9tYWNyb3MuaW5jCmluZGV4IDY2Mjk3MjZlYzZiNi4u MGY2ZWE4YTdlMGQ3IDEwMDY0NAotLS0gYS9kb2MvcmVmX21ha2VfbWFjcm9zLmluYworKysgYi9k b2MvcmVmX21ha2VfbWFjcm9zLmluYwpAQCAtNjQwLDE0OSArNjQwLDc2IEBAIGJlIGluc3RhbGxl ZCB3aXRoIHNvbWUgb3RoZXIgYGBpbnN0YWxsXypgYCBjb21tYW5kIGJlZm9yZQogICAgCQkkKFBU WENPTkZfVElNRVpPTkVfTE9DQUxUSU1FKSkKIAogLi4gX3BhcmFtX21hY3JvczoKLQogLi4gX3B0 eEVuZGlzOgotCi1wdHgvZW5kaXMKLX5+fn5+fn5+fgotCi1UbyBjb252ZXJ0IHRoZSBzdGF0ZSAo c2V0L3Vuc2V0KSBvZiBhIHZhcmlhYmxlIGludG8gYW4gYGBlbmFibGUvZGlzYWJsZWBgCi1zdHJp bmcgdXNlIHRoZSBgYHB0eC9lbmRpc2BgIG1hY3JvLgotSWYgdGhlIGdpdmVuIDx2YXJpYWJsZT4g aXMgc2V0IHRoaXMgbWFjcm8gZXhwYW5kcyB0bwotdGhlIHN0cmluZyBgYGVuYWJsZWBgLCBpZiB1 bnNldCB0byBgYGRpc2FibGVgYCBpbnN0ZWFkLgotCi1Vc2FnZToKLQotLi4gY29kZS1ibG9jazo6 IG5vbmUKLQotIC0tJChjYWxsIHB0eC9lbmRpcywgPHZhcmlhYmxlPiktPHBhcmFtZXRlcj4KLQot QW4gZXhhbXBsZToKLQotLi4gY29kZS1ibG9jazo6IG1ha2UKLQotIEZPT19DT05GX09QVCArPSAt LSQoY2FsbCBwdHgvZW5kaXMsRk9PX1ZBUklBQkxFKS1zb21ldGhpbmcKLQotRGVwZW5kaW5nIG9u IHRoZSBzdGF0ZSBvZiBGT09fVkFSSUFCTEUgdGhpcyBsaW5lIHJlc3VsdHMgaW50bwotCi0uLiBj b2RlLWJsb2NrOjogbWFrZQotCi0gRk9PX0NPTkZfT1BUICs9IC0tZW5hYmxlLXNvbWV0aGluZyAo aWYgRk9PX1ZBUklBQkxFIGlzIHNldCkKLSBGT09fQ09ORl9PUFQgKz0gLS1kaXNhYmxlLXNvbWV0 aGluZyAoaWYgRk9PX1ZBUklBQkxFIGlzIHVuc2V0KQotCi1SZWZlciA6cmVmOmBwdHhEaXNlbmAg Zm9yIHRoZSBvcHBvc2l0ZSBzdHJpbmcgZXhwYW5zaW9uLgotCiAuLiBfcHR4RGlzZW46CisuLiBf cHR4X3d3bzoKKy4uIF9wdHhfaWZkZWY6CisuLiBfcHR4X3RydWVmYWxzZToKIAotcHR4L2Rpc2Vu Ci1+fn5+fn5+fn4KLQotVG8gY29udmVydCB0aGUgc3RhdGUgKHNldC91bnNldCkgb2YgYSB2YXJp YWJsZSBpbnRvIGEgYGBkaXNhYmxlL2VuYWJsZWBgCi1zdHJpbmcgdXNlIHRoZSBgYHB0eC9kaXNl bmBgIG1hY3JvLgotSWYgdGhlIGdpdmVuIDx2YXJpYWJsZT4gaXMgc2V0IHRoaXMgbWFjcm8gZXhw YW5kcyB0bwotdGhlIHN0cmluZyBgYGRpc2FibGVgYCwgaWYgdW5zZXQgdG8gYGBlbmFibGVgYCBp bnN0ZWFkLgorcHR4L2VuZGlzLCBwdHgvZGlzZW4sIHB0eC93d28sIHB0eC90cnVlZmFsc2UsIHB0 eC9pZmRlZgorfn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+ fn5+fn5+fgogCiBVc2FnZToKIAotLi4gY29kZS1ibG9jazo6IG5vbmUKLQotIC0tJChjYWxsIHB0 eC9kaXNlbiwgPHZhcmlhYmxlPiktPHBhcmFtZXRlcj4KLQotQW4gZXhhbXBsZToKLQogLi4gY29k ZS1ibG9jazo6IG1ha2UKIAotIEZPT19DT05GX09QVCArPSAtLSQoY2FsbCBwdHgvZGlzZW4sRk9P X1ZBUklBQkxFKS1zb21ldGhpbmcKKyAkKGNhbGwgcHR4L2VuZGlzLCBWQVJJQUJMRSkKKyAkKGNh bGwgcHR4L2Rpc2VuLCBWQVJJQUJMRSkKKyAkKGNhbGwgcHR4L3d3bywgVkFSSUFCTEUpCisgJChj YWxsIHB0eC90cnVlZmFsc2UsIFZBUklBQkxFKQorICQoY2FsbCBwdHgvaWZkZWYsIFZBUklBQkxF LCBbZXhwYW5zaW9uLWlmLXRydWVdLCBbZXhwYW5zaW9uLWlmLWZhbHNlXSkKIAotRGVwZW5kaW5n IG9uIHRoZSBzdGF0ZSBvZiBGT09fVkFSSUFCTEUgdGhpcyBsaW5lIHJlc3VsdHMgaW50bworU2V2 ZXJhbCBtYWNyb3MgZXhpc3QgdG8gY29udmVydCB0aGUgc3RhdGUgKHNldC91bnNldCkgb2YgYSB2 YXJpYWJsZSBpbnRvIGEgc3RyaW5nLgorVGhlc2UgYXJlIHVzZWZ1bCBmb3IgYGA8UEtHPl9DT05G X09QVGBgIHZhcmlhYmxlcywgYW5kIGV4cGFuZCBhcyBmb2xsb3dzOgogCi0uLiBjb2RlLWJsb2Nr OjogbWFrZQotCi0gRk9PX0NPTkZfT1BUICs9IC0tZGlzYWJsZS1zb21ldGhpbmcgKGlmIEZPT19W QVJJQUJMRSBpcyBzZXQpCi0gRk9PX0NPTkZfT1BUICs9IC0tZW5hYmxlLXNvbWV0aGluZyAoaWYg Rk9PX1ZBUklBQkxFIGlzIHVuc2V0KQorKy0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKy0t LS0tLS0tLS0tLS0tLS0tLS0tLSsKK3wgTWFjcm8gbmFtZSAgICAgICAgIHwgRXhwYW5zaW9uIGlm IGBgVkFSSUFCTEVgYCBzZXQgfCBFeHBhbnNpb24gaWYgYGBWQVJJQUJMRWBgIHVuc2V0IHwgRXhl bXBsYXJ5IHVzZSBjYXNlICB8CisrPT09PT09PT09PT09PT09PT09PT0rPT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PSs9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0rPT09PT09 PT09PT09PT09PT09PT09KworfCBwdHgvZW5kaXMgICAgICAgICAgfCBgYGVuYWJsZWBgICAgICAg ICAgICAgICAgICAgICB8IGBgZGlzYWJsZWBgICAgICAgICAgICAgICAgICAgICAgfCBhdXRvY29u ZiAgICAgICAgICAgIHwKKystLS0tLS0tLS0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSstLS0tLS0tLS0t LS0tLS0tLS0tLS0rCit8IHB0eC9kaXNlbiAgICAgICAgICB8IGBgZGlzYWJsZWBgICAgICAgICAg ICAgICAgICAgIHwgYGBlbmFibGVgYCAgICAgICAgICAgICAgICAgICAgICB8IGF1dG9jb25mICAg ICAgICAgICAgfAorKy0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0t LS0tLS0tLSsKK3wgcHR4L3d3byAgICAgICAgICAgIHwgYGB3aXRoYGAgICAgICAgICAgICAgICAg ICAgICAgfCBgYHdpdGhvdXRgYCAgICAgICAgICAgICAgICAgICAgIHwgYXV0b2NvbmYgICAgICAg ICAgICB8CisrLS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0tLS0tLS0tLS0tLS0tLS0t LS0tKworfCBwdHgvdHJ1ZWZhbHNlICAgICAgfCBgYHRydWVgYCAgICAgICAgICAgICAgICAgICAg ICB8IGBgZmFsc2VgYCAgICAgICAgICAgICAgICAgICAgICAgfCBtZXNvbiAgICAgICAgICAgICAg IHwKKystLS0tLS0tLS0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t Ky0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSstLS0tLS0tLS0tLS0tLS0tLS0tLS0r Cit8IHB0eC9pZmRlZiAgICAgICAgICB8ICp0aGUgc2Vjb25kIHBhcmFtZXRlciogICAgICAgIHwg KnRoZSB0aGlyZCBwYXJhbWV0ZXIqICAgICAgICAgICB8ICoobXVsdGlwbGUpKiAgICAgICAgfAor Ky0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKIAot UmVmZXIgOnJlZjpgcHR4RW5kaXNgIGZvciB0aGUgb3Bwb3NpdGUgc3RyaW5nIGV4cGFuc2lvbi4K LQotcHR4L3d3bwotfn5+fn5+fgotCi1UbyBjb252ZXJ0IHRoZSBzdGF0ZSAoc2V0L3Vuc2V0KSBv ZiBhIHZhcmlhYmxlIGludG8gYSBgYHdpdGgvd2l0aG91dGBgCi1zdHJpbmcgdXNlIHRoZSBgYHB0 eC93d29gYCBtYWNyby4KLUlmIHRoZSBnaXZlbiA8dmFyaWFibGU+IGlzIHNldCB0aGlzIG1hY3Jv IGV4cGFuZHMgdG8KLXRoZSBzdHJpbmcgYGB3aXRoYGAsIGlmIHVuc2V0IHRvIGBgd2l0aG91dGBg IGluc3RlYWQuCi0KLVVzYWdlOgotCi0uLiBjb2RlLWJsb2NrOjogbm9uZQotCi0gLS0kKGNhbGwg cHR4L3d3bywgPHZhcmlhYmxlPiktPHBhcmFtZXRlcj4KLQotQW4gZXhhbXBsZToKLQotLi4gY29k ZS1ibG9jazo6IG1ha2UKLQotIEZPT19DT05GX09QVCArPSAtLSQoY2FsbCBwdHgvd3dvLEZPT19W QVJJQUJMRSktc29tZXRoaW5nCi0KLURlcGVuZGluZyBvbiB0aGUgc3RhdGUgb2YgRk9PX1ZBUklB QkxFIHRoaXMgbGluZSByZXN1bHRzIGludG8KLQotLi4gY29kZS1ibG9jazo6IG1ha2UKLQotIEZP T19DT05GX09QVCArPSAtLXdpdGgtc29tZXRoaW5nIChpZiBGT09fVkFSSUFCTEUgaXMgc2V0KQot IEZPT19DT05GX09QVCArPSAtLXdpdGhvdXQtc29tZXRoaW5nIChpZiBGT09fVkFSSUFCTEUgaXMg dW5zZXQpCi0KLXB0eC9pZmRlZgotfn5+fn5+fn5+Ci0KLVRvIGNvbnZlcnQgdGhlIHN0YXRlIChz ZXQvdW5zZXQpIG9mIGEgdmFyaWFibGUgaW50byBvbmUgb2YgdHdvIHN0cmluZ3MgdXNlIHRoZQot YGBwdHgvaWZkZWZgYCBtYWNyby4KLUlmIHRoZSBnaXZlbiA8dmFyaWFibGU+IGlzIHNldCB0aGlz IG1hY3JvIGV4cGFuZHMgdG8KLXRoZSBmaXJzdCBnaXZlbiBzdHJpbmcsIGlmIHVuc2V0IHRvIHRo ZSBzZWNvbmQgZ2l2ZW4gc3RyaW5nLgotCi1Vc2FnZToKK1NvbWUgcmVhbC1saWZlIGV4YW1wbGVz OgogCiAuLiBjb2RlLWJsb2NrOjogbWFrZQorIDpsaW5lbm9zOgogCi0gLS13aXRoLXNvbWV0aGlu Zz0kKGNhbGwgcHR4L2lmZGVmLCA8dmFyaWFibGU+LCA8Zmlyc3Qtc3RyaW5nPiwgPHNlY29uZC1z dHJpbmcpCisgQkFTSF9DT05GX09QVCAgICAgICs9IC0tJChjYWxsIHB0eC9lbmRpcywgUFRYQ09O Rl9CQVNIX0RFQlVHR0VSKS1kZWJ1Z2dlcgorIE9QRU5PQ0RfQ09ORl9PUFQgICArPSAtLSQoY2Fs bCBwdHgvZGlzZW4sIFBUWENPTkZfT1BFTk9DRF9QQVJQT1JUX0RJU0FCTEVfUEFSUE9SVF9QUERF ViktcGFycG9ydC1wcGRldgorIENPUkVVVElMU19DT05GX09QVCArPSAtLSQoY2FsbCBwdHgvd3dv LCBQVFhDT05GX0dMT0JBTF9TRUxJTlVYKS1zZWxpbnV4CisgU1lTVEVNRF9DT05GX09QVCAgICs9 IC1EbWljcm9odHRwZD0kKGNhbGwgcHR4L3RydWVmYWxzZSxQVFhDT05GX1NZU1RFTURfTUlDUk9I VFRQRCkKKyBDVVBTX0NPTkZfT1BUICAgICAgKz0gJChjYWxsIHB0eC9pZmRlZixQVFhDT05GX0NV UFNfUEVSTCwtLXdpdGgtcGVybD0vdXNyL2Jpbi9wZXJsLC0td2l0aG91dC1wZXJsKQogCi1BbiBl eGFtcGxlOgorSWYgdGhlIHJlc3BlY3RpdmUgdmFyaWFibGUgaXMgc2V0LCB0aGVzZSBzdGF0ZW1l bnRzIHdvdWxkIGV4cGFuZCB0bzoKIAogLi4gY29kZS1ibG9jazo6IG1ha2UKKyA6bGluZW5vczoK IAotIEZPT19DT05GX09QVCArPSAtLXdpdGgtc29tZXRoaW5nPSQoY2FsbCBwdHgvaWZkZWYsRk9P X1ZBUklBQkxFLC91c3Isbm9uZSkKKyBCQVNIX0NPTkZfT1BUICAgICAgKz0gLS1lbmFibGUtZGVi dWdnZXIKKyBPUEVOT0NEX0NPTkZfT1BUICAgKz0gLS1kaXNhYmxlLXBhcnBvcnQtcHBkZXYKKyBD T1JFVVRJTFNfQ09ORl9PUFQgKz0gLS13aXRoLXNlbGludXgKKyBTWVNURU1EX0NPTkZfT1BUICAg Kz0gLURtaWNyb2h0dHBkPXRydWUKKyBDVVBTX0NPTkZfT1BUICAgICAgKz0gLS13aXRoLXBlcmw9 L3Vzci9iaW4vcGVybAogCi1EZXBlbmRpbmcgb24gdGhlIHN0YXRlIG9mIEZPT19WQVJJQUJMRSB0 aGlzIGxpbmUgcmVzdWx0cyBpbnRvCit3aGVyZWFzIGlmIHRoZSByZXNwZWN0aXZlIHZhcmlhYmxl IGlzIHVuc2V0LCB0aGV5IHdvdWxkIGV4cGFuZCB0byB0aGUgb3Bwb3NpdGU6CiAKIC4uIGNvZGUt YmxvY2s6OiBtYWtlCisgOmxpbmVub3M6CiAKLSBGT09fQ09ORl9PUFQgKz0gLS13aXRoLXNvbWV0 aGluZz0vdXNyIChpZiBGT09fVkFSSUFCTEUgaXMgc2V0KQotIEZPT19DT05GX09QVCArPSAtLXdp dGgtc29tZXRoaW5nPW5vbmUgKGlmIEZPT19WQVJJQUJMRSBpcyB1bnNldCkKKyBCQVNIX0NPTkZf T1BUICAgICAgKz0gLS1kaXNhYmxlLWRlYnVnZ2VyCisgT1BFTk9DRF9DT05GX09QVCAgICs9IC0t ZW5hYmxlLXBhcnBvcnQtcHBkZXYKKyBDT1JFVVRJTFNfQ09ORl9PUFQgKz0gLS13aXRob3V0LXNl bGludXgKIAotcHR4L3RydWVmYWxzZQotfn5+fn5+fn5+fn5+fgotCi1UbyBjb252ZXJ0IHRoZSBz dGF0ZSAoc2V0L3Vuc2V0KSBvZiBhIHZhcmlhYmxlIGludG8gYSBgYHRydWUvZmFsc2VgYAotc3Ry aW5nIHVzZSB0aGUgYGBwdHgvdHJ1ZWZhbHNlYGAgbWFjcm8uCi1JZiB0aGUgZ2l2ZW4gPHZhcmlh YmxlPiBpcyBzZXQgdGhpcyBtYWNybyBleHBhbmRzIHRvCi10aGUgc3RyaW5nIGBgdHJ1ZWBgLCBp ZiB1bnNldCB0byBgYGZhbHNlYGAgaW5zdGVhZC4KLQotVXNhZ2U6Ci0KLS4uIGNvZGUtYmxvY2s6 OiBub25lCi0KLSAtRHdpdGgtc29tZXRoaW5nPSQoY2FsbCBwdHgvdHJ1ZWZhbHNlLDx2YXJpYWJs ZT4pCi0KLUFuIGV4YW1wbGU6Ci0KLS4uIGNvZGUtYmxvY2s6OiBtYWtlCi0KLSBGT09fQ09ORl9P UFQgKz0gLUR3aXRoLXNvbWV0aGluZz0kKGNhbGwgcHR4L3RydWVmYWxzZSw8dmFyaWFibGU+KQot Ci1EZXBlbmRpbmcgb24gdGhlIHN0YXRlIG9mIEZPT19WQVJJQUJMRSB0aGlzIGxpbmUgcmVzdWx0 cyBpbnRvCi0KLS4uIGNvZGUtYmxvY2s6OiBtYWtlCisgU1lTVEVNRF9DT05GX09QVCAgICs9IC1E bWljcm9odHRwZD1mYWxzZQogCi0gRk9PX0NPTkZfT1BUICs9IC1Ed2l0aC1zb21ldGhpbmc9dHJ1 ZSAoaWYgRk9PX1ZBUklBQkxFIGlzIHNldCkKLSBGT09fQ09ORl9PUFQgKz0gLUR3aXRoLXNvbWV0 aGluZz1mYWxzZSAoaWYgRk9PX1ZBUklBQkxFIGlzIHVuc2V0KQorIENVUFNfQ09ORl9PUFQgICAg ICArPSAtLXdpdGhvdXQtcGVybAogCiBwdHgvZ2V0LWFsdGVybmF0aXZlCiB+fn5+fn5+fn5+fn5+ fn5+fn5+Ci0tIAoyLjIwLjEKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpwdHhkaXN0IG1haWxpbmcgbGlzdApwdHhkaXN0QHBlbmd1dHJvbml4LmRl