GNU bug report logs - #5608
23.1.92; ibuffer.el lacks instructions

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 5608 in the body.
You can then email your comments to 5608 AT debbugs.gnu.org in the normal way.

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

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: jidanni <at> jidanni.org
To: bug-gnu-emacs <at> gnu.org
Subject: 23.1.92; ibuffer.el lacks instructions
Date: Sat, 20 Feb 2010 08:38:20 +0800

In ibuffer.el we see

  ;; ibuffer.el is an advanced replacement for the `buffer-menu' which
  ;; is normally distributed with Emacs.  Its interface is intended to
  ;; be analogous to that of Dired.

and

  (defgroup ibuffer nil
    "An advanced replacement for `buffer-menu'.

  Ibuffer allows you to operate on buffers in a manner much like Dired.
  Operations include sorting, marking by regular expression, and
  the ability to filter the displayed buffers by various criteria."

However nowhere is it mentioned what one should do to their .emacs file
to become a regular ibuffer user. It should mention rebinding stanzas or
"put" commands, etc.

Message #10 received at 5608 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: jidanni <at> jidanni.org
Cc: 5608 <at> debbugs.gnu.org
Subject: Re: bug#5608: 23.1.92; ibuffer.el lacks instructions
Date: Sun, 30 Jun 2019 08:44:23 +0200

[Message part 1 (text/plain, inline)]

tags 5608 + patch
quit

jidanni <at> jidanni.org writes:
> In ibuffer.el we see
>
>   ;; ibuffer.el is an advanced replacement for the `buffer-menu' which
>   ;; is normally distributed with Emacs.  Its interface is intended to
>   ;; be analogous to that of Dired.
>
> and
>
>   (defgroup ibuffer nil
>     "An advanced replacement for `buffer-menu'.
>
>   Ibuffer allows you to operate on buffers in a manner much like Dired.
>   Operations include sorting, marking by regular expression, and
>   the ability to filter the displayed buffers by various criteria."
>
> However nowhere is it mentioned what one should do to their .emacs file
> to become a regular ibuffer user. It should mention rebinding stanzas or
> "put" commands, etc.

I took a stab at this.  Please see the attached patch.

I also took the opportunity to remove redundant :group args from
defcustoms.

Thanks,
Stefan Kangas

[0001-Document-normal-usage-in-ibuffer.el.patch (application/octet-stream, attachment)]

Message #15 received at 5608 <at> debbugs.gnu.org (full text, mbox):

From: Noam Postavsky <npostavs <at> gmail.com>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 5608 <at> debbugs.gnu.org, jidanni <at> jidanni.org
Subject: Re: bug#5608: 23.1.92; ibuffer.el lacks instructions
Date: Mon, 22 Jul 2019 23:16:36 -0400

tags 5608 fixed
close 5608 27.1
quit

> From: Stefan Kangas <stefankangas <at> gmail.com>
> Date: Sun, 30 Jun 2019 08:31:21 +0200
> Subject: [PATCH] Document normal usage in ibuffer.el
>
> * lisp/ibuffer.el (Commentary): Document normal usage. (Bug#5608)
> Remove redundant :group args.

Pushed to master.

> @@ -1811,7 +1789,6 @@ ibuffer-locked-buffer
>      (t (:foreground "brown4")))
>    "Face used for locked buffers in Ibuffer."
>    :version "26.1"
> -  :group 'ibuffer
>    :group 'font-lock-highlighting-faces)
>  (defvar ibuffer-locked-buffer 'ibuffer-locked-buffer)

Except for this hunk, because that :group arg is not redundant.

97477edaf2 2019-07-22T23:13:16-04:00 "Document normal usage in ibuffer.el"
https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=97477edaf2044e51696f46b166b43801893156a3

Previous Next

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