From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Maxim Cournoyer Newsgroups: gmane.lisp.guile.bugs Subject: bug#71300: [PATCH v4] doc: Document SRFI 64. Date: Thu, 26 Sep 2024 22:35:44 +0900 Message-ID: <87r096edvz.fsf@gmail.com> References: <20240601021743.808-1-maxim.cournoyer@gmail.com> <20240915042603.8529-1-maxim.cournoyer@gmail.com> <877cb3hnvr.fsf@wolfsden.cz> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29366"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 71300@debbugs.gnu.org, Filip =?UTF-8?Q?=C5=81ajszczak?= , Maxime Devos To: Tomas Volf <~@wolfsden.cz> Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Thu Sep 26 15:37:55 2024 Return-path: Envelope-to: guile-bugs@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 1stogs-0007Rz-V5 for guile-bugs@m.gmane-mx.org; Thu, 26 Sep 2024 15:37:55 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1stogb-0001IC-9u; Thu, 26 Sep 2024 09:37:37 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1stogZ-0001Hg-Ee for bug-guile@gnu.org; Thu, 26 Sep 2024 09:37:35 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1stogZ-00082i-5w for bug-guile@gnu.org; Thu, 26 Sep 2024 09:37:35 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=+hE77JjINT8eKl092axTt3hazn5sT5OwP+D8HGLP3Ao=; b=sOqS6V0osmQKJ53mNZLMoMTf2KH6xoc/qHqO4kgDpHHfXgc/BB5sSKP6qPakFos2kVx8mAAzPRnfnDHQLUkS3nvf/nk8ELNngrRzMqSqbv1HYM2j/QTQdRUMO7IjtIYJCDk8EpEEvNumYbeKlBqesZ075KMwvD+jhd+CSksXj3qc61WmXYurHcZBoO62yCaAkYQakSB3nJdRx5berNUaOxl7Kl0IbZPV08yC9mYvMYY1SeYCgvynMiaTsxl0AxKT/ku7BdaLaiRxUm7zK0imZvPM3Eq6jQfwNVcKz2Zpv0qvzC8x8CHdo9JYHYKxwVN/83vAR+0zirUJOX8vEVpz1g==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1stoh0-0000C8-99 for bug-guile@gnu.org; Thu, 26 Sep 2024 09:38:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 26 Sep 2024 13:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71300 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch Original-Received: via spool by 71300-submit@debbugs.gnu.org id=B71300.1727357844668 (code B ref 71300); Thu, 26 Sep 2024 13:38:02 +0000 Original-Received: (at 71300) by debbugs.gnu.org; 26 Sep 2024 13:37:24 +0000 Original-Received: from localhost ([127.0.0.1]:33639 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stogN-0000Af-0D for submit@debbugs.gnu.org; Thu, 26 Sep 2024 09:37:24 -0400 Original-Received: from mail-pg1-f182.google.com ([209.85.215.182]:58675) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1stogK-0000A9-92 for 71300@debbugs.gnu.org; Thu, 26 Sep 2024 09:37:20 -0400 Original-Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-7db1f13b14aso752160a12.1 for <71300@debbugs.gnu.org>; Thu, 26 Sep 2024 06:36:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1727357747; x=1727962547; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=+hE77JjINT8eKl092axTt3hazn5sT5OwP+D8HGLP3Ao=; b=CmC/OmIiPLTs8adUCBS4k6H+teq+HAywK7sgrZht3oVMNdJcrFkc9ovPfxlAD6I5Jr 5DIRuf/wzZYBobRn6ZVZ4YIe+o84WYDDlslGSkBQb3n1iUqvl06zeJuGg3zqjWJrZ9MB YhJ/eJZhkVXzVN72OEYYiAZoA5UWbE3O0ijELN31stpWvWaDXsP4tnREMv3w0+eaCPIl edvaILrU0dp52R1oItSLtuAnk314ZBT5t8zD3ZD8PYMD3yO/dFLUzkbanaVjHhaHMm70 lFMUR9o9jlrmQda/vlncSiDzocH6FLpN1coAfVbIBedyt1kRkMZeTWEhu8C833UdRliZ oZ/g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1727357747; x=1727962547; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=+hE77JjINT8eKl092axTt3hazn5sT5OwP+D8HGLP3Ao=; b=A9Pp7KUquMJP5Zbod9RwZYr3obvDB0sZkOED5XByZ7PRtYQrsxV/DCnVFubVNuJyeK ++S17v4w5L3nXrT3DBwFmheQsKcNdBGy93YPop/M/absdipZSeVOfOnlVZwu4SwxgYKf RS7FRuFZHVBZKUreIbcz1gJZyx7PfGpaXEtLuK7AtMocXjb2KbUsDchhHAM3c1u4JVxX o1/tKG+bZY6eV5k/JbE+f+d4AlzXfEn0Lryq1YVBgZUMBntUlKpglU9bhHbG2PUc4Uf8 8amDuVYB/lxAnA94K0dN92/264qguVNXnP7+/O+PTvQT21zTa8ukWhZB5ZymqlqAiKpt IL3w== X-Gm-Message-State: AOJu0Ywa8bVsazzDSxCRQ3EDGX1rmijSQnZILZAhqM/sCKfbvGkMDQMm XTrlSi+2sFWqYhy+kw8i7Y9UjVwQ0V8QQSYdoTTg9juXheg+G/91 X-Google-Smtp-Source: AGHT+IFWrdY3RQFur0pdp3Y5dDNE7TOyV/u8ARirCX0GQYBEuAqyeaDB8gIYD7ttfOQg/n2E5LigLA== X-Received: by 2002:a05:6a20:bf22:b0:1d4:e5fd:a98c with SMTP id adf61e73a8af0-1d4e5fda9d7mr5544969637.0.1727357747241; Thu, 26 Sep 2024 06:35:47 -0700 (PDT) Original-Received: from hurd ([2405:6586:be0:0:c8ff:1707:9b9:af89]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-71afc9c79a5sm4341411b3a.220.2024.09.26.06.35.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 26 Sep 2024 06:35:46 -0700 (PDT) In-Reply-To: <877cb3hnvr.fsf@wolfsden.cz> (Tomas Volf's message of "Sun, 22 Sep 2024 14:30:16 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.lisp.guile.bugs:10986 Archived-At: Hi Tomas, Tomas Volf <~@wolfsden.cz> writes: > Maxim Cournoyer writes: > >> This is an import of the 'Abstract', 'Rationale', and 'Specification' >> sections from the upstream specification text, with some manual >> adjustment. >> >> * doc/ref/srfi-modules.texi (SRFI 64): New subsection. > > I think important question to ask here is whether this manual section > documents SRFI-64 or what Guile ships as SRFI-64. Current > implementation shipped by Guile has many quirks that do not conform to > the specification. > >> +@c This SRFI 64 documentation was "snarfed" from upstream specification >> +@c HTML document using the 'snarfi' script. > > Based on this I believe it describes the specification. That's correct. It's been slightly modified in places where it said things like "left to the implementation" and I was able to verify what the current implementation in Guix does. > I think either of those is fine (albeit describing the Guile's flavor > would be preferred), but is should be stated (that the behavior There's not really a Guile flavor; it's more like the reference implementation flavor ;-). The one in Guile is pretty stock. > described by the manual does not match the implementation shipped). I'd consider different behavior in the implementation compared to the specification bugs. -- Thanks, Maxim