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#17507: Documentation for `add-text-property' and relatives Date: Sat, 17 Aug 2019 09:41:40 +0300 Message-ID: <83sgq0nviz.fsf@gnu.org> References: <21365.44878.936634.958813@home.barzilay.org> <87a7cbti4n.fsf@mouse.gnus.org> <83k1beqz6f.fsf@gnu.org> <837e7dpkfj.fsf@gnu.org> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="227170"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 17507@debbugs.gnu.org, larsi@gnus.org To: Eli Barzilay Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Aug 17 08:42: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 1hysPi-000wzE-I3 for geb-bug-gnu-emacs@m.gmane.org; Sat, 17 Aug 2019 08:42:10 +0200 Original-Received: from localhost ([::1]:34516 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1hysPh-0006q2-2T for geb-bug-gnu-emacs@m.gmane.org; Sat, 17 Aug 2019 02:42:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35531) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1hysPa-0006pm-W5 for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2019 02:42:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hysPa-0000XX-0p for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2019 02:42:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46460) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hysPZ-0000XI-TO for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2019 02:42:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hysPZ-0004Ts-Pm for bug-gnu-emacs@gnu.org; Sat, 17 Aug 2019 02:42:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 17 Aug 2019 06:42:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17507 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 17507-submit@debbugs.gnu.org id=B17507.156602411317208 (code B ref 17507); Sat, 17 Aug 2019 06:42:01 +0000 Original-Received: (at 17507) by debbugs.gnu.org; 17 Aug 2019 06:41:53 +0000 Original-Received: from localhost ([127.0.0.1]:55281 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hysPQ-0004TU-OS for submit@debbugs.gnu.org; Sat, 17 Aug 2019 02:41:53 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:51377) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hysPO-0004TG-7R for 17507@debbugs.gnu.org; Sat, 17 Aug 2019 02:41:50 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37391) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hysPH-0000Nc-IF; Sat, 17 Aug 2019 02:41:43 -0400 Original-Received: from [176.228.60.248] (port=1823 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hysPH-0004vI-22; Sat, 17 Aug 2019 02:41:43 -0400 In-reply-to: (message from Eli Barzilay on Sat, 17 Aug 2019 02:49:54 +0300) 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:165245 Archived-At: > From: Eli Barzilay > Date: Sat, 17 Aug 2019 02:49:54 +0300 > Cc: Lars Ingebrigtsen , 17507@debbugs.gnu.org > > To clarify what I said, it sounds like a string is a tuple of the > actual string *and* its properties, so it's always #("xyz" ...) where > the quotes denote the raw string contents, except that when there's no > properties, then you see just the "xyz" part -- but that's *not* a raw > string, it just doesn't show the (empty) properties. That's not what the printed representation is trying to convey. It is simply trying to show you the properties, because that's useful in many situations. > Yet another way to show this is the fact that if you evaluate > #("xyz"), the result is *displayed* as "xyz". > > Maybe adding some note to that effect (perhaps rephrased, to point at > the fact that all strings have properties, there are no raw strings) > would have resolved my original confusion. I really don't see how this is related to what you originally wrote, sorry. Also, "all strings have properties" would be misleading because most strings have no properties. Can we please return to the original issue, which was the documentation of add-text-property? I don't see how the printed representation of a Lisp string is relevant to the documentation of that function (and similar functions that modify text properties of strings). Maybe that's what I'm missing, in which case please help me connect the dots. Thanks.