From unknown Sun Sep 07 03:08:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6851: Documentation: `make-hash-table' "add that many space" Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 13 Aug 2010 18:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6851 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 6851@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.128172352411560 (code B ref -1); Fri, 13 Aug 2010 18:19:02 +0000 Received: (at submit) by debbugs.gnu.org; 13 Aug 2010 18:18:44 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ojyq4-00030P-BL for submit@debbugs.gnu.org; Fri, 13 Aug 2010 14:18:44 -0400 Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ojyq2-00030K-2e for submit@debbugs.gnu.org; Fri, 13 Aug 2010 14:18:42 -0400 Received: from lists.gnu.org ([199.232.76.165]:40365) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Ojyqs-0007TP-8f for submit@debbugs.gnu.org; Fri, 13 Aug 2010 14:19:34 -0400 Received: from [140.186.70.92] (port=47201 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ojyqq-0000Nn-G2 for bug-gnu-emacs@gnu.org; Fri, 13 Aug 2010 14:19:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable version=3.3.1 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Ojyqp-0005zR-Er for bug-gnu-emacs@gnu.org; Fri, 13 Aug 2010 14:19:32 -0400 Received: from mail-wy0-f169.google.com ([74.125.82.169]:43422) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ojyqp-0005z5-A2 for bug-gnu-emacs@gnu.org; Fri, 13 Aug 2010 14:19:31 -0400 Received: by wyg36 with SMTP id 36so3244390wyg.0 for ; Fri, 13 Aug 2010 11:19:29 -0700 (PDT) MIME-Version: 1.0 Received: by 10.227.155.203 with SMTP id t11mr1747356wbw.141.1281723569390; Fri, 13 Aug 2010 11:19:29 -0700 (PDT) Received: by 10.216.65.140 with HTTP; Fri, 13 Aug 2010 11:19:29 -0700 (PDT) Date: Fri, 13 Aug 2010 14:19:29 -0400 X-Google-Sender-Auth: dy9t_VtmRvmWtTRD3vTlck9KGVc Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -4.3 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -5.2 (-----) Documentation: `make-hash-table' "add that many space" ,---- (documentation 'make-hash-table) | | { ... } | | :rehash-size REHASH-SIZE - Indicates how to expand the table when it | fills up. If REHASH-SIZE is an integer, add that many space. If it | is a float, it must be > 1.0, and the new size is computed by | multiplying the old size with that factor. Default is 1.5. | | { ... } | `---- Following sentence doesn't parse: "If REHASH-SIZE is an integer, add that many space." ^^^^ ^^^^^ Even if what the author meant was: "If REHASH-SIZE is an integer, add that much space." it still won't yield a satisfactory parse b/c space isn't a term specified elsewhere in the doc so it isn't clear which space is being added to. Problem current through Bzr-101071 -- /s_P\ From unknown Sun Sep 07 03:08:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6851: Documentation: `make-hash-table' "add that many space" Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Aug 2010 00:40:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6851 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: MON KEY Cc: 6851@debbugs.gnu.org Received: via spool by 6851-submit@debbugs.gnu.org id=B6851.128174634823655 (code B ref 6851); Sat, 14 Aug 2010 00:40:03 +0000 Received: (at 6851) by debbugs.gnu.org; 14 Aug 2010 00:39:08 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok4mB-00069U-CH for submit@debbugs.gnu.org; Fri, 13 Aug 2010 20:39:07 -0400 Received: from pantheon-po45.its.yale.edu ([130.132.50.79]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok4m9-000698-Cu for 6851@debbugs.gnu.org; Fri, 13 Aug 2010 20:39:05 -0400 Received: from furry (dhcp128036014221.central.yale.edu [128.36.14.221]) (authenticated bits=0) by pantheon-po45.its.yale.edu (8.12.11.20060308/8.12.11) with ESMTP id o7E0dwAh018515 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 13 Aug 2010 20:39:58 -0400 Received: by furry (Postfix, from userid 1000) id 641BB16D402; Fri, 13 Aug 2010 20:39:58 -0400 (EDT) From: Chong Yidong References: Date: Fri, 13 Aug 2010 20:39:58 -0400 In-Reply-To: (MON KEY's message of "Fri, 13 Aug 2010 14:19:29 -0400") Message-ID: <87vd7eyqld.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-YaleITSMailFilter: Version 1.2c (attachment(s) not renamed) X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) MON KEY writes: > | :rehash-size REHASH-SIZE - Indicates how to expand the table when it > | fills up. If REHASH-SIZE is an integer, add that many space. If it > | is a float, it must be > 1.0, and the new size is computed by > | multiplying the old size with that factor. Default is 1.5. > Following sentence doesn't parse: > > "If REHASH-SIZE is an integer, add that many space." > ^^^^ ^^^^^ > Even if what the author meant was: > > "If REHASH-SIZE is an integer, add that much space." > > it still won't yield a satisfactory parse b/c space isn't a term > specified elsewhere in the doc so it isn't clear which space is being > added to. Thanks. I checked in a fix. The "number of spaces" is the nominal size of the hash table, defined in the preceding part of the docstring. From debbugs-submit-bounces@debbugs.gnu.org Fri Aug 13 20:39:25 2010 Received: (at control) by debbugs.gnu.org; 14 Aug 2010 00:39:25 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok4mS-00069h-SU for submit@debbugs.gnu.org; Fri, 13 Aug 2010 20:39:25 -0400 Received: from pantheon-po45.its.yale.edu ([130.132.50.79]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok4mP-00069b-8y for control@debbugs.gnu.org; Fri, 13 Aug 2010 20:39:24 -0400 Received: from furry (dhcp128036014221.central.yale.edu [128.36.14.221]) (authenticated bits=0) by pantheon-po45.its.yale.edu (8.12.11.20060308/8.12.11) with ESMTP id o7E0eE5E018575 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Fri, 13 Aug 2010 20:40:14 -0400 Received: by furry (Postfix, from userid 1000) id A1C9C16D402; Fri, 13 Aug 2010 20:40:14 -0400 (EDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 6851 Date: Fri, 13 Aug 2010 20:40:14 -0400 Message-ID: <871va2uivl.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-YaleITSMailFilter: Version 1.2c (attachment(s) not renamed) X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) close 6851 thanks From unknown Sun Sep 07 03:08:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6851: Documentation: `make-hash-table' "add that many space" Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Aug 2010 04:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6851 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Chong Yidong Cc: 6851@debbugs.gnu.org Received: via spool by 6851-submit@debbugs.gnu.org id=B6851.12817614722405 (code B ref 6851); Sat, 14 Aug 2010 04:52:02 +0000 Received: (at 6851) by debbugs.gnu.org; 14 Aug 2010 04:51:12 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok8i8-0000ck-54 for submit@debbugs.gnu.org; Sat, 14 Aug 2010 00:51:12 -0400 Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ok8i6-0000cf-4I for 6851@debbugs.gnu.org; Sat, 14 Aug 2010 00:51:10 -0400 Received: by wyb40 with SMTP id 40so3337062wyb.3 for <6851@debbugs.gnu.org>; Fri, 13 Aug 2010 21:52:03 -0700 (PDT) MIME-Version: 1.0 Received: by 10.227.156.213 with SMTP id y21mr1092298wbw.110.1281761522926; Fri, 13 Aug 2010 21:52:02 -0700 (PDT) Received: by 10.216.65.140 with HTTP; Fri, 13 Aug 2010 21:52:02 -0700 (PDT) In-Reply-To: <87vd7eyqld.fsf@stupidchicken.com> References: <87vd7eyqld.fsf@stupidchicken.com> Date: Sat, 14 Aug 2010 00:52:02 -0400 X-Google-Sender-Auth: Xg5ext0iNYOsbPdQGOqwtbzLxs8 Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 X-Spam-Score: -3.2 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.2 (---) On Fri, Aug 13, 2010 at 8:39 PM, Chong Yidong wrote: > Thanks. I checked in a fix. The "number of spaces" is the nominal size > of the hash table, defined in the preceding part of the docstring. > Yes. My point is was that "space" is a loaded term, esp. w/re hashes. Also, I noticed this: ,---- | | {...} | | :rehash-threshold THRESHOLD -- THRESHOLD must a float > 0, and <= 1.0. | Resize the hash table when the ratio (number of entries / table size) | is greater or equal than THRESHOLD. Default is 0.8. | | {...} | `---- "is greater or equal than THRESHOLD. Default is 0.8." ^^^^^^^^^^^^^^^^^^^^^ Maybe better as: "is greater than or equal to THRESHOLD. Default is 0.8." Appears through Bzr-101073 -- /s_P\ From unknown Sun Sep 07 03:08:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6851: Documentation: `make-hash-table' "add that many space" Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Aug 2010 21:14:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6851 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: MON KEY Cc: 6851@debbugs.gnu.org Received: via spool by 6851-submit@debbugs.gnu.org id=B6851.128182040030281 (code B ref 6851); Sat, 14 Aug 2010 21:14:01 +0000 Received: (at 6851) by debbugs.gnu.org; 14 Aug 2010 21:13:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OkO2a-0007sM-IN for submit@debbugs.gnu.org; Sat, 14 Aug 2010 17:13:20 -0400 Received: from pantheon-po18.its.yale.edu ([130.132.50.74]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OkO2Z-0007sH-2Z for 6851@debbugs.gnu.org; Sat, 14 Aug 2010 17:13:19 -0400 Received: from furry (173-14-147-246-NewEngland.hfc.comcastbusiness.net [173.14.147.246]) (authenticated bits=0) by pantheon-po18.its.yale.edu (8.12.11.20060308/8.12.11) with ESMTP id o7ELEDTN019933 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sat, 14 Aug 2010 17:14:14 -0400 Received: by furry (Postfix, from userid 1000) id 8037F16D402; Sat, 14 Aug 2010 17:14:12 -0400 (EDT) From: Chong Yidong References: <87vd7eyqld.fsf@stupidchicken.com> Date: Sat, 14 Aug 2010 17:14:12 -0400 In-Reply-To: (MON KEY's message of "Sat, 14 Aug 2010 00:52:02 -0400") Message-ID: <87aaoo3niz.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-YaleITSMailFilter: Version 1.2c (attachment(s) not renamed) X-Spam-Score: -2.8 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.8 (--) MON KEY writes: > | :rehash-threshold THRESHOLD -- THRESHOLD must a float > 0, and <= 1.0. > | Resize the hash table when the ratio (number of entries / table size) > | is greater or equal than THRESHOLD. Default is 0.8. > Maybe better as: > > "is greater than or equal to THRESHOLD. Default is 0.8." Thanks, fixed.