From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.user Subject: Updated Guile Tutorial Date: Fri, 14 Aug 2009 00:19:14 +0100 Message-ID: <87ab235mkt.fsf_-_@arudy.ossau.uklinux.net> References: <1249204627.2918.56.camel@debianrts.home> <3ae3aa420908020417nd62c8ffw28fec741c26a81cc@mail.gmail.com> <1249225244.12325.8835.camel@localhost.localdomain> <3ae3aa420908021022y1cc35168y63c697fa79db2dd2@mail.gmail.com> <4A75D612.7010801@domob.eu> <3ae3aa420908021215k106da181w6f3c1292718c8f99@mail.gmail.com> 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 1250205733 10796 80.91.229.12 (13 Aug 2009 23:22:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 13 Aug 2009 23:22:13 +0000 (UTC) Cc: guile-user@gnu.org, richard.shann@virgin.net To: Daniel Kraft , linasvepstas@gmail.com Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Fri Aug 14 01:22:06 2009 Return-path: Envelope-to: guile-user@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MbjcS-0004eH-Uj for guile-user@m.gmane.org; Fri, 14 Aug 2009 01:22:05 +0200 Original-Received: from localhost ([127.0.0.1]:33715 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MbjcS-0004Yf-AO for guile-user@m.gmane.org; Thu, 13 Aug 2009 19:22:04 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MbjZr-0002nZ-EF for guile-user@gnu.org; Thu, 13 Aug 2009 19:19:23 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MbjZm-0002kC-QH for guile-user@gnu.org; Thu, 13 Aug 2009 19:19:23 -0400 Original-Received: from [199.232.76.173] (port=46282 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MbjZm-0002jy-Df for guile-user@gnu.org; Thu, 13 Aug 2009 19:19:18 -0400 Original-Received: from mail3.uklinux.net ([80.84.72.33]:52594) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MbjZk-0002eg-Sl for guile-user@gnu.org; Thu, 13 Aug 2009 19:19:17 -0400 Original-Received: from arudy (host86-152-99-133.range86-152.btcentralplus.com [86.152.99.133]) by mail3.uklinux.net (Postfix) with ESMTP id 16E4D1F67B5; Fri, 14 Aug 2009 00:19:15 +0100 (BST) Original-Received: from arudy.ossau.uklinux.net (arudy [127.0.0.1]) by arudy (Postfix) with ESMTP id 60F393801F; Fri, 14 Aug 2009 00:19:14 +0100 (BST) In-Reply-To: <3ae3aa420908021215k106da181w6f3c1292718c8f99@mail.gmail.com> (Linas Vepstas's message of "Sun\, 2 Aug 2009 14\:15\:49 -0500") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.4-2.6 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.user:7400 Archived-At: Hi all, I know that by know Daniel has updated the tutorial (and I'll comment on that later), but there are a few points below that I should respond to. Linas Vepstas writes: > 2009/8/2 Daniel Kraft : >> >> I also got started using Guile with that turtle package tutorial, and it= was >> really quite nice for the purpose... =A0But I also later rewrote my orig= inal >> code to not use gh_ after I discovered there was a new API ;) >> >> This document is linked here: >> http://www.gnu.org/software/guile/docs/guile-tut/tutorial.html >> >> So it seems to be part of the "official documentation" somewhat... > > Well, its on the main gnu.org website, so it doesn't get much > more official than that. It was believed to be useful at the time that David contributed it, and so one of us (I can't remember who) added it to the website. I believe it's still useful - and especially so now that Daniel has updated the APIs. >> However, >> it does not seem to be the stuff in doc/tutorial (actually, grepping doc= for >> tortoise does not give any hits at all?) No. It's only on the website at the moment, not in Git or Guile releases. A bit weird, I accept, but not a big problem. >> -- so does anyone know who wrote it >> and where/what it is meant to be? > > I don't get what you are saying ... > at the bottom of your URL it says clearly: > "I wrote this page because ... etc > Copyright (c) 2000 David Drysdale > Permission is granted to copy, distribute and/or modify ... > GNU Free Documentation License, FWIW, David is a colleague of mine at work. >> If that's no problem with the original author, I'd volunteer to rework t= he >> tutorial for the new Guile API. > > Well, with the GFDL, you don't have to contact the original author. > You can hack away at it as desired. Indeed. In any case, I am sure that David would have no problem with reworking. >> Or maybe write some other tutorial in the >> same style just with another example (that maybe does not use X functions >> but something more basic). > > Yeah, X examples are rather anachronistic. I dunno, an OpenGL > version might be fun. Imagine .. 3D programming in scheme ..! > it would not be a bad idea, I don't think. > > Anyway, doing something interactive would be appropriate -- > something vaguely enjoyable when its done. Maybe a simple > fractal explorer? Personally I'm really happy that you've updated the existing tutorial; because on the one hand it was a good tutorial, and on the other its use of GH was definitely confusing people. Of course, if you'd now like to extend it by adding examples of other kinds of programming, that would be great. Regards, Neil