GNU bug report logs - #50467
Could :properties have index entries in the elisp manual?

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: wishlist; Reported by: Stefan Kangas <stefan@HIDDEN>; dated Wed, 8 Sep 2021 01:53:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 25 Aug 2022 14:26:59 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Aug 25 10:26:59 2022
Received: from localhost ([127.0.0.1]:50936 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oRDow-0005kK-Vx
	for submit <at> debbugs.gnu.org; Thu, 25 Aug 2022 10:26:59 -0400
Received: from quimby.gnus.org ([95.216.78.240]:32834)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1oRDou-0005k7-TM
 for 50467 <at> debbugs.gnu.org; Thu, 25 Aug 2022 10:26:57 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:Date:References:
 In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=p5jqEIDwXFxb00Sr094MUH4ELvG5+fJF9488dWAlDGM=; b=EdCQPdbpmfJ3dn90D3ypLcRjnL
 R1ZtCP3uEs8+DjA31WuLRYPOFTs3iqZUlMMRHKgAWXLLUFFxMiBt6xhd+uTCWbHyedRfTjaDQmALZ
 fCgewnu32m5yIx0TO0MhZfay17js9mCeswMrNjb3nmITZrjMovQ1zXW4t+WGJw2XZI2c=;
Received: from [84.212.220.105] (helo=joga)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1oRDom-00007X-Eq; Thu, 25 Aug 2022 16:26:50 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
In-Reply-To: <83y284j41z.fsf@HIDDEN> (Eli Zaretskii's message of "Fri, 10 Sep
 2021 10:14:00 +0300")
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 <83k0jro9wm.fsf@HIDDEN>
 <CADwFkm=T6w8c5jt5Xj0THZL=oLB-ZA2jpOxPh6dvs=Pb6DV_NA@HIDDEN>
 <83y284j41z.fsf@HIDDEN>
X-Now-Playing: The Notwist's _Shrink_: "Chemicals"
Date: Thu, 25 Aug 2022 16:26:47 +0200
Message-ID: <87o7w8iel4.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 @@CONTACT_ADDRESS@@ for details.
 Content preview: Eli Zaretskii <eliz@HIDDEN> writes: >> How important is this
 consideration? In other words, how serious of a >> breakage are we risking?
 For example, if it is just that the index >> entries won't work in other
 info readers, that seems a [...] 
 Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 50467
Cc: Stefan Kangas <stefan@HIDDEN>, 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Eli Zaretskii <eliz@HIDDEN> writes:

>> How important is this consideration?  In other words, how serious of a
>> breakage are we risking?  For example, if it is just that the index
>> entries won't work in other info readers, that seems acceptable to me.
>
> It is serious enough that the Texinfo manual advises against it.
> Which in practice means we should use it sparingly, only for very
> important attributes that aren't readily accessible otherwise.

It seems like the info readers now support quoted node names (see
bug#57277), but info.el doesn't.





Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 10 Sep 2021 07:14:41 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Sep 10 03:14:41 2021
Received: from localhost ([127.0.0.1]:36815 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mOakC-0002YQ-C2
	for submit <at> debbugs.gnu.org; Fri, 10 Sep 2021 03:14:41 -0400
Received: from eggs.gnu.org ([209.51.188.92]:41436)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1mOajw-0002Xv-W6
 for 50467 <at> debbugs.gnu.org; Fri, 10 Sep 2021 03:14:39 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e]:35082)
 by eggs.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@HIDDEN>)
 id 1mOajr-0002iH-Jn; Fri, 10 Sep 2021 03:14:19 -0400
Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:1038
 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1mOajr-0003yH-61; Fri, 10 Sep 2021 03:14:19 -0400
Date: Fri, 10 Sep 2021 10:14:00 +0300
Message-Id: <83y284j41z.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stefan Kangas <stefan@HIDDEN>
In-Reply-To: <CADwFkm=T6w8c5jt5Xj0THZL=oLB-ZA2jpOxPh6dvs=Pb6DV_NA@HIDDEN>
 (message from Stefan Kangas on Fri, 10 Sep 2021 09:00:00 +0200)
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 <83k0jro9wm.fsf@HIDDEN>
 <CADwFkm=T6w8c5jt5Xj0THZL=oLB-ZA2jpOxPh6dvs=Pb6DV_NA@HIDDEN>
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 50467
Cc: 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stefan Kangas <stefan@HIDDEN>
> Date: Fri, 10 Sep 2021 09:00:00 +0200
> Cc: 50467 <at> debbugs.gnu.org
> 
> [Sorry, I missed replying to these below points so I'll do that here.]
> 
> Eli Zaretskii <eliz@HIDDEN> writes:
> 
> > One problem here is that use of the colon character in index entries
> > should be avoided, as some Info readers could get confused by that
> > (the colon is a special character in Info file format).
> 
> How important is this consideration?  In other words, how serious of a
> breakage are we risking?  For example, if it is just that the index
> entries won't work in other info readers, that seems acceptable to me.

It is serious enough that the Texinfo manual advises against it.
Which in practice means we should use it sparingly, only for very
important attributes that aren't readily accessible otherwise.

> > Also, most of the keywords are, or should be, found by using their
> > "family name".  For example, for faces we have "face attributes" in
> > the index.
> 
> This is the workflow that I wanted to avoid.  For example, I might not
> know which section ":align-to" belongs to, which means that the
> fastest way for me to find out is to search the entire manual.

Where the "family name" is not obvious, and the attribute is important
or popular, it is indeed justified to have a separate index entry.  I
agree that :align-to is one such example, so it's okay to add it.

One other consideration is that Info-index uses substring matches, so
having an index entry :foo runs the risk of its turning up in searches
for "foo", which could be undesirable if "foo" is a general enough
word, like "weight" or similar.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 10 Sep 2021 07:00:18 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Sep 10 03:00:18 2021
Received: from localhost ([127.0.0.1]:36803 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mOaWI-0002E6-Io
	for submit <at> debbugs.gnu.org; Fri, 10 Sep 2021 03:00:18 -0400
Received: from mail-pj1-f53.google.com ([209.85.216.53]:55024)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stefankangas@HIDDEN>) id 1mOaWH-0002Dq-NL
 for 50467 <at> debbugs.gnu.org; Fri, 10 Sep 2021 03:00:18 -0400
Received: by mail-pj1-f53.google.com with SMTP id oc9so737040pjb.4
 for <50467 <at> debbugs.gnu.org>; Fri, 10 Sep 2021 00:00:17 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:mime-version:references:in-reply-to:from:date
 :message-id:subject:to:cc;
 bh=8ygKTZlPfNIUmFvrd/0EDpxWfzURUGK6MGXwN0tv15c=;
 b=PEYa4dY3qme3aplEPYGrEIn8uWyuSRyZctRuBYaZw7PfLZkKLi0r+K6d7uCg57h1B4
 FhM9cKIGSaoYtUrJMrI+mU54oBpU56oy4EorGYtc7OIqtzJnP9hfb1hoepZc9ypR9KvV
 omZ9OIzjj/t4W6P51NXijZ5xV3vxTy6AdMtiJEL2F3RxiSBedLEgKkjmW7WeviKHTrfz
 e8o7RkgZyn55NTYDBBh3wpH3B4/XdKzQJbVmeqYB3Jysv6HqN+TVTDHh896ORda1YOU7
 xXjbTc3SWwKiK5ssHAM8Vin7mthvnMsvaHt9YGd+4QDsgds39t/mYUFu2XccEKWrdrhn
 VSyQ==
X-Gm-Message-State: AOAM530arAWe9J4qZyst2jbZkLOiJk1x9xs1ZrnbxGb+E/syivarnxnd
 7MPM6zdEQRJvknxzz7BTv4PK+d+ceekeFPBdI0Q=
X-Google-Smtp-Source: ABdhPJyzN1dpKBkM7r8GnHUW7bTM6Bj2Kk2zijj8XjLdO+dapu0KqIIj3vYZmQu7zei0PceAVyw5U+9joNUUSZ0wtp4=
X-Received: by 2002:a17:90b:3812:: with SMTP id
 mq18mr7814246pjb.143.1631257211889; 
 Fri, 10 Sep 2021 00:00:11 -0700 (PDT)
MIME-Version: 1.0
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 <83k0jro9wm.fsf@HIDDEN>
In-Reply-To: <83k0jro9wm.fsf@HIDDEN>
From: Stefan Kangas <stefan@HIDDEN>
Date: Fri, 10 Sep 2021 09:00:00 +0200
Message-ID: <CADwFkm=T6w8c5jt5Xj0THZL=oLB-ZA2jpOxPh6dvs=Pb6DV_NA@HIDDEN>
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
To: Eli Zaretskii <eliz@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Score: 0.5 (/)
X-Debbugs-Envelope-To: 50467
Cc: 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.5 (/)

[Sorry, I missed replying to these below points so I'll do that here.]

Eli Zaretskii <eliz@HIDDEN> writes:

> One problem here is that use of the colon character in index entries
> should be avoided, as some Info readers could get confused by that
> (the colon is a special character in Info file format).

How important is this consideration?  In other words, how serious of a
breakage are we risking?  For example, if it is just that the index
entries won't work in other info readers, that seems acceptable to me.

> Also, most of the keywords are, or should be, found by using their
> "family name".  For example, for faces we have "face attributes" in
> the index.

This is the workflow that I wanted to avoid.  For example, I might not
know which section ":align-to" belongs to, which means that the
fastest way for me to find out is to search the entire manual.  This
is less convenient than typing 'i :a TAB'.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 10 Sep 2021 06:54:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Sep 10 02:54:53 2021
Received: from localhost ([127.0.0.1]:36757 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mOaR2-00022Y-Sd
	for submit <at> debbugs.gnu.org; Fri, 10 Sep 2021 02:54:53 -0400
Received: from mail-pf1-f177.google.com ([209.85.210.177]:34607)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stefankangas@HIDDEN>) id 1mOaR1-00022K-EE
 for 50467 <at> debbugs.gnu.org; Fri, 10 Sep 2021 02:54:51 -0400
Received: by mail-pf1-f177.google.com with SMTP id g14so1061471pfm.1
 for <50467 <at> debbugs.gnu.org>; Thu, 09 Sep 2021 23:54:51 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:mime-version:references:in-reply-to:from:date
 :message-id:subject:to:cc;
 bh=FuaQY+NxO+X+hIdSDUa5H5vbJMGSQOUfPs5tPTCrrRI=;
 b=fVrEdkdc6SFGLJf+7PD6OtNNThowGG/V9DgVUaVrFRPPcJ3Q4h99KZaTFNtKM1pkQK
 /ObnAb+nED5S+ulNA2X62dEJAkfz3yKs4OmJYIIFghfAWBFC1o7kMUnRiYAlHk/lMOSU
 NuamM/i/HA5i5upvsjldfsrVGCw5M/hmoE7n1O07CKXauRU5+t8Gfa3a9Rid6wkGx84q
 zyb25rievtn2v700eBBRCSPbhaOQjuODlAoF+q7e2vHWVAieimyes39U7fodIgsJlQtr
 fMHh3ipgmWaNx3utn62aPAWgvDGWj/ZbFAfzLsst0127Mwhxbq+On4xkpCZnG2mulGWo
 DZOA==
X-Gm-Message-State: AOAM5308Ar6uPVGyNGE8BekKoFk0u0nUG1tntVtLxC6OrN7+beLUk+27
 bG3zQgqIHNjglvR3xNBOpHGSAM0hPn8oBa1ivz35Rznv
X-Google-Smtp-Source: ABdhPJyPm1vMacvfV6kGYDorIluGxvbNRKorp+uhZQpOimw3i5DdJnv//M2mP3rLV9X21j6X5XGuGojTVa0nQ+i+Wh4=
X-Received: by 2002:a62:ea06:0:b0:3e1:62a6:95b8 with SMTP id
 t6-20020a62ea06000000b003e162a695b8mr6816792pfh.70.1631256885608; Thu, 09 Sep
 2021 23:54:45 -0700 (PDT)
MIME-Version: 1.0
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 <83k0jro9wm.fsf@HIDDEN>
In-Reply-To: <83k0jro9wm.fsf@HIDDEN>
From: Stefan Kangas <stefan@HIDDEN>
Date: Fri, 10 Sep 2021 08:54:34 +0200
Message-ID: <CADwFkmmGe=NG4Y3jLqyucTLVpe-fVz5g8bytvLTLX6SM+KSx7g@HIDDEN>
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
To: Eli Zaretskii <eliz@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Score: 0.5 (/)
X-Debbugs-Envelope-To: 50467
Cc: 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.5 (/)

Eli Zaretskii <eliz@HIDDEN> writes:

> > Please consider adding properties to the index of the elisp manual for
> > easy access.
>
> Which ones? all of them?  There are a lot of them, and we sometimes
> have the same keyword used in different contexts to mean different
> things, so we'd need a lot of disambiguation text to make unique
> entries.

As a first approximation, only some of them.

(That's what I meant when I wrote: "Perhaps some properties are more
important to add than others, and perhaps others still would not even
make sense adding.")

> (And you mean keywords that start with a colon, not properties.
> Right?)

Yes, that was a thinko, sorry.

> That said, feel free to suggest additions to the indexing for the
> important keywords, we can always discuss them one by one.

That seems like a good approach here.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 8 Sep 2021 15:55:56 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Sep 08 11:55:56 2021
Received: from localhost ([127.0.0.1]:33360 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mNzvY-0001hp-8H
	for submit <at> debbugs.gnu.org; Wed, 08 Sep 2021 11:55:56 -0400
Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:56344)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <drew.adams@HIDDEN>) id 1mNzvW-0001hg-Jv
 for 50467 <at> debbugs.gnu.org; Wed, 08 Sep 2021 11:55:55 -0400
Received: from pps.filterd (m0246627.ppops.net [127.0.0.1])
 by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 188ExKJ9023705; 
 Wed, 8 Sep 2021 15:55:53 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com;
 h=from : to : cc :
 subject : date : message-id : references : in-reply-to : content-type :
 content-transfer-encoding : mime-version; s=corp-2021-07-09;
 bh=UEhSXd7CAs+eDJ1rZQowLq1fvVk6Xzf5hi6P5sdsMP0=;
 b=of8WfzYNrCab3ygkLZCxmhKYt4INhTPk2EMdpfnvNPweqbjwiNLHDHImnFoetAxtG4MC
 0NTRoKUbZtXsGj1lc6SEX0rejht8hIPf8Jeg8oVT4g5OtZ8XDALe/MM32S1yyWpEz1yd
 lP0DpPW8FNkLokThaano6yjNi9Y0N94AhcrbJaKbeTPI08OQYfe/kcZia0xNV2N7XDmV
 4bOXKQSOTejrCniaBeBxnhVmzaVU2Y0QRUJ2D/OUWb2sakb2JpO7Mn3hWYmROpZQhbRm
 NkvOo/mvjaKza+n6uEltlu3aNEO6ZP1E2By86PnHpcp3XG2skh/pXFhrRhy4UJqfXrLb KQ== 
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com;
 h=from : to : cc :
 subject : date : message-id : references : in-reply-to : content-type :
 content-transfer-encoding : mime-version; s=corp-2020-01-29;
 bh=UEhSXd7CAs+eDJ1rZQowLq1fvVk6Xzf5hi6P5sdsMP0=;
 b=wok8QyWb3M9DOKv+Ga74+O82gB0RrcJIZGnLCP5ggM1D+scvacVvQWPs1CuWA8i0i3xo
 CutfWwJxUP9dCsmsRyvjFWfbW5RnblJnP9afpX4mZO+fgpZV1CQoZlHB/drkPY+dSXy0
 fHf0Vx+NxJaCAeAAdzuj3xU3BCkOE1pRBFw76BaCtnO1x/xOCuWoT47ASipyFoMS0zf9
 C8+cXodOct/Z/+8WjFJ992aS4IbgCEulU7c4SEe74jtKGdrW8nu7jVFkMOOGuG9Yxm4i
 Ht5zcMwCXTUIqfzlU+gNbiPzTEIDRh5ShgC7qtwz47yPs6HhXO6ADPXHPwyIqggyZ7HF CA== 
Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70])
 by mx0b-00069f02.pphosted.com with ESMTP id 3axd7tb6w5-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Wed, 08 Sep 2021 15:55:52 +0000
Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1])
 by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 188Fo5JA072915;
 Wed, 8 Sep 2021 15:55:50 GMT
