GNU bug report logs - #18253
24.4.50; doc string of `remq': correct it per the doc of `remove'

Previous Next

Full log

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

From: Drew Adams <drew.adams <at> oracle.com>
To: tsugutomo.enami <at> jp.sony.com, Christoph <cschol2112 <at> gmail.com>
Cc: 18253 <at> debbugs.gnu.org
Subject: RE: bug#18253: 24.4.50; doc string of `remq': correct it per the doc
 of `remove'
Date: Mon, 25 Aug 2014 15:37:27 -0700 (PDT)

> > > Please explicitly say that `remq' returns a *copy* of LIST, just as we
> > > do in the doc string of `remove'.  It does *not* "Return LIST with all
> > > occurrences of ELT removed."
> 
> IMHO, describing remq to return a copy of list is also confusing.  Since
> it does not return a copy on some cases.

Good point. Perhaps it should say that it returns either a copy or a
tail of the list.  It could say something like this, for example:

 If the only elements in LIST that are `eq' to ELT occur before any
 other elements then a copy is not made: the tail after the last such
 occurrence is returned.

Whatever language we choose, it should be precise wrt what the behavior
is.

Previous Next

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