kcombobox doc update

[Dawit A.]

On Wednesday 11 August 2004 18:44, George Staikos wrote:
> After a frustrating bug hunt, I'd like to add this for 3.3 if it's OK and
> not too late by the time I get a response.  Ok?

Can you please explain what problem lead you to the "frustrating bug hunt" ? 
The API is admittedly a bit more complicated than it should be, but that is 
the price paid for making it as flexiable as possible to accomodate too many 
differing requirements. Anyways, I do not object adding useful comment, but 
can you please make it less melodramatic ?? If you do not want to do that, I 
will add a more appropriate comment myself.

> Note: this is a very confusing API/object!

Thanks...


> --- kcombobox.h 6 Mar 2004 22:13:09 -0000       1.139
> +++ kcombobox.h 11 Aug 2004 22:42:23 -0000
> @@ -63,6 +63,10 @@ class KURL;
>   * KCompletionBase::setHandleSignals(bool) or alternatively set the
> boolean * parameter in the @p setCompletionObject call to false.
>   *
> + * Beware: The completion object can be deleted on you, especially if a
> call + * such as setEditable(false) is made.  Store the pointer at your own
> risk, + * and consider using QGuardedPtr<KCompletion>.
> + *
>   * The default key-bindings for completion and rotation is determined from
> the
>   * global settings in KStdAccel. These values, however, can be overridden
>   * locally by invoking KCompletionBase::setKeyBinding(). The values can

-- 
Regards,
Dawit A.
"Preach what you practice, practice what you preach"