Received: from nam04-mw2-obe.outbound.protection.outlook.com
 (mail-mw2nam08lp2171.outbound.protection.outlook.com [104.47.73.171])
 by aserp3020.oracle.com with ESMTP id 3axcpme5q5-1
 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);
 Wed, 08 Sep 2021 15:55:50 +0000
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;
 b=jCIvbaOYOQ6G4HlGtvW4zVFHpbXd/zlg0ExnYU/plfpIOs2L3Q0tVObhd7P93ojhkKErOCvQOyLqjwk5152o+Dz0yIbeQvWLfN9P0dQ2z285wpUjdhmvGoKKUDO0jJwvbW/gsHd4eSn7wPhloM0t8MrOjRAPTwiKuqJtKpYCkv9qit4tD8n3deFCk2tvCkHyllsPCiHKLooR/B7VFcFOicA2biQNu0c6VVrpVV/1gH50iwUvd4UPyTuJ0reyBVysOKX5Dd9rgIelFvQgVjsxMH3KUA/Ir1ZvU7Rz9UcYgWjRXeEmWJIdvRkEK0jXg2j8PqtYHm8Sg94K09wd/jFfgw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector9901;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; 
 bh=UEhSXd7CAs+eDJ1rZQowLq1fvVk6Xzf5hi6P5sdsMP0=;
 b=l1y6TMlBhKiaWVIlPmkXLD9kJpXiMqGWvJZyV9srrK9rwRa4+Ze3Bzo1S1zfM46WfPS/GlMXMx0isDJryknTake6iCMaXRkUOBpBPm1TqO4T4gM8NniYApLYJqxqFpIncG32LxbxOIXoUnaxT4cTn0fRuj2eS05vgTZTwe9vUgFwGxCRPWahT6wYsP2a0HZsYTErrXfME78ov9PZ2X8F/EO3UdeRgyZvS2CHsSz5SGSCMhw8b9Ym7UgTG2b356XDh5b4jdiJIqQWiMI1p0K9IL+O1HUo8KfXKcxJQtEy18xcrpnq9aukd3BMBxR5ouW800PSoZBxaBnxtNR3bWwePA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass
 smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com;
 dkim=pass header.d=oracle.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=UEhSXd7CAs+eDJ1rZQowLq1fvVk6Xzf5hi6P5sdsMP0=;
 b=axOeIob0kworuZrxncqQifkKzB4bF0gfDmrA1n9FXzcoMcV0Hq4oOArnkpelL9ZcaTURQMfXzruOEng/It9jXTMbSYZurrvKp00hicWvYOCTdPwPP/hgS8+c52+Mn55kqJRc1i5hFbqKD/OFdXK7tJ1KZRQIu2OtmONmnEN2BLQ=
Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19)
 by BYAPR10MB3670.namprd10.prod.outlook.com (2603:10b6:a03:124::14)
 with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4500.14; Wed, 8 Sep
 2021 15:55:48 +0000
Received: from SJ0PR10MB5488.namprd10.prod.outlook.com
 ([fe80::c0bc:7c3a:292f:8a82]) by SJ0PR10MB5488.namprd10.prod.outlook.com
 ([fe80::c0bc:7c3a:292f:8a82%9]) with mapi id 15.20.4500.014; Wed, 8 Sep 2021
 15:55:48 +0000
From: Drew Adams <drew.adams@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>, Stefan Kangas <stefan@HIDDEN>
Subject: RE: [External] : bug#50467: Could :properties have index entries in
 the elisp manual?
Thread-Topic: [External] : bug#50467: Could :properties have index entries in
 the elisp manual?
Thread-Index: AQHXpHtEifMGpEMotkesXDJ3fxyB0KuaSl2Q
Date: Wed, 8 Sep 2021 15:55:48 +0000
Message-ID: <SJ0PR10MB54887F638F22A9A86D08DC12F3D49@HIDDEN>
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 <83k0jro9wm.fsf@HIDDEN>
In-Reply-To: <83k0jro9wm.fsf@HIDDEN>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
authentication-results: gnu.org; dkim=none (message not signed)
 header.d=none;gnu.org; dmarc=none action=none header.from=oracle.com;
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: a282acb7-6843-4ede-0ff2-08d972e1207e
x-ms-traffictypediagnostic: BYAPR10MB3670:
x-microsoft-antispam-prvs: <BYAPR10MB367005CB9FF5673FF6D3B3B9F3D49@HIDDEN>
x-ms-oob-tlc-oobclassifiers: OLM:7219;
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: r7WlAzFV2iYcVmANaxppJAoF6nUofjSqYbTBPasGCfg5joPmF855SI9daN5N3rkl1uU1LNBnso+JyBLmWVOTlgxQc3uZJtEK0lOJoQLI3ReN+fCy+sfoWb3rkuIPB2A796GdvSMGGQ1cvrKjVd2W4WH2wYakBNuulXRimhh6dKPs5ZC85rw19qCkRc65xnrQ1wTLVULy4zE1S9DVm4gG4XuJnCMEs36tmA3I4WAQwlEq2E+eTQ27S4AvLOqg2ER0JIxC02V1l+agJzgAXtJs64IJhvt4rMkokxxnoySKqXBgQKBTPtlSC4CRFOuhcNdBpzmZMt+klM8HOYP1xW41xutcgtfl+bj/RSKuaF5vbifFpMptFaEZ3u8rB1D794y7dfQkQtMa6cdkSBAYnt8uh9qJpLtAkQRCmoqXOkg/oIlfP4npRQ2olfcvsL/hYQIzPC8UPaHHq+thGsTb7XfHdUpATW8Qzs8TjDpswt5IEUQKb9MFq1aad5X655DF5AhBx5O/0wZr70CjEqhul7PeUwh5YbtmN/on7ez9ig4rzrXwb/fxvZXnr7V7YKBd01hVKZkaY7w556TLIonOwR1RfgsDWXaPiAn8zMV9JeKdcWjKl/q3KSqCMkjmWmnZW8OaOJR54JPKNZRvaANteHExymChCQhL8M+Pki1CNDuV8ofegbKFB5IE1HQnxEPoSPRYXqxuPXRZWm9xEnyl5z7oa8i3OyyTHgqtcm+dyxPLGP2RYTpRxPUedb8BNGF2upNdfItMZFN9gK9TShNgBy+kR4M7fvzmahqPiAFrXiokXnQ=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE;
 SFS:(396003)(376002)(136003)(366004)(39860400002)(346002)(4744005)(71200400001)(52536014)(186003)(33656002)(64756008)(66476007)(6506007)(8936002)(38100700002)(76116006)(9686003)(7696005)(66446008)(44832011)(26005)(66946007)(4326008)(66556008)(8676002)(5660300002)(86362001)(2906002)(122000001)(316002)(478600001)(55016002)(110136005)(38070700005)(966005);
 DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?jucSH5sbo9uG/9sqoP6tOYtgugCv60cgCrdqAXHlckDZcmvmUydON1RqfKIy?=
 =?us-ascii?Q?tAvP595fqjNnZ2OyV2a4lJS9AK24gjHExW5H7T8A2zXjto0JRNu9Z0OGIReO?=
 =?us-ascii?Q?wig/9EbxxBVKnamZPW3oonmW7GJWSKtnMUTuENUxvr0Wt+GK0dJBR8MQZewj?=
 =?us-ascii?Q?pGzGMK7r65eFioptiGdbeyQmliwP46Sk85mJ4jelIRakVhXWYD3j6sen3aLy?=
 =?us-ascii?Q?p3TgR6JQn/+1+nzFOhjwMSyj0rxZrx6BafA/vEkpuJefsN9xck/8bPM+Fedo?=
 =?us-ascii?Q?nsxLKfYhPvRB7rNXDJA/QxP4OdN2pT2fET8JMlP4wW0VeTaB47W53xgJzmDu?=
 =?us-ascii?Q?k63OC/BOA9ZnumXImFvDbPWrIIOosmhC6TEphd4aM/ETLd2z+aHKEJrdj3qC?=
 =?us-ascii?Q?wUASBkFKNCJ7rtkFHmMrBVqYRXDJSzUjZqpmg4zrfguEnDHOyeN+vwJ3LcIn?=
 =?us-ascii?Q?uZwDsJInVx/24HPRUHt/3fDBiwWK8y4i3QAcTrxju0zysA8XSZ6R+hksiBgO?=
 =?us-ascii?Q?8I0Ph6/sikmea6o6pD+SxMzBU5a4jTNNO8zKbuuuk4JrU1b/B4S+lmRpzhNF?=
 =?us-ascii?Q?fZ2QR7paGb65pkfoaob7sPRaTvv4OY7jGQrEGuFTpcOMnWNmIxiUN30KyRuL?=
 =?us-ascii?Q?2ydeQKIzD2mUjISIjYlGI6azdtIZsHlFRckjf7HXEoqTYDcluLHK8XFIYjd9?=
 =?us-ascii?Q?q86bSF2mIOL6qjGuB7OzBL4nijhD+z1HrsmJR2k/+JsPCh7+uVU7MMBVpsgq?=
 =?us-ascii?Q?xm7JtiRREbM5xZWOXa0LIY2Sn7Lx6MJ/FZB2MdL3C5N+RmOr+CAq/DKv9mQD?=
 =?us-ascii?Q?x/xeNZCOcpEUzJZDUeZXFbOgEH6jqIUUJLwMI7X4EU1lfKu5a80hzgS8K5SP?=
 =?us-ascii?Q?PD8dseIOkgSZC+8Oy6YVEGTST3HwsTeXiblDNKhuQT2RGAiGRWZ3us2WhdcH?=
 =?us-ascii?Q?W/MwIEYIOsY+ifxtdga/euJAX5GBCsD6qn5Jjrtz2d+Uj/g/wlFANYRycN13?=
 =?us-ascii?Q?BxY7gI13ESVgV1zfFYhtXqJ2TSh2oIoI/TSU9jZ85RmkbI1sAxy46vhK7dHr?=
 =?us-ascii?Q?4atxFJS03+0sYcdYJG+yZz1rleFOK+LFz5okUW9mcmw2dsCvFiDimTDHP8BV?=
 =?us-ascii?Q?C6s6qqS5qvQU1PoYwlIlOr3AxD4xkjCg+WpIvnm9695unEi0EGZkUeP2jHhU?=
 =?us-ascii?Q?nn4hGaB2PO53m1jodvt84bKLs3tm/hgSjlBQjAs7kmTu4Flz53K3lpngOVdg?=
 =?us-ascii?Q?JFHvMo1firHjI3hmNhwVjptukpg/Fx+DLfHLEK3DL8nTsrHLTHMr5zJ++uHA?=
 =?us-ascii?Q?H5c=3D?=
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a282acb7-6843-4ede-0ff2-08d972e1207e
X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Sep 2021 15:55:48.7070 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: 94YRJeV6KE7fMlZwjINyUEC4S6lYEPkEez5fOJObI7topULOcNNiSkHgQ/q0ZFLqp0h2/M9Fuq081DPSzSkfeg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR10MB3670
X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10101
 signatures=668682
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0
 suspectscore=0
 malwarescore=0 spamscore=0 mlxscore=0 phishscore=0 mlxlogscore=801
 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2109030001 definitions=main-2109080099
X-Proofpoint-GUID: jFhYSsx9i28hQTB3Gv0L48S6IqaBzauk
X-Proofpoint-ORIG-GUID: jFhYSsx9i28hQTB3Gv0L48S6IqaBzauk
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 50467
Cc: "50467 <at> debbugs.gnu.org" <50467 <at> debbugs.gnu.org>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

> ...keywords that start with a colon...
>=20
> One problem here is that use of the colon character in index entries
> should be avoided, as some Info readers could get confused by that
> (the colon is a special character in Info file format).

Indeed.  See bugs #18957 and #30478.

https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D18957

https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D30478




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 8 Sep 2021 06:31:54 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Sep 08 02:31:54 2021
Received: from localhost ([127.0.0.1]:58306 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mNr7h-0001Pu-RY
	for submit <at> debbugs.gnu.org; Wed, 08 Sep 2021 02:31:54 -0400
Received: from eggs.gnu.org ([209.51.188.92]:36814)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1mNr7f-0001Ph-V2
 for 50467 <at> debbugs.gnu.org; Wed, 08 Sep 2021 02:31:52 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e]:52638)
 by eggs.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <eliz@HIDDEN>)
 id 1mNr7a-0001W5-HF; Wed, 08 Sep 2021 02:31:46 -0400
Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:3639
 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1mNr7Y-0007LS-Gh; Wed, 08 Sep 2021 02:31:46 -0400
