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,gmane.lisp.guile.user Subject: Re: Guile web page docs Date: Fri, 23 Oct 2009 23:25:00 +0100 Message-ID: <871vktkatf.fsf@ossau.uklinux.net> References: <87my3kcw42.fsf@ossau.uklinux.net> <874opsbfsp.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1256336766 7475 80.91.229.12 (23 Oct 2009 22:26:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 23 Oct 2009 22:26:06 +0000 (UTC) Cc: guile-user@gnu.org, guile-devel@gnu.org To: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Sat Oct 24 00:25:59 2009 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1N1Sa6-0003eC-NC for guile-devel@m.gmane.org; Sat, 24 Oct 2009 00:25:58 +0200 Original-Received: from localhost ([127.0.0.1]:47060 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N1Sa6-0000Ko-0F for guile-devel@m.gmane.org; Fri, 23 Oct 2009 18:25:58 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1N1SZy-0000K3-Uq for guile-devel@gnu.org; Fri, 23 Oct 2009 18:25:50 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1N1SZt-0000I6-IQ for guile-devel@gnu.org; Fri, 23 Oct 2009 18:25:50 -0400 Original-Received: from [199.232.76.173] (port=42370 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N1SZt-0000I3-Fl; Fri, 23 Oct 2009 18:25:45 -0400 Original-Received: from mail3.uklinux.net ([80.84.72.33]:57848) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1N1SZp-0000n8-2u; Fri, 23 Oct 2009 18:25:41 -0400 Original-Received: from arudy (host86-147-112-196.range86-147.btcentralplus.com [86.147.112.196]) by mail3.uklinux.net (Postfix) with ESMTP id 0CB171F68AC; Fri, 23 Oct 2009 23:25:02 +0100 (BST) Original-Received: from arudy (arudy [127.0.0.1]) by arudy (Postfix) with ESMTP id 6FE6E38026; Fri, 23 Oct 2009 23:25:01 +0100 (BST) In-Reply-To: <874opsbfsp.fsf@gnu.org> ("Ludovic =?iso-8859-1?Q?Court=E8s?= =?iso-8859-1?Q?=22's?= message of "Wed, 21 Oct 2009 23:25:26 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.4-2.6 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:9563 gmane.lisp.guile.user:7460 Archived-At: ludo@gnu.org (Ludovic Court=E8s) writes: > Neil Jerram writes: > >> I noticed that the docs on the Guile web pages are a bit out of date. >> The 1.8 ones are behind those in 1.8.7 (the latest release). > > http://www.gnu.org/software/guile/manual/html_node/index.html appears to > correspond to 1.8.7. Yes, but amusingly this copy of the manual is only linked from the "support for many SRFIs" link on http://www.gnu.org/software/guile/guile.html, and from inside Daniel's tutorial. If you follow the more prominent links from http://www.gnu.org/software/guile/, you get to http://www.gnu.org/software/guile/docs/docs-1.8/guile-ref/index.html, which is still at version 1.8.1. So, anyway, I think we agree that this needs sorting out! > (BTW, Gnulib has a new script to automate updates to > www.gnu.org/software/PROJECT/manual.) Right; I assume you mean gendocs.sh. >> Would anyone object if we added a 1.9/2.0 set, and updated all these to >> correspond to the latest available (i.e. from CVS/Git) in each release >> series? > > I hadn't done it so far, mostly because 1.9 is alpha, and I think > gnu.org/software/guile/manual should point to the current stable series. > That said, perhaps we could put them in a sub-directory. Yes, that's what I had in mind, linked from http://www.gnu.org/software/guile/docs/docs.html. Do you have strong views on whether we should use current Git or the latest pre-release? I don't think it matters much, and current Git is marginally easier. Regards, Neil