bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#1943: marked as done (23.0.60; doc string for substring: mention va


From: Emacs bug Tracking System
Subject: bug#1943: marked as done (23.0.60; doc string for substring: mention value is a copy, string is any vector)
Date: Mon, 19 Jan 2009 15:20:03 +0000

Your message dated Mon, 19 Jan 2009 10:14:34 -0500
with message-id <87y6x7nx9h.fsf@cyd.mit.edu>
and subject line Re: 23.0.60; doc string for substring: mention value is a 
copy, string is any vector
has caused the Emacs bug report #1943,
regarding 23.0.60; doc string for substring: mention value is a copy, string is 
any vector
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
1943: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=1943
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems
--- Begin Message --- Subject: 23.0.60; doc string for substring: mention value is a copy, string is any vector Date: Sat, 17 Jan 2009 15:35:11 -0800
The doc string for function `substring' could be made clearer.

1. Like the Elisp manual entry for `substring', mention that the
value returned does not share with the input STRING object. That is, a
copy of the substring is returned, not the substring itself.
 
2. State more clearly that STRING can be any kind of vector, not just
a vector of characters.

3. FROM and TO do not "start" at 0.  It is indexing that starts at 0.
   Better to speak of "zero-based indexing".
 
Something like this:
 
  "Return a new string whose characters are a substring of STRING.
STRING can be any kind of vector; elements need not be characters.
Indexing of STRING is zero-based.  The substring starts at index
FROM and ends before index TO.  If TO is nil, then the substring
runs to the end of STRING.  If either FROM or TO is negative,
then STRING is indexed backward, from its end."
 

In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2009-01-04 on
 LENNART-69DE564 Windowing system distributor `Microsoft Corp.',
 version 5.1.2600 configured using `configure --with-gcc (3.4)
 --no-opt --cflags -Ic:/g/include -fno-crossjumping'
 




--- End Message ---
--- Begin Message --- Subject: Re: 23.0.60; doc string for substring: mention value is a copy, string is any vector Date: Mon, 19 Jan 2009 10:14:34 -0500
> The doc string for function `substring' could be made clearer.

I've rewritten it.  Thanks for the report.


--- End Message ---

reply via email to

[Prev in Thread] Current Thread [Next in Thread]