From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Panicz Maciej Godek Newsgroups: gmane.lisp.guile.user Subject: Re: SLAYER announcement and help request for preparing a GNU package Date: Wed, 8 May 2013 00:50:32 +0200 Message-ID: References: <874nefpzq0.fsf@zigzag.favinet> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=20cf307f38220d735c04dc28a5f0 X-Trace: ger.gmane.org 1367967056 9690 80.91.229.3 (7 May 2013 22:50:56 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 7 May 2013 22:50:56 +0000 (UTC) Cc: "guile-user@gnu.org" To: Thien-Thi Nguyen Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Wed May 08 00:50:55 2013 Return-path: Envelope-to: guile-user@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UZqii-0004y3-L7 for guile-user@m.gmane.org; Wed, 08 May 2013 00:50:52 +0200 Original-Received: from localhost ([::1]:51265 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UZqii-0001Ij-8H for guile-user@m.gmane.org; Tue, 07 May 2013 18:50:52 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38515) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UZqiT-0001Ic-Ae for guile-user@gnu.org; Tue, 07 May 2013 18:50:38 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UZqiS-0002te-5m for guile-user@gnu.org; Tue, 07 May 2013 18:50:37 -0400 Original-Received: from mail-vb0-x230.google.com ([2607:f8b0:400c:c02::230]:43856) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UZqiP-0002sD-Bj; Tue, 07 May 2013 18:50:33 -0400 Original-Received: by mail-vb0-f48.google.com with SMTP id q16so1014909vbe.7 for ; Tue, 07 May 2013 15:50:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=i3MXV0deVDYUeGm2ItkljI2ZBtQbz9jk0zmgl+AMhH8=; b=wl/9i4kHZ1CMCMlB/ksGxuhWL62GOqKVP5y+Qc4E5zpTRzywkPm3w0Lnra4sJC40Ig K8mtaEbw9qM08uugsohT+fvVuYHgdzRiByUK1ms3jCB8PLEaACm0eQBMZLMaMPksCzP3 sZFb9isKkNfyjwv2caC+KEe3txGxulwlSgvE4Hw20lBREA6ON7opXU3Uvq2LcKxx6jxG M1A2w8mw5BuMLU/YNAFc92/7pu6XRjDobnJgtIF0xkkb8rRsc8n0S5QUiIcZvYglfVxm NLauUjRJX++Ew95FuxBPYi79TnTlUXE8CmHm4C1IjmVyxiiCYJPT+fV2DzXTmXlaf8ko KaEw== X-Received: by 10.52.95.39 with SMTP id dh7mr2396496vdb.26.1367967032765; Tue, 07 May 2013 15:50:32 -0700 (PDT) Original-Received: by 10.220.141.10 with HTTP; Tue, 7 May 2013 15:50:32 -0700 (PDT) In-Reply-To: <874nefpzq0.fsf@zigzag.favinet> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:400c:c02::230 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Original-Sender: guile-user-bounces+guile-user=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.user:10336 Archived-At: --20cf307f38220d735c04dc28a5f0 Content-Type: text/plain; charset=ISO-8859-1 2013/5/6 Thien-Thi Nguyen > () Panicz Maciej Godek > () Mon, 6 May 2013 21:36:33 +0200 > > Thanks :) I see that there are a few persons with similar ideas, and > I wonder how powerful we'd become if we managed to orchestrate our > powers somehow, as TTN suggested > > Orchestration is a nice concept. It is the marshalling of separate > efforts in a parallel direction (towards the audience), moderated > individually, but w/ group awareness, by precise changes in timing and > pitch. Cool. > > For this, i strongly urge everyone who wants to jam[0] to provide > documentation. That is the minimal requirement, the tuning of your > instrument so that it does not burn the ears of others seated beside > you. So what if you don't have (the autotools) rhythm? That can (and > must!) be cyclically attained. To start, you gotta have the right Hz. > > "But ttn, documentation is a pain to create and maintain!" > > Well, yes. For creation, i offer as riposte Guile-BAUX[1], > [...] This looks truly awesome! However, I'm only getting acquainted with autotools, and there are many secrets to me. I see that both guile-sdl and guile-figl copy the scm modules to $(prefix)/share/guile/site..., but apparently they both do that in a different way (which means there's no standard way), and none of them allows to 'fine tune' that directory with an optarg to ./configure And the whole thing makes me wonder about the status of guile documentation. The guide is really great (although sometimes it remains silent about certain features that can be found in header files), but I've observed that doc-strings for built-in functions are no longer available, even though they are specified. And besides, how do the aforementioned modules (those are, as I reckon, tsar and c-tsar) refer to guile-snarf-docs that is shipped with guile source? The nice thing (IMNSHO) is that Guile-BAUX is itself a nontrivial chunk > of Guile Scheme, nothing more, and furthermore takes pains to rise above > the cacaphony of Guile version-specific quirks. > > Documentation maintenance, on the other hand, is a charge laid squarely > on the Author and the Author's discipline and astuteness. You know what > to do; you know how to do it; what must be dredged from the void is the > will and the practice, the mind and the motion. I wish you fortitude. > Well, thanks, I'll do my best :) --20cf307f38220d735c04dc28a5f0 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
2013/5/6 Thien-Thi Nguyen <ttn@gnu.org>
() Panicz Maciej Godek <godek.maciek@gmail.com>
() Mon, 6 May 2013 21:36:33 +0200

=A0 =A0Thanks :) I see that there are a few persons with similar ideas, and=
=A0 =A0I wonder how powerful we'd become if we managed to orchestrate o= ur
=A0 =A0powers somehow, as TTN suggested

Orchestration is a nice concept. =A0It is the marshalling of separate=
efforts in a parallel direction (towards the audience), moderated
individually, but w/ group awareness, by precise changes in timing and
pitch. =A0Cool.

For this, i strongly urge everyone who wants to jam[0] to provide
documentation. =A0That is the minimal requirement, the tuning of your
instrument so that it does not burn the ears of others seated beside
you. =A0So what if you don't have (the autotools) rhythm? =A0That can (= and
must!) be cyclically attained. =A0To start, you gotta have the right Hz.
"But ttn, documentation is a pain to create and maintain!"

Well, yes. =A0For creation, i offer as riposte Guile-BAUX[1],
[...]

This looks truly awesome!
However, I'm only getting acquainted with autotools, and th= ere are many secrets to me. I see that both guile-sdl and guile-figl copy t= he scm modules to $(prefix)/share/guile/site...,
but apparently they both do that in a different way (which means= there's no standard way), and none of them allows to 'fine tune= 9; that directory with an optarg to ./configure

And the whole thing makes me wonder about the status of guile do= cumentation. The guide is really great (although sometimes it remains silen= t about certain features that can be found in header files), but I've o= bserved that doc-strings for built-in functions are no longer available, ev= en though they are specified.

And besides, how do the aforementioned modu= les (those are, as I reckon, tsar and c-tsar) refer to guile-snarf-docs tha= t is shipped with guile source?

The nice thing (IMNSHO) is that Guile-BAUX is itself a nontrivial chunk
of Guile Scheme, nothing more, and furthermore takes pains to rise above the cacaphony of Guile version-specific quirks.

Documentation maintenance, on the other hand, is a charge laid squarely
on the Author and the Author's discipline and astuteness. =A0You know w= hat
to do; you know how to do it; what must be dredged from the void is the
will and the practice, the mind and the motion. =A0I wish you fortitude.

Well, thanks, I'll do my best := )

--20cf307f38220d735c04dc28a5f0--