From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Newsgroups: gmane.lisp.guile.devel Subject: Re: Contributions to Guile Date: Mon, 08 Feb 2016 09:06:04 +0100 Message-ID: <87si13k4nn.fsf@gnu.org> References: <87twlno63d.fsf@gnu.org> <877figyxb2.fsf@dustycloud.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1454918792 22479 80.91.229.3 (8 Feb 2016 08:06:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Feb 2016 08:06:32 +0000 (UTC) Cc: guile-devel@gnu.org To: Christopher Allan Webber Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Feb 08 09:06:15 2016 Return-path: Envelope-to: guile-devel@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 1aSgpq-00032a-4s for guile-devel@m.gmane.org; Mon, 08 Feb 2016 09:06:14 +0100 Original-Received: from localhost ([::1]:42265 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSgpp-0001o0-D0 for guile-devel@m.gmane.org; Mon, 08 Feb 2016 03:06:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSgpm-0001nr-Oa for guile-devel@gnu.org; Mon, 08 Feb 2016 03:06:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aSgpj-0006Ru-Hl for guile-devel@gnu.org; Mon, 08 Feb 2016 03:06:10 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:42204) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aSgpj-0006Rq-Ec; Mon, 08 Feb 2016 03:06:07 -0500 Original-Received: from pluto.bordeaux.inria.fr ([193.50.110.57]:36476 helo=pluto) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aSgpi-0001Ab-LZ; Mon, 08 Feb 2016 03:06:06 -0500 X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 20 =?utf-8?Q?Pluvi=C3=B4se?= an 224 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x3D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-unknown-linux-gnu In-Reply-To: <877figyxb2.fsf@dustycloud.org> (Christopher Allan Webber's message of "Sun, 07 Feb 2016 14:23:29 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:18148 Archived-At: Christopher Allan Webber skribis: > Chad Albers writes: [...] >> b. More robust documentation system - texinfo is not the greatest. And >> it's non-trivial to generate any documentation (including texinfo) for >> modules. > > Texinfo is pretty nice to use if you're an emacs user... in fact, if > you're an emacs user, it's the best documentation reading system in the > world. But not everyone's an emacs user. I think Texinfo is OK even if you=E2=80=99re not an Emacs user, no? Especi= ally with the just-release 6.1 where menus can (finally!) be automatically generated. > If the html export was nicely themed It can be nicely themed. FWIW, Gnulib=E2=80=99s gendocs.sh, which is what = most projects use to export their HTML to gnu.org, now includes a CSS by default (see as an example.) We can change this CSS anytime, and in fact, I would love it if someone talented would come up with improvements! >> d. An easier build system. I see most projects using autoconf and >> make. Using build tools designed for the C language presents a higher >> barrier to those that want to contribute libraries to the guile >> community. FWIW, I think what we=E2=80=99re using now is the easiest build system *for users*: ./configure && make && make install. It=E2=80=99s admittedly trick= ier for developers, but not insurmountable (and someone working on Guile doesn=E2=80=99t touch it every day either.) >> e. Refactors - I have a _long_ list in my head, but here's one: the >> "ice-9" namespace is cute but confusing to the beginner I once was. > > Yes, I encountered frustration here too. It's faded to the background > now, but I think ice-9 is confusing for newcomers, so is srfi-*. As > much as I love robots, these robot names are kind of jarring. We've > talked about some ice-9 stuff being factored into (guile foo) instead of > (ice-9 foo) but I think Mark Weaver said he'd want a lot of careful > cleanup going through that process (could be misremembering). Some talk > of aliases for srfi modules was made as well.. Agreed, aliases and a plan for future modules would be nice. Thanks for the feedback! Ludo=E2=80=99.