From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Maxime Devos Newsgroups: gmane.lisp.guile.user Subject: Re: [ANN] Scheme-GNUnet 0.2 released Date: Thu, 03 Feb 2022 22:08:59 +0100 Message-ID: References: <87h79fofbq.fsf@fcs22.keithdiane.us> Mime-Version: 1.0 Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-isFz/AAa+ulzMTODHLW1" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="10895"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Evolution 3.38.3-1 Cc: guile-user@gnu.org To: Keith Wright Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Thu Feb 03 22:49:05 2022 Return-path: Envelope-to: guile-user@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nFjyR-0002ej-Sf for guile-user@m.gmane-mx.org; Thu, 03 Feb 2022 22:49:03 +0100 Original-Received: from localhost ([::1]:37216 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nFjyQ-00026d-DY for guile-user@m.gmane-mx.org; Thu, 03 Feb 2022 16:49:02 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49770) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFjLy-0002Xe-Da for guile-user@gnu.org; Thu, 03 Feb 2022 16:09:18 -0500 Original-Received: from [2a02:1800:120:4::f00:13] (port=33374 helo=baptiste.telenet-ops.be) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nFjLv-0003t2-WB for guile-user@gnu.org; Thu, 03 Feb 2022 16:09:18 -0500 Original-Received: from ptr-bvsjgyhxw7psv60dyze.18120a2.ip6.access.telenet.be ([IPv6:2a02:1811:8c09:9d00:3c5f:2eff:feb0:ba5a]) by baptiste.telenet-ops.be with bizsmtp id ql9B2600L4UW6Th01l9BvY; Thu, 03 Feb 2022 22:09:12 +0100 In-Reply-To: <87h79fofbq.fsf@fcs22.keithdiane.us> DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22; t=1643922552; bh=YxlNH8SotUKn8RXKQreufV9G+KXO4rRLQON0ETwSre8=; h=Subject:From:To:Cc:Date:In-Reply-To:References; b=Q9G1em+bD+7+Mg1amvNMFOZvLpksXOodcDWvl2AzOGR+Np/l8pDjYR1o/7KXS9UTs RB1mYfV/J//XbKIHUkg3RyvhdjrT9bxGmhxSE7COLhYwf927ALElPe9pvWUZ1g6jwp t4zQdvM2WyDxoBbh8Thx0oX3af06M4ES7ja/XXqO//MfMqdF2IATW0BpRFdVerhVS6 lk+4XgOBPxX/wNpHKm+iSaliaG84Wiwh2j2wyiHhhW84FJPg72V6sN1iQK80Fqpdo3 cJcBQzum9413Dp8KKLx9WXcMc+setXjsM05ZY/hl0kjd/m+0sgVadaQ/OCXqxbif5v 50kzezAEdrg3Q== X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a02:1800:120:4::f00:13 (failed) Received-SPF: pass client-ip=2a02:1800:120:4::f00:13; envelope-from=maximedevos@telenet.be; helo=baptiste.telenet-ops.be X-Spam_score_int: -19 X-Spam_score: -2.0 X-Spam_bar: -- X-Spam_report: (-2.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.io gmane.lisp.guile.user:17993 Archived-At: --=-isFz/AAa+ulzMTODHLW1 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi, Keith Wright schreef op do 03-02-2022 om 15:39 [-0500]: > Maxime Devos writes: >=20 > > The source code can be found at , >=20 > > I can send a copy of the manual (PDF, HTML or TeXmacs) by mail if desir= ed. >=20 > Would it not be easier to put the documentation in the same place > as the source code? (Possibly in a separate directory) It is, in doc/scheme-gnunet.tm in the git repo! And after running "make", you can find the HTML in doc/scheme-gnunet.html and doc/scheme-gnunet.pdf. > As a proponent of literate programming (cf Knuth), I think the > human readable documentation is part of the source code. > An onle machine readable program, even if it is in some "high level" > language, is really no better than a binary "blob", which > could be de-compiled. There's some comments and docstrings in the various .scm source files explaining things. It's not really =E2=80=98Knuth-level=E2=80=99 literate = programming though,=C2=A0were the =E2=80=98executable=E2=80=99 source code is extracted= from the manual, if that's what you were referring to here. Greetings, Maxime. --=-isFz/AAa+ulzMTODHLW1 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- iIwEABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYfxEaxccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7uXIAPjY+eBFvFWsEY/fUAT+gWbx5P98 1oPUx6wFZLCfWia2AQD6pBe3zBAIi/TIaMsV0oiR4giyODPW9SWmSX7J/HAxCQ== =As3W -----END PGP SIGNATURE----- --=-isFz/AAa+ulzMTODHLW1--