From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#40671: [DOC] modify literal objects Date: Mon, 11 May 2020 03:26:59 +0300 Message-ID: <83ff79aa-0b79-e61a-93b3-c88bbdc322db@yandex.ru> References: <37a54ac2-da80-ca35-9c01-38c8e12a4b5f@yandex.ru> <9375aaeb-2a9a-b307-c793-0d99328201ea@yandex.ru> <7fe0574a-62ae-94fb-2e55-1a69de6ce828@cs.ucla.edu> <91857438-f44a-90f4-dfe2-a32224ba3994@yandex.ru> <880dc34b-46a9-0149-3c6e-0a951a70125d@cs.ucla.edu> <9c46b93e-a855-0be0-7ab0-50cb8c5cd74d@yandex.ru> <48e90f87-1519-9101-d54b-4bfd81a0c936@yandex.ru> <252d6368-ddea-2f41-b53f-cd927ebc3d1d@cs.ucla.edu> <43d93102-d361-f64b-971b-909418b89fca@yandex.ru> <2ca64f28-1255-4135-6e45-0f0e12b9e72d@cs.ucla.edu> <0c7570cb-bf52-a617-bf54-27a47c54e04a@cs.ucla.edu> <04298f7d-f2c0-5186-57d3-522e3d886166@cs.ucla.edu> <88af48c6-bc39-6ab0-59ec-7d537f2d375d@yandex.ru> <41d69e2e-561f-743a-e1f0-282b2e22b66c@cs.ucla.edu> <87mu6ftk6o.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="113405"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.7.0 Cc: ke.vigouroux@laposte.net, 40671@debbugs.gnu.org, Richard Stallman , Mattias =?UTF-8?Q?Engdeg=C3=A5rd?= To: Michael Heerdegen , Paul Eggert Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon May 11 02:28:09 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jXwIj-000TOM-Ak for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 11 May 2020 02:28:09 +0200 Original-Received: from localhost ([::1]:36380 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jXwIi-0001Th-DQ for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 10 May 2020 20:28:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51318) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jXwIc-0001TU-94 for bug-gnu-emacs@gnu.org; Sun, 10 May 2020 20:28:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:39184) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jXwIb-0000mz-W9 for bug-gnu-emacs@gnu.org; Sun, 10 May 2020 20:28:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jXwIb-0000fj-Se for bug-gnu-emacs@gnu.org; Sun, 10 May 2020 20:28:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 11 May 2020 00:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40671 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 40671-submit@debbugs.gnu.org id=B40671.15891568292493 (code B ref 40671); Mon, 11 May 2020 00:28:01 +0000 Original-Received: (at 40671) by debbugs.gnu.org; 11 May 2020 00:27:09 +0000 Original-Received: from localhost ([127.0.0.1]:50730 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jXwHl-0000e8-Fl for submit@debbugs.gnu.org; Sun, 10 May 2020 20:27:09 -0400 Original-Received: from mail-wm1-f47.google.com ([209.85.128.47]:37127) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jXwHk-0000dq-3F for 40671@debbugs.gnu.org; Sun, 10 May 2020 20:27:08 -0400 Original-Received: by mail-wm1-f47.google.com with SMTP id z72so7625906wmc.2 for <40671@debbugs.gnu.org>; Sun, 10 May 2020 17:27:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=elNaZsLOHpn3N6Z726ptlxXPrATLay7TJ3g3wAtL2tU=; b=W3SDiqNESTcNeobEPjaCzGmTgEOsyRNvGIsS+SC5RoR3i4JPW7oE9b/cxLvjyf1jRm x/7BSldnY35buTS9rOuEm9qfguAP+K9RybWntwpYJvkTIPLNrRxTeojNE6eCUMfzJLJC anJQ415uLKg4Rq+hfZbtjZ2qA6w6yvsjv/tI+HnT4l2tNjqHayCe6bLVGT6CV0HYPbj0 +lbY0Of91BzPUE5c2uMSNclizdS8v5/snGgAu8mZHId+GdabIQ518IEjbpyojTfPA2iR 1cgnkZMPgbYfCKQh8d8pk6nQNF59gMAMrKpwUlEg5JG8nTZd6CllLIBar/L7ClciQJY9 3KuQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=elNaZsLOHpn3N6Z726ptlxXPrATLay7TJ3g3wAtL2tU=; b=RP6r/GuGs97QWBFvcXOKV7q27fcdk5Otk7EM2AuEWolJGWzTm4djXtPqdEpj8jcnaw 1uS7HB1KdL8uFOqJ/DU6qyLlgHQXuXp9Xhjotp8xn0GjOUs46kkiaUbu+hp8V2HS/tG4 Wg/l9XsRMWiDEP65ST+osM1Ic3sdaptjAL99XbiUQSkpL5VHXB0K40fg0FnGEO41GWTQ jDcW6OzEvwk+B5n5jBvLsK6My5tqo4nqwjRXn10aIIHv7QfbZKVQmsxI15WIDCbiUQWO O6oB8EZIH3OZxJ4rx52E6Ur35Hrv37sasgJ8uoZwjKBjH4rne09NTcFzhFcQA4n65uIC wmrg== X-Gm-Message-State: AGi0PuYi9yjK7y5zOssESODKGUIEayDxxUHb91yMwSXCf0cSuciYTSMe OjuXUhp2ODYpjl1CU/EZ4RQ= X-Google-Smtp-Source: APiQypKe1Vk54iPWZAkeeeBfJHxOwPAx4ZmXcrf52S9L8W1vYlBq0ZS+EnfxUTB/6kITqHpfhfLqIA== X-Received: by 2002:a1c:7513:: with SMTP id o19mr25828690wmc.9.1589156822183; Sun, 10 May 2020 17:27:02 -0700 (PDT) Original-Received: from [192.168.0.3] ([66.205.73.129]) by smtp.googlemail.com with ESMTPSA id r11sm13691748wrv.14.2020.05.10.17.27.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 10 May 2020 17:27:01 -0700 (PDT) In-Reply-To: <87mu6ftk6o.fsf@web.de> Content-Language: en-US X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:180036 Archived-At: Thanks, Michael, +1 on your points, but this one especially: On 11.05.2020 03:00, Michael Heerdegen wrote: >> + A mutable object stops being mutable if it is part of an expression >> +that is evaluated. For example: > > FWIW, I would feel better about the word "mutable" if you would > introduce the term like "safely mutable", and then say that we call it > just "mutable" in the following sections because this is shorter. Drew > mentioned his dislike for the term "safe" AFAIR but I think "my Emacs > won't crash if I follow this" vs. "it can crash" describes some kind of > safety. "safely mutable" definitely sounds better to me. And while we might use the shorthand "mutable" in the corresponding section, while referring to this notion outside of it, it would be better to use the full two-word version. >> + When the same value appears multiple times in a program, the Lisp >> +interpreter might save time or space by reusing existing values or >> +their components. For example, @code{(eq "abc" "abc")} returns > > I think we call "values" what evaluation of expressions yields, so > values don't appear in a program (to be read). I don't know the > backgrounds and when this can happen. Is it always the interpreter that > does this mapping? > > "Same syntax" is not good as well: > > (eq (list 1 2 3) (list 1 2 3)) > > doesn't provoke the pitfall you warn about, but your wording doesn't > make clear why the one case is ok and the other is not. Maybe it's > again as simple as saying something about objects as being part of a > program? FWIW, CLtL seems to use a clunky term "similar as constants" for this.