Re: API changes

[Daniel Pittman <daniel@rimspace.net>]

On Sat, 27 Apr 2002, Ben Wing wrote:

[...]

> Recently I also added the function
> 
> (truncate-string-with-continuation-dots STR END-COLUMN &optional
> DOTS-STR)
> 
> Documentation: Truncate string STR to end at column END-COLUMN, adding
> dots if needed. The dots (normally `...', but can be controlled by
> DOTS-STR)' will be added in such a way that the total string occupies
> no more than END-COLUMN columns -- i.e. if the string goes past
> END-COLUMN, it will be truncated somewhere short of END-COLUMN so
> that, with the dots added, the string occupies END-COLUMN columns.
> 
> "columns" in here refers to the same thing that
> `truncate-string-to-width' deals in, i.e. "display columns" where
> Japanese characters get two.

Can you please include the fact that this deals with display columns to
the documentation? Having dealt with the differing opinions of GNU Emacs
and XEmacs on what (format "%-10s" foo) outputs, it's /really/ nice to
have that in the docstring, not just the source. :)

Thanks,
        Daniel

-- 
In the present-day reconstruction of physics, fragments of the Newtonian
concepts are stubbornly retained. The result is to reduce modern physics to a
sort of mystic chant over an unintelligible universe.
        -- Alfred North Whitehead, _Modes of Thought_