From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <daniel.vetter@ffwll.ch>
Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org
	[172.17.192.35])
	by mail.linuxfoundation.org (Postfix) with ESMTPS id 28F3683D
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Tue,  4 Aug 2015 10:59:15 +0000 (UTC)
Received: from mail-oi0-f46.google.com (mail-oi0-f46.google.com
	[209.85.218.46])
	by smtp1.linuxfoundation.org (Postfix) with ESMTPS id A762C13D
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Tue,  4 Aug 2015 10:59:14 +0000 (UTC)
Received: by oizz185 with SMTP id z185so3002765oiz.0
	for <ksummit-discuss@lists.linuxfoundation.org>;
	Tue, 04 Aug 2015 03:59:14 -0700 (PDT)
MIME-Version: 1.0
In-Reply-To: <20150803204505.GF38878@dtor-ws>
References: <20150801164142.653012af@lwn.net>
	<1438499234.2249.122.camel@stgolabs.net>
	<1893963.CjFnBCekyb@vostro.rjw.lan>
	<20150803083311.5abd23f6@lwn.net> <20150803204505.GF38878@dtor-ws>
Date: Tue, 4 Aug 2015 12:59:13 +0200
Message-ID: <CAKMK7uHmShgov=mTSrLYtrCXcpywXbk0P8eXjO6yXcyN+GuEgg@mail.gmail.com>
From: Daniel Vetter <daniel.vetter@ffwll.ch>
To: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Content-Type: text/plain; charset=UTF-8
Cc: "ksummit-discuss@lists.linuxfoundation.org"
	<ksummit-discuss@lists.linuxfoundation.org>
Subject: Re: [Ksummit-discuss] [CORE TOPIC] Documentation
List-Id: <ksummit-discuss.lists.linuxfoundation.org>
List-Unsubscribe: <https://lists.linuxfoundation.org/mailman/options/ksummit-discuss>,
	<mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=unsubscribe>
List-Archive: <http://lists.linuxfoundation.org/pipermail/ksummit-discuss/>
List-Post: <mailto:ksummit-discuss@lists.linuxfoundation.org>
List-Help: <mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=help>
List-Subscribe: <https://lists.linuxfoundation.org/mailman/listinfo/ksummit-discuss>,
	<mailto:ksummit-discuss-request@lists.linuxfoundation.org?subject=subscribe>

On Mon, Aug 3, 2015 at 10:45 PM, Dmitry Torokhov
<dmitry.torokhov@gmail.com> wrote:
>
> My main issue with the DocBook is that it is not generated by default
> and it is actually takes a while to generate them; otherwise I woudl
> love to be able to catch at least issues breaking existing docs as early
> as possible.

0day does build docbook by default nowadays and screams at you if you
break something. Well if the kerneldoc stuff can catch, like missing
parameters in a function.
-Daniel
-- 
Daniel Vetter
Software Engineer, Intel Corporation
+41 (0) 79 365 57 48 - http://blog.ffwll.ch