From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: inside the Guile REPL Date: Tue, 16 Jun 2015 13:38:18 +0200 Message-ID: <877fr3x4r9.fsf@gnu.org> References: <20150616070443.GA23824@thebird.nl> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:56715) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z4pCC-0003r6-8g for guix-devel@gnu.org; Tue, 16 Jun 2015 07:38:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z4pC9-0003L0-CW for guix-devel@gnu.org; Tue, 16 Jun 2015 07:38:24 -0400 In-Reply-To: <20150616070443.GA23824@thebird.nl> (Pjotr Prins's message of "Tue, 16 Jun 2015 09:04:43 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Pjotr Prins Cc: guix-devel Pjotr Prins skribis: > I have started to document how to use Guix from the Guile REPL. > Tips/hints wanted from experienced hackers! This is not only to keep > my memory fresh, it may be useful for others. > > https://github.com/pjotrp/guix-notes/blob/master/HACKING.org#debugging-= the-package Nice work! I think it would be nice to see what could be folded into the manual. The =E2=80=9CDefining Packages=E2=80=9D section attempts to get the reader = started with writing package definitions, also giving references to the various tools (=E2=80=98guix import=E2=80=99, =E2=80=98guix hash=E2=80=99, etc.) Do you = think there are things that could be presented differently or added to that section? The API, things like bags, and using the REPL are largely undocumented in the manual. Regarding the REPL, we probably don=E2=80=99t want to dupli= cate what=E2=80=99s already in the Guile manual. However, I agree that giving an example of how to use the REPL specifically with Guix would be welcome. Would you like to propose a patch? This could be a section below =E2=80=9CDefining Packages=E2=80=9D w= ith the transcript of a simple REPL session and cross-references to the relevant parts of the Guile manual. The part about patches should be mostly covered by the new =E2=80=9CSubmitt= ing Patches=E2=80=9D section of the manual, but again, improvements are always welcome! Thanks, Ludo=E2=80=99.