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

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

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

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

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

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

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

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

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

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 variant of

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

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 however,

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-date, that

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 hard to write a

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 a

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 using them,

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 heuristics

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 make it

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 was

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 metadata which will be

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

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

[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,

[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,