From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.devel Subject: Re: Predicate for true lists Date: Mon, 22 Apr 2019 13:58:01 +0100 Message-ID: <877ebmp57q.fsf@tcd.ie> References: <87fu3vdjjk.fsf@tcd.ie> <83h8lcnbxb.fsf@gnu.org> <87sh4s9poo.fsf@tcd.ie> <87k1q49p0i.fsf@tcd.ie> <87efgbbq2p.fsf@tcd.ie> <87a7gz8hp2.fsf@tcd.ie> <875zrn9bum.fsf@tcd.ie> <835zrm7fow.fsf@gnu.org> <878swivtcr.fsf@gmail.com> <87r2aayln2.fsf@tcd.ie> <87lg0hyidf.fsf@tcd.ie> <87tvew7bxj.fsf@tcd.ie> <83a7gne5w8.fsf@gnu.org> <87h8argqhu.fsf@tcd.ie> <83r29v87sz.fsf@gnu.org> <87imv76nos.fsf@tcd.ie> <83imv68rwy.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="228830"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: branham@utexas.edu, monnier@iro.umontreal.ca, drew.adams@oracle.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 22 14:58:41 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hIYWu-000xQW-PC for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2019 14:58:40 +0200 Original-Received: from localhost ([127.0.0.1]:37089 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hIYWt-0001Dw-RJ for ged-emacs-devel@m.gmane.org; Mon, 22 Apr 2019 08:58:39 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:56615) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hIYWN-0001Dm-0S for emacs-devel@gnu.org; Mon, 22 Apr 2019 08:58:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hIYWL-0003hb-W1 for emacs-devel@gnu.org; Mon, 22 Apr 2019 08:58:06 -0400 Original-Received: from mail-ed1-x530.google.com ([2a00:1450:4864:20::530]:47014) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hIYWL-0003gP-Gx for emacs-devel@gnu.org; Mon, 22 Apr 2019 08:58:05 -0400 Original-Received: by mail-ed1-x530.google.com with SMTP id d1so9352762edd.13 for ; Mon, 22 Apr 2019 05:58:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=jagjOUh/oIwmPKouuOMDsZ4gEZQt+PAhwQh8bqaGNTc=; b=dY3wU0MU0nHRakA5U1Xi1rh7mcr+zeYkl73uNFjBQtoZqPIrlaffCysc61llJqWCzK EWlJ2N4UBOlI9xVqg1rtb63gbUdXBDQIjD6icTtYnHpCy6uLTK/03L4+lenAMcJahna/ DLOoSjoivsx2CNzNaigp6aE+NxBnN+EmGjdDC2tuKVUIzygoVK8CTyLQRZjWRBrM6MOd e1erYhfshDl5k09g1ljfoDndL5v11CNSv3AAC1MYAAQtSiT8hFk0d9HLEcPFVDYbBEkj iXl2GbOldUa3aeg4FvFBCvwPwuA9qW9HeyFcRKAmvETk2O4SnHWr2P1RZVMsstcZP3Dp bMnQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=jagjOUh/oIwmPKouuOMDsZ4gEZQt+PAhwQh8bqaGNTc=; b=ul5P5eorasl/qh2Or0yO0dBsGn5TiAzn8q6pyZDRS7weefWXNVNW54cjT8KVYmchVA 9I5r5Jpk9WFufpWtaH0tSrzTuEqYc3ODIFaKdt7DbLcr4Hq3Bd5dng1VgHxao4DceHmG EQKDDBz2vPR2Dkb7pbpSJJVInk6AENrxnGptY16i+UxxPX7Andx7e+yZHcM4K5jskFNK jNe+WtDAIdgN4bmLSecsc9R02A+K3DOeEkMbOxrlBxO52aQ18Ua9dEzJc9HH29xqNSe5 QgOBT28Iv27Dv57ch71EVy/QZHpwKxuMgB9fglxiQjp+lucMFAibl1o+5TgpywYqztRB Fffg== X-Gm-Message-State: APjAAAWA/vOOfy0Am5TqVTr8jTk0fQsZvv9FlDU94O8dI54vODXNb3M+ FVxz6zNSXpwxqkG5oEOWRMHSVw== X-Google-Smtp-Source: APXvYqzORyu7io4fBY3BVUy6v9hfJmeKwHDkvPUxX/vSPx67qN3YDuIYBVC7wM6aIk5Sn1j6h9jwwA== X-Received: by 2002:a50:9172:: with SMTP id f47mr12216558eda.233.1555937883826; Mon, 22 Apr 2019 05:58:03 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:8f5:8e00:4345:7c72]) by smtp.gmail.com with ESMTPSA id j92sm3646877edb.34.2019.04.22.05.58.02 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Mon, 22 Apr 2019 05:58:02 -0700 (PDT) In-Reply-To: <83imv68rwy.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 22 Apr 2019 09:39:41 +0300") X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::530 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:235762 Archived-At: Eli Zaretskii writes: >> From: "Basil L. Contovounesios" >> Cc: , , , >> Date: Sun, 21 Apr 2019 22:41:39 +0100 >> >> > Each time you write @cindex (or @findex, or @vindex, or ...), the >> > entry you wrote is added to the Index, and it points to the place >> > where you wrote the above. >> >> I understood this, but thought that every section relevant to some key >> should be indexed by that key, not just the section which defines it. >> I understand now that this is not the case. > > This is not the case. The index entry should point to the place where > the subject is described and discussed in its fullest. If there are > certain specific aspects of the subject whose description is elsewhere > (e.g., because it would be out of place or inappropriate as part of > the main description, perhaps because some missing context), then add > qualified index entries that point to those other places, as in > > @cindex foo -- the main index entry > @cindex foo, and bar -- index entry for discussion of foo in context of bar > > Here are two real-life examples of the latter: > > @cindex display property, and point display > @cindex display property, unsafe evaluation Makes sense, thanks for explaining. -- Basil