From unknown Sat Aug 16 13:51:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71800: [PATCH 0/2] Improve documentation about using modules. Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 27 Jun 2024 14:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 71800 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 71800@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz> X-Debbugs-Original-To: bug-guile@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.171949785421510 (code B ref -1); Thu, 27 Jun 2024 14:18:02 +0000 Received: (at submit) by debbugs.gnu.org; 27 Jun 2024 14:17:34 +0000 Received: from localhost ([127.0.0.1]:43036 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMpwM-0005as-2K for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:17:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:32934) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMpwK-0005ak-20 for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:17:32 -0400 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 <~@wolfsden.cz>) id 1sMpwG-0007Fr-Ju for bug-guile@gnu.org; Thu, 27 Jun 2024 10:17:28 -0400 Received: from wolfsden.cz ([37.205.8.62]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1sMpwE-0006Tv-Ij for bug-guile@gnu.org; Thu, 27 Jun 2024 10:17:28 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id 7B20E2A7645; Thu, 27 Jun 2024 14:17:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497843; bh=OXjB8ZC54usNk7+mlb+ZxGWLfEl4qzADoCvLWXM9Qf0=; h=From:To:Cc:Subject:Date; b=VzmQGvWRTZoCEU7flDzbY7TKY4Y94Y9jn0MN+2D7B/iwW/WAwMh8mPARm1KZgN96k Jn+xtJhVQRwKjT6eYIBiIyC9aghvzooYOvd1eq+DuFsdXsTHjwQIAoIgsoKLHxQYn5 7TJflhLqmtUbLWJb4iMzT2sOvKs/m6iWMBivziAkSF6S3RtcW2RvKoGraPBXMx4Is5 qwida+E6N0LKGhSI677dagMV4QeCmxTB0aMZrSuC+sJ/lar+mTi0wfVjHi/x2Ztmx0 QwW2rWlGlArI/kKH5maZc2/8bWtPL8runHnBTBtodMBlNdJJ69coXBWLm3rU6Af6DJ LljieQ6XC1A6BG9Z8uUu499/VGGgl1sig+sHUyYd1nXtlLYWtAqS9Fv7EaGaKKmrnU CGbh2dTUrqT+Fh0P2mzPq231gSbCmlV2okhP8Ae+pBOpri3vKWPsobBT5/qCftHwR5 pQIdGr5eaBX1GlYkmjNThZwf5tUWt+Ylw6SD+cydHUmbP//k59u3HyQ/0L+JDor9an q1pPAisvncgU3AR+GstpdSJxVIW0YsnrXedMVbVBGCLXSLbYZQpe3zuleyzoA2PeOu r+6jwMpjNtm1uVa2nFWNPD1G3e70daFLvBS0qxFtyfK2h33nSLbFY5HF10ls0Dwn88 msvcWg/ZcoajnETuKej25zzM= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [128.0.188.242]) by wolfsden.cz (Postfix) with ESMTPSA id 290C12A67DB; Thu, 27 Jun 2024 14:17:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497843; bh=OXjB8ZC54usNk7+mlb+ZxGWLfEl4qzADoCvLWXM9Qf0=; h=From:To:Cc:Subject:Date; b=VzmQGvWRTZoCEU7flDzbY7TKY4Y94Y9jn0MN+2D7B/iwW/WAwMh8mPARm1KZgN96k Jn+xtJhVQRwKjT6eYIBiIyC9aghvzooYOvd1eq+DuFsdXsTHjwQIAoIgsoKLHxQYn5 7TJflhLqmtUbLWJb4iMzT2sOvKs/m6iWMBivziAkSF6S3RtcW2RvKoGraPBXMx4Is5 qwida+E6N0LKGhSI677dagMV4QeCmxTB0aMZrSuC+sJ/lar+mTi0wfVjHi/x2Ztmx0 QwW2rWlGlArI/kKH5maZc2/8bWtPL8runHnBTBtodMBlNdJJ69coXBWLm3rU6Af6DJ LljieQ6XC1A6BG9Z8uUu499/VGGgl1sig+sHUyYd1nXtlLYWtAqS9Fv7EaGaKKmrnU CGbh2dTUrqT+Fh0P2mzPq231gSbCmlV2okhP8Ae+pBOpri3vKWPsobBT5/qCftHwR5 pQIdGr5eaBX1GlYkmjNThZwf5tUWt+Ylw6SD+cydHUmbP//k59u3HyQ/0L+JDor9an q1pPAisvncgU3AR+GstpdSJxVIW0YsnrXedMVbVBGCLXSLbYZQpe3zuleyzoA2PeOu r+6jwMpjNtm1uVa2nFWNPD1G3e70daFLvBS0qxFtyfK2h33nSLbFY5HF10ls0Dwn88 msvcWg/ZcoajnETuKej25zzM= From: Tomas Volf <~@wolfsden.cz> Date: Thu, 27 Jun 2024 16:17:16 +0200 Message-ID: <20240627141716.30583-1-~@wolfsden.cz> X-Mailer: git-send-email 2.45.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=37.205.8.62; envelope-from=~@wolfsden.cz; helo=wolfsden.cz X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Document the #:hide argument. Correct text for implication of leaving all optional arguments out. Tomas Volf (2): doc: Document #:hide. doc: Fix implication of omitting optional arguments. doc/ref/api-modules.texi | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) -- 2.45.1 From unknown Sat Aug 16 13:51:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71800: [PATCH 1/2] doc: Document #:hide. References: <20240627141716.30583-1-~@wolfsden.cz> In-Reply-To: <20240627141716.30583-1-~@wolfsden.cz> Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 27 Jun 2024 14:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71800 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 71800@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz> Received: via spool by 71800-submit@debbugs.gnu.org id=B71800.171949794421708 (code B ref 71800); Thu, 27 Jun 2024 14:20:01 +0000 Received: (at 71800) by debbugs.gnu.org; 27 Jun 2024 14:19:04 +0000 Received: from localhost ([127.0.0.1]:43052 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMpxn-0005e3-CI for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:19:03 -0400 Received: from wolfsden.cz ([37.205.8.62]:51244) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMpxk-0005dM-85 for 71800@debbugs.gnu.org; Thu, 27 Jun 2024 10:19:01 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id D68C02A8994; Thu, 27 Jun 2024 14:18:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497935; bh=c8v4ocMYGzv29otCIIWLoFB/10HZ/10/GITszo0FIVA=; h=From:To:Cc:Subject:Date; b=i+WS+qiepWnvJdKJyuXM5v+nnbAY7Zce3ZV0+zKj8E5QomOEjgRlYPdW7U4z4/CCn ivNuYzAjENHQiHoq7Nwkbck8S9+FuUHY0Pt5HHB0M7lIO/vm/NGzhAlbIik+TpgZ7Y UXbE299YVptUwvOODVB2UMtlzSB4IUf1BFfpj8aZ135cUF//jeeES1U3oD0HV3vulx W2HT+9gqf7l+miPQPh7sbdaR8xqxTqbKSBSBv731j205tyy4+J09fsnE1zjJKiq0KE oOmbC9jSZfgPD7Je8P2sTW+Fut7Yl8sJq0YXL1kh/nCxelhIAgXc6af5CHqWnY+KHh zka59wneRD6krmht7Vvp1bW6eQTlF2BYUe2xvUsL2oSKlUQcKJE9qmAW/sHo1YRpix WJFlq1idbdUyoZRS/L9yswVTfgj3YcsQCBU1sj3CCUzogHzXHGrfftV4XuwIRoRR5u sEdRbt2fykzw86LdRa1CpOa9w8ljNOUr+MfE6WBw9bbNeFgpqLgl0Heop6qaZAjR45 V1iWnuAf+nlYoQDWD4MkJO5wDKnl5EpVYgU1yugpHKB/6SzciBNiuKUYQD+q/8Bdbf 9isiCow+mrnA4bkeS3bmNlYyqJayuomK5+1v8UiL4n4AU6Cjf2Cjezb2sXta5wWvaJ 5Hr+o1qv+6DmMPdzchvlu6nc= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [128.0.188.242]) by wolfsden.cz (Postfix) with ESMTPSA id 26D822A7847; Thu, 27 Jun 2024 14:18:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497935; bh=c8v4ocMYGzv29otCIIWLoFB/10HZ/10/GITszo0FIVA=; h=From:To:Cc:Subject:Date; b=i+WS+qiepWnvJdKJyuXM5v+nnbAY7Zce3ZV0+zKj8E5QomOEjgRlYPdW7U4z4/CCn ivNuYzAjENHQiHoq7Nwkbck8S9+FuUHY0Pt5HHB0M7lIO/vm/NGzhAlbIik+TpgZ7Y UXbE299YVptUwvOODVB2UMtlzSB4IUf1BFfpj8aZ135cUF//jeeES1U3oD0HV3vulx W2HT+9gqf7l+miPQPh7sbdaR8xqxTqbKSBSBv731j205tyy4+J09fsnE1zjJKiq0KE oOmbC9jSZfgPD7Je8P2sTW+Fut7Yl8sJq0YXL1kh/nCxelhIAgXc6af5CHqWnY+KHh zka59wneRD6krmht7Vvp1bW6eQTlF2BYUe2xvUsL2oSKlUQcKJE9qmAW/sHo1YRpix WJFlq1idbdUyoZRS/L9yswVTfgj3YcsQCBU1sj3CCUzogHzXHGrfftV4XuwIRoRR5u sEdRbt2fykzw86LdRa1CpOa9w8ljNOUr+MfE6WBw9bbNeFgpqLgl0Heop6qaZAjR45 V1iWnuAf+nlYoQDWD4MkJO5wDKnl5EpVYgU1yugpHKB/6SzciBNiuKUYQD+q/8Bdbf 9isiCow+mrnA4bkeS3bmNlYyqJayuomK5+1v8UiL4n4AU6Cjf2Cjezb2sXta5wWvaJ 5Hr+o1qv+6DmMPdzchvlu6nc= From: Tomas Volf <~@wolfsden.cz> Date: Thu, 27 Jun 2024 16:18:51 +0200 Message-ID: <20240627141852.30845-1-~@wolfsden.cz> X-Mailer: git-send-email 2.45.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) * doc/ref/api-modules.texi (Using Guile Modules): Document #:hide. --- doc/ref/api-modules.texi | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/doc/ref/api-modules.texi b/doc/ref/api-modules.texi index 9f2bba02d..efe739a25 100644 --- a/doc/ref/api-modules.texi +++ b/doc/ref/api-modules.texi @@ -196,25 +196,32 @@ whose public interface is found and used. @cindex binding renamer @lisp (MODULE-NAME [#:select SELECTION] + [#:hide HIDE] [#:prefix PREFIX] [#:renamer RENAMER]) @end lisp in which case a custom interface is newly created and used. @var{module-name} is a list of symbols, as above; @var{selection} is a -list of selection-specs; @var{prefix} is a symbol that is prepended to -imported names; and @var{renamer} is a procedure that takes a symbol and -returns its new name. A selection-spec is either a symbol or a pair of -symbols @code{(ORIG . SEEN)}, where @var{orig} is the name in the used -module and @var{seen} is the name in the using module. Note that -@var{seen} is also modified by @var{prefix} and @var{renamer}. +list of selection-specs; @var{hide} is a list of bindings which should +not be imported; @var{prefix} is a symbol that is prepended to imported +names; and @var{renamer} is a procedure that takes a symbol and returns +its new name. A selection-spec is either a symbol or a pair of symbols +@code{(ORIG . SEEN)}, where @var{orig} is the name in the used module +and @var{seen} is the name in the using module. Note that @var{seen} is +also modified by @var{prefix} and @var{renamer}. -The @code{#:select}, @code{#:prefix}, and @code{#:renamer} clauses are -optional. If all are omitted, the returned interface has no bindings. -If the @code{#:select} clause is omitted, @var{prefix} and @var{renamer} -operate on the used module's public interface. +The @code{#:select}, @code{#:hide}, @code{#:prefix}, and +@code{#:renamer} clauses are optional. If all are omitted, the returned +interface has no bindings. If the @code{#:select} clause is omitted, +@var{prefix} and @var{renamer} operate on the used module's public +interface. -In addition to the above, @var{spec} can also include a @code{#:version} +The @code{#:hide} operates on list of bindings in the module being +imported, before any renaming is performed. If both @code{#:select} and +@code{#:hide} contain a binding, the @code{#:hide} wins. + +In addition to the above, @var{spec} can also include a @code{#:version} clause, of the form: @lisp -- 2.45.1 From unknown Sat Aug 16 13:51:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71800: [PATCH 2/2] doc: Fix implication of omitting optional arguments. Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 27 Jun 2024 14:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71800 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 71800@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz> Received: via spool by 71800-submit@debbugs.gnu.org id=B71800.171949794421715 (code B ref 71800); Thu, 27 Jun 2024 14:20:02 +0000 Received: (at 71800) by debbugs.gnu.org; 27 Jun 2024 14:19:04 +0000 Received: from localhost ([127.0.0.1]:43054 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMpxn-0005e5-RY for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:19:04 -0400 Received: from wolfsden.cz ([37.205.8.62]:51248) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMpxk-0005dO-BO for 71800@debbugs.gnu.org; Thu, 27 Jun 2024 10:19:01 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id BEBFC2A76E9; Thu, 27 Jun 2024 14:18:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497936; bh=5BFj5wVzNgHaPanfg+eWhOGULYY6eLBxecbQJxqDsQY=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=Lj3vOvMQVajkeFHTVWt0m0sL+GD4zO2yqU46pPXoIjqAaJHWEYiEiFzL2BPnJPJBN G7cOXALjcAj6O7ViALssOxwW9AuMCgRddBfD5g8huldgMu38bp0SNJDP0G6kuN7OSy 1JGHtpg4VJsUoV5BY0PLUGqHO5QMMxdzcgvXz0BTSJABoWlONl/71vZ1hbmr+ncZWq Hl4YGKNknzXbHzcl7ukmXeJMM7fJQJxkOePFun/qKIMy9b5gdztZU1az6rXa1uvbz5 Kzrg32YJC3XAySjD/E1sBwqvxBZRsi6AoGpwb0zkeQR5yBgB7yWJQFM8iTqzSdSTLq 5Wh2kmrJH+2SLPDWmgfygWpRnnOnm09YaPKA1UBeNjaecxviMN8UrOvC50/FRYztxZ YoIBnYY3alVMi1h4Naeu8E8Qsl3HNmahdFksOpqNcX1FuqA4yvzy3b8ZCts1K6WovL aI9rveq2T9eYQBwDhZ/qWBiAaV+N2B8YSBAjesSNL2UDvzAB8UZQu6MVEtXCDjtNxQ EUNnkIgHA5tbCtgAZI7E3L1XEt4xHzWvt9VftWtMg/V2OmoV1Ouue20pk9zjvn67E6 tnZa95rf2phbUV4ODbbNzRBvXxSRUIsu1W1+5WWdpEo7fPGba3o7IaBfHDoVSGmx8N AUezoar9KWOXdYYcmH3lesIg= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [128.0.188.242]) by wolfsden.cz (Postfix) with ESMTPSA id 492C12A8631; Thu, 27 Jun 2024 14:18:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497936; bh=5BFj5wVzNgHaPanfg+eWhOGULYY6eLBxecbQJxqDsQY=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=Lj3vOvMQVajkeFHTVWt0m0sL+GD4zO2yqU46pPXoIjqAaJHWEYiEiFzL2BPnJPJBN G7cOXALjcAj6O7ViALssOxwW9AuMCgRddBfD5g8huldgMu38bp0SNJDP0G6kuN7OSy 1JGHtpg4VJsUoV5BY0PLUGqHO5QMMxdzcgvXz0BTSJABoWlONl/71vZ1hbmr+ncZWq Hl4YGKNknzXbHzcl7ukmXeJMM7fJQJxkOePFun/qKIMy9b5gdztZU1az6rXa1uvbz5 Kzrg32YJC3XAySjD/E1sBwqvxBZRsi6AoGpwb0zkeQR5yBgB7yWJQFM8iTqzSdSTLq 5Wh2kmrJH+2SLPDWmgfygWpRnnOnm09YaPKA1UBeNjaecxviMN8UrOvC50/FRYztxZ YoIBnYY3alVMi1h4Naeu8E8Qsl3HNmahdFksOpqNcX1FuqA4yvzy3b8ZCts1K6WovL aI9rveq2T9eYQBwDhZ/qWBiAaV+N2B8YSBAjesSNL2UDvzAB8UZQu6MVEtXCDjtNxQ EUNnkIgHA5tbCtgAZI7E3L1XEt4xHzWvt9VftWtMg/V2OmoV1Ouue20pk9zjvn67E6 tnZa95rf2phbUV4ODbbNzRBvXxSRUIsu1W1+5WWdpEo7fPGba3o7IaBfHDoVSGmx8N AUezoar9KWOXdYYcmH3lesIg= From: Tomas Volf <~@wolfsden.cz> Date: Thu, 27 Jun 2024 16:18:52 +0200 Message-ID: <20240627141852.30845-2-~@wolfsden.cz> X-Mailer: git-send-email 2.45.1 In-Reply-To: <20240627141852.30845-1-~@wolfsden.cz> References: <20240627141852.30845-1-~@wolfsden.cz> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) According to the previous wording, omitting all optional arguments led to empty interface. That however was not the case and was only a documentation bug (as confirmed by wingo on IRC). So let us fix that. * doc/ref/api-modules.texi (Using Guile Modules): Fix implication of omitting optional arguments. --- doc/ref/api-modules.texi | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/ref/api-modules.texi b/doc/ref/api-modules.texi index efe739a25..115ebbac2 100644 --- a/doc/ref/api-modules.texi +++ b/doc/ref/api-modules.texi @@ -212,10 +212,10 @@ and @var{seen} is the name in the using module. Note that @var{seen} is also modified by @var{prefix} and @var{renamer}. The @code{#:select}, @code{#:hide}, @code{#:prefix}, and -@code{#:renamer} clauses are optional. If all are omitted, the returned -interface has no bindings. If the @code{#:select} clause is omitted, -@var{prefix} and @var{renamer} operate on the used module's public -interface. +@code{#:renamer} clauses are optional. If all are omitted, this form +behaves identically to the previous one. If the @code{#:select} clause +is omitted, @var{prefix} and @var{renamer} operate on the used module's +public interface. The @code{#:hide} operates on list of bindings in the module being imported, before any renaming is performed. If both @code{#:select} and -- 2.45.1 From unknown Sat Aug 16 13:51:14 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71800: [PATCH 0/2] Improve documentation about using modules. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Tue, 02 Jul 2024 03:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71800 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: Tomas Volf <~@wolfsden.cz> Cc: 71800@debbugs.gnu.org Received: via spool by 71800-submit@debbugs.gnu.org id=B71800.17198911565593 (code B ref 71800); Tue, 02 Jul 2024 03:33:02 +0000 Received: (at 71800) by debbugs.gnu.org; 2 Jul 2024 03:32:36 +0000 Received: from localhost ([127.0.0.1]:35353 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sOUFv-0001S9-W0 for submit@debbugs.gnu.org; Mon, 01 Jul 2024 23:32:36 -0400 Received: from mail-qk1-f172.google.com ([209.85.222.172]:53709) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sOUFs-0001S0-OA for 71800@debbugs.gnu.org; Mon, 01 Jul 2024 23:32:33 -0400 Received: by mail-qk1-f172.google.com with SMTP id af79cd13be357-79c2c05638cso297446185a.3 for <71800@debbugs.gnu.org>; Mon, 01 Jul 2024 20:32:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1719891090; x=1720495890; 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=ocQcshfx6X7/BMb0MseYYcKOqRaCMMci68dzCHU9HpU=; b=EDWioJ4vKEg4FncSZoTOaCS15GCPUIMPlYwB1qRZKgB0pYxCoiYjysSCwg3Ax2ztBE XxJ3l4zKhqAAHricNMzs/00AlCcyAOEG2m1jMgcbfdI0w2O+OJuKyPh0LkuvML0stsFh sePMZJjUldRxDUTWkn92LdjJDz9//k955bySR/YF1O8sRvsPLU5cifv2dQGjdlFKJO37 RbO9XLO8QZZQPw9n7vvaQ2or0g3bWSFiDPzzc65o9uR+Jw1OSjaF5boen7XxZ96NjGJN mW8Qf8Vt5zFMyZOyMd0/Q3WZibYKEhu8bL5UKgHs1KjKaLgd/N8SmX1qF3viRby7sz/R Z+zQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1719891090; x=1720495890; 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=ocQcshfx6X7/BMb0MseYYcKOqRaCMMci68dzCHU9HpU=; b=kqb3TEt/hBTuf9Y9mI3iN5pINY1qW9IBhlmrzhVIYrkMZ2xd5Xj69cY04u63O11/zg QqC6o/BEBrv9xQa16L6zFTKF9B621x3XYPlt/j2q7iigJxXuZ89D53h9lLcAXdGF1GUQ FMv2du6zUWXcjAkNaQWsHV78f14lBz+EM8c9Hd7xm7QCLJ6Nv2BvaFShcrIzO8vQw0Ub KKSsuPZ03bR3+mArCF4E6fk/zbU+E5qnvYJI7eWHRB77RUPD658vOejN0Qw9ZVC5XgPc RoFJZWDvFfkglg5orTAdEtlcc/rcEB0FMlJFRuLENiOAmu8p7d8y05JGH0R64MKF4bqN glKg== X-Gm-Message-State: AOJu0Yz/BGWi8sGbOfyjCbdwpdYV/swXcXnjM9z0LViOsDffKirxyoGF II7TW5wkPt34u0PipXXDOpPFM3j4jNROhov82lcDv/GPFfmQE83XmDkaww== X-Google-Smtp-Source: AGHT+IH6AIQxGFSYoEQS0h0Ow3G0iBhHpw0/6db9eGXIfC6K3zj+0VesRPkk1m8BRYBTTqXrjb4HiA== X-Received: by 2002:a05:6214:300c:b0:6b5:8056:6c80 with SMTP id 6a1803df08f44-6b5b70d3928mr95122176d6.36.1719891090134; Mon, 01 Jul 2024 20:31:30 -0700 (PDT) Received: from hurd (dsl-159-108.b2b2c.ca. [66.158.159.108]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6b59e57463esm39631546d6.51.2024.07.01.20.31.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 01 Jul 2024 20:31:29 -0700 (PDT) From: Maxim Cournoyer In-Reply-To: <20240627141716.30583-1-~@wolfsden.cz> (Tomas Volf's message of "Thu, 27 Jun 2024 16:17:16 +0200") References: <20240627141716.30583-1-~@wolfsden.cz> Date: Mon, 01 Jul 2024 23:31:28 -0400 Message-ID: <87o77g5v1r.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Tomas! Tomas Volf <~@wolfsden.cz> writes: > Document the #:hide argument. Correct text for implication of leaving > all optional arguments out. > > Tomas Volf (2): > doc: Document #:hide. > doc: Fix implication of omitting optional arguments. > This looks good to me. Reviewed-by: Maxim Cournoyer -- Thanks, Maxim From unknown Sat Aug 16 13:51:14 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Tomas Volf <~@wolfsden.cz> Subject: bug#71800: closed (Re: bug#71800: [PATCH 0/2] Improve documentation about using modules.) Message-ID: References: <875xpevkn2.fsf@gnu.org> <20240627141716.30583-1-~@wolfsden.cz> X-Gnu-PR-Message: they-closed 71800 X-Gnu-PR-Package: guile X-Gnu-PR-Keywords: patch Reply-To: 71800@debbugs.gnu.org Date: Sat, 26 Oct 2024 17:30:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1729963802-1789-1" This is a multi-part message in MIME format... ------------=_1729963802-1789-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #71800: [PATCH 0/2] Improve documentation about using modules. which was filed against the guile package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 71800@debbugs.gnu.org. --=20 71800: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D71800 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1729963802-1789-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 71800-done) by debbugs.gnu.org; 26 Oct 2024 17:29:20 +0000 Received: from localhost ([127.0.0.1]:42441 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t4kbH-0000RT-Rw for submit@debbugs.gnu.org; Sat, 26 Oct 2024 13:29:20 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57942) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1t4kbF-0000R7-Iq for 71800-done@debbugs.gnu.org; Sat, 26 Oct 2024 13:29:18 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1t4kac-0000U2-7g; Sat, 26 Oct 2024 13:28:38 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=D/f8d4LHFGn23rqrrJIwmhjGHhZsLRvCylW36EbBnRA=; b=R2zlsK5x2CdxquyP+Wgz dUenG5sWZZYA/gcjMayEci4jYsQPYdZoZkohfrrQ3hXN9ZHpVRKIPKusB2KViJ1YG5iLzTsX7bRdU +6NQqDAVC4bdHFE100K4O1dw1pYzklq+U4EWrqTpv48NiH3xGVTiC96IVatzJP4fxdFttUYNs8w4m ivE1ScuuvLN3K5PYsEORcoTfbVQuIxzbbFYgmbtwLn/ffS0GR0Ou2Ux/OTReLlFyd5oO6bb33uLpd 8Su2ccebgeaH+jfIwvdvN3iYfvwRpd1MuKAlS7VJLYLCOTRnD5v3qSifJjk0yLy0Nml3YvKQks5vk GUFJGKsCS7LyNg==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Tomas Volf <~@wolfsden.cz> Subject: Re: bug#71800: [PATCH 0/2] Improve documentation about using modules. In-Reply-To: <20240627141716.30583-1-~@wolfsden.cz> (Tomas Volf's message of "Thu, 27 Jun 2024 16:17:16 +0200") References: <20240627141716.30583-1-~@wolfsden.cz> Date: Sat, 26 Oct 2024 19:28:33 +0200 Message-ID: <875xpevkn2.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71800-done Cc: 71800-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Tomas Volf <~@wolfsden.cz> skribis: > Document the #:hide argument. Correct text for implication of leaving > all optional arguments out. > > Tomas Volf (2): > doc: Document #:hide. > doc: Fix implication of omitting optional arguments. Applied, thanks! ------------=_1729963802-1789-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 27 Jun 2024 14:17:34 +0000 Received: from localhost ([127.0.0.1]:43036 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMpwM-0005as-2K for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:17:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:32934) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMpwK-0005ak-20 for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:17:32 -0400 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 <~@wolfsden.cz>) id 1sMpwG-0007Fr-Ju for bug-guile@gnu.org; Thu, 27 Jun 2024 10:17:28 -0400 Received: from wolfsden.cz ([37.205.8.62]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1sMpwE-0006Tv-Ij for bug-guile@gnu.org; Thu, 27 Jun 2024 10:17:28 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id 7B20E2A7645; Thu, 27 Jun 2024 14:17:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497843; bh=OXjB8ZC54usNk7+mlb+ZxGWLfEl4qzADoCvLWXM9Qf0=; h=From:To:Cc:Subject:Date; b=VzmQGvWRTZoCEU7flDzbY7TKY4Y94Y9jn0MN+2D7B/iwW/WAwMh8mPARm1KZgN96k Jn+xtJhVQRwKjT6eYIBiIyC9aghvzooYOvd1eq+DuFsdXsTHjwQIAoIgsoKLHxQYn5 7TJflhLqmtUbLWJb4iMzT2sOvKs/m6iWMBivziAkSF6S3RtcW2RvKoGraPBXMx4Is5 qwida+E6N0LKGhSI677dagMV4QeCmxTB0aMZrSuC+sJ/lar+mTi0wfVjHi/x2Ztmx0 QwW2rWlGlArI/kKH5maZc2/8bWtPL8runHnBTBtodMBlNdJJ69coXBWLm3rU6Af6DJ LljieQ6XC1A6BG9Z8uUu499/VGGgl1sig+sHUyYd1nXtlLYWtAqS9Fv7EaGaKKmrnU CGbh2dTUrqT+Fh0P2mzPq231gSbCmlV2okhP8Ae+pBOpri3vKWPsobBT5/qCftHwR5 pQIdGr5eaBX1GlYkmjNThZwf5tUWt+Ylw6SD+cydHUmbP//k59u3HyQ/0L+JDor9an q1pPAisvncgU3AR+GstpdSJxVIW0YsnrXedMVbVBGCLXSLbYZQpe3zuleyzoA2PeOu r+6jwMpjNtm1uVa2nFWNPD1G3e70daFLvBS0qxFtyfK2h33nSLbFY5HF10ls0Dwn88 msvcWg/ZcoajnETuKej25zzM= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [128.0.188.242]) by wolfsden.cz (Postfix) with ESMTPSA id 290C12A67DB; Thu, 27 Jun 2024 14:17:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497843; bh=OXjB8ZC54usNk7+mlb+ZxGWLfEl4qzADoCvLWXM9Qf0=; h=From:To:Cc:Subject:Date; b=VzmQGvWRTZoCEU7flDzbY7TKY4Y94Y9jn0MN+2D7B/iwW/WAwMh8mPARm1KZgN96k Jn+xtJhVQRwKjT6eYIBiIyC9aghvzooYOvd1eq+DuFsdXsTHjwQIAoIgsoKLHxQYn5 7TJflhLqmtUbLWJb4iMzT2sOvKs/m6iWMBivziAkSF6S3RtcW2RvKoGraPBXMx4Is5 qwida+E6N0LKGhSI677dagMV4QeCmxTB0aMZrSuC+sJ/lar+mTi0wfVjHi/x2Ztmx0 QwW2rWlGlArI/kKH5maZc2/8bWtPL8runHnBTBtodMBlNdJJ69coXBWLm3rU6Af6DJ LljieQ6XC1A6BG9Z8uUu499/VGGgl1sig+sHUyYd1nXtlLYWtAqS9Fv7EaGaKKmrnU CGbh2dTUrqT+Fh0P2mzPq231gSbCmlV2okhP8Ae+pBOpri3vKWPsobBT5/qCftHwR5 pQIdGr5eaBX1GlYkmjNThZwf5tUWt+Ylw6SD+cydHUmbP//k59u3HyQ/0L+JDor9an q1pPAisvncgU3AR+GstpdSJxVIW0YsnrXedMVbVBGCLXSLbYZQpe3zuleyzoA2PeOu r+6jwMpjNtm1uVa2nFWNPD1G3e70daFLvBS0qxFtyfK2h33nSLbFY5HF10ls0Dwn88 msvcWg/ZcoajnETuKej25zzM= From: Tomas Volf <~@wolfsden.cz> To: bug-guile@gnu.org Subject: [PATCH 0/2] Improve documentation about using modules. Date: Thu, 27 Jun 2024 16:17:16 +0200 Message-ID: <20240627141716.30583-1-~@wolfsden.cz> X-Mailer: git-send-email 2.45.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=37.205.8.62; envelope-from=~@wolfsden.cz; helo=wolfsden.cz X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit Cc: Tomas Volf <~@wolfsden.cz> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Document the #:hide argument. Correct text for implication of leaving all optional arguments out. Tomas Volf (2): doc: Document #:hide. doc: Fix implication of omitting optional arguments. doc/ref/api-modules.texi | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) -- 2.45.1 ------------=_1729963802-1789-1--