GNU bug report logs - #53898
The module name for using weak vectors is undocumented.

Message received at submit <at> debbugs.gnu.org:

Received: (at submit) by debbugs.gnu.org; 9 Feb 2022 15:32:09 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Feb 09 10:32:09 2022
Received: from localhost ([127.0.0.1]:52350 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1nHowz-0004zQ-6T
	for submit <at> debbugs.gnu.org; Wed, 09 Feb 2022 10:32:09 -0500
Received: from lists.gnu.org ([209.51.188.17]:43944)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <maximedevos@HIDDEN>) id 1nHoww-0004zI-PP
 for submit <at> debbugs.gnu.org; Wed, 09 Feb 2022 10:32:07 -0500
Received: from eggs.gnu.org ([209.51.188.92]:38366)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <maximedevos@HIDDEN>)
 id 1nHoww-00023y-IA
 for bug-guile@HIDDEN; Wed, 09 Feb 2022 10:32:06 -0500
Received: from leibniz.telenet-ops.be ([195.130.137.77]:54128)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <maximedevos@HIDDEN>)
 id 1nHowt-0006b2-VI
 for bug-guile@HIDDEN; Wed, 09 Feb 2022 10:32:06 -0500
Received: from baptiste.telenet-ops.be (baptiste.telenet-ops.be
 [IPv6:2a02:1800:120:4::f00:13])
 by leibniz.telenet-ops.be (Postfix) with ESMTPS id 4Jv3lN6mvdzMqhHY
 for <bug-guile@HIDDEN>; Wed,  9 Feb 2022 16:32:00 +0100 (CET)
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 t3Xw2601B4UW6Th013XxVd; Wed, 09 Feb 2022 16:31:57 +0100
Message-ID: <00f5b5fb4502ee12d1bb9ca1790bf10c649a8c1b.camel@HIDDEN>
Subject: The module name for using weak vectors is undocumented.
From: Maxime Devos <maximedevos@HIDDEN>
To: bug-guile@HIDDEN
Date: Wed, 09 Feb 2022 16:31:47 +0100
Content-Type: multipart/signed; micalg="pgp-sha512";
 protocol="application/pgp-signature"; boundary="=-VcHG+fE2qrowsylhdFVU"
User-Agent: Evolution 3.38.3-1 
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
 t=1644420717; bh=PrpQKEfiUPjhC0mi/j5r+jujQTH2R55NWO5kBauF5Cw=;
 h=Subject:From:To:Date;
 b=l3jQZOgW22asAzMbguJjUKrZaymEWtCJm8PSwNeT8uRbFPgJI/EfbZEQ1QWG9G5xC
 p3/Fco5K9CYvenkxXXG9T2rQ6oHlRhQo7bwPmpJxUKL23x0pb3rZtanxq5c95jGYdQ
 NRRnk7eX6yF7R76TSxhUOFLtHSr0cGY5gZgvdhlezFMTPRreNauve4G/6mXe3qtPoi
 uRmYSWk+6AzeCgQdyWu6nnXat6D/TIzveX7iHgeA8Dm+SfA9FohBtpnJJp0lq8tZeL
 zs77Vfz7o0XuhRagpSrNN+8S8vPah4bBDPyfUdH+1Nrdsp3F/lRE267hoRiY4BV3hG
 M6vLe+wmR1J0g==
Received-SPF: pass client-ip=195.130.137.77;
 envelope-from=maximedevos@HIDDEN; helo=leibniz.telenet-ops.be
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 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, 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-Spam-Score: 0.2 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)


--=-VcHG+fE2qrowsylhdFVU
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi,

Weak vectors are documented in =E2=80=986.17.3.2  Weak vectors=E2=80=99.
However,=C2=A0they are not available from the (guile) module
and that section does not document which module needs to
be imported to use the procedures from that section.

I only found the required module (ice-9 weak-vector) by doing

$ git grep -F 'make-weak-vector'

It would be nice to document the module name, and not only
the procedures theirselves.

Greetings,
Maxime.

--=-VcHG+fE2qrowsylhdFVU
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----

iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgPeYxccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7vYeAQDbW+YZ6fRvTlNgk1zELUaf2e28
HHSsBiodtOHegsklYQD/VgTegk8MDzRV8Q58LJ1uKmld1Y7Q5Vv2xP6XWblMXgQ=
=agtm
-----END PGP SIGNATURE-----

--=-VcHG+fE2qrowsylhdFVU--