linux-kernel - Re: Documentation of kernel messages (Summary)

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

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-Id: <200708061050.53263.rob@landley.net>
Date:	Mon, 6 Aug 2007 11:50:51 -0400
From:	Rob Landley <rob@...dley.net>
To:	Stefan Richter <stefanr@...6.in-berlin.de>
Cc:	Greg KH <gregkh@...e.de>, Randy Dunlap <rdunlap@...otime.net>,
	Alan Cox <alan@...rguk.ukuu.org.uk>,
	Theodore Tso <tytso@....edu>, leoli@...escale.com,
	Gerrit Huizenga <gh@...ibm.com>,
	"H. Peter Anvin" <hpa@...or.com>,
	"Kunai, Takashi" <kunai@...ux-foundation.jp>,
	holzheu@...ux.vnet.ibm.com,
	Andrew Morton <akpm@...ux-foundation.org>,
	linux-kernel@...r.kernel.org,
	lf_kernel_messages@...ux-foundation.org, mtk-manpages@....net,
	jack@...e.cz, pavel@....cz, tim.bird@...sony.com,
	arjan@...radead.org, sam@...nborg.org, jengelh@...putergmbh.de,
	joe@...ches.com, auke-jan.h.kok@...el.com, hansendc@...ibm.com,
	davem@...emloft.net, Valdis.Kletnieks@...edu, kenistoj@...ibm.com,
	schwidefsky@...ibm.com, heiko.carstens@...ibm.com,
	linux-doc@...r.kernel.org
Subject: Re: Documentation of kernel messages (Summary)

On Saturday 04 August 2007 3:04:33 pm Stefan Richter wrote:
> Rob Landley wrote:
> > Documentation is merely one resource among many, and
> > to link _out_ you need HTML.
>
> Do you suggest HTML files in linux/Documentation?

I've thought about it, but right now Documentation is text.  Converting all 
the existing text files to html is a fairly intrusive change, and having 
multiple file formats in there seems even more untidy.  (What next, pdf?).

I'm aware there are some docbook files in there, plus an ancient graphic file, 
plus the bloody stains of various chicken sacrificies, but the point would be 
how best to clean it up...

> I think we can follow 
> URIs and other references in plaintext files just fine.

Go for it.  Have fun.  I'll be over here.

Rob
-- 
"One of my most productive days was throwing away 1000 lines of code."
  - Ken Thompson.
-
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/