summaryrefslogtreecommitdiff
path: root/web/src/cgi.tcl-1.10/install.mac
diff options
context:
space:
mode:
authorEduardo Chappa <echappa@gmx.com>2013-02-03 00:59:38 -0700
committerEduardo Chappa <echappa@gmx.com>2013-02-03 00:59:38 -0700
commit094ca96844842928810f14844413109fc6cdd890 (patch)
treee60efbb980f38ba9308ccb4fb2b77b87bbc115f3 /web/src/cgi.tcl-1.10/install.mac
downloadalpine-094ca96844842928810f14844413109fc6cdd890.tar.xz
Initial Alpine Version
Diffstat (limited to 'web/src/cgi.tcl-1.10/install.mac')
-rw-r--r--web/src/cgi.tcl-1.10/install.mac70
1 files changed, 70 insertions, 0 deletions
diff --git a/web/src/cgi.tcl-1.10/install.mac b/web/src/cgi.tcl-1.10/install.mac
new file mode 100644
index 00000000..a79c6b72
--- /dev/null
+++ b/web/src/cgi.tcl-1.10/install.mac
@@ -0,0 +1,70 @@
+This file is install.mac. It contains installation instructions for
+cgi.tcl on MacOS.
+
+If you do not have Tcl, get it (the README explains how) and install
+it. The rest of these instructions assume that you have Tcl
+installed.
+
+--------------------
+Installation
+--------------------
+
+These instructions are based on contributions courtesy of Henk-Jan
+Kooiman <hjk@cable.a2000.nl>. Send fixes to me (libes@nist.gov).
+
+If you just want to experiment with cgi.tcl, you can simply source it
+into your Tcl files by saying "source cgi.tcl".
+
+Once you're done playing, go ahead and install it. To install it:
+
+1) Make a package index. (This will create pkgIndex.tcl which will
+make it possible to use "package require cgi" in scripts.) Asari
+Hirotsugu <asari@math.uiuc.edu> has supplied the following
+elaboration of this step:
+
+ 1a) Put the cgi.tcl folder in the "Tool Command Language" folder
+ inside the Extensions folder. (Don't make an alias for the Tool
+ Command Language folder since Tcl Shell doesn't resolve aliases as
+ of 8.2.1.)
+
+ 1b) Launch the Tcl Shell (or Wish) and move to the Tool Command
+ Language folder by entering:
+
+ cd "Macintosh HD:System Folder:Extensions:Tool Command Language"
+
+ (You may have to modify this command depending upon the names
+ and structure of your file system.)
+
+ Issue the pkg_mkIndex command:
+
+ pkg_mkIndex cgi.tcl*
+
+ 1c) Test if the package comand works by trying:
+
+ package require cgi
+
+2) You may want to edit some things in cgi.tcl at this time.
+
+ 2a) Upon errors in production code, cgi.tcl sends mail to an
+ administrator. This can be set on a per-script basis but it
+ defaults to "root". You'll probably want to change this for your
+ site. To do that, search cgi.tcl for cgi_admin_mail_addr "root" and
+ change the argument to whatever you prefer.
+
+ 2b) The cgi_mail_end procedure attempts to do mail delivery using
+ SMTP (the de facto Internet mail protocol). However, this mechanism
+ is not robust. For example, if the mail gateway is down, the mail
+ will not be requeued for later delivery. If you have a robust
+ mailer program or some other interface, you should switch to using
+ it. The ability to send mail isn't required for basic use of
+ cgi.tcl, but this ability is especially useful for in-the-field
+ debugging so I encourage you to use it.
+
+You're done! Now you can use cgi.tcl.
+
+--------------------
+Examples
+--------------------
+
+The example directory has some examples. See the README in there.
+