From: Sagar Arun Kamble Subject: Re: [PATCH 1/1] Documentation: drm: describing drm properties exposed by various drivers Date: Wed, 12 Mar 2014 16:46:05 +0530 Message-ID: <1394622965.18918.12.camel@sagar-desktop> References: <1394016990-5218-1-git-send-email-sagar.a.kamble@intel.com> <2919182.UBDg5nOr7Z@avalon> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by gabe.freedesktop.org (Postfix) with ESMTP id 345BBFAE29 for ; Wed, 12 Mar 2014 04:15:20 -0700 (PDT) In-Reply-To: <2919182.UBDg5nOr7Z@avalon> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: intel-gfx-bounces@lists.freedesktop.org Errors-To: intel-gfx-bounces@lists.freedesktop.org To: Laurent Pinchart Cc: Laurent Pinchart , linux-doc@vger.kernel.org, Daniel Vetter , intel-gfx , Rob Landley , David Herrmann , Alex Deucher , Dave Airlie List-Id: intel-gfx@lists.freedesktop.org Hi Laurent, Daniel On Mon, 2014-03-10 at 15:36 +0100, Laurent Pinchart wrote: > Hi Daniel, > > On Monday 10 March 2014 06:21:49 Daniel Vetter wrote: > > On Wed, Mar 5, 2014 at 11:56 AM, wrote: > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > + > > > > In my opinion this is a horrible way to write property documentations > > - explicitly constructing html tables is error prone and really hard > > to read in the source. Imo docbook in general is rather horrible, > > which is way I write almost all my docs as kerneldoc ;-) > > > > I think a simple asciidoc/markdown would be much simpler, with a bit > > of free-form structure to group properties into relevant groups. > > Long-term we might even need to split it up into different spec files > > to keep a good overview. > > Docbook is indeed hard to read and write when it comes to such tables. However > I like having the properties documented in the DRM core documentation. Maybe > we could come up with a simpler text format that would be transformed into > docbook when compiling the documentation ? Does this mean we need to create comment block with "Doc: drm properties" style section in each driver where drm properties are instantiated. And then in drm.tmpl collect all these using !P escape sequence? How do create table out of these across all drivers?
Owner Module/DriversGroupProperty ObjectProperty NameTypeProperty ValuesObject attachedDescription