From owner-freebsd-doc Tue Dec 4 19:36:30 2001 Delivered-To: freebsd-doc@freebsd.org Received: from lists.blarg.net (lists.blarg.net [206.124.128.17]) by hub.freebsd.org (Postfix) with ESMTP id D143037B416 for ; Tue, 4 Dec 2001 19:36:28 -0800 (PST) Received: from thig.blarg.net (thig.blarg.net [206.124.128.18]) by lists.blarg.net (Postfix) with ESMTP id 77D5CBD33; Tue, 4 Dec 2001 19:36:28 -0800 (PST) Received: from localhost.localdomain ([206.124.139.115]) by thig.blarg.net (8.9.3/8.9.3) with ESMTP id TAA18910; Tue, 4 Dec 2001 19:36:28 -0800 Received: (from jojo@localhost) by localhost.localdomain (8.11.6/8.11.3) id fB53aO816666; Tue, 4 Dec 2001 19:36:25 -0800 (PST) (envelope-from swear@blarg.net) To: Jun Kuriyama Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Link to book/book.html from book/index.html? References: <7p667poypk.67p@localhost.localdomain> <20011203143344.A39683@canyon.nothing-going-on.org> <7mitbm4lr8.wl@waterblue.imgsrc.co.jp> From: swear@blarg.net (Gary W. Swearingen) Date: 04 Dec 2001 19:36:23 -0800 In-Reply-To: <7mitbm4lr8.wl@waterblue.imgsrc.co.jp> Message-ID: <6qg06qjq2w.06q@localhost.localdomain> Lines: 30 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Jun Kuriyama writes: > How about generating index.html from {article,book}.sgml as default > (with {article,book}.html for backward compatibility)? I don't understand that. Are you worried about the case where an index.html file is made, but an {article,book}.html is not? And you propose always making the latter when the former is made? I'll be looking into the SGML/make scene, but as I currently understand it, the makefile can set some kind of low-level SGML entity thing, depending on what formats are asked for, so index.html can be made with the new text only when it makes sense. Your suggestion (as I interpreted it) is certainly easier, but I think I'll keep it in my back pocket and re-ask it here if I don't determine how to do the more complex thing. Thanks. P.S. I hope the complexity of the SGML/make system is worth, in saved effort, consistancy, etc., all the efforts of people it discourages from participating in documentation. I wonder if it wouldn't be better to have a wiki-wiki (http://c2.com/cgi-bin/wiki) type documentation system lots of people would learn in an hour and hack on and which a few people would moderate. The quality would suffer, but the quantity might be greatly improved (and I"m not so sure about the quality either -- there's some quite good stuff on the wikis I've seen). If some project wanted to copy content to a more formal document, they'd be free to do that, maybe copyright-protecting their work to get paid for their tedium. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message