home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Source / Libraries / tcl7.4b3 / doc / source.n < prev    next >
Encoding:
Text File  |  1994-12-17  |  1.2 KB  |  35 lines
  1. '\"
  2. '\" Copyright (c) 1993 The Regents of the University of California.
  3. '\" Copyright (c) 1994 Sun Microsystems, Inc.
  4. '\"
  5. '\" See the file "license.terms" for information on usage and redistribution
  6. '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '\" 
  8. '\" @(#) source.n 1.2 94/12/17 16:18:48
  9. '\" 
  10. .so man.macros
  11. .HS source tcl
  12. .BS
  13. '\" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. source \- Evaluate a file as a Tcl script
  16. .SH SYNOPSIS
  17. \fBsource \fIfileName\fR
  18. .BE
  19.  
  20. .SH DESCRIPTION
  21. .PP
  22. Read file \fIfileName\fR and pass the contents to the Tcl interpreter
  23. as a script to evaluate in the normal fashion.  The return
  24. value from \fBsource\fR is the return value of the last command executed
  25. from the file.  If an error occurs in evaluating the contents of the
  26. file then the \fBsource\fR command will return that error.
  27. If a \fBreturn\fR command is invoked from within the file then the remainder of
  28. the file will be skipped and the \fBsource\fR command will return
  29. normally with the result from the \fBreturn\fR command.
  30. If \fIfileName\fR starts with a tilde, then it is tilde-substituted
  31. as described in the \fBTcl_TildeSubst\fR manual entry.
  32.  
  33. .SH KEYWORDS
  34. file, script
  35.