lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
Open Source and information security mailing list archives
| ||
|
Date: Thu, 26 Feb 2009 08:59:43 +0800 From: Yang Hongyang <yanghy@...fujitsu.com> To: Randy Dunlap <randy.dunlap@...cle.com> CC: Theodore Tso <tytso@....edu>, Yang Hongyang <imhy.yang@...il.com>, netdev@...r.kernel.org, "David S. Miller" <davem@...emloft.net>, linux-kernel@...r.kernel.org, Andrew Morton <akpm@...ux-foundation.org>, linux-doc@...r.kernel.org, mtk.manpages@...il.com Subject: Re: Documentation:Update the INDEX of the documents Randy Dunlap wrote: > Yang Hongyang wrote: >> Theodore Tso wrote: >>> On Wed, Feb 25, 2009 at 11:25:08PM +0800, Yang Hongyang wrote: >>>>> If folks do find the 00-INDEX files useful, my suggestion would be to >>>>> make a way of automatically extracting them from the individual files >>>>> and/or directories, and then making the 00-INDEX files to be >>>>> automatically generated. >>>> Sounds like a good idea but How to automatically generate >>>> the summaries then? >>> Well, for text files (including subdirectory's 00-INDEX files) we >>> could have a convention which is the first line of the file should be >>> a (max 60 characters) one-line summary of the file. >>> >>> We would probably have to do something special with non-free-form-text >>> files, including structured text files like Docbook files. So it's >>> not quite so straightforward, but it should be doable. >> Yeah,if we do this one-line summary thing,we still have to go through >> all these documents.So why not just update the 00-INDEX and then tell >> the authors that will add docs to the kernel do the "00-INDEX work" >> themselves? > > I doubt that the 00-INDEX files are that useful... > > I think it depends on the individual^_^ -- Regards Yang Hongyang -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@...r.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists