Sujet : poss minor doc error + minor doc suggestion
De : mark (at) *nospam* qtrac.eu (Mark Summerfield)
Groupes : comp.lang.tclDate : 09. Jul 2024, 10:37:38
Autres entêtes
Message-ID : <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
User-Agent : Pan/0.154 (Izium; 517acf4)
*Poss doc error*
Page:
https://www.tcl.tk/man/tcl9.0/TclCmd/define.html#M55This 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#M5This 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.