Rocksolid Light

News from da outaworlds

mail  files  register  groups  login

Message-ID:  

BOFH excuse #92: Stale file handle (next time use Tupperware(tm)!)

comp / comp.lang.tcl / Re: poss minor doc error + minor doc suggestion

SubjectAuthor
* poss minor doc error + minor doc suggestionMark Summerfield
`* Re: poss minor doc error + minor doc suggestionHarald Oehlmann
 `* Re: poss minor doc error + minor doc suggestionMark Summerfield
  `- Re: poss minor doc error + minor doc suggestionHarald Oehlmann

1
Subject: poss minor doc error + minor doc suggestion
From: Mark Summerfield
Newsgroups: comp.lang.tcl
Date: Tue, 9 Jul 2024 09:37 UTC
Path: eternal-september.org!news.eternal-september.org!feeder3.eternal-september.org!border-3.nntp.ord.giganews.com!nntp.giganews.com!Xl.tags.giganews.com!local-2.nntp.ord.giganews.com!nntp.brightview.co.uk!news.brightview.co.uk.POSTED!not-for-mail
NNTP-Posting-Date: Tue, 09 Jul 2024 09:37:38 +0000
From: mark@qtrac.eu (Mark Summerfield)
Subject: poss minor doc error + minor doc suggestion
Newsgroups: comp.lang.tcl
MIME-Version: 1.0
User-Agent: Pan/0.154 (Izium; 517acf4)
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Message-ID: <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
Date: Tue, 09 Jul 2024 09:37:38 +0000
Lines: 35
X-Usenet-Provider: http://www.giganews.com
X-Trace: sv3-9UUb5lnJqdeVhL+P6KdE4bhDt6XJAAPoEGZadSyeBPNIAiypQ9oNIHuLAHjlvpeTlue5VEUx6wNgyAH!EOIJQLiRmaVXo6CcFUVJ/x3gXBrpMi57un92DyqzXIJh3LeWFeronKOUE3/N26eZIB9dTIwhkVEe!qVN2+ucOEFkssfr5gTnF2hwmJg==
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly
X-Postfilter: 1.3.40
View all headers

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

Subject: Re: poss minor doc error + minor doc suggestion
From: Harald Oehlmann
Newsgroups: comp.lang.tcl
Organization: A noiseless patient Spider
Date: Tue, 9 Jul 2024 09:49 UTC
References: 1
Path: eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: wortkarg3@yahoo.com (Harald Oehlmann)
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
View all headers

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

Subject: Re: poss minor doc error + minor doc suggestion
From: Mark Summerfield
Newsgroups: comp.lang.tcl
Date: Tue, 9 Jul 2024 10:06 UTC
References: 1 2
Path: eternal-september.org!news.eternal-september.org!feeder3.eternal-september.org!border-2.nntp.ord.giganews.com!nntp.giganews.com!Xl.tags.giganews.com!local-2.nntp.ord.giganews.com!nntp.brightview.co.uk!news.brightview.co.uk.POSTED!not-for-mail
NNTP-Posting-Date: Tue, 09 Jul 2024 10:06:32 +0000
From: mark@qtrac.eu (Mark Summerfield)
Subject: Re: poss minor doc error + minor doc suggestion
Newsgroups: comp.lang.tcl
References: <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
<v6j136$19pva$2@dont-email.me>
MIME-Version: 1.0
User-Agent: Pan/0.154 (Izium; 517acf4)
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Message-ID: <6Gydne6C-rs1lhD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
Date: Tue, 09 Jul 2024 10:06:32 +0000
Lines: 11
X-Usenet-Provider: http://www.giganews.com
X-Trace: sv3-L65TyDgXT1ThyUFvbdf+l8kr+LPyMg7p91DIeWC9GBmYNk4PejacuOg2rHewUD0m416df0tQ9cxsyqF!i7BrlH8hXiEFk79lF4NO8WnDVs3It79NRe2Gfb8cxIt19RQrs5exT05nrxYAb5RWwCJVADiUiqQm!bOHy35PPvnejGMMUUqKToTHGWA==
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly
X-Postfilter: 1.3.40
View all headers

[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

Subject: Re: poss minor doc error + minor doc suggestion
From: Harald Oehlmann
Newsgroups: comp.lang.tcl
Organization: A noiseless patient Spider
Date: Tue, 9 Jul 2024 10:35 UTC
References: 1 2 3
Path: eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: wortkarg3@yahoo.com (Harald Oehlmann)
Newsgroups: comp.lang.tcl
Subject: Re: poss minor doc error + minor doc suggestion
Date: Tue, 9 Jul 2024 12:35:14 +0200
Organization: A noiseless patient Spider
Lines: 15
Message-ID: <v6j3p1$19pva$3@dont-email.me>
References: <6GydneyC-rt_mRD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
<v6j136$19pva$2@dont-email.me>
<6Gydne6C-rs1lhD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Injection-Date: Tue, 09 Jul 2024 12:35:13 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="9654c8edbcf0fc704dc2fa1e0b6c21d9";
logging-data="1370090"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX1+yfr48GvUpomHWxTap4OkP"
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:FcyIiHceCx91vBwsFX1LlbT1PEA=
Content-Language: en-GB
In-Reply-To: <6Gydne6C-rs1lhD7nZ2dnZfqnPSdnZ2d@brightview.co.uk>
View all headers

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

1

rocksolid light 0.9.8
clearnet tor