From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#38598: 26.3; Document relation between `make-symbol` and `gensym` Date: Sat, 14 Dec 2019 11:30:00 +0200 Message-ID: <83blsb6yqv.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="106245"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 38598-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 14 10:31:19 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ig3le-000RTL-2d for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Dec 2019 10:31:18 +0100 Original-Received: from localhost ([::1]:57524 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ig3lc-0001xM-K0 for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Dec 2019 04:31:16 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46116) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ig3lP-0001v7-Ty for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2019 04:31:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ig3lO-0004JT-L8 for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2019 04:31:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57214) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ig3lO-0004GF-Cu for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2019 04:31:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ig3lO-00024q-3z for bug-gnu-emacs@gnu.org; Sat, 14 Dec 2019 04:31:02 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Dec 2019 09:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 38598 X-GNU-PR-Package: emacs Mail-Followup-To: 38598@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 38598-done@debbugs.gnu.org id=D38598.15763158257927 (code D ref 38598); Sat, 14 Dec 2019 09:31:01 +0000 Original-Received: (at 38598-done) by debbugs.gnu.org; 14 Dec 2019 09:30:25 +0000 Original-Received: from localhost ([127.0.0.1]:34953 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ig3km-00023n-Ru for submit@debbugs.gnu.org; Sat, 14 Dec 2019 04:30:25 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49360) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ig3kk-00023X-K4 for 38598-done@debbugs.gnu.org; Sat, 14 Dec 2019 04:30:22 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:58400) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ig3kf-0001Er-79; Sat, 14 Dec 2019 04:30:17 -0500 Original-Received: from [176.228.60.248] (port=2336 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1ig3ka-0007bS-IA; Sat, 14 Dec 2019 04:30:13 -0500 In-reply-to: (message from Drew Adams on Fri, 13 Dec 2019 12:35:13 -0800 (PST)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:173317 Archived-At: > Date: Fri, 13 Dec 2019 12:35:13 -0800 (PST) > From: Drew Adams > > (See https://emacs.stackexchange.com/a/54361/105.) > > The Common-Lisp doc is clear about the similarity and difference between > `make-symbol` and `gensym`. The Emacs-Lisp doc says nothing about this. > > Please consider mentioning this in (elisp) `Creating Symbols'. Such > info can help users better understand when they might want to use one or > the other of these functions. > > Yes, this info can be gleaned by carefully reading their individual > descriptions (how the symbol-naming is done). But it would help users > to state it clearly. Thanks, but I find the current documentation clear enough: -- Function: make-symbol name This function returns a newly-allocated, uninterned symbol whose name is NAME (which must be a string). Its value and function definition are void, and its property list is ‘nil’. In the example below, the value of ‘sym’ is not ‘eq’ to ‘foo’ because it is a distinct uninterned symbol whose name is also ‘foo’. (setq sym (make-symbol "foo")) ⇒ foo (eq sym 'foo) ⇒ nil -- Function: gensym &optional prefix This function returns a symbol using ‘make-symbol’, whose name is made by appending ‘gensym-counter’ to PREFIX. The prefix defaults to ‘"g"’. I see nothing that could be gained by adding any explicit sentence about the difference, since that would simply be a rewording of what is already said right there. So I'm closing this bug report.