From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1161458AbcE3P3d (ORCPT ); Mon, 30 May 2016 11:29:33 -0400 Received: from mail-oi0-f68.google.com ([209.85.218.68]:34709 "EHLO mail-oi0-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933365AbcE3P3b (ORCPT ); Mon, 30 May 2016 11:29:31 -0400 MIME-Version: 1.0 X-Originating-IP: [2a02:168:56b5:0:ac27:b86c:7764:9429] In-Reply-To: <878tyrbo36.fsf@intel.com> References: <877fec7gfm.fsf@intel.com> <36300F5F-C3F3-4A55-9257-788CF9F96CA4@darmarit.de> <878tyrbo36.fsf@intel.com> Date: Mon, 30 May 2016 17:29:30 +0200 Message-ID: Subject: Re: [PATCH 00/10] Documentation/Sphinx From: Daniel Vetter To: Jani Nikula Cc: Markus Heiser , Jonathan Corbet , Grant Likely , Mauro Carvalho Chehab , Dan Allen , Russel Winder , Keith Packard , LKML , linux-doc@vger.kernel.org, Hans Verkuil Content-Type: text/plain; charset=UTF-8 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org I concur with Jani on all points, just want to follow-up here. On Mon, May 30, 2016 at 4:46 PM, Jani Nikula wrote: >> Many of the facts mentioned above have been covered in my POC at >> https://github.com/return42/sphkerneldoc ... On others, >> like 5. I'am working on .... >> >>> I've had a few moments of spare time to look into Sphinx. >> >> ... a comprehensive solution needs time and will not be done in a >> hurry. Please give me a week or may be two, then I could present >> a much more comprehensive solution. > > Please do not underestimate the productivity of my moments of spare > time. ;) > > My view of the whole is that we've been talking about adding lightweight > markup support for the better part of a year now, and I'm getting pretty > tired of talking... Tbh I'd like to get this in soonish, so that we have about 1 month of time before 4.8 for actually polishing gpu documentation. Maybe there's some room for more, better tables, other extensions, polish the kernel-doc script a bit more. But what we have now works, I think it does address everything we've discussed over the past year that we absolutely need. I think it makes it possible to extend for all the more optional use-cases we need to be able to convert, and we can add those extensions later on. And with Jani's big pile of kernel-doc patches we now also have someone who understands that perl script, which is awesome. In short I want to go nuts improving the docs themselves and stop discussing the tooling to build them. Can we please make this happen? Note that Jani's already started to throw out our old ascidoc hacks in the topic/kerneldoc branch in the drm-intel.git repo, and we'll switch over the autobuilder for the 01.org docs as soon as that's done. We're committed, I want this ;-) Thanks, Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch