Warning: mysqli::__construct(): (HY000/1203): User howardkn already has more than 'max_user_connections' active connections in D:\Inetpub\vhosts\howardknight.net\al.howardknight.net\includes\artfuncs.php on line 21
Failed to connect to MySQL: (1203) User howardkn already has more than 'max_user_connections' active connections
Warning: mysqli::query(): Couldn't fetch mysqli in D:\Inetpub\vhosts\howardknight.net\al.howardknight.net\index.php on line 66
Article <v5bfrs$s87f$1@dont-email.me>
Deutsch   English   Français   Italiano  
<v5bfrs$s87f$1@dont-email.me>

View for Bookmarking (what is this?)
Look up another Usenet article

Path: ...!feed.opticnetworks.net!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: aotto1968 <aotto1968@t-online.de>
Newsgroups: comp.lang.tcl
Subject: Re: typical TCL docu nonsens
Date: Mon, 24 Jun 2024 11:56:12 +0200
Organization: A noiseless patient Spider
Lines: 35
Message-ID: <v5bfrs$s87f$1@dont-email.me>
References: <v53hqa$33n2h$1@dont-email.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Date: Mon, 24 Jun 2024 11:56:12 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="fab158b6e9adeb1e0786b6f3fea2de69";
	logging-data="925935"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX1+zUVmPi151u6vbjrQT9BNhsi1ZdykqGr4="
User-Agent: Mozilla Thunderbird
Cancel-Lock: sha1:cWh28TGCcTpxixeMPr775xvv1b8=
Content-Language: en-US
In-Reply-To: <v53hqa$33n2h$1@dont-email.me>
Bytes: 2001

There are a couple of layers to solve the TCL documentation bug:

1. -> get better error message

 > can't find package FileLib
 >      while executing
 > "package require FileLib"

Not just write the problem itself (can't find package FileLib) but also write about what was checked.
A good error message would be:

 > can't find package FileLib
 >      while executing
 > "package require FileLib"
 >
 > checked the tcl variable "tcl_pkgPath" filled with:
 >  ...
 > checked the tcl variable "auto_path" filled with:
 >  ...
 > checked the environment variable "TCLLIBPATH" filled with:
 >  ...
 > read more about package path lookup at:
 >  ...

2. -> add the "pkg_mkIndex" docu INTO the "package.n" docu

*pkg_mkIndex* has a lot of information about the package lookup …

also add *pkg_mkIndex* as sub-command "mkindex" into the "package" command…


3. all commands which depend on a special variable set should also mention the variable in the docu :-)


mfg