From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S965685AbcIPUms (ORCPT ); Fri, 16 Sep 2016 16:42:48 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:47871 "EHLO s-opensource.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S965641AbcIPUma (ORCPT ); Fri, 16 Sep 2016 16:42:30 -0400 Date: Fri, 16 Sep 2016 17:42:19 -0300 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Markus Heiser , Jani Nikula , LKML Subject: Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to ReST markup Message-ID: <20160916174219.0d2866d6@vento.lan> In-Reply-To: <20160916111531.5dd2ad58@lwn.net> References: <877b1fd8d94ce4eb2325da828547b4ac4419a887.1473849886.git.mchehab@s-opensource.com> <20160916111531.5dd2ad58@lwn.net> Organization: Samsung X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.30; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Fri, 16 Sep 2016 11:15:31 -0600 Jonathan Corbet escreveu: > On Wed, 14 Sep 2016 08:06:40 -0300 > Mauro Carvalho Chehab wrote: > > > This one required lots of manual work, for it to be properly > > displayed. > > And, honestly, I wonder if it was worth it. This document contains no > entries for any recent documents, Not sure about that. There are a number of patches from 2016 made by Luis de Bethencourt updating several stuff. > many of the links in it are long since > dead, and I honestly doubt it has been helpful to anybody. I tested: all links there point to an existing documentation. Yet, it lacks pointers to more recent printed Kernel books. > If we keep it > should definitely be marked as historical cruft, but I wonder if it's > worth even that much effort? That's a good question. I don't know the answer. At the media book, we keep a bibliography updated as we add new stuff there. I found it to be useful, specially since it mentions some ITU-T specs that the media framework needs, but this is somewhat different than what's there. Maybe we could keep it there for a while and see if people update it. If not, move it to an "historical" archive or remove it as a hole. Thanks, Mauro