From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jani Nikula Subject: Re: [RFC 3/4] Documentation: move dma-buf documentation to rst Date: Thu, 11 Aug 2016 14:47:26 +0300 Message-ID: <87twerv86p.fsf@intel.com> References: <1470912480-32304-1-git-send-email-sumit.semwal@linaro.org> <1470912480-32304-4-git-send-email-sumit.semwal@linaro.org> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by gabe.freedesktop.org (Postfix) with ESMTP id C58D46E890 for ; Thu, 11 Aug 2016 11:47:28 +0000 (UTC) In-Reply-To: <1470912480-32304-4-git-send-email-sumit.semwal@linaro.org> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Sumit Semwal , linux-media@vger.kernel.org, dri-devel@lists.freedesktop.org, linaro-mm-sig@lists.linaro.org, linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, corbet@lwn.net List-Id: dri-devel@lists.freedesktop.org T24gVGh1LCAxMSBBdWcgMjAxNiwgU3VtaXQgU2Vtd2FsIDxzdW1pdC5zZW13YWxAbGluYXJvLm9y Zz4gd3JvdGU6Cj4gZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZG1hLWJ1Zi9ndWlkZS5yc3Qg Yi9Eb2N1bWVudGF0aW9uL2RtYS1idWYvZ3VpZGUucnN0Cj4gbmV3IGZpbGUgbW9kZSAxMDA2NDQK PiBpbmRleCAwMDAwMDAwMDAwMDAuLmZkMzUzNGZkY2NiMwo+IC0tLSAvZGV2L251bGwKPiArKysg Yi9Eb2N1bWVudGF0aW9uL2RtYS1idWYvZ3VpZGUucnN0Cj4gQEAgLTAsMCArMSw1MDMgQEAKPiAr Cj4gKy4uIF9kbWEtYnVmLWd1aWRlOgo+ICsKPiArPT09PT09PT09PT09PT09PT09PT09PT09PT09 PQo+ICtETUEgQnVmZmVyIFNoYXJpbmcgQVBJIEd1aWRlCj4gKz09PT09PT09PT09PT09PT09PT09 PT09PT09PT0KPiArCj4gK1N1bWl0IFNlbXdhbCAtIHN1bWl0LnNlbXdhbEBsaW5hcm8ub3JnLCBz dW1pdHNAa2VybmVsLm9yZwoKUGxlYXNlIHVzZSB0aGUgZm9ybWF0Cgo6YXV0aG9yOiBTdW1pdCBT ZW13YWwgPHN1bWl0LnNlbXdhbEBsaW5hcm8ub3JnPgoKLS0tCgpXaGlsZSBvbiB0aGlzIHN1Ympl Y3QsIHBsZWFzZSBleGN1c2UgbWUgZm9yIGhpamFja2luZyB0aGUgdGhyZWFkIGEgYml0LgoKUGVy c29uYWxseSwgSSBiZWxpZXZlIGl0IHdvdWxkIGJlIGJldHRlciB0byBsZWF2ZSBvdXQgYXV0aG9y c2hpcCBub3Rlcwpmcm9tIGRvY3VtZW50YXRpb24gYW5kIHNvdXJjZSBmaWxlcyBpbiBjb2xsYWJv cmF0aXZlIHByb2plY3RzLiBPZgpjb3Vyc2UsIGl0IGlzIG9ubHkgZmFpciB0aGF0IHBlb3BsZSB3 aG8gZGVzZXJ2ZSBjcmVkaXQgZ2V0IHRoZQpjcmVkaXQuIExpc3RpbmcgdGhlIGF1dGhvcnMgaW4g dGhlIGZpbGUgaXMgb2Z0ZW4gdGhlIG5hdHVyYWwgdGhpbmcgdG8KZG8sIGFuZCBzdXBlcmZpY2lh bGx5IHNlZW1zIGZhaXIuCgpIb3dldmVyLCB3aGVuIGRvIHlvdSBhZGQgbW9yZSBuYW1lcyB0byB0 aGUgbGlzdD8gV2hlbiBoYXMgc29tZW9uZQpjb250cmlidXRlZCBlbm91Z2ggdG8gd2FycmFudCB0 aGF0PyBJcyBpdCBmYWlyIHRoYXQgdGhlIG9yaWdpbmFsIGF1dGhvcnMKa2VlcCBnZXR0aW5nIHRo ZSBjcmVkaXQgZm9yIHRoZSBjb250cmlidXRpb25zIG9mIG90aGVycz8gQWZ0ZXIgYSB3aGlsZSwK cGVyaGFwcyB0aGVyZSBpcyBuZXh0IHRvIG5vdGhpbmcgbGVmdCBvZiB0aGUgb3JpZ2luYWwgY29u dHJpYnV0aW9ucywgYnV0CnRoZSBiYXIgaXMgcmVhbGx5IGhpZ2ggZm9yIHJlbW92aW5nIGFueW9u ZSBmcm9tIHRoZSBhdXRob3JzLiBMaXN0aW5nIHRoZQphdXRob3JzIGdpdmVzIHRoZSBpbXByZXNz aW9uIHRoaXMgaXMgKnRoZWlyKiBmaWxlLCB3aGlsZSBldmVyeW9uZSBzaG91bGQKZmVlbCB3ZWxj b21lIHRvIGNvbnRyaWJ1dGUsIGFuZCBldmVyeW9uZSB3aG8gY29udHJpYnV0ZXMgc2hvdWxkIGZl ZWwKb3duZXJzaGlwLgoKSU1ITyB3ZSB3b3VsZCBiZSBiZXR0ZXIgb2ZmIHVzaW5nIGp1c3QgdGhl IGdpdCBoaXN0b3J5IGZvciB0aGUgY3JlZGl0cy4KCgpCUiwKSmFuaS4KCgpQUy4gSSBhbSBubyBz YWludCBoZXJlLCBJJ3ZlIGdvdCBhIGNvdXBsZSBvZiBhdXRob3JzIGxpbmVzIG15c2VsZi4gSQpw cm9taXNlIG5vdCB0byBhZGQgbW9yZS4gSSBjZXJ0YWlubHkgd29uJ3QgY2hhc3Rpc2UgYW55b25l IGZvciBhZGRpbmcKdGhlaXJzLgoKCi0tIApKYW5pIE5pa3VsYSwgSW50ZWwgT3BlbiBTb3VyY2Ug VGVjaG5vbG9neSBDZW50ZXIKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0 b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJp LWRldmVsCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from mga03.intel.com ([134.134.136.65]:43095 "EHLO mga03.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932236AbcHKLr3 (ORCPT ); Thu, 11 Aug 2016 07:47:29 -0400 From: Jani Nikula To: Sumit Semwal , linux-media@vger.kernel.org, dri-devel@lists.freedesktop.org, linaro-mm-sig@lists.linaro.org, linux-doc@vger.kernel.org Cc: linux-kernel@vger.kernel.org, corbet@lwn.net Subject: Re: [RFC 3/4] Documentation: move dma-buf documentation to rst In-Reply-To: <1470912480-32304-4-git-send-email-sumit.semwal@linaro.org> References: <1470912480-32304-1-git-send-email-sumit.semwal@linaro.org> <1470912480-32304-4-git-send-email-sumit.semwal@linaro.org> Date: Thu, 11 Aug 2016 14:47:26 +0300 Message-ID: <87twerv86p.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-media-owner@vger.kernel.org List-ID: On Thu, 11 Aug 2016, Sumit Semwal wrote: > diff --git a/Documentation/dma-buf/guide.rst b/Documentation/dma-buf/guide.rst > new file mode 100644 > index 000000000000..fd3534fdccb3 > --- /dev/null > +++ b/Documentation/dma-buf/guide.rst > @@ -0,0 +1,503 @@ > + > +.. _dma-buf-guide: > + > +============================ > +DMA Buffer Sharing API Guide > +============================ > + > +Sumit Semwal - sumit.semwal@linaro.org, sumits@kernel.org Please use the format :author: Sumit Semwal --- While on this subject, please excuse me for hijacking the thread a bit. Personally, I believe it would be better to leave out authorship notes from documentation and source files in collaborative projects. Of course, it is only fair that people who deserve credit get the credit. Listing the authors in the file is often the natural thing to do, and superficially seems fair. However, when do you add more names to the list? When has someone contributed enough to warrant that? Is it fair that the original authors keep getting the credit for the contributions of others? After a while, perhaps there is next to nothing left of the original contributions, but the bar is really high for removing anyone from the authors. Listing the authors gives the impression this is *their* file, while everyone should feel welcome to contribute, and everyone who contributes should feel ownership. IMHO we would be better off using just the git history for the credits. BR, Jani. PS. I am no saint here, I've got a couple of authors lines myself. I promise not to add more. I certainly won't chastise anyone for adding theirs. -- Jani Nikula, Intel Open Source Technology Center