• poss minor doc error + minor doc suggestion

    From Mark Summerfield@21:1/5 to All on Tue Jul 9 09:37:38 2024
    *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.

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Harald Oehlmann@21:1/5 to All on Tue Jul 9 11:49:26 2024
    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

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Mark Summerfield@21:1/5 to All on Tue Jul 9 10:06:32 2024
    [snip]

    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".

    Done:
    https://core.tcl-lang.org/tcl/tktview/929a918ec1 https://core.tcl-lang.org/tcl/tktview/e9b7cb3b45 https://core.tcl-lang.org/tcl/tktview/2b7d3233ae

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Harald Oehlmann@21:1/5 to All on Tue Jul 9 12:35:14 2024
    Am 09.07.2024 um 12:06 schrieb Mark Summerfield:
    [snip]

    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".

    Done:
    https://core.tcl-lang.org/tcl/tktview/929a918ec1 https://core.tcl-lang.org/tcl/tktview/e9b7cb3b45 https://core.tcl-lang.org/tcl/tktview/2b7d3233ae

    Great, thanks!
    HArald

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)