unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Patch for (elisp's) buffers.texi.
@ 2005-08-17 11:57 Alan Mackenzie
  2005-08-17 18:25 ` Eli Zaretskii
  2005-08-18 14:47 ` Richard M. Stallman
  0 siblings, 2 replies; 5+ messages in thread
From: Alan Mackenzie @ 2005-08-17 11:57 UTC (permalink / raw)


Hi, Emacs!

I submitted this patch on Monday 15th August (Subject: Re: (elisp's)
buffer.texi: Vagueness in chapter "The Buffer List"), but it seems to
have been overlooked, possibly because it was a response to my own rant.
So, here it is again!

This patch is about the description of the buffer list.  The reasons I
want this patch are that the current buffers.texi (V 1.43) is a bit vague
about the buffer list.  In particular,

1-/ It doesn't say that newly created buffers get put on the END of the
  buffer list.

2-/ It is a bit vague on which functions "select" a buffer to move it to the
  front of the list.

3-/ It doesn't state explicitly that the buffer list can not be directly
  manipulated in Lisp.  This is so unusual in Emacs (are there any other
  structures visible in Lisp that likewise can't be manipulated?) that it
  seems worthwhile pointing out, to save hackers the time which would be
  wasted looking for manipulation functions.

So, here's the patch again.  Please consider installing it.


2005-08-15  Alan Mackenzie  <acm@muc.de>

	* buffers.texi (The Buffer List): Clarify the manipulation of the
	buffer list.


*** buffers.texi	Sun Aug 14 09:23:39 2005
--- buffers-1.43.new.texi	Mon Aug 15 09:27:29 2005
***************
*** 757,772 ****
  @section The Buffer List
  @cindex buffer list

!   The @dfn{buffer list} is a list of all live buffers.  Creating a
! buffer adds it to this list, and killing a buffer removes it.  The
! order of the buffers in the list is based primarily on how recently
! each buffer has been displayed in the selected window.  Buffers move
! to the front of the list when they are selected (selecting a window
! that already displays the buffer counts as selecting the buffer), and
! to the end when they are buried (see @code{bury-buffer}, below).
! Several functions, notably @code{other-buffer}, use this ordering.  A
! buffer list displayed for the user also follows this order.

    In addition to the fundamental Emacs buffer list, each frame has its
  own version of the buffer list, in which the buffers that have been
  selected in that frame come first, starting with the buffers most
--- 757,775 ----
  @section The Buffer List
  @cindex buffer list

!   The @dfn{buffer list} is a list of all live buffers.  The order of
! the buffers in the list is based primarily on how recently each buffer
! has been displayed in a window.  Several functions, notably
! @code{other-buffer}, use this ordering.  A buffer list displayed for
! the user also follows this order.

+   Creating a buffer adds it to the end of the buffer list, and killing
+ a buffer removes it.  Buffers move to the front of the list when they
+ are selected for display in a window (@pxref{Displaying Buffers}), and
+ to the end when they are buried (see @code{bury-buffer}, below).
+ There are no functions available to the Lisp programmer which directly
+ manipulate the buffer list.
+
    In addition to the fundamental Emacs buffer list, each frame has its
  own version of the buffer list, in which the buffers that have been
  selected in that frame come first, starting with the buffers most


-- 
Alan Mackenzie (Munich, Germany)

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Patch for (elisp's) buffers.texi.
  2005-08-17 11:57 Patch for (elisp's) buffers.texi Alan Mackenzie
@ 2005-08-17 18:25 ` Eli Zaretskii
  2005-08-17 20:32   ` Alan Mackenzie
  2005-08-18 14:47 ` Richard M. Stallman
  1 sibling, 1 reply; 5+ messages in thread
From: Eli Zaretskii @ 2005-08-17 18:25 UTC (permalink / raw)
  Cc: emacs-devel

> Date: Wed, 17 Aug 2005 11:57:08 +0000 (GMT)
> From: Alan Mackenzie <acm@muc.de>
> 
> I submitted this patch on Monday 15th August (Subject: Re: (elisp's)
> buffer.texi: Vagueness in chapter "The Buffer List"), but it seems to
> have been overlooked, possibly because it was a response to my own rant.

Wow!  This _must_ set some kind of record in impatience: only 2 days
passed since you posted the patch, and you already think that it was
overlooked!

Please be more patient.  If no disaster strikes, I will install your
patch this weekend.

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Patch for (elisp's) buffers.texi.
  2005-08-17 18:25 ` Eli Zaretskii
@ 2005-08-17 20:32   ` Alan Mackenzie
  0 siblings, 0 replies; 5+ messages in thread
From: Alan Mackenzie @ 2005-08-17 20:32 UTC (permalink / raw)
  Cc: emacs-devel

Hi, Eli!

On Wed, 17 Aug 2005, Eli Zaretskii wrote:

>> Date: Wed, 17 Aug 2005 11:57:08 +0000 (GMT)
>> From: Alan Mackenzie <acm@muc.de>

>> I submitted this patch on Monday 15th August (Subject: Re: (elisp's)
>> buffer.texi: Vagueness in chapter "The Buffer List"), but it seems to
>> have been overlooked, possibly because it was a response to my own rant.

>Wow!  This _must_ set some kind of record in impatience: only 2 days
>passed since you posted the patch, and you already think that it was
>overlooked!

Well, you people on emacs-devel are normally _very_ quick in replying.
And my first post in that thread was grumpy enough that nobody could be
blamed for ignoring my followup.  ;-)

But sorry for causing the annoyance, all the same.

>Please be more patient.  If no disaster strikes, I will install your
>patch this weekend.

Much appreciated!  I'll be a \(bit\|lot\) more patient next time.

-- 
Alan Mackenzie (Munich, Germany)

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Patch for (elisp's) buffers.texi.
  2005-08-17 11:57 Patch for (elisp's) buffers.texi Alan Mackenzie
  2005-08-17 18:25 ` Eli Zaretskii
@ 2005-08-18 14:47 ` Richard M. Stallman
  2005-08-20 12:00   ` Eli Zaretskii
  1 sibling, 1 reply; 5+ messages in thread
From: Richard M. Stallman @ 2005-08-18 14:47 UTC (permalink / raw)
  Cc: emacs-devel

I am in favor of installing your patch.
Would someone please install it?

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Patch for (elisp's) buffers.texi.
  2005-08-18 14:47 ` Richard M. Stallman
@ 2005-08-20 12:00   ` Eli Zaretskii
  0 siblings, 0 replies; 5+ messages in thread
From: Eli Zaretskii @ 2005-08-20 12:00 UTC (permalink / raw)
  Cc: acm, emacs-devel

> From: "Richard M. Stallman" <rms@gnu.org>
> Date: Thu, 18 Aug 2005 10:47:48 -0400
> Cc: emacs-devel@gnu.org
> 
> I am in favor of installing your patch.
> Would someone please install it?

I just did.

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2005-08-20 12:00 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2005-08-17 11:57 Patch for (elisp's) buffers.texi Alan Mackenzie
2005-08-17 18:25 ` Eli Zaretskii
2005-08-17 20:32   ` Alan Mackenzie
2005-08-18 14:47 ` Richard M. Stallman
2005-08-20 12:00   ` Eli Zaretskii

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).