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

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

bug#9493: 24.0.50; doc string of `read-from-string'


From: Lars Magne Ingebrigtsen
Subject: bug#9493: 24.0.50; doc string of `read-from-string'
Date: Mon, 19 Sep 2011 10:27:49 +0200
User-agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux)

"Drew Adams" <address@hidden> writes:

> The return value of this function is the most important info that can be
> conveyed by its doc string.  All that is said is that the value returned
> is "a cons: (OBJECT-READ . FINAL-STRING-INDEX)".  There is no
> description of either OBJECT-READ (could be guessed, but better to
> specify it) or, especially, FINAL-STRING-INDEX (not obvious at all).
>
> Describe these properly, as is done in the Elisp manual.  It is not long
> to say what the manual says for FINAL-STRING-INDEX: "an integer giving
> the position of the next remaining character in the string (i.e., the
> first one not read)."  It would be enough to say this: "zero-based
> position of first char not read".

I've now documented FINAL-STRING-INDEX.  Saying "OBJECT-READ is the
object read" seems superfluous.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





reply via email to

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