From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id B0483CA0EC6 for ; Mon, 11 Sep 2023 23:52:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:Cc:To:Subject:Message-ID:Date:From: In-Reply-To:References:MIME-Version:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=iSiTjKY3d75So7rdsohYUuo9UEQMgbKgiaE5L4hnTws=; b=sad2W6y19dkpLA ZyRapfADj+EVrIWjNWljTFZzr4En9ie8H605oKR9KtvG+uCXBnxKmCseqBjvfl0Wf0hEdRzVdEmpM t7F31JKsuSvuguzzWzetIBEVgqwibU5OEzmd4VqFBFn2TmV0ZHDmStFGA9GGsLYeL4CyVebRct7LQ BogWuDXvvd9JvDaMc2M+1/7pG+KzYtottKjNARv8R2B4cjCgGq6I/0wnKrf1QQ4CcS+6lUmVWAWVt c+pSxdsX++x2HntXBqSPsyqoZWT3WFsKvPyDKHeM9VfViKW+kSUT/hjZuiZ5ZQ/zJ7NF2FOuqX3kb NTIFzvU5poO66TeudKdw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1qfqgu-001d9N-1x; Mon, 11 Sep 2023 23:51:40 +0000 Received: from mail-yb1-xb33.google.com ([2607:f8b0:4864:20::b33]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1qfqgs-001d89-0J for linux-arm-kernel@lists.infradead.org; Mon, 11 Sep 2023 23:51:39 +0000 Received: by mail-yb1-xb33.google.com with SMTP id 3f1490d57ef6-d7d50ba994eso4398653276.1 for ; Mon, 11 Sep 2023 16:51:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1694476293; x=1695081093; darn=lists.infradead.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=e9FHti0UeaT45a62FC88dUwVtXoyU66QnGu8MY083Gc=; b=31C0682OcNUqLF6Rihodkwne1Mw02ooKY1VtW/EpXvmbKa/DP4bltAURI6nO18e3BT b0ff9AmEeOP7dDV4H5Kvcmjzj+oBrvaASX9He9SrAXIZirFhFx4x01PolSSEzUUi9XNj MNDT47Hr238gS4h/2fOl+UdnCtH//XV3taWkkGJABcVq9EcXTvySD+EFeiD9nwv0RKva 6A1rJEdcPMEuvnTaMXeVxDycnb9QbAjUAolByMkktFurl+VaqC/x3KcStXgd/t99L9BQ eadA8VC21RCjXWj7Jq1Z6ClrLKgQ1aLZHbOwCpOv/4eDJz33w9lL6+RKiw7Y5m1Y5fG7 GM5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1694476293; x=1695081093; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=e9FHti0UeaT45a62FC88dUwVtXoyU66QnGu8MY083Gc=; b=v/n72vks04ib0hXgjuqFJ4O7aW54pHaB/Rtw427jFv8NfR1pgjfY++8MCR2+9DSGBh 9I2qC/vAgJXWiPKH209pVWr687Z1Q9zHI0nqVRpT2xlVzE/4U29kVtqjuCLO4AHcN8hQ G4naJeKD2DJkHIbC/x7uJap7+0c03c3ot5ZadNN/GYKw8P84iAtJDejtXyvxwKvoKYBd RaQEm1OnJLOvgSKRaDkXBQedRNuEJT+IbSo0Tu3izb3WLSOZ07vqWSna4hZKidZnnyKK KL8ZaDRr6RQEoQ9grobLc9/Mct6mS3Z+uAvdp+Ma+L85qhIzAxdSHM7o2DK6AKIfKf7u 1ZtQ== X-Gm-Message-State: AOJu0YzajMQg0CEI78KPOpCKfYP88Am0UA+6Kw/ASUKi6RHPGvdM26SX 3l88AuXtX6rwuCU28ZLr0+xvSrGfjf9m+GcmbmlYAw== X-Google-Smtp-Source: AGHT+IGFOM/4w9EDJt7MB2VEaaVKgVLAWXiT0CbJ/s1mQvZfpoxvSUlNkizqXQqtn0mkteVDRyeHoSWnwX1ZfV5oYr4= X-Received: by 2002:a25:ce03:0:b0:d09:f934:f2fe with SMTP id x3-20020a25ce03000000b00d09f934f2femr9212180ybe.18.1694476292641; Mon, 11 Sep 2023 16:51:32 -0700 (PDT) MIME-Version: 1.0 References: <20230911023038.30649-1-yong.wu@mediatek.com> <20230911023038.30649-2-yong.wu@mediatek.com> <46532644-a38b-98d5-13a1-8b51b9276a1d@amd.com> In-Reply-To: <46532644-a38b-98d5-13a1-8b51b9276a1d@amd.com> From: "T.J. Mercier" Date: Mon, 11 Sep 2023 16:51:20 -0700 Message-ID: Subject: Re: [PATCH 1/9] dma-buf: heaps: Deduplicate docs and adopt common format To: =?UTF-8?Q?Christian_K=C3=B6nig?= Cc: Yong Wu , Rob Herring , Sumit Semwal , Matthias Brugger , Krzysztof Kozlowski , Conor Dooley , Benjamin Gaignard , Brian Starkey , John Stultz , AngeloGioacchino Del Regno , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, dri-devel@lists.freedesktop.org, linaro-mm-sig@lists.linaro.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, jianjiao.zeng@mediatek.com, kuohong.wang@mediatek.com X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230911_165138_134711_224FF493 X-CRM114-Status: GOOD ( 27.88 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gTW9uLCBTZXAgMTEsIDIwMjMgYXQgMjozNuKAr0FNIENocmlzdGlhbiBLw7ZuaWcKPGNocmlz dGlhbi5rb2VuaWdAYW1kLmNvbT4gd3JvdGU6Cj4KPiBtIDExLjA5LjIzIHVtIDA0OjMwIHNjaHJp ZWIgWW9uZyBXdToKPiA+IEZyb206ICJULkouIE1lcmNpZXIiIDx0am1lcmNpZXJAZ29vZ2xlLmNv bT4KPiA+Cj4gPiBUaGUgZG9jcyBmb3IgZG1hX2hlYXBfZ2V0X25hbWUgd2VyZSBpbmNvcnJlY3Qs IGFuZCBzaW5jZSB0aGV5IHdlcmUKPiA+IGR1cGxpY2F0ZWQgaW4gdGhlIGltcGxlbWVudGF0aW9u IGZpbGUgdGhleSB3ZXJlIHdyb25nIHRoZXJlIHRvby4KPiA+Cj4gPiBUaGUgZG9jcyBmb3JtYXR0 aW5nIHdhcyBpbmNvbnNpc3RlbnQgc28gSSB0cmllZCB0byBtYWtlIGl0IG1vcmUKPiA+IGNvbnNp c3RlbnQgYWNyb3NzIGZ1bmN0aW9ucyBzaW5jZSBJJ20gYWxyZWFkeSBpbiBoZXJlIGRvaW5nIGNs ZWFudXAuCj4gPgo+ID4gUmVtb3ZlIG11bHRpcGxlIHVudXNlZCBpbmNsdWRlcy4KPiA+Cj4gPiBT aWduZWQtb2ZmLWJ5OiBULkouIE1lcmNpZXIgPHRqbWVyY2llckBnb29nbGUuY29tPgo+ID4gU2ln bmVkLW9mZi1ieTogWW9uZyBXdSA8eW9uZy53dUBtZWRpYXRlay5jb20+Cj4gPiBbWW9uZzogSnVz dCBhZGQgYSBjb21tZW50IGZvciAicHJpdiIgdG8gbXV0ZSBidWlsZCB3YXJuaW5nXQo+ID4gLS0t Cj4gPiAgIGRyaXZlcnMvZG1hLWJ1Zi9kbWEtaGVhcC5jIHwgMjkgKysrKysrKy0tLS0tLS0tLS0t LS0tLS0tLS0tLS0KPiA+ICAgaW5jbHVkZS9saW51eC9kbWEtaGVhcC5oICAgfCAxMSArKysrKy0t LS0tLQo+ID4gICAyIGZpbGVzIGNoYW5nZWQsIDEyIGluc2VydGlvbnMoKyksIDI4IGRlbGV0aW9u cygtKQo+ID4KPiA+IGRpZmYgLS1naXQgYS9kcml2ZXJzL2RtYS1idWYvZG1hLWhlYXAuYyBiL2Ry aXZlcnMvZG1hLWJ1Zi9kbWEtaGVhcC5jCj4gPiBpbmRleCA4NGFlNzA4ZmFmZTcuLjUxMDMwZjZj OWQ2ZSAxMDA2NDQKPiA+IC0tLSBhL2RyaXZlcnMvZG1hLWJ1Zi9kbWEtaGVhcC5jCj4gPiArKysg Yi9kcml2ZXJzL2RtYS1idWYvZG1hLWhlYXAuYwo+ID4gQEAgLTcsMTcgKzcsMTUgQEAKPiA+ICAg ICovCj4gPgo+ID4gICAjaW5jbHVkZSA8bGludXgvY2Rldi5oPgo+ID4gLSNpbmNsdWRlIDxsaW51 eC9kZWJ1Z2ZzLmg+Cj4gPiAgICNpbmNsdWRlIDxsaW51eC9kZXZpY2UuaD4KPiA+ICAgI2luY2x1 ZGUgPGxpbnV4L2RtYS1idWYuaD4KPiA+ICsjaW5jbHVkZSA8bGludXgvZG1hLWhlYXAuaD4KPiA+ ICAgI2luY2x1ZGUgPGxpbnV4L2Vyci5oPgo+ID4gLSNpbmNsdWRlIDxsaW51eC94YXJyYXkuaD4K PiA+ICAgI2luY2x1ZGUgPGxpbnV4L2xpc3QuaD4KPiA+IC0jaW5jbHVkZSA8bGludXgvc2xhYi5o Pgo+ID4gICAjaW5jbHVkZSA8bGludXgvbm9zcGVjLmg+Cj4gPiAtI2luY2x1ZGUgPGxpbnV4L3Vh Y2Nlc3MuaD4KPiA+ICAgI2luY2x1ZGUgPGxpbnV4L3N5c2NhbGxzLmg+Cj4gPiAtI2luY2x1ZGUg PGxpbnV4L2RtYS1oZWFwLmg+Cj4gPiArI2luY2x1ZGUgPGxpbnV4L3VhY2Nlc3MuaD4KPiA+ICsj aW5jbHVkZSA8bGludXgveGFycmF5Lmg+Cj4gPiAgICNpbmNsdWRlIDx1YXBpL2xpbnV4L2RtYS1o ZWFwLmg+Cj4gPgo+ID4gICAjZGVmaW5lIERFVk5BTUUgImRtYV9oZWFwIgo+ID4gQEAgLTI4LDkg KzI2LDEwIEBACj4gPiAgICAqIHN0cnVjdCBkbWFfaGVhcCAtIHJlcHJlc2VudHMgYSBkbWFidWYg aGVhcCBpbiB0aGUgc3lzdGVtCj4gPiAgICAqIEBuYW1lOiAgICAgICAgICAgdXNlZCBmb3IgZGVi dWdnaW5nL2RldmljZS1ub2RlIG5hbWUKPiA+ICAgICogQG9wczogICAgICAgICAgICBvcHMgc3Ry dWN0IGZvciB0aGlzIGhlYXAKPiA+IC0gKiBAaGVhcF9kZXZ0ICAgICAgICAgICAgICAgIGhlYXAg ZGV2aWNlIG5vZGUKPiA+IC0gKiBAbGlzdCAgICAgICAgICAgICBsaXN0IGhlYWQgY29ubmVjdGlu ZyB0byBsaXN0IG9mIGhlYXBzCj4gPiAtICogQGhlYXBfY2RldiAgICAgICAgICAgICAgICBoZWFw IGNoYXIgZGV2aWNlCj4gPiArICogQHByaXY6ICAgICAgICAgICAgcHJpdmF0ZSBkYXRhIGZvciB0 aGlzIGhlYXAKPiA+ICsgKiBAaGVhcF9kZXZ0OiAgICAgICAgICAgICAgIGhlYXAgZGV2aWNlIG5v ZGUKPiA+ICsgKiBAbGlzdDogICAgICAgICAgICBsaXN0IGhlYWQgY29ubmVjdGluZyB0byBsaXN0 IG9mIGhlYXBzCj4gPiArICogQGhlYXBfY2RldjogICAgICAgICAgICAgICBoZWFwIGNoYXIgZGV2 aWNlCj4gPiAgICAqCj4gPiAgICAqIFJlcHJlc2VudHMgYSBoZWFwIG9mIG1lbW9yeSBmcm9tIHdo aWNoIGJ1ZmZlcnMgY2FuIGJlIG1hZGUuCj4gPiAgICAqLwo+ID4gQEAgLTE5MiwyNSArMTkxLDEx IEBAIHN0YXRpYyBjb25zdCBzdHJ1Y3QgZmlsZV9vcGVyYXRpb25zIGRtYV9oZWFwX2ZvcHMgPSB7 Cj4gPiAgICNlbmRpZgo+ID4gICB9Owo+ID4KPiA+IC0vKioKPiA+IC0gKiBkbWFfaGVhcF9nZXRf ZHJ2ZGF0YSgpIC0gZ2V0IHBlci1zdWJkcml2ZXIgZGF0YSBmb3IgdGhlIGhlYXAKPiA+IC0gKiBA aGVhcDogRE1BLUhlYXAgdG8gcmV0cmlldmUgcHJpdmF0ZSBkYXRhIGZvcgo+ID4gLSAqCj4gPiAt ICogUmV0dXJuczoKPiA+IC0gKiBUaGUgcGVyLXN1YmRyaXZlciBkYXRhIGZvciB0aGUgaGVhcC4K PiA+IC0gKi8KPgo+IEtlcm5lbCBkb2N1bWVudGF0aW9uIGlzIHVzdWFsbHkga2VwdCBvbiB0aGUg aW1wbGVtZW50YXRpb24gYW5kIG5vdCB0aGUKPiBkZWZpbml0aW9uLgo+Cj4gU28gSSBzdHJvbmds eSBzdWdnZXN0IHRvIHJlbW92ZSB0aGUgZG9jdW1lbnRhdGlvbiBmcm9tIHRoZSBoZWFkZXIKPiBp bnN0ZWFkIGFuZCBpZiB0aGVyZSBpcyBhbnkgYWRkaXRpb25hbCBpbmZvcm1hdGlvbiBpbiB0aGVy ZSBhZGQgaXQgaGVyZS4KPgo+IFJlZ2FyZHMsCj4gQ2hyaXN0aWFuLgo+Ck9rIHRoYW5rcyBmb3Ig bG9va2luZy4gSSdsbCBtb3ZlIGFsbCB0aGUgZnVuY3Rpb24gZG9jcyBvdmVyIHRvIHRoZQppbXBs ZW1lbnRhdGlvbi4KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fCmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMu aW5mcmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZv L2xpbnV4LWFybS1rZXJuZWwK