From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.devel Subject: Re: On-line manual Date: Mon, 13 Nov 2006 23:09:16 +0000 Message-ID: <87irhjymeb.fsf@ossau.uklinux.net> References: <87slhap3qn.fsf@laas.fr> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1163459762 9511 80.91.229.2 (13 Nov 2006 23:16:02 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 13 Nov 2006 23:16:02 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Tue Nov 14 00:15:59 2006 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Gjl1h-0002U4-EF for guile-devel@m.gmane.org; Tue, 14 Nov 2006 00:15:41 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gjl1g-0002Uf-G1 for guile-devel@m.gmane.org; Mon, 13 Nov 2006 18:15:40 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gjl1c-0002TF-TL for guile-devel@gnu.org; Mon, 13 Nov 2006 18:15:36 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gjl1Y-0002Of-2i for guile-devel@gnu.org; Mon, 13 Nov 2006 18:15:36 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gjl1X-0002OF-NW for guile-devel@gnu.org; Mon, 13 Nov 2006 18:15:31 -0500 Original-Received: from [80.84.72.33] (helo=mail3.uklinux.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gjl1X-0000Op-HA for guile-devel@gnu.org; Mon, 13 Nov 2006 18:15:31 -0500 Original-Received: from laruns (host86-145-51-69.range86-145.btcentralplus.com [86.145.51.69]) by mail3.uklinux.net (Postfix) with ESMTP id 479DA40A017 for ; Mon, 13 Nov 2006 23:09:47 +0000 (UTC) Original-Received: from laruns (laruns [127.0.0.1]) by laruns (Postfix) with ESMTP id 0441E70346 for ; Mon, 13 Nov 2006 23:09:16 +0000 (GMT) Original-To: Guile-Devel In-Reply-To: <87slhap3qn.fsf@laas.fr> ( =?iso-8859-1?q?Ludovic_Court=E8s's_message_of?= "Fri, 27 Oct 2006 10:22:40 +0200") User-Agent: Gnus/5.1007 (Gnus v5.10.7) Emacs/21.4 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:6218 Archived-At: ludovic.courtes@laas.fr (Ludovic Court=E8s) writes: > As a followup to a recent discussion on `guile-user', I made the manual > for 1.8.1 available from the web in a way that is similar to what other > GNU projects do: > > http://www.gnu.org/software/guile/manual/ Nice. > I also updated http://www.gnu.org/manual/ so that it points to this > address (the update has not propagated yet). My feeling is that the "guile" link in http://www.gnu.org/manual should always go to the same page as the "Manuals" link in http://www.gnu.org/software/guile. > However, the current doc page [0] has more information (manual for 1.6 > and for GOOPS, tutorial, book) so we need to find a way to "merge" both > pages. For GOOPS, I think we could add an entry in `/manual' and have > that point to `/software/guile/manual/goops'. For the other docs, we > could add pointers in http://www.gnu.org/software/guile/manual/ and have > that point to subdirectories. Finally, the Guile web site could refer > to that page as well, rather than having a separate `docs.html' page. > > Opinions? That sounds fine from a usage point of view, but it also sounds unnecessarily hard to implement, if pages like http://www.gnu.org/software/guile/manual are generated as a whole by gendocs.sh. It sounds to me as though it would be easier to keep the existing http://www.gnu.org/software/guile/docs/docs.html as the main Manuals page, and modify its "Reference Manual for Guile 1.8" link to point to http://www.gnu.org/software/guile/manual. Then later, if we want, we can progressively create parallels of http://www.gnu.org/software/guile/manual for the GOOPS and 1.6 manuals, and so on, and just update the links on http://www.gnu.org/software/guile/docs/docs.html to point to them. Regards, Neil _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://lists.gnu.org/mailman/listinfo/guile-devel