GNU bug report logs - #1484
23.0.60; Apropos output: <v> etc.?

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 1484 in the body.
You can then email your comments to 1484 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.60; Apropos output: <v> etc.?
Date: Wed, 3 Dec 2008 09:08:49 -0800

M-x apropos now uses tags such as <v>, <f>, <p>, instead of Variable,
Function, Plist. Is this a bug? I don't see anything in NEWS about it
(searching for "apropos").
 
It's certainly more opaque (less clear) than using plain English
words. And there is no explanation (e.g. legend) of this new
convention in the Apropos output buffer. How will a user know what <p>
means?
 

In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-11-24 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 

Message #10 received at 1484-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 1484-done <at> debbugs.gnu.org
Subject: Re: bug#1484: 23.0.60; Apropos output: <v> etc.?
Date: Wed, 03 Dec 2008 16:57:15 -0500

> M-x apropos now uses tags such as <v>, <f>, <p>, instead of Variable,
> Function, Plist. Is this a bug? I don't see anything in NEWS about it
> (searching for "apropos").

Indeed, this is odd: the short form is now used in the default layout,
whereas the long form is now used in the compact layout.  It should be
the other way around.
The pach below should fix it.  Thanks.
 

        Stefan


=== modified file 'lisp/apropos.el'
--- lisp/apropos.el	2008-08-31 00:41:24 +0000
+++ lisp/apropos.el	2008-12-03 21:52:25 +0000
@@ -1096,8 +1096,8 @@
 	 'face 'default 'apropos-symbol (car apropos-item))
       (insert-text-button
        (if apropos-compact-layout
-           (button-type-get type 'apropos-label)
-         (format "<%s>" (button-type-get type 'apropos-short-label)))
+           (format "<%s>" (button-type-get type 'apropos-short-label))
+         (button-type-get type 'apropos-label))
        'type type
        ;; Can't use the default button face, since user may have changed the
        ;; variable!  Just say `no' to variables containing faces!

Message #11 received at 1484-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Stefan Monnier'" <monnier <at> iro.umontreal.ca>
Cc: <1484-done <at> debbugs.gnu.org>
Subject: RE: bug#1484: 23.0.60; Apropos output: <v> etc.?
Date: Wed, 3 Dec 2008 14:01:41 -0800

> > M-x apropos now uses tags such as <v>, <f>, <p>, instead of 
> > Variable, Function, Plist. Is this a bug? I don't see anything in 
> > NEWS about it (searching for "apropos").
> 
> Indeed, this is odd: the short form is now used in the default layout,
> whereas the long form is now used in the compact layout.  It should be
> the other way around.
> The pach below should fix it.  Thanks.

Glad the report helped. But what are the long and short forms? Is that
documented somewhere (didn't see anything in NEWS)? Should the (short form)
Apropos buffer explain that abbreviated notation?

Message #12 received at 1484-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: <1484-done <at> debbugs.gnu.org>
Subject: Re: bug#1484: 23.0.60; Apropos output: <v> etc.?
Date: Thu, 04 Dec 2008 08:28:02 -0500

> Glad the report helped. But what are the long and short forms? Is that
> documented somewhere (didn't see anything in NEWS)? Should the (short form)
> Apropos buffer explain that abbreviated notation?

C-h v apropos-compact-layout


        Stefan

Message #13 received at 1484-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Stefan Monnier'" <monnier <at> iro.umontreal.ca>
Cc: <1484-done <at> debbugs.gnu.org>
Subject: RE: bug#1484: 23.0.60; Apropos output: <v> etc.?
Date: Thu, 4 Dec 2008 08:23:58 -0800

> > Glad the report helped. But what are the long and short 
> > forms? Is that documented somewhere (didn't see anything
> > in NEWS)? Should the (short form) Apropos buffer explain
> > that abbreviated notation?
> 
> C-h v apropos-compact-layout

A user is unlikely to know about this. How about mentioning this change in NEWS
or even documenting it in the Emacs manual?

Also, the variable should be autoloaded. In emacs -Q, C-h v doesn't recognize it
until you load apropos.el.

Message #14 received at 1484-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Stefan Monnier <monnier <at> IRO.UMontreal.CA>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: <1484-done <at> debbugs.gnu.org>
Subject: Re: bug#1484: 23.0.60; Apropos output: <v> etc.?
Date: Thu, 04 Dec 2008 14:47:34 -0500

> Also, the variable should be autoloaded. In emacs -Q, C-h v doesn't
> recognize it until you load apropos.el.

Welcome to Emacs.  99% of Emacs's variables behave like that.  It's not
a bug.


        Stefan

Previous Next

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