Re: doc strings of reverse and nreverse.

[Luc Teirlinck]

I took a look at the C code of Freverse and Fnreverse and they do
indeed always return the entire reversed list (except when they throw
an error, of course).  So why those confusing doc strings?  The
following would get rid of them.  I could commit if desired.


===File ~/fns-diff==========================================
cd ~/emacscvsdir/emacs/src/
diff -c /home/teirllm/fns.old.c /home/teirllm/emacscvsdir/emacs/src/fns.c
*** /home/teirllm/fns.old.c     Mon Nov 17 21:24:17 2003
--- /home/teirllm/emacscvsdir/emacs/src/fns.c   Wed Nov 19 22:22:57 2003
***************
*** 1840,1846 ****
  
  DEFUN ("nreverse", Fnreverse, Snreverse, 1, 1, 0,
         doc: /* Reverse LIST by modifying cdr pointers.
! Returns the beginning of the reversed list.  */)
       (list)
       Lisp_Object list;
  {
--- 1840,1846 ----
  
  DEFUN ("nreverse", Fnreverse, Snreverse, 1, 1, 0,
         doc: /* Reverse LIST by modifying cdr pointers.
! Return the reversed list.  */)
       (list)
       Lisp_Object list;
  {
***************
*** 1863,1869 ****
  }
  
  DEFUN ("reverse", Freverse, Sreverse, 1, 1, 0,
!        doc: /* Reverse LIST, copying.  Returns the beginning of the reversed 
list.
  See also the function `nreverse', which is used more often.  */)
       (list)
       Lisp_Object list;
--- 1863,1869 ----
  }
  
  DEFUN ("reverse", Freverse, Sreverse, 1, 1, 0,
!        doc: /* Reverse LIST, copying.  Return the reversed list.
  See also the function `nreverse', which is used more often.  */)
       (list)
       Lisp_Object list;

Diff finished at Wed Nov 19 22:23:49
============================================================