From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id C5682BC6 for ; Mon, 13 Jul 2015 17:45:10 +0000 (UTC) Received: from vena.lwn.net (tex.lwn.net [70.33.254.29]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id 8B23D110 for ; Mon, 13 Jul 2015 17:45:10 +0000 (UTC) Date: Mon, 13 Jul 2015 11:45:09 -0600 From: Jonathan Corbet To: Alexey Dobriyan Message-ID: <20150713114509.14f1f866@lwn.net> In-Reply-To: References: <201507130038.01474.PeterHuewe@gmx.de> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Cc: ksummit-discuss@lists.linuxfoundation.org, Dan Carpenter Subject: Re: [Ksummit-discuss] [CORE-TOPIC] Documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Mon, 13 Jul 2015 12:47:23 +0300 Alexey Dobriyan wrote: > I have counter suggestion: > * remove kernel-doc official status, remove generating scripts > because it doesn't work, kerneldoc does work, after a fashion. It works well enough that people use it, and I hear about it quickly when somebody's comment change breaks the docs build. I don't think we can remove it in the absence of something better. Creating "something better" is actually on my list of things to do. The only problem is that I've had to buy a second 4TB drive to hold that list, so I don't know when I'll have time to think about it. jon