Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 4:47:17 pm Stefan Richter wrote: > Rob Landley wrote: > > On Sunday 12 August 2007 3:17:38 pm Stefan Richter wrote: > >> - it's a little bit faster to create these headers than to add them > >> to 00-INDEX: Just move the existing title to the top. > > ... > > > What

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Stefan Richter
Rob Landley wrote: > On Sunday 12 August 2007 3:17:38 pm Stefan Richter wrote: >> - it's a little bit faster to create these headers than to add them >> to 00-INDEX: Just move the existing title to the top. ... > What variant of "fast" do you mean? Processing the entire directory takes a >

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 3:17:38 pm Stefan Richter wrote: > > This heuristic seems to need about as much cleanup as just fixing > > 00-INDEX.txt in all the directories. > > I didn't think of heuristics but rather of a style guideline. Maybe > prepend this metadata line with "Subject: " or so to di

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 3:11:06 pm Jesper Juhl wrote: > On 12/08/07, Rob Landley <[EMAIL PROTECTED]> wrote: > > On Sunday 12 August 2007 7:48:37 am Stefan Richter wrote: > > > Isn't it with 00-INDEX just like with the "Last Updated:" footers in > > > documentation texts? > > > > > > They are metad

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 12:10:56 pm Jesper Juhl wrote: > > Isn't it with 00-INDEX just like with the "Last Updated:" footers in > > documentation texts? > > That is certainly a risk, yes. But it shouldn't be hard to write a > small script to check if the 00-INDEX files are up-to-date, that will >

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Saturday 11 August 2007 5:45:02 pm Jesper Juhl wrote: > So please do the ACK/NACK/Merge dance with these patches and > let me know if more are wanted or not. :-) Acked-by: Rob Landley <[EMAIL PROTECTED]> Just tried 'em: they worked for me. :) Thanks, Rob -- "One of my most productive days w

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Stefan Richter
Rob Landley wrote: > On Sunday 12 August 2007 12:34:30 pm Stefan Richter wrote: >> Or use the first line of each text file to describe what the file is about. ... > This heuristic seems to need about as much cleanup as just fixing > 00-INDEX.txt > in all the directories. I didn't think of heuris

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Jesper Juhl
On 12/08/07, Rob Landley <[EMAIL PROTECTED]> wrote: > On Sunday 12 August 2007 7:48:37 am Stefan Richter wrote: > > Isn't it with 00-INDEX just like with the "Last Updated:" footers in > > documentation texts? > > > > They are metadata which will be almost always out of date. > > If nothing is usin

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 7:48:37 am Stefan Richter wrote: > Isn't it with 00-INDEX just like with the "Last Updated:" footers in > documentation texts? > > They are metadata which will be almost always out of date. If nothing is using them, they'll bit-rot, yes. Way of the world. But I've found

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Rob Landley
On Sunday 12 August 2007 12:34:30 pm Stefan Richter wrote: > Jesper Juhl wrote: > > On 12/08/07, Stefan Richter <[EMAIL PROTECTED]> wrote: > >> Isn't it with 00-INDEX just like with the "Last Updated:" footers in > >> documentation texts? > > > > That is certainly a risk, yes. But it shouldn't be h

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Stefan Richter
Jesper Juhl wrote: > On 12/08/07, Stefan Richter <[EMAIL PROTECTED]> wrote: >> Isn't it with 00-INDEX just like with the "Last Updated:" footers in >> documentation texts? >> > That is certainly a risk, yes. But it shouldn't be hard to write a > small script to check if the 00-INDEX files are up-to

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Jesper Juhl
On 12/08/07, Stefan Richter <[EMAIL PROTECTED]> wrote: > Jesper Juhl wrote: > > Rob Landley is trying to organize Linux kernel documentation. One > > thing he is doing is generating index.html files based on our > > 00-INDEX files in the Documentation directory. He has met with a > > small problem

Re: [PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-12 Thread Stefan Richter
Jesper Juhl wrote: > Rob Landley is trying to organize Linux kernel documentation. One > thing he is doing is generating index.html files based on our > 00-INDEX files in the Documentation directory. He has met with a > small problem however, since not all subdirectories inside > Documentation

[PATCH 0/5] Add some missing Documentation/*/00-INDEX files

2007-08-11 Thread Jesper Juhl
Hi, Rob Landley is trying to organize Linux kernel documentation. One thing he is doing is generating index.html files based on our 00-INDEX files in the Documentation directory. He has met with a small problem however, since not all subdirectories inside Documentation contain such a file, nor