From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#38598: 26.3; Document relation between `make-symbol` and `gensym` Date: Fri, 13 Dec 2019 12:35:13 -0800 (PST) Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="157634"; mail-complaints-to="usenet@blaine.gmane.org" To: 38598@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 13 21:38:10 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 1ifrhR-000erF-Pr for geb-bug-gnu-emacs@m.gmane.org; Fri, 13 Dec 2019 21:38:09 +0100 Original-Received: from localhost ([::1]:53216 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifrhQ-0005D2-KK for geb-bug-gnu-emacs@m.gmane.org; Fri, 13 Dec 2019 15:38:08 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50830) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifrhL-0005Cu-Os for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:38:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ifrhK-0006Yj-LT for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:38:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:56957) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ifrhK-0006Xp-Gj for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:38:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ifrhK-0005ZY-Cf for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:38:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 13 Dec 2019 20:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38598 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.157626944821324 (code B ref -1); Fri, 13 Dec 2019 20:38:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 13 Dec 2019 20:37:28 +0000 Original-Received: from localhost ([127.0.0.1]:34697 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ifrgm-0005Xs-0q for submit@debbugs.gnu.org; Fri, 13 Dec 2019 15:37:28 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:46778) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ifrgj-0005Xj-Gb for submit@debbugs.gnu.org; Fri, 13 Dec 2019 15:37:25 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42322) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifrgg-00059E-95 for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:37:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ifrgd-0004ZO-1g for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:37:21 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:50700) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ifrgc-0004Tw-Ot for bug-gnu-emacs@gnu.org; Fri, 13 Dec 2019 15:37:18 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xBDKYTYt076507 for ; Fri, 13 Dec 2019 20:37:16 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=hG0m9PCljp/ZLNCBuv8bNWg9kFkV2fgVFlq7OWxhyoU=; b=FztJ6tJbH/21lOn1bhvWtmL++nOzq3c7f2TrnN575KJDIO87xpQfXN5uTIcCWIkhVElX 9rfWE0P5vEQcPPbTq0/HvN+3WyQ3W/So58Wf1R6MaRVkecWnl/TLh97gZ8S5/JIF75Od 1hOpuPU69rycEQQwU7Ulg/eJiHw3znm4XeeyNvQ+O9A+bjsKxTmKHcwBxs4VVMRWJL7y YwCjdoMtVm0pD/Z97waOI/RoaHzp2IcM9YPk2yxQzNe5XZgkloBw0sWmK1ZKWTjf9H/q 5jiO02hUNj/01CODXVYVqZ1fsb8DO8ZIn0xtz5rJzwprvtsCIMHNVytrsZBMyG2YFqYf XA== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 2wr41qu7v4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 13 Dec 2019 20:37:16 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id xBDKYApV052734 for ; Fri, 13 Dec 2019 20:35:15 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3030.oracle.com with ESMTP id 2wvb99tn3h-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 13 Dec 2019 20:35:15 +0000 Original-Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id xBDKZEAA008073 for ; Fri, 13 Dec 2019 20:35:14 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4939.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9470 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=804 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1912130151 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9470 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=863 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1912130151 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] 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:173291 Archived-At: (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. The Common-Lisp doc does this simply, with a single parenthetical sentence:=20 (The only difference between gensym and make-symbol is in how the new-symbol's name is determined.) http://clhs.lisp.se/Body/f_gensym.htm In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.17763 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''