From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Keith Wright Newsgroups: gmane.lisp.guile.user Subject: Re: [ANN] Scheme-GNUnet 0.2 released Date: Thu, 03 Feb 2022 15:39:05 -0500 Message-ID: <87h79fofbq.fsf@fcs22.keithdiane.us> References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38531"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guile-user@gnu.org To: Maxime Devos Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Thu Feb 03 22:23:12 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 1nFjZQ-0009nh-I6 for guile-user@m.gmane-mx.org; Thu, 03 Feb 2022 22:23:12 +0100 Original-Received: from localhost ([::1]:58298 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nFjZP-00029o-IY for guile-user@m.gmane-mx.org; Thu, 03 Feb 2022 16:23:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:41724) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFitJ-00062s-Ps for guile-user@gnu.org; Thu, 03 Feb 2022 15:39:41 -0500 Original-Received: from dsl.keithdiane.us ([66.92.74.188]:53403) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nFit9-00059t-II for guile-user@gnu.org; Thu, 03 Feb 2022 15:39:33 -0500 Original-Received: from fcs22.keithdiane.us (fcs22.keithdiane.us [192.168.1.121]) by fcs19.keithdiane.us (Postfix) with ESMTP id 3C53D218375; Thu, 3 Feb 2022 15:39:06 -0500 (EST) In-Reply-To: (message from Maxime Devos on Thu, 03 Feb 2022 18:11:55 +0000) Received-SPF: pass client-ip=66.92.74.188; envelope-from=kwright@keithdiane.us; helo=dsl.keithdiane.us X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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:17992 Archived-At: Maxime Devos writes: > The source code can be found at , > I can send a copy of the manual (PDF, HTML or TeXmacs) by mail if desired. Would it not be easier to put the documentation in the same place as the source code? (Possibly in a separate directory) 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. I hope the offer to send copies by email, if desired, means you will send it to anyone who requests it. Please don't send a big wad of bytes to the mailing list, even if one person desires it. -- Keith