Date: Wed, 08 Sep 2021 09:31:53 +0300
Message-Id: <83k0jro9wm.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stefan Kangas <stefan@HIDDEN>
In-Reply-To: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 (message from Stefan Kangas on Wed, 8 Sep 2021 03:52:34 +0200)
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 50467
Cc: 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stefan Kangas <stefan@HIDDEN>
> Date: Wed, 8 Sep 2021 03:52:34 +0200
> 
> Please consider adding properties to the index of the elisp manual for
> easy access.

Which ones? all of them?  There are a lot of them, and we sometimes
have the same keyword used in different contexts to mean different
things, so we'd need a lot of disambiguation text to make unique
entries.

(And you mean keywords that start with a colon, not properties.
Right?)

One problem here is that use of the colon character in index entries
should be avoided, as some Info readers could get confused by that
(the colon is a special character in Info file format).

Also, most of the keywords are, or should be, found by using their
"family name".  For example, for faces we have "face attributes" in
the index.

That said, feel free to suggest additions to the indexing for the
important keywords, we can always discuss them one by one.

Thanks.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at 50467 <at> debbugs.gnu.org:


Received: (at 50467) by debbugs.gnu.org; 8 Sep 2021 05:51:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Sep 08 01:51:53 2021
Received: from localhost ([127.0.0.1]:58254 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mNqUy-0000LR-VW
	for submit <at> debbugs.gnu.org; Wed, 08 Sep 2021 01:51:53 -0400
Received: from quimby.gnus.org ([95.216.78.240]:55502)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1mNqUx-0000LB-Ph
 for 50467 <at> debbugs.gnu.org; Wed, 08 Sep 2021 01:51:52 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date:
 References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=0Bi3VqyOWUBTXhPthLzUxxRKBBZoqikzZbf9uM8GFz0=; b=nLV3FdjOIK9Ug/jCG8oZG/cqmE
 365MCySCvq7DHtyVU62eTFmRTWuJ8987G5EQbAtsarlz1RUoLP9DrP2jBBouIMvxccq08F1ZOFi6F
 2cHcgYwXRWQotUSInTmhYPzUw/vvq//xNL04ADnD8WfuqRM2pSl2nK8QKRfWzeOQ7Lf4=;
Received: from [84.212.220.105] (helo=elva)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1mNqUp-0007SG-40; Wed, 08 Sep 2021 07:51:45 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: Stefan Kangas <stefan@HIDDEN>
Subject: Re: bug#50467: Could :properties have index entries in the elisp
 manual?
References: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
Date: Wed, 08 Sep 2021 07:51:39 +0200
In-Reply-To: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
 (Stefan Kangas's message of "Wed, 8 Sep 2021 03:52:34 +0200")
Message-ID: <875yvb8vis.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 @@CONTACT_ADDRESS@@ for details.
 Content preview: Stefan Kangas <stefan@HIDDEN> writes: > Please consider
 adding properties to the index of the elisp manual for > easy access. > >
 Rationale: I find myself often looking for properties such as > :align-to
 in the elisp manual, but they are [...] 
 Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 50467
Cc: 50467 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Stefan Kangas <stefan@HIDDEN> writes:

> Please consider adding properties to the index of the elisp manual for
> easy access.
>
> Rationale: I find myself often looking for properties such as
> :align-to in the elisp manual, but they are not indexed.  This means
> that I have to look instead for them manually instead, which takes
> more time.

Sure, I think that's a good idea.

That'd basically be

@cindex @code{:align-to}, @code{display} text property

That's a mouthful...  I mean, these aren't text properties per se, but
properties when displaying a space-filling `display' property.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 8 Sep 2021 01:52:51 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Sep 07 21:52:51 2021
Received: from localhost ([127.0.0.1]:58104 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1mNmlf-0002i2-DE
	for submit <at> debbugs.gnu.org; Tue, 07 Sep 2021 21:52:51 -0400
Received: from lists.gnu.org ([209.51.188.17]:41304)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stefankangas@HIDDEN>) id 1mNmld-0002hi-HK
 for submit <at> debbugs.gnu.org; Tue, 07 Sep 2021 21:52:49 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:40492)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <stefankangas@HIDDEN>)
 id 1mNmld-0000ym-4o
 for bug-gnu-emacs@HIDDEN; Tue, 07 Sep 2021 21:52:49 -0400
Received: from mail-pg1-f172.google.com ([209.85.215.172]:33351)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <stefankangas@HIDDEN>)
 id 1mNmlb-0000sY-II
 for bug-gnu-emacs@HIDDEN; Tue, 07 Sep 2021 21:52:48 -0400
Received: by mail-pg1-f172.google.com with SMTP id u18so907125pgf.0
 for <bug-gnu-emacs@HIDDEN>; Tue, 07 Sep 2021 18:52:46 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:mime-version:from:date:message-id:subject:to;
 bh=n39En8Uzh+Grc6Vu7+61DGRK9nJVqPo1dVbWVaI0Bmw=;
 b=C7mS9fV4Rqcji9Gf1MbkPPTN8nyI2kjOAct08UprP7oTiAuGn+uXoPCfHhrPb0DeHN
 iUoiqBYbGMv8vfNUXqOgKPj7QAYqM8b2diaVWrWrSa0AQeOBRwB4Z1IWlmnlm0yxU88z
 FF3d123BOLgdyWt02TcVTbJZRFsLgtFlj8qp7cTKOXKqBPNhX436vAodfgceRXQBe7MB
 0ay5lgF2YDFxKqo6Q+QRSwwvncqzYGwc+Ed0fsvazOm4k45+XqohCSw5DGCDl0DtbFxP
 tw9z2264cLPNj/zGw4Y5jvwK8s8S6OQi+lqf2lr+lxFxEZYF5iBjR4mrze1FDuDpwNwI
 2MHQ==
X-Gm-Message-State: AOAM53094L43koMR2G1XVdoM9QKXX5v7ymaJzmMcn4y1pxaXGFC+4Z3R
 3QYMi1z1h0p2jHl3XEwiusQkjNH+XKeDKFSHCzGV/Y4xp48=
X-Google-Smtp-Source: ABdhPJyyEJCwivWwGfCYf5Lhw61DeS6C5Xy1ngEEBYTjAdL2Y2dO0LqigV/xk+aYFN6w4/7CXQu6BzmEK29S/lnu760=
X-Received: by 2002:a62:80d8:0:b0:3f2:72f5:bb31 with SMTP id
 j207-20020a6280d8000000b003f272f5bb31mr1172955pfd.0.1631065964921; Tue, 07
 Sep 2021 18:52:44 -0700 (PDT)
MIME-Version: 1.0
From: Stefan Kangas <stefan@HIDDEN>
Date: Wed, 8 Sep 2021 03:52:34 +0200
Message-ID: <CADwFkmkkta5ZD6wxUu3EhVmko2KakYwW_n7qA8jqRAYv_NqF+w@HIDDEN>
Subject: Could :properties have index entries in the elisp manual?
To: bug-gnu-emacs@HIDDEN
Content-Type: text/plain; charset="UTF-8"
Received-SPF: pass client-ip=209.85.215.172;
 envelope-from=stefankangas@HIDDEN; helo=mail-pg1-f172.google.com
X-Spam_score_int: -13
X-Spam_score: -1.4
X-Spam_bar: -
X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25,
 FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249,
 RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -0.8 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.8 (-)

Severity: wishlist

Please consider adding properties to the index of the elisp manual for
easy access.

Rationale: I find myself often looking for properties such as
:align-to in the elisp manual, but they are not indexed.  This means
that I have to look instead for them manually instead, which takes
more time.

Perhaps there is some conflict of interest between having a usable
index inside Emacs and the length of the printed manual.  One way to
side-step that would be to put them in the index only in the info
version of the manual, while excluding them from the print version.  I
don't know if texinfo supports this.

If we decide to go ahead with this wishlist request, we would only
need to add a few properties as examples.  We could then close this
bug add the rest in over time.  Perhaps some properties are more
important to add than others, and perhaps others still would not even
make sense adding.




Acknowledgement sent to Stefan Kangas <stefan@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#50467; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Thu, 25 Aug 2022 14:30:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.