Forum OpenACS Q&A: Tcl resources
general Tcl resources people might be interested in:
<a href="http://www.purl.org/NET/akupries/c.l.t.welcome.html">
The latest version of this message</a>.
---------------------------------------------------
Before posting a question to 'comp.lang.tcl', be sure to consult the
following resources on your own system and across the internet:
* The source distribution of Tcl/Tk comes with reference pages for all
commands and API functions. If Tcl has been installed properly on
your Unix system, you can access the reference pages using the 'man'
command. Windows Tcl/Tk comes with a Windows help file.
On Unix, some Tcl commands have the same name as existing Unix
commands (i.e.: file, expr). To ensure that you receive the Tcl man
page, you must force man to look in section 'n', the default man
section for core Tcl/Tk commands (i.e.: man -s n file, man -S n
file,
or as is appropriate on your system).
Another possibility is TkMan, a manpage viewer written in Tcl/Tk by
Tom Phelps.
<a href="http://tkman.sourceforge.net/">TkMan</a>
* A HTML'ized version of the Tcl/Tk man pages is available at
<a href="http://tcl.activestate.com/man/">
Developer XChange man pages</a>
* The Tcl/Tk FAQ answers many common questions, has a big list of
books about or related to Tcl/Tk and tons of references to other
works using Tcl/Tk. Pointers to FAQs covering special topics (like
'Tcl on Windows') are part of it as well. If you are in search of
specific extensions/applications start searching here or one of the
archives mentioned later.
<a href="http://www.purl.org/NET/Tcl-FAQ/">Tcl/Tk FAQ</a>, by Larry
Virden (mailto:lvirden@yahoo.org).
* The official Tcl/Tk site on the net is the
<a href="http://tcl.activestate.com/">Tcl Developer XChange</a>,
hosted
by <a href="http://www.activestate.com/">ActiveState</a>.
New releases of the Tcl and Tk source, as well as binary versions
for
some platforms, can be found here, together with information
provided
by the Tcl-Team at ActiveState and the Tcl Core Team.
* The sources of many Tcl-related projects (and of Tcl/Tk itself) are
now hosted by <a href="http://www.sourceforge.net/">SourceForge</a>
and can be reached either through the
<a href="http://www.sourceforge.net/foundry/tcl-foundry/">
Tcl Foundry</a>
or the catalog of
<a href="http://www.sourceforge.net/softwaremap/trove_list.php?
form_cat=182">
Tcl projects</a>
* Announcements of new core releases, external extensions,
applications, etc. can be found in the newsgroup
'comp.lang.tcl.announce'.
This group is moderated, so if you want to post a message there,
please send your request to the moderator
(mailto:tcl-announce@mitchell.org).
The newsgroup is archived on the internet at
<a href="http://groups.gahoo.com/group/tcl_announce/">
the announce archive</a>.
* D. R. Hipp maintains a list of individuals and/or companies who
claim to have some expertise in Tcl/Tk programming and are willing
to
work for hire.
<a href="http://www.hwaci.com/tclconsultants/">Tcl consultants</a>
Further online resources:
* The Tcl Developer XChange features a resource center containing
information about tcl itself, extensions, books, FAQs, etc.
<a href="http://tcl.activestate.com/resource">
Developer XChange resource center</a>
* NeoSoft Inc., an ISP, software developer, and consulting company
specializing in Tcl support, maintains the official Tcl/Tk
Contributed Sources Archive site, an extensive searchable archive of
extensions and applications relating to Tcl.
<a href="http://www.neosoft.com/tcl/">NeoSoft archive</a>.
* Another searchable database of Tcl software available around the
internet is maintained by J.M. Ivler (mailto:ivler@i-xpress.com).
<a href="http://www.wwinfo.com/tcl/">Tcl/Tk Resource pages</a>.
* The 'Tcl'ers Wiki' resource is unique among all else mentioned here
because you, the reader are able to EDIT AND EXPAND its content. It
is a collaborative environment for the creation of the resources you
feel that you need them.
<a href="http://purl.org/thecliff/tcl/wiki/">Tcl'ers Wiki</a>
* Next, here is a big set of extremely useful WWW pages relating to
Tcl. Among them are assistance in resolving common linking problems
when building Tcl, a list of frequently made mistakes, notes on
migration to Tcl 8.0 and many more.
<a href="http://starbase.neosoft.com/%
7Eclaird/comp.lang.tcl/">Archive</a>,
by Cameron Laird (mailto:claird@Starbase.neosoft.com)
List of frequently made mistakes:
<a href="http://starbase.neosoft.com/%
7Eclaird/comp.lang.tcl/fmm.html">Mistakes</a>.
Help for linking problems:
<a href="http://starbase.neosoft.com/%
7Eclaird/comp.unix.programmer/linking-unix.html">
Unix Builds</a>.
* Numerous examples and links to other resources, collected by Mike
Hopkirk (mailto:hops@x.co.uk).
<a href="http://www.sco.com/Technology/tcl/Tcl.html">
Examples and links</a>.
* Another site with many links to other resources.
<a href="http://cuisung.unige.ch/TclTk.html">Yet more links</a>.
* And even more links.
<a
href="http://www.yahoo.com/Computers_and_Internet/Programming_Language
s/Tcl_Tk/">
Tcl at Yahoo</a>.
<a href="http://www.ensta.fr/internet/unix/tcl-tk/">
Somewhere in France</a>.
* The Cetus site maintains link collections for various languages,
including Tcl/Tk.
<a href="http://www.cetus-links.org/oo_tcl_tk.html">Tcl/Tk at
Cetus</a>
* <a href="http://tcl.activestate.com/ftp/doc/tut.tar.Z">
Tutorials written by John Ousterhout</a>
The referenced file is a compressed tar archive containing
postscript
and powerpoint slides (610K, last updated at Feb 3, 1996).
* Source code from the article "A Tutorial Introduction to Tcl and Tk"
by Graham Mark (mailto:gam@lanl.gov).
<a
href="ftp://ftp.ora.com/pub/examples/xresource/issue11/TclTk.tar.Z">
Example code</a>.
* The Tcl Cookbook, a free Tcl/Tk tutorial. The document describes the
use of Tcl 7.4 and Tk 4.0 across platforms. It is aimed at novice
window-based interactive application developers and newcomers to
Tcl/Tk.
<a
href="http://www.dci.clrc.ac.uk/Publications/Cookbook/index.html">
The cookbook</a>.
* A computer aided instruction package covering all of the Tcl
features available up to 7.6, and some of the 8.0 features. It is
aimed at new users of Tcl with varying levels of computer expertise.
It runs on W/95/NT, Unixes and Mac (the latter as of version 0.97 or
higher).
<a href="http://www.msen.com/~clif/TclTutor.html">The TclTutor</a>
* A series of Tcl examples of how to do things which are not
necessarily obvious.
<a href="http://www.kencorey.com/tcl/answers.html">Obtuse Tcl</a>.
* A tutorial explaining the usage of compiled Tcl extensions (like
OraTcl, BLT, ...) in general.
<a href="http://www.equi4.com/jcw/extuse.html">
EXTension USagE tutorial</a>
* The Tcl Developer XChange provides lists of online tutorials and
books about Tcl.
<a href="http://tcl.activestate.com/resource/doc/start/">
Developer XChange resource center: Tutorials</a>
<a href="http://tcl.activestate.com/resource/doc/books/">
Developer XChange resource center: Book-list</a>
* Another hub listing tcl tutorials is provided by Cameron Laird at
<a
href="http://starbase.neosoft.com/~claird/comp.lang.tcl/tcl_tutorials.
html">Cameron's
tutorial list</a>
* The people from ArsDigita provide a tutorial for Tcl too, as it is
used in their web framework based upon AOLServer.
<a href="http://www.arsdigita.com/books/tcl/">
ArsDigita Tcl tutorial</a>
General searching on the net:
* <a href="http://www.google.com/">Google (former Deja(News))</a>.
This company provides a searchable archive of all traffic on all
existing newsgroups. If you are in search of information about some
Tcl related topic and suspect it has been discussed previously,
start
searching here.
<a href="http://groups.google.com/groups?
hl=en&lr=&safe=off&group=comp.lang.tcl">Google:
comp.lang.tcl</a>
<a href="http://groups.google.com/groups?
hl=en&lr=&safe=off&group=comp.lang.tcl.announce">Google:
comp.lang.tcl.announce</a>
Note: Dejanews was aquired by
<a href="http://www.google.com">Google</a>
* There are many search engines on the WEB indexing URLs and allowing
queries of the databases thus built. The most prominent of these
are:
<a href="http://www.altavista.digital.com/">AltaVista</a>.
<a href="http://www.yahoo.com/">Yahoo</a>.
<a href="http://www.webcrawler.com/">WebCrawler</a>.
<a href="http://lycos.com/">Lycos</a>.
<a href="http://www.excite.com/">Excite</a>.
<a href="http://www.go.com/">Go.com</a> (formerly InfoSeek).
<a href="http://www.google.com/">Google</a>.
<a href="http://northernlight.com/">Northernlight</a>.
<a href="http://www.hotbot.com/">HotBot</a>.
<a href="http://www.directhit.com/">DirectHit</a>.
<a href="http://www.metacrawler.com/">MetaCrawler</a>.
<a href="http://www.raging.com">Raging</a>
<a href="http://www.searchenginewatch.com/">
Information about search engines in general</a>
Less prominent, but specialized to all types of software including
tcl are the resource centers below:
<a href="http://www.sourceforge.net/">SourceForge</a>
<a href="http://www.freshmeat.net/">FreshMeat</a>
---------------------------------------------------
So, you have exhausted the resources mentioned above, and your
question is still unanswered ?
Well, post your question to 'comp.lang.tcl' and numerous individuals
around the world will rally to help you. To help us in helping you
please consider the following before you start writing:
A more descriptive subject like 'Searching Rule-based interference
engine' or 'Problem with fileevent' will have a better chance of
drawing a response than a broadcast plea for 'Help!' or 'Newbie needs
help'.
We are just a bunch of engineers who want to get the most out of Tcl.
Because of that we are more concerned with what you are having
trouble with than how much experience you have.
In case of a problem with some code of yours send the code. We don't
ask for multi-megabyte sources, or confidential material, but just
the snippet exhibiting the faulty behaviour, or some condensed
example code that will focus attention immensively. Creating such an
excerpt will help you understand the error much better, perhaps well
enough to discover the solution for yourself, or at least you will
help us diagnose the problem. Trying to guess the reason for some
error without code is difficult at best, and impossible in the
average case. The usual responses are none, or requests for the code.
Another useful tip - give us some background of what you are trying
to do, along with your specific question. Sometimes the '''real'''
solution is a different approach to the problem!
See also this
<a href="http://freshmeat.net/news/2000/02/26/951627540.html">
essay about reporting bugs</a>
And now some more formal rulings:
---------------------------------------------------
Posting guidelines for 'comp.lang.tcl'
Language is english.
Source code: is ok, if small (around 100-200 lines). It is
recommended to mark such posts with LONG.
Binaries: Well, usually these are NOT allowed. This includes MIME
encoded source, especially as free ftp space IS available
at Neosoft. Anyone wishing to share binaries with the Tcl
community can upload them via the web or FTP to the Tcl
Contributed Sources Archive (mentioned at the beginning of
this message). To upload via the web (the method the people
at Neosoft really want folks to use), go to the
<a href="http://www.neosoft.com/tcl/">Tcl/Tk Contributed
Sources Archive</a> and register yourself as a contributor.
Follow the instructions on uploading. You can also upload
to the Archive via FTP - the address is
<a
href="ftp.neosoft.com/pub/tcl/incoming">ftp.neosoft.com/pub/tcl/incomi
ng</a>.
Though FTP is quick and easy, the reason people are asked
to use the web interface is that it provides better
cataloging of the package, on the fly. Any questions about
uploading to the Archive can be directed to the Tcl/Tk CSA
Master (mailto:tcl-archive@neosoft.com). On the other hand there
are things people ask and wait for, such as the reference
guide. So, if such posts contain USEFUL information and are
posted infrequently, people should not complain. Abuse of
the good nature of the newsgroup policies will likely
result in cancellation of postings. Nevertheless,
cancelling of non-spam postings by someone other than their
original poster is not permitted in comp.lang.tcl.
Ads: for Tcl related software, books, or even jobs are acceptable as
long as they are in context to answering a question and are not
of a form letter format and don't become too frequent. The same
thing more than once a month is too frequent. Formal
announcments should go to comp.lang.tcl.announce.
Job ads: The same as for ads (see above).
In both cases it is recommended to find a FAQ which would be
appropriate and have info about your offerings added, as well as to
make web pages that not only advertise but provide useful services to
the Tcl community.
Another thing: Most readers prefer that postings occur in plain text
English without a mirroring text/html attachment. This note is
especially important to folks installing a new version of Netscape,
the option causing this behaviour is easily forgotten.
And more: When replying to a posting, PLEASE be concise in the amount
of text that you include as reference. It is seldom necessary to
quote more than 6 lines of text. If someone wants more context than
that, Google (former Deja.com) and other archives are certainly
available. Reducing the amount of text in your reply ensures that
people actually see your comments...
Enjoy,
the TclTeam
---------------------------------------------------
c.l.t. welcome message V 1.22, as of May 3, 2001.
