Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752265Ab1BUUAL (ORCPT ); Mon, 21 Feb 2011 15:00:11 -0500 Received: from mx2.parallels.com ([64.131.90.16]:45742 "EHLO mx2.parallels.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751338Ab1BUUAK (ORCPT ); Mon, 21 Feb 2011 15:00:10 -0500 Message-ID: <4D62C43F.5040302@parallels.com> Date: Mon, 21 Feb 2011 13:59:59 -0600 From: Rob Landley User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.13) Gecko/20101208 Thunderbird/3.1.7 MIME-Version: 1.0 To: Mariusz Kozlowski CC: LKML , Subject: Re: Update to http://kernel.org/doc References: <4D6095E3.2040103@parallels.com> <20110221185205.GA23284@mako-laptop> In-Reply-To: <20110221185205.GA23284@mako-laptop> Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: 7bit X-Originating-IP: [208.54.86.49] Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 4324 Lines: 94 On 02/21/2011 12:52 PM, Mariusz Kozlowski wrote: >> I'm not saying it's complete. I'm just saying I exhumed it, gave it a >> good scrub, applied the interocitor to the bolts on its' neck, and sent >> it lurching towards the village... >> >> Opinions? > > Very useful if updated. I can now remove some portion of my kernel related > bookmarks. Thanks. I can set up a cron job, but in reality it looks prettier than it actually is. Part of the problem is that "make htmldocs" doesn't reliably build between about -rc1 and -rc4 or so. It's usually not part of anybody's regression testing, and when it DOES fail the output is usually crazy stuff like: xmlto: /home/landley/linux/linux/Documentation/DocBook/80211.xml does not validate (status 3) xmlto: Fix document syntax or use --skip-validation option /home/landley/linux/linux/Documentation/DocBook/80211.xml:13074: element chapter: validity error : Element chapter content does not follow the DTD, expecting (chapterinfo? , (title , subtitle? , titleabbrev?) , (toc | lot | index | glossary | bibliography)* , tocchap? , (((calloutlist | glosslist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+ , (sect1* | refentry* | simplesect* | section*)) | sect1+ | refentry+ | simplesect+ | section+) , (toc | lot | index | glossary | bibliography)*), got (title sect1 sect1 refentry ) Document /home/landley/linux/linux/Documentation/DocBook/80211.xml does not validate Which means what, exactly? (That particular example was from last week, it's been fixed since upstream. I added --skip-validation to my xmlto invocation because more stuff built. There are still two blank entries in http://kernel.org/doc/htmldocs/ are because their builds broke. I should pull and run it again and see if those build now...) Oh, another fun thing is that my Documentation index is created from the 00-INDEX files when those exist, and there's usually version skew between that file and the directory contents. I have a http://kernel.org/doc/make/doclinkcheck.py which finds the files it lists which don't exist and the files which exist but aren't listed. The current list of files 00-INDEX says exist, but aren't at that location, is: 404 errors: Documentation/time_interpolators.txt Documentation/voyager.txt Documentation/powerpc/booting-without-of.txt Documentation/powerpc/mpc52xx-device-tree-bindings.txt Documentation/arm/msm Documentation/arm/Samsung-S3C24XX Documentation/arm/Sharp-LH Documentation/arm/SPEAr Documentation/arm/empeg/ Documentation/PCI/PCI-DMA-mapping.txt Documentation/networking/dgrs.txt Documentation/networking/ethertap.txt Documentation/networking/wavelan.txt Documentation/w1/masters/mxc_w1 Documentation/vm/slabinfo.c Documentation/serial/hayes-esp.txt Documentation/filesystems/dentry-locking.txt Documentation/filesystems/reiser4.txt Documentation/s390/zfcpdump The list of files which exist but aren't in a 00-INDEX is crazy long so I won't post it here. (I can if you're interested...) I'll probably get around to chipping away at some of that, but first I need to do a proper 2010 OLS paper index. (And that's just a chronological index. A _topic_ index is a huge undertaking. I did a quick search for the NFS guys last night and came up with 7 papers, and I haven't even checked 2010 yet. I'm only even considering an OLS paper topic index because I'd only have to _update_ it once a year, so the work involved is at least finite...) Rob -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/