From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752506AbcGASro (ORCPT ); Fri, 1 Jul 2016 14:47:44 -0400 Received: from mga03.intel.com ([134.134.136.65]:23999 "EHLO mga03.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751426AbcGASrS (ORCPT ); Fri, 1 Jul 2016 14:47:18 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.26,558,1459839600"; d="scan'208";a="998943270" From: Jani Nikula To: Mauro Carvalho Chehab Cc: Markus Heiser , Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, hverkuil@xs4all.nl, daniel.vetter@ffwll.ch, airlied@gmail.com, grant.likely@secretlab.ca, rdunlap@infradead.org, keithp@keithp.com Subject: Re: [PATCH] doc: flat-table directive In-Reply-To: <20160701151731.28c78794@recife.lan> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <1467288022-10496-1-git-send-email-markus.heiser@darmarIT.de> <20160630130511.34b732e6@lwn.net> <20160630164420.4e3908de@recife.lan> <20160701063857.674bde86@recife.lan> <87shvtpri6.fsf@intel.com> <20160701065821.59196b28@lwn.net> <87y45lqnj3.fsf@intel.com> <20160701151731.28c78794@recife.lan> User-Agent: Notmuch/0.22+51~gcc1a6d2 (https://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Fri, 01 Jul 2016 21:47:01 +0300 Message-ID: <87shvtqjq2.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 01 Jul 2016, Mauro Carvalho Chehab wrote: > Em Fri, 01 Jul 2016 20:24:48 +0300 > Jani Nikula escreveu: >> The current media DocBook docs are a prime example. There are really >> great features there, but IMHO done in a really complicated way and >> specifically for media documentation (sorry Mauro). > > My view is just the reverse of yours: the non-media documentation is > too simple, and has lots of gaps ;) Heh, can't argue with that. > We're doing a real hard work to keep it updated over the last 10 > years, and we just don't want to throw it away and do a fresh > start. Whatever we do, we should not lost documentation nor lost > the scripts that have been working so well to enforce the docs > to keep updated as we touch on the code. I hear you. I just want to make it work nicely for everybody. Including media docs. BR, Jani. -- Jani Nikula, Intel Open Source Technology Center