On 14 July 2011 21:42, Erik Huelsmann <ehuels@gmail.com> wrote:
> Yesterday, we fixed #154 -- the PRINT-OBJECT regression in 0.26.0. Once
> again, it turns out that our object printing and stringification routines
> are confusingly named. Additionally, they are also under documented: The
> writeToString() method calls toString(), but doesn't document the difference
> between the two.
> My idea would be to disambiguate the two functions by making writeToString()
> a java-side PRINT-OBJECT, renaming it to printObject() and documenting
> that's what it does. Then, probably, the lisp side function %write-to-string
> should be renamed to %print-object too. Probably, more adjustments are
> required throughout the code base, but those are probably at the
> 'implementation detail' level.
> So, what's your take on it?

By all means go for it. I've never quite understood why we have writeToString()
that calls toString(). Trying to find out from the codebase is
non-trivial, and even
our maintenance ends up making mistakes. Any clarification is a plus.