From unknown Mon Aug 18 04:11:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#71798: [PATCH 1/2] doc: Document #:hide. Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 27 Jun 2024 14:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 71798 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 71798@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.17194972529785 (code B ref -1); Thu, 27 Jun 2024 14:08:02 +0000 Received: (at submit) by debbugs.gnu.org; 27 Jun 2024 14:07:32 +0000 Received: from localhost ([127.0.0.1]:43009 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMpmd-0002Xl-Nl for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:07:32 -0400 Received: from lists.gnu.org ([209.51.188.17]:60502) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMpmb-0002XY-SY for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:07:30 -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 1sMpmX-00025m-Lg for bug-guile@gnu.org; Thu, 27 Jun 2024 10:07:26 -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 1sMpmV-0003ly-G5 for bug-guile@gnu.org; Thu, 27 Jun 2024 10:07:25 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id DC4382A85B1; Thu, 27 Jun 2024 14:07:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497240; bh=c8v4ocMYGzv29otCIIWLoFB/10HZ/10/GITszo0FIVA=; h=From:To:Cc:Subject:Date; b=FuDSd30j/FUX9L/B8dmLIgYG6lBKihFFDjJ4+6yBHiVJ1BVvkB/MCs1b5WKAW6DC/ RJLAAFTzmYLN+nEXlzuWXnqEIF4AJwNyilzxEQo86DxtZ8SLe5FhwWmfy60adLLwAZ GVFgYuSqlaYGjDGIn6Rs6tnVU0gdwNoawPrLF0FPhzNDK8Fuf+wAOsddPUxD8oWUO5 HM3c4BzSEg06b9g4LwASMHY6M5jI+ZxORriY+TcyqcybFQJ7i1+4Lms2d7M2XJrkmd jD3gUnbkdXKz4c1bd64c3yPt0q3Do55uz5Otfd8sqHTCjz1Y8hHipWaCanbW1bKs9S lEGWXZzLSAON+8VW5w4t26XtvcjforPdZZYeyihPgc4WvhicJAOi1/H/v9tlw1iBCl 3Lw8K/H/yMFK1goXAqwrwEAxfF0M3Mjg5bp5lV2hR3TztZBgxqgFKcVPpvi98wIZPW YQ4B8KIYHtEVAETYAB6FqvW6AOlZ70v2rz2W0P51vpUnuUIQuMowvq35B8yLUHR4X7 apBNYUP97zxc5PCSBGiXhSwRpzQLXkpSO7yeOQOW1Cq56RfwZPiITsm0jG1xNS7vmD xusjvbTVg4yBtgRdnE2qhWqq3Pqeyozd/oWDSOfQsnendoYuSyH6FapOqJz6cas74R c8YsRYScQ8LwQL0kJNll8JXs= 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 7029F2A6D64; Thu, 27 Jun 2024 14:07:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497240; bh=c8v4ocMYGzv29otCIIWLoFB/10HZ/10/GITszo0FIVA=; h=From:To:Cc:Subject:Date; b=FuDSd30j/FUX9L/B8dmLIgYG6lBKihFFDjJ4+6yBHiVJ1BVvkB/MCs1b5WKAW6DC/ RJLAAFTzmYLN+nEXlzuWXnqEIF4AJwNyilzxEQo86DxtZ8SLe5FhwWmfy60adLLwAZ GVFgYuSqlaYGjDGIn6Rs6tnVU0gdwNoawPrLF0FPhzNDK8Fuf+wAOsddPUxD8oWUO5 HM3c4BzSEg06b9g4LwASMHY6M5jI+ZxORriY+TcyqcybFQJ7i1+4Lms2d7M2XJrkmd jD3gUnbkdXKz4c1bd64c3yPt0q3Do55uz5Otfd8sqHTCjz1Y8hHipWaCanbW1bKs9S lEGWXZzLSAON+8VW5w4t26XtvcjforPdZZYeyihPgc4WvhicJAOi1/H/v9tlw1iBCl 3Lw8K/H/yMFK1goXAqwrwEAxfF0M3Mjg5bp5lV2hR3TztZBgxqgFKcVPpvi98wIZPW YQ4B8KIYHtEVAETYAB6FqvW6AOlZ70v2rz2W0P51vpUnuUIQuMowvq35B8yLUHR4X7 apBNYUP97zxc5PCSBGiXhSwRpzQLXkpSO7yeOQOW1Cq56RfwZPiITsm0jG1xNS7vmD xusjvbTVg4yBtgRdnE2qhWqq3Pqeyozd/oWDSOfQsnendoYuSyH6FapOqJz6cas74R c8YsRYScQ8LwQL0kJNll8JXs= From: Tomas Volf <~@wolfsden.cz> Date: Thu, 27 Jun 2024 16:07:10 +0200 Message-ID: <20240627140711.30118-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 (--) * 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 debbugs-submit-bounces@debbugs.gnu.org Thu Jun 27 10:10:41 2024 Received: (at control) by debbugs.gnu.org; 27 Jun 2024 14:10:41 +0000 Received: from localhost ([127.0.0.1]:43023 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sMppg-0002cy-NY for submit@debbugs.gnu.org; Thu, 27 Jun 2024 10:10:40 -0400 Received: from wolfsden.cz ([37.205.8.62]:57080) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1sMppe-0002cm-2j for control@debbugs.gnu.org; Thu, 27 Jun 2024 10:10:39 -0400 Received: by wolfsden.cz (Postfix, from userid 104) id 8BDFC2A67D8; Thu, 27 Jun 2024 14:10:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497433; bh=9iPx53mp9zzD0tsyfot/IgZwTZzio9DYPps98LDmMcM=; h=Date:To:From:Subject; b=cpzhTz8I0jsEB8Zk45tWCYFOy6vY/6bh57niENQ06hZbDGVQLxH+FdYc/k0cHkVL/ fGst/IuuoVaBnwqmRlWE6tBjH80PqRC6nzCJ/Mw7cCct8ZFP2g7NeB1hJ7gsfiFbs8 ZNBzv5E9C3x+e+HpB8TR6u7s8yAY/WvEQh0eKVCNqm/m3bcmHrXlHJb2u85RpDyuFx zpUXmA8pGu29Keb2svof3DEJon6cebakYPVzjZTfeOrbauLGdNpfU1FhmtazKfMwmm a4jycMpN/29DKlw/6hsHOAX5h7Ba6Icl1/aHVhZOLM6vunEV2NyJfhi9ZBWIu8hLH5 V6K6C854Zk+VA58bZJM7g8TEAjFhUxhubhhWrxkAcs1sgD4JVLj+qzmFb3fTduLnYV AK5Tc3Z3iG8ScRKV7+pVZ8axfsAY47EvubxnjT86pnLb2O/jDtsUm5tBoT9ub3v4N7 FXLw6pZN2h0IOdzrv1oLrMwoV/lW4RwEBVymMrTFrW7g/Ca04+zOmnuFAvn4p4vIUN zcbQlogH3CoZngRxDW5zUIHng6OndsAsajXqBC+CqUCr/Y/MfpxEoHCrsbaYOTUZW+ dlIwKUZ3F65BSdAD9y7U2o0KUEbYyq0Qyb5HYodEGRrSDWnJhoaTbj7QKW1UDLM9DK Ra6Uq4OgAwz9WjyfpnnfzMDI= 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 B0B622A87B6 for ; Thu, 27 Jun 2024 14:10:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1719497432; bh=9iPx53mp9zzD0tsyfot/IgZwTZzio9DYPps98LDmMcM=; h=Date:To:From:Subject; b=EYZIv/F+VLqCYbxtXLa5HX0U3X8O2gEht6tkQynDcQ8sGef/Qd+ALhopdey6qUy5M YXtjVKgJKjWD4+gOLUNvImxpVuRyUVF5nv17tLoMEPy8+Kul4k3/J9mBSQ5ldIID5E FSc2N0mTFOHTRwNpuQyw/tKmGby5BaX9lV2bq60K2YV74IalrK5U/nTE56TL32K4h7 2lG0PVQyhrXG7jZ653hLU8DSCqJpm8e6NuP8qpmJyIFUDIi6FVAfdDKpmY45TLQP/L J8q/UgAarh6PTI3C07LksQuRJJy778z4pzw+6V3goQNWetBVLh78/o/hmgH2QA06FX L1wzAOeCB80bps7EdYGGHf388sCT5z0L8S9SY9MEWCeQOPGyWXdHQnweJwUsRtIarQ wqNDYkJz4X7dnScv9/kYHR7fPvsLFkNtEsPNASHLqWo3dUjklIG1UdyBZK6iMDc6Zm gVs+GI4v+kkZwr27bIIsTbl3yCaPMaF5NTPHBwJKOEo4WRwgiEuOOd2k9eZ7dr8GvZ 9yw40FB1aTY0/jAt2twv0wzgBDapm8QqIc1QaaY96E/lIDM9FWciqaSoGK1I7KpbeJ lUoqh0QMqd2o1KKTwwujhaPRVPjDbY2VIg/BLx0Uqd89a4tZUJrMMeDdIgwRhzsret /ZgQnQs4yvjEf22fIYbXqgR8= Date: Thu, 27 Jun 2024 16:10:32 +0200 Message-ID: To: control@debbugs.gnu.org From: Tomas Volf <~@wolfsden.cz> Subject: control message for bug #71798 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: control 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 (-) close 71798 quit