summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordgp <dgp@users.sourceforge.net>2003-09-05 22:55:31 (GMT)
committerdgp <dgp@users.sourceforge.net>2003-09-05 22:55:31 (GMT)
commitbd269ad6a5dfc06bc05e719dcb5d2be2fb84be87 (patch)
treef7e0a69094483a0696d970952d2ac19bbdc845d5
parentc024a2de4b3868a69fd48901c50a0beedb49ed9d (diff)
downloadtcl-bd269ad6a5dfc06bc05e719dcb5d2be2fb84be87.zip
tcl-bd269ad6a5dfc06bc05e719dcb5d2be2fb84be87.tar.gz
tcl-bd269ad6a5dfc06bc05e719dcb5d2be2fb84be87.tar.bz2
one more bit of TIP 137 documentation...
-rw-r--r--ChangeLog3
-rw-r--r--doc/Tcl_Main.313
2 files changed, 9 insertions, 7 deletions
diff --git a/ChangeLog b/ChangeLog
index c9837f2..d0a7d9b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,6 @@
2003-09-04 Don Porter <dgp@users.sourceforge.net>
-
+
+ * doc/Tcl_Main.3:
* doc/FileSystem.3: Implementation of
* doc/source.n: TIPs 137/151. Adds
* doc/tclsh.1: a -encoding option to
diff --git a/doc/Tcl_Main.3 b/doc/Tcl_Main.3
index 85a1101..b0dc0da 100644
--- a/doc/Tcl_Main.3
+++ b/doc/Tcl_Main.3
@@ -6,7 +6,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: Tcl_Main.3,v 1.9 2002/07/01 18:24:39 jenglish Exp $
+'\" RCS: @(#) $Id: Tcl_Main.3,v 1.10 2003/09/05 22:55:32 dgp Exp $
'\"
.so man.macros
.TH Tcl_Main 3 8.4 Tcl "Tcl Library Procedures"
@@ -76,9 +76,12 @@ channels to their default values. See \fBTcl_StandardChannels\fR for
more information.
.PP
\fBTcl_Main\fR supports two modes of operation, depending on the
-values of \fIargc\fR and \fIargv\fR. If \fIargv[1]\fR exists and
-does not begin with the character \fI-\fR, it is taken to be the
-name of a file containing a \fIstartup script\fR, which \fBTcl_Main\fR
+values of \fIargc\fR and \fIargv\fR. If the first few arguments
+in \fIargv\fR match ?\fB-encoding \fIname\fR? ?\fIfileName\fR?,
+where \fIfileName\fR does not begin with the character \fI-\fR,
+then \fIfileName\fR is taken to be the name of a file containing
+a \fIstartup script\fR, and \fIname\fR is taken to be the name
+of the encoding of the contents of that file, which \fBTcl_Main\fR
will attempt to evaluate. Otherwise, \fBTcl_Main\fR will enter an
interactive mode.
.PP
@@ -116,7 +119,6 @@ The prompts and command evaluation results are written to the standard
output channel only if the Tcl variable \fItcl_interactive\fR in the
master interpreter holds a non-zero integer value.
.PP
-.VS 8.4
\fBTcl_SetMainLoop\fR allows setting an event loop procedure to be run.
This allows, for example, Tk to be dynamically loaded and set its event
loop. The event loop will run following the startup script. If you
@@ -129,7 +131,6 @@ The main loop procedure must have an interface that matches the type
.CS
typedef void Tcl_MainLoopProc(void);
.CE
-.VE 8.4
.PP
\fBTcl_Main\fR does not return. Normally a program based on
\fBTcl_Main\fR will terminate when the \fBexit\fR command is