On Wed, Mar 5, 2014 at 11:56 AM, <sagar.a.kamble@xxxxxxxxx> wrote: > +<table border="1" cellpadding="0" cellspacing="0" > > +<tbody> > +<tr style="font-weight: bold;" > > +<td valign="top" >Owner Module/Drivers</td> > +<td valign="top" >Group</td> > +<td valign="top" >Property Object</td> > +<td valign="top" >Property Name</td> > +<td valign="top" >Type</td> > +<td valign="top" >Property Values</td> > +<td valign="top" >Object attached</td> > +<td valign="top" >Description</td> > +</tr> 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. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
