unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Stefan Monnier <monnier@IRO.UMontreal.CA>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 9891@debbugs.gnu.org
Subject: bug#9891: 24.0.90; Duplicated entry at the info directory
Date: Wed, 02 Nov 2011 15:52:54 -0400	[thread overview]
Message-ID: <jwv4nyme31q.fsf-monnier+emacs@gnu.org> (raw)
In-Reply-To: <83hb2mmmuq.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 02 Nov 2011 19:54:21 +0200")

>> I think I'm beginning to understand: the problem is that the "top-level
>> dir" is used in two very different contexts:
>> - for interactive use, where it should be shortish and avoid redundancy.
>> - for non-interactive use, typically to make `info' emulate `man', where
>> the toplevel `dir' is abused as an index.  This only works for
>> specially built `dir' files and I don't see it used in Debian,
>> for instance.
>> The Info-dir-remove-duplicates is clearly meant for the first use and
>> I think that's the most important use, so if we want to make it handle
>> the second case we'll have to make sure it doesn't hurt the first.
> What would constitute "hurting the first use case"?

An example of hurting the first use case would be to keep "* GDB: (gdb)"
along with "* Gdb: (gdb)".

> I intend to make a change whereby the header lines we maintain on
> Emacs's info/dir file are not deleted (by removing ("Emacs . "Emacs)
> from Info-streamline-headers) -- would that "hurt", and if so, why?

I added that code because I bumped into different dir entries which used
slightly different header lines for fundamentally the same purpose.
E.g. my current /usr/share/info/dir contains:

   Emacs
   * Ada mode: (emacs-21/ada-mode).
                                   The GNU Emacs mode for editing Ada.
   [...]
   Emacs editing modes
   * Ada mode: (emacs-23/ada-mode).
                                   Emacs mode for editing and compiling Ada code.
   [...]
   Emacs network features
   [...]
   * TRAMP: (emacs-23/tramp).      Transparent Remote Access, Multiple Protocol 
                                     Emacs remote file access via rsh and rcp.
   [...]
   GNU Emacs
   * TRAMP: (emacs-22/tramp).      Transparent Remote Access, Multiple Protocol 
                                     GNU Emacs remote file access via rsh and rcp.

And of course, between these headings appear some others that aren't
related to Emacs.  It's a pretty messy part of the Texinfo
infrastructure and would deserve to be improved.


        Stefan





  reply	other threads:[~2011-11-02 19:52 UTC|newest]

Thread overview: 29+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-10-27 19:15 bug#9891: 24.0.90; Duplicated entry at the info directory Dani Moncayo
2011-10-28 16:38 ` Glenn Morris
2011-10-28 17:39   ` Dani Moncayo
2011-10-29 18:23     ` Glenn Morris
2011-10-29 18:55       ` Dani Moncayo
2011-10-29 19:16         ` Dani Moncayo
2011-10-29 20:41         ` Dani Moncayo
2011-10-31 18:57           ` Eli Zaretskii
2011-10-29 20:59         ` Eli Zaretskii
2011-10-29 21:19           ` Dani Moncayo
2011-10-31 18:53         ` Eli Zaretskii
2011-10-31 18:49     ` Eli Zaretskii
2011-11-01  9:29       ` Juri Linkov
2011-11-01 11:32         ` Eli Zaretskii
2011-11-01 22:31           ` Juri Linkov
2011-11-02  1:39             ` Stefan Monnier
2011-11-02 10:01               ` Juri Linkov
2011-11-02  3:55             ` Eli Zaretskii
2011-11-02 10:07               ` Juri Linkov
2011-11-02 10:57                 ` Eli Zaretskii
2011-11-02 12:41                   ` Stefan Monnier
2011-11-02 13:03                     ` Eli Zaretskii
2011-11-02 14:05                       ` Stefan Monnier
2011-11-02 14:33                         ` Drew Adams
2011-11-02 17:28                         ` Andreas Schwab
2011-11-02 17:54                         ` Eli Zaretskii
2011-11-02 19:52                           ` Stefan Monnier [this message]
2011-11-05 13:54                             ` Eli Zaretskii
2022-04-26 13:17     ` Lars Ingebrigtsen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=jwv4nyme31q.fsf-monnier+emacs@gnu.org \
    --to=monnier@iro.umontreal.ca \
    --cc=9891@debbugs.gnu.org \
    --cc=eliz@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).