Path: ...!3.eu.feeder.erje.net!feeder.erje.net!news.in-chemnitz.de!news.swapon.de!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: Harald Oehlmann <wortkarg3@yahoo.com>
Newsgroups: comp.lang.tcl
Subject: Re: poss minor doc error + minor doc suggestion
Date: Tue, 9 Jul 2024 11:49:26 +0200
Organization: A noiseless patient Spider
Lines: 46
Message-ID: <v6j136$19pva$2@dont-email.me>
References: <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Date: Tue, 09 Jul 2024 11:49:26 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="9654c8edbcf0fc704dc2fa1e0b6c21d9";
	logging-data="1370090"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX19O3T88qp0FirYe0kEq6YSR"
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:fUPpggC+zGHvpkFl0b5ZgffLT/o=
In-Reply-To: <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
Content-Language: en-GB
Bytes: 2476

Am 09.07.2024 um 11:37 schrieb Mark Summerfield:
> *Poss doc error*
> 
> Page: https://www.tcl.tk/man/tcl9.0/TclCmd/define.html#M55
> This is the examples section.
> In the example that begins with the line:
> 
>    oo::class create DBTable {
> 
> The interactive output reported at the end looks slightly wrong. For
> example, it shows:
> 
>      set u1 [Users insert "username=abc"]
>          → DB: create row from ::Users matching username=abc
> 
> but I was expecting:
> 
>      set u1 [Users insert "username=abc"]
>          → DB: create row in ::Users matching username=abc
> 
> This also applies to the 'set u2' example that follows.
> 
> *Doc suggestion*
> 
> Page: https://www.tcl.tk/man/tcl9.0/TclCmd/configurable.html#M5
> This is the description section.
> 
> I suggest adding a sentence something like:
> 
>      Note that oo::configurable classes can only be mixed in (using
> `mixin`) with _other_ oo::configurable classes, not with plain oo::class
> classes.
> 
> The reason for suggesting this is that I tried mixing in an oo::class with
> an oo::configurable and got a very confusing "unknown method "configure":"
> error message.


Thanks ! Please file a tcl ticket at:
https://core.tcl-lang.org/tcl/timeline
Please login (eventually as anonymous)
and press Tickets, then "New ticket".

THanks,
Harald