overlay-buffer on deleted overlays.

[Lute Kamstra <Lute.Kamstra.lists@xs4all.nl>]

Currently, if an overlay has been deleted, overlay-buffer returns nil.
What about documenting this?

Lute.


*** lispref/display.texi	29 Jan 2005 13:58:04 -0000	1.147
--- lispref/display.texi	21 Feb 2005 14:57:52 -0000
***************
*** 1339,1345 ****
  @end defun
  
  @defun overlay-buffer overlay
! This function returns the buffer that @var{overlay} belongs to.
  @end defun
  
  @defun delete-overlay overlay
--- 1339,1346 ----
  @end defun
  
  @defun overlay-buffer overlay
! This function returns the buffer that @var{overlay} belongs to.  It
! returns @code{nil}, if @var{overlay} has been deleted.
  @end defun
  
  @defun delete-overlay overlay
Index: src/buffer.c
===================================================================
RCS file: /cvsroot/emacs/emacs/src/buffer.c,v
retrieving revision 1.473
diff -c -r1.473 buffer.c
*** src/buffer.c	3 Feb 2005 07:33:52 -0000	1.473
--- src/buffer.c	21 Feb 2005 14:58:03 -0000
***************
*** 1,6 ****
  /* Buffer manipulation primitives for GNU Emacs.
!    Copyright (C) 1985,86,87,88,89,93,94,95,97,98, 1999, 2000, 2001, 02, 03, 2004
! 	Free Software Foundation, Inc.
  
  This file is part of GNU Emacs.
  
--- 1,6 ----
  /* Buffer manipulation primitives for GNU Emacs.
!    Copyright (C) 1985, 86, 87, 88, 89, 93, 94, 95, 97, 98, 99, 
!      2000, 01, 02, 03, 04, 2005 Free Software Foundation, Inc. 
  
  This file is part of GNU Emacs.
  
***************
*** 3830,3836 ****
  }
  
  DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
!        doc: /* Return the buffer OVERLAY belongs to.  */)
       (overlay)
         Lisp_Object overlay;
  {
--- 3830,3837 ----
  }
  
  DEFUN ("overlay-buffer", Foverlay_buffer, Soverlay_buffer, 1, 1, 0,
!        doc: /* Return the buffer OVERLAY belongs to.
! Return nil if OVERLAY has been deleted.  */)
       (overlay)
         Lisp_Object overlay;
  {