From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jan Nieuwenhuizen Subject: Re: extending the documentation of the Scheme API Date: Sun, 29 Dec 2019 09:20:57 +0100 Message-ID: <87v9pzv8ye.fsf@gnu.org> References: <87sgleprp6.fsf@elephly.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:53661) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ilTop-0007sB-QU for guix-devel@gnu.org; Sun, 29 Dec 2019 03:21:00 -0500 In-Reply-To: <87sgleprp6.fsf@elephly.net> (Ricardo Wurmus's message of "Fri, 20 Dec 2019 23:17:41 +0100") 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" To: Ricardo Wurmus Cc: Guix-devel Ricardo Wurmus writes: Hello Ricardo > we have lots of nice macros and procedures in Guix that aren=E2=80=99t > documented beyond their docstrings. > > Should we snarf the docstrings and add them to the manual? If you are talking about guix records and (guix build utils); I think it would be great if these were split off from Guix. I guess that documenting them right now, as a first step, would be nice in itself. I am not sure where Guix records could go (Guile?); but many (guix build utils) could move to Gash or a common library even. WDYT? Greetings, jannneke --=20 Jan Nieuwenhuizen | GNU LilyPond http://lilypond.org Freelance IT http://JoyofSource.com | Avatar=C2=AE http://AvatarAcademy.com