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 connectionsPath: ...!local-2.nntp.ord.giganews.com!Xl.tags.giganews.com!local-1.nntp.ord.giganews.com!news.giganews.com.POSTED!not-for-mail NNTP-Posting-Date: Fri, 21 Jun 2024 23:20:55 +0000 MIME-Version: 1.0 From: Robert Heller Organization: Deepwoods Software X-Newsreader: TkNews 3.0 (1.2.18) Subject: Re: typical TCL docu nonsens In-Reply-To: References: Newsgroups: comp.lang.tcl Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="us-ascii" Originator: heller@sharky4.deepsoft.com Message-ID: Date: Fri, 21 Jun 2024 23:20:55 +0000 Lines: 63 X-Usenet-Provider: http://www.giganews.com X-Trace: sv3-9qSmbtY78J99IjyVkMCS76asWNw6mV5AgDMiYbhg1K2ezSSag7KTIgZ53Rmv1uEQkfb3TMtluy85XZn!wT2zNziRLJQ3eTUjXLU7yS9r+fLdUpDg5DHgDU2NyAyTN+m1tj8Jhkq2wg8+bPJvNOmyDidrIZLV!pv8= X-Complaints-To: abuse@giganews.com X-DMCA-Notifications: http://www.giganews.com/info/dmca.html 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 Bytes: 4312 At Fri, 21 Jun 2024 21:55:54 -0000 (UTC) Rich wrote: > > et99 wrote: > > On 6/21/2024 1:17 PM, aotto1968 wrote: > > snip > >> > >> the core problem is *not* the "autopath" is wrong because at the > >> time I use it I does not know it was wrong. The core problem is > >> that is was *very* difficult to figure out what was the "right" > >> name. special the tcl_traceExec… does not help and more important > >> the package.n docu (package require…) does *not* spend a single word > >> on *how* to find a package. > > > > I'm not sure if this would have helped in your case, but I've used > > this with some success. It outputs every package command issued and > > by using a search pattern to limit the output to the ifneeded > > commands, sometimes gets me what I need to know. > > aotto1968's complaint is that the "package" man page does not mention > that the auto_path variable stores the search path list for finding > packages. And, I looked, it does not make any mention of the > "specialness" of that variable. > > On my Slack15 install, all of the Tcl special variables are documented > in a man page named "tcl_library" (although the page contents believes > it is named "tclvars"). So auto_path's specialness /is/ documented, > but unless one has discovered that it is documented in a different > manpage from 'package', one could very well spend a lot of time and not > find the proper docs. > > So the least disruptive change to cover aotto1968's complaint would be > for aotto1968 to file a patch against the package man page adding a > "see tcl_library manpage for Tcl special variables related to package > handling". I suspect that the tcl_library manpage is replicated from the tclvars man page. A number of Tcl's (and Tk's) man pages are dups. Which happen at build or install time (links?) or possibly using an old UNIX trick where man pages can implement a re-direct -- this is done because some man pages cover multiple closely related topics (or groups commands that have common documentation. > > That, or aotto1968 should file a patch against the package namespace to > add a brief paragraph to the package manpage detailing that the special > global auto_path contains a list of directories within which to search > for packages when doing a package require. > > Either of the above would be a proactive step to eliminate the problem. > > Grumbling on Usenet about the issue is not taking any direct steps to > proactively eliminate the issue. > > > -- Robert Heller -- Cell: 413-658-7953 GV: 978-633-5364 Deepwoods Software -- Custom Software Services http://www.deepsoft.com/ -- Linux Administration Services heller@deepsoft.com -- Webhosting Services