From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#70846: Imenu flatten Date: Mon, 13 May 2024 09:57:43 +0300 Organization: LINKOV.NET Message-ID: <86frumtd08.fsf@mail.linkov.net> References: <861q6b7xus.fsf@mail.linkov.net> <86le4j53y9.fsf@gnu.org> <86ttj6nopi.fsf@mail.linkov.net> <86v83m3z0v.fsf@gnu.org> <86o79dmx8u.fsf@mail.linkov.net> <8634qo3ag0.fsf@gnu.org> <86o79bzfh1.fsf@mail.linkov.net> <865xvj1p56.fsf@gnu.org> <86cyprx9z9.fsf@mail.linkov.net> <86a5kvymof.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1462"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) Cc: 70846@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon May 13 09:01:11 2024 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 1s6PgN-0000Iz-HW for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 13 May 2024 09:01:11 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1s6Pg4-0004Pt-LD; Mon, 13 May 2024 03:00:52 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s6PfG-0004JF-VB for bug-gnu-emacs@gnu.org; Mon, 13 May 2024 03:00:05 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1s6PfG-0001Gp-LD for bug-gnu-emacs@gnu.org; Mon, 13 May 2024 03:00:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1s6PfG-0003It-PV for bug-gnu-emacs@gnu.org; Mon, 13 May 2024 03:00:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 13 May 2024 07:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 70846 X-GNU-PR-Package: emacs Original-Received: via spool by 70846-submit@debbugs.gnu.org id=B70846.171558356512649 (code B ref 70846); Mon, 13 May 2024 07:00:02 +0000 Original-Received: (at 70846) by debbugs.gnu.org; 13 May 2024 06:59:25 +0000 Original-Received: from localhost ([127.0.0.1]:58931 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s6Pef-0003Hs-BQ for submit@debbugs.gnu.org; Mon, 13 May 2024 02:59:25 -0400 Original-Received: from relay4-d.mail.gandi.net ([217.70.183.196]:33213) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1s6Ped-0003Hf-EE for 70846@debbugs.gnu.org; Mon, 13 May 2024 02:59:23 -0400 Original-Received: by mail.gandi.net (Postfix) with ESMTPSA id 11262E0009; Mon, 13 May 2024 06:58:56 +0000 (UTC) In-Reply-To: <86a5kvymof.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 12 May 2024 20:17:36 +0300") X-GND-Sasl: juri@linkov.net 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:284957 Archived-At: >> >> >> >> BTW, the manual says in (info "(emacs) Imenu"): >> >> >> >> >> >> >> >> You can customize the way the menus are sorted by setting the >> >> >> >> variable ‘imenu-sort-function’. By default, names are ordered as they >> >> >> >> occur in the buffer; if you want alphabetic sorting, use the symbol >> >> >> >> ‘imenu--sort-by-name’ as the value. You can also define your own >> >> >> >> comparison function by writing Lisp code. >> >> >> >> >> >> The "menus" above are pertaining only to popup menus, >> >> >> and the variable ‘imenu-sort-function’ can't be used >> >> >> to change the sorting order of Imenu completion candidates. >> >> >> Only the following customization changes this order: >> >> >> >> >> >> (add-to-list 'completion-category-overrides >> >> >> '(imenu (display-sort-function . identity))) >> >> >> >> >> >> Using this setting is especially essential for Imenu >> >> >> on a PDF document with doc-view.el to keep the order >> >> >> of chapters for the table of contents. >> >> >> >> >> >> But I have no idea how to document this customization. >> >> > >> >> > Now I'm confused: I thought the change you installed was supposed to >> >> > make sure the completion candidates are sorted using the same sort >> >> > order as determined by imenu-sort-function. If not, then what did >> >> > your change do in this matter? >> >> >> >> Completions can be sorted only by 'display-sort-function'. >> >> There is no other way to sort completions. >> > >> > Then what did the change you installed do wrt sorting of candidates? >> >> It allows the users to customize the sorting order of >> completion candidates displayed by 'imenu'. > > And the only way to customize that is via add-to-list as above? IOW, > without the change you installed, even the add-to-list method would > not have worked? Yes, there was no way to customize sorting of Imenu completion candidates. Ok, I could add display-sort-function directly to the imenu completing-read that will depend on the value of display-sort-function. Then there will be no need to change the manual.