Re: [PATCH 3/3] ubifs: ubifs.h: clean up kernel-doc comments
Zhihao Cheng <[email protected]> Thu, 30 Jul 2026 09:25:50 +0800
| Newsgroups | org.infradead.lists.linux-mtd,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
1NogMjAyNi83LzMwIDE6MjAsIFJhbmR5IER1bmxhcCDQtLXAOgo+IC0gdXNlIHRoZSBzdHJ1Y3Qg a2V5d29yZCB3aGVuIGRlc2NyaWJpbmcgYSBzdHJ1Y3QgaW4ga2VybmVsLWRvYyBmb3JtYXQuCj4g LSBhZGQgb3IgY29ycmVjdCBtaXNzaW5nIHN0cnVjdCBtZW1iZXJzIEBsZWFmLCBAZW9mLCBhbmQK PiAgICBAc3VwZXJibG9ja19uZWVkX3dyaXRlLgo+IC0gYWRkIFJldHVybnM6IGNsYXVzZXMgZm9y IDQgZnVuY3Rpb24gZGVzY3JpcHRpb25zLgo+IAo+IHRvIHByZXZlbnQga2VybmVsLWRvYyB3YXJu aW5nczoKPiAKPiBXYXJuaW5nOiBmcy91Ymlmcy91Ymlmcy5oOjc1NSBzdHJ1Y3QgbWVtYmVyICds ZWFmJyBub3QgZGVzY3JpYmVkIGluICd1Ymlmc196YnJhbmNoJwo+IFdhcm5pbmc6IGZzL3ViaWZz L3ViaWZzLmg6ODE0IHN0cnVjdCBtZW1iZXIgJ2VvZicgbm90IGRlc2NyaWJlZCBpbiAnYnVfaW5m bycKPiBXYXJuaW5nOiBmcy91Ymlmcy91Ymlmcy5oOjgxNCBFeGNlc3Mgc3RydWN0IG1lbWJlciAn b2VmJyBkZXNjcmlwdGlvbiBpbiAnYnVfaW5mbycKPiBXYXJuaW5nOiBmcy91Ymlmcy91Ymlmcy5o Ojk5MiBjYW5ub3QgdW5kZXJzdGFuZCBmdW5jdGlvbiBwcm90b3R5cGU6ICdzdHJ1Y3QgdWJpZnNf c3RhdHNfaW5mbycKPiBXYXJuaW5nOiBmcy91Ymlmcy91Ymlmcy5oOjE1MTMgc3RydWN0IG1lbWJl ciAnc3VwZXJibG9ja19uZWVkX3dyaXRlJyBub3QgZGVzY3JpYmVkIGluICd1Ymlmc19pbmZvJwo+ IFdhcm5pbmc6IGZzL3ViaWZzL3ViaWZzLmg6MTU5NyBObyBkZXNjcmlwdGlvbiBmb3VuZCBmb3Ig cmV0dXJuIHZhbHVlIG9mICd1Ymlmc19jaGVja19oYXNoJwo+IFdhcm5pbmc6IGZzL3ViaWZzL3Vi aWZzLmg6MTYxMiBObyBkZXNjcmlwdGlvbiBmb3VuZCBmb3IgcmV0dXJuIHZhbHVlIG9mICd1Ymlm c19jaGVja19obWFjJwo+IFdhcm5pbmc6IGZzL3ViaWZzL3ViaWZzLmg6MTY1MyBObyBkZXNjcmlw dGlvbiBmb3VuZCBmb3IgcmV0dXJuIHZhbHVlIG9mICd1Ymlmc19icmFuY2hfaGFzaCcKPiBXYXJu aW5nOiBmcy91Ymlmcy91Ymlmcy5oOjE3MDMgTm8gZGVzY3JpcHRpb24gZm91bmQgZm9yIHJldHVy biB2YWx1ZSBvZiAndWJpZnNfYXV0aF9ub2RlX3N6Jwo+IAo+IFNpZ25lZC1vZmYtYnk6IFJhbmR5 IER1bmxhcCA8cmR1bmxhcEBpbmZyYWRlYWQub3JnPgo+IC0tLQo+IENjOiBSaWNoYXJkIFdlaW5i ZXJnZXIgPHJpY2hhcmRAbm9kLmF0Pgo+IENjOiBaaGloYW8gQ2hlbmcgPGNoZW5nemhpaGFvMUBo dWF3ZWkuY29tPgo+IENjOiBsaW51eC1tdGRAbGlzdHMuaW5mcmFkZWFkLm9yZwo+IAo+ICAgZnMv dWJpZnMvdWJpZnMuaCB8ICAgMjAgKysrKysrKysrKysrLS0tLS0tLS0KPiAgIDEgZmlsZSBjaGFu Z2VkLCAxMiBpbnNlcnRpb25zKCspLCA4IGRlbGV0aW9ucygtKQo+IAo+IC0tLSBsaW51eC1uZXh0 LTIwMjYwNzI5Lm9yaWcvZnMvdWJpZnMvdWJpZnMuaAo+ICsrKyBsaW51eC1uZXh0LTIwMjYwNzI5 L2ZzL3ViaWZzL3ViaWZzLmgKPiBAQCAtNzM4LDYgKzczOCw3IEBAIHN0cnVjdCB1Ymlmc19qaGVh ZCB7Cj4gICAgKiBzdHJ1Y3QgdWJpZnNfemJyYW5jaCAtIGtleS9jb29yZGluYXRlL2xlbmd0aCBi cmFuY2ggc3RvcmVkIGluIHpub2Rlcy4KPiAgICAqIEBrZXk6IGtleQo+ICAgICogQHpub2RlOiB6 bm9kZSBhZGRyZXNzIGluIG1lbW9yeQo+ICsgKiBAbGVhZjogbGVhZiBub2RlCj4gICAgKiBAbG51 bTogTEVCIG51bWJlciBvZiB0aGUgdGFyZ2V0IG5vZGUgKGluZGV4aW5nIG5vZGUgb3IgZGF0YSBu b2RlKQo+ICAgICogQG9mZnM6IHRhcmdldCBub2RlIG9mZnNldCB3aXRoaW4gQGxudW0KPiAgICAq IEBsZW46IHRhcmdldCBub2RlIGxlbmd0aAo+IEBAIC04MDEsNyArODAyLDcgQEAgc3RydWN0IHVi aWZzX3pub2RlIHsKPiAgICAqIEBnY19zZXE6IEdDIHNlcXVlbmNlIG51bWJlciB0byBkZXRlY3Qg cmFjZXMgd2l0aCBHQwo+ICAgICogQGNudDogbnVtYmVyIG9mIGRhdGEgbm9kZXMgZm9yIGJ1bGsg cmVhZAo+ICAgICogQGJsa19jbnQ6IG51bWJlciBvZiBkYXRhIGJsb2NrcyBpbmNsdWRpbmcgaG9s ZXMKPiAtICogQG9lZjogZW5kIG9mIGZpbGUgcmVhY2hlZAo+ICsgKiBAZW9mOiBlbmQgb2YgZmls ZSByZWFjaGVkCgpSZXZpZXdlZC1ieTogWmhpaGFvIENoZW5nIDxjaGVuZ3poaWhhbzFAaHVhd2Vp LmNvbT4KPiAgICAqLwo+ICAgc3RydWN0IGJ1X2luZm8gewo+ICAgCXVuaW9uIHViaWZzX2tleSBr ZXk7Cj4gQEAgLTk4NSw3ICs5ODYsNyBAQCBzdHJ1Y3QgdWJpZnNfYnVkZ19pbmZvIHsKPiAgIH07 Cj4gICAKPiAgIC8qKgo+IC0gKiB1Ymlmc19zdGF0c19pbmZvIC0gcGVyLUZTIHN0YXRpc3RpY3Mg aW5mb3JtYXRpb24uCj4gKyAqIHN0cnVjdCB1Ymlmc19zdGF0c19pbmZvIC0gcGVyLUZTIHN0YXRp c3RpY3MgaW5mb3JtYXRpb24uCj4gICAgKiBAbWFnaWNfZXJyb3JzOiBudW1iZXIgb2YgYmFkIG1h Z2ljIG51bWJlcnMgKHdpbGwgYmUgcmVzZXQgd2l0aCBhIG5ldyBtb3VudCkuCj4gICAgKiBAbm9k ZV9lcnJvcnM6IG51bWJlciBvZiBiYWQgbm9kZXMgKHdpbGwgYmUgcmVzZXQgd2l0aCBhIG5ldyBt b3VudCkuCj4gICAgKiBAY3JjX2Vycm9yczogbnVtYmVyIG9mIGJhZCBjcmNzICh3aWxsIGJlIHJl c2V0IHdpdGggYSBuZXcgbW91bnQpLgo+IEBAIC0xMDUxLDYgKzEwNTIsNyBAQCBzdHJ1Y3QgdWJp ZnNfZGVidWdfaW5mbzsKPiAgICAqIEByd19pbmNvbXBhdDogdGhlIG1lZGlhIGlzIG5vdCBSL1cg Y29tcGF0aWJsZQo+ICAgICogQGFzc2VydF9hY3Rpb246IGFjdGlvbiB0byB0YWtlIHdoZW4gYSB1 Ymlmc19hc3NlcnQoKSBmYWlscwo+ICAgICogQGF1dGhlbnRpY2F0ZWQ6IGZsYWcgaW5kaWdhdGlu ZyB0aGUgRlMgaXMgbW91bnRlZCBpbiBhdXRoZW50aWNhdGVkIG1vZGUKPiArICogQHN1cGVyYmxv Y2tfbmVlZF93cml0ZTogc3VwZXJibG9jayBub2RlIG5lZWRzIHRvIGJlIHdyaXR0ZW4KPiAgICAq Cj4gICAgKiBAdG5jX211dGV4OiBwcm90ZWN0cyB0aGUgVHJlZSBOb2RlIENhY2hlIChUTkMpLCBA enJvb3QsIEBjbmV4dCwgQGVuZXh0LCBhbmQKPiAgICAqICAgICAgICAgICAgIEBjYWxjX2lkeF9z ego+IEBAIC0xNTg4LDggKzE1OTAsOSBAQCBpbnQgdWJpZnNfcHJlcGFyZV9hdXRoX25vZGUoc3Ry dWN0IHViaWZzCj4gICAgKiBAZXhwZWN0ZWQ6IGZpcnN0IGhhc2gKPiAgICAqIEBnb3Q6IHNlY29u ZCBoYXNoCj4gICAgKgo+IC0gKiBDb21wYXJlIHR3byBoYXNoZXMgQGV4cGVjdGVkIGFuZCBAZ290 LiBSZXR1cm5zIDAgd2hlbiB0aGV5IGFyZSBlcXVhbCwgYQo+IC0gKiBuZWdhdGl2ZSBlcnJvciBj b2RlIG90aGVyd2lzZS4KPiArICogQ29tcGFyZSB0d28gaGFzaGVzIEBleHBlY3RlZCBhbmQgQGdv dC4KPiArICoKPiArICogUmV0dXJuczogMCB3aGVuIHRoZXkgYXJlIGVxdWFsLCBhIG5lZ2F0aXZl IGVycm9yIGNvZGUgb3RoZXJ3aXNlLgo+ICAgICovCj4gICBzdGF0aWMgaW5saW5lIGludCB1Ymlm c19jaGVja19oYXNoKGNvbnN0IHN0cnVjdCB1Ymlmc19pbmZvICpjLAo+ICAgCQkJCSAgIGNvbnN0 IHU4ICpleHBlY3RlZCwgY29uc3QgdTggKmdvdCkKPiBAQCAtMTYwMyw4ICsxNjA2LDkgQEAgc3Rh dGljIGlubGluZSBpbnQgdWJpZnNfY2hlY2tfaGFzaChjb25zdAo+ICAgICogQGV4cGVjdGVkOiBm aXJzdCBITUFDCj4gICAgKiBAZ290OiBzZWNvbmQgSE1BQwo+ICAgICoKPiAtICogQ29tcGFyZSB0 d28gaGFzaGVzIEBleHBlY3RlZCBhbmQgQGdvdC4gUmV0dXJucyAwIHdoZW4gdGhleSBhcmUgZXF1 YWwsIGEKPiAtICogbmVnYXRpdmUgZXJyb3IgY29kZSBvdGhlcndpc2UuCj4gKyAqIENvbXBhcmUg dHdvIGhhc2hlcyBAZXhwZWN0ZWQgYW5kIEBnb3QuCj4gKyAqCj4gKyAqIFJldHVybnM6IDAgd2hl biB0aGV5IGFyZSBlcXVhbCwgYSBuZWdhdGl2ZSBlcnJvciBjb2RlIG90aGVyd2lzZS4KPiAgICAq Lwo+ICAgc3RhdGljIGlubGluZSBpbnQgdWJpZnNfY2hlY2tfaG1hYyhjb25zdCBzdHJ1Y3QgdWJp ZnNfaW5mbyAqYywKPiAgIAkJCQkgICBjb25zdCB1OCAqZXhwZWN0ZWQsIGNvbnN0IHU4ICpnb3Qp Cj4gQEAgLTE2NDQsNyArMTY0OCw3IEBAIHN0YXRpYyBpbmxpbmUgdm9pZCB1Ymlmc19leGl0X2F1 dGhlbnRpY2EKPiAgICAqIEBjOiBVQklGUyBmaWxlLXN5c3RlbSBkZXNjcmlwdGlvbiBvYmplY3QK PiAgICAqIEBicjogYnJhbmNoIHRvIGdldCB0aGUgaGFzaCBmcm9tCj4gICAgKgo+IC0gKiBUaGlz IHJldHVybnMgYSBwb2ludGVyIHRvIHRoZSBoYXNoIG9mIGEgYnJhbmNoLiBTaW5jZSB0aGUga2V5 IGFscmVhZHkgaXMgYQo+ICsgKiBSZXR1cm5zOiBhIHBvaW50ZXIgdG8gdGhlIGhhc2ggb2YgYSBi cmFuY2guIFNpbmNlIHRoZSBrZXkgYWxyZWFkeSBpcyBhCj4gICAgKiBkeW5hbWljYWxseSBzaXpl ZCBvYmplY3Qgd2UgY2Fubm90IHVzZSBhIHN0cnVjdCBtZW1iZXIgaGVyZS4KPiAgICAqLwo+ICAg c3RhdGljIGlubGluZSB1OCAqdWJpZnNfYnJhbmNoX2hhc2goc3RydWN0IHViaWZzX2luZm8gKmMs Cj4gQEAgLTE2OTQsNyArMTY5OCw3IEBAIHN0YXRpYyBpbmxpbmUgaW50IHViaWZzX25vZGVfdmVy aWZ5X2htYWMKPiAgICAqIHViaWZzX2F1dGhfbm9kZV9zeiAtIHJldHVybnMgdGhlIHNpemUgb2Yg YW4gYXV0aGVudGljYXRpb24gbm9kZQo+ICAgICogQGM6IFVCSUZTIGZpbGUtc3lzdGVtIGRlc2Ny aXB0aW9uIG9iamVjdAo+ICAgICoKPiAtICogVGhpcyBmdW5jdGlvbiByZXR1cm5zIHRoZSBzaXpl IG9mIGFuIGF1dGhlbnRpY2F0aW9uIG5vZGUgd2hpY2ggY2FuCj4gKyAqIFJldHVybnM6IHRoZSBz aXplIG9mIGFuIGF1dGhlbnRpY2F0aW9uIG5vZGUgd2hpY2ggY2FuCj4gICAgKiBiZSAwIGZvciB1 bmF1dGhlbnRpY2F0ZWQgZmlsZXN5c3RlbXMgb3IgdGhlIHJlYWwgc2l6ZSBvZiBhbiBhdXRoIG5v ZGUKPiAgICAqIGF1dGhlbnRpY2F0aW9uIGlzIGVuYWJsZWQuCj4gICAgKi8KPiAuCj4gCgoKX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCkxpbnV4 IE1URCBkaXNjdXNzaW9uIG1haWxpbmcgbGlzdApodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9t YWlsbWFuL2xpc3RpbmZvL2xpbnV4LW10ZC8K