From c82a59c1e5af6415a4b4dac1dd7d1c53a1ba374e Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Fri, 30 May 1997 19:23:37 +0000 Subject: [PATCH] *** empty log message *** original commit: 106e7f74d5842aaf24b08f2acf32fea5242fe947 --- man/man1/mzscheme.1 | 136 +++++++++++++++++++++++++------------------- 1 file changed, 76 insertions(+), 60 deletions(-) diff --git a/man/man1/mzscheme.1 b/man/man1/mzscheme.1 index 7f58e826..d7983068 100644 --- a/man/man1/mzscheme.1 +++ b/man/man1/mzscheme.1 @@ -1,8 +1,8 @@ .\" dummy line -.TH MZSCHEME 1 "8 June 1996" +.TH MZSCHEME 1 "31 May 1997" .UC 4 .SH NAME -mzscheme \- The Rice PLT Scheme implementation +mzscheme \- The PLT Scheme implementation .SH SYNOPSIS .B mzscheme [ @@ -12,46 +12,15 @@ mzscheme \- The Rice PLT Scheme implementation ] .SH DESCRIPTION .I MzScheme -is Rice University's Programming Languages Group's +is Rice University's Programming Languages Team's primary Scheme implementation. It implements the language as described in the .I Revised^4 Report on -.I the Algorithmic Language Scheme. -In addition, it includes an object system, thread -support and some interoperability with code written in C++. -.I MzScheme -runs on a variety of platforms. +.I the Algorithmic Language Scheme, +plus numerous extensions. .SH OPTIONS -.TP -.B \-h, --help -Shows help for command-line arguments. -.TP -.B \-g, --case-sens -Identifiers and symbols are initially case-sensitive. -.TP -.B \-c, --esc-cont -Call/cc is replaced with call/ec. -.TP -.B \-k, --const-globs -Builtin globals are constant. -.TP -.B \-s, --set-undef -Set! works on undefined identifiers. -.TP -.B \-a, --no-auto-else -Fall-through cond or case is an error. -.TP -.B \-n, --no-key -Keywords not enforced. -.TP -.B \-y, --hash-percent-syntax -Only #% syntactic forms are present. -.TP -.B \-r, --script -Script mode: use as last flag for scripts. -.TP -.B \-i, --script-cd -Like -r, but also sets the directory. + +Startup file and expression switches: .TP .BI \-e \ expr Evaluates @@ -87,16 +56,58 @@ Load/cds all remaining arguments after starts. .TP .B \-l \ file -Shorthand for -e '(require-library file)'. +Same as -e '(require-library "file")'. +.TP +.B \-r, --script +Script mode: use as last flag for scripts. +Same as -fmv-. +.TP +.B \-i, --script-cd +Like -r, but also sets the directory. +Same as -dmv-. +.PP + +Initialization switches: .TP .B \-x, --no-lib-path -Does not try to set (current-library-path). +Does not try to set current-library-collection-paths. .TP .B \-q, --no-init-file -Does not load "~/.mzschemerc". +Does not try to load "~/.mzschemerc". +.PP + +Language setting switches: +.TP +.B \-g, --case-sens +Identifiers and symbols are initially case-sensitive. +.TP +.B \-c, --esc-cont +Call/cc is replaced with call/ec. +.TP +.B \-k, --const-globs +Builtin globals are constant. +.TP +.B \-s, --set-undef +Set! works on undefined identifiers. +.TP +.B \-a, --no-auto-else +Fall-through cond or case is an error. +.TP +.B \-n, --no-key +Keywords are not enforced. +.TP +.B \-y, --hash-percent-syntax +Only #% syntactic forms are present. .TP .B \-p, --persistent Catches AIX SIGDANGER (low page space) signal. (AIX only) +.PP + +Miscellaneous switches: +.TP +.B \-- +.br +No argument following this switch is used as a switch. .TP .B \-m, --mute-banner Suppresses the startup banner. @@ -104,19 +115,24 @@ Suppresses the startup banner. .B \-v, --version Suppresses the read-eval-print loop. .TP -.B \-- -.br -No argument following this switch is used as a switch. +.B \-h, --help +Shows help for command-line arguments. .PP -Files loaded with -f, etc. and expressions evaluated by -e -are loaded and evaluated in the order that they are specified on -on the command line. +Multiple single-letter switches can be collapsed, with arguments placed +after the collapsed switches; the first collapsed switch cannot be --. +E.g.: `-vfme file expr' is the same as `-v -f file -m -e expr'. .PP -Command-line arguments that are not flags are bound to the -Scheme global variable `argv' as a vector of strings. The name by which +Extra arguments following the last switch are put into the Scheme global +variable `argv' as a vector of strings. The name used to start .I MzScheme -was invoked is bound to the Scheme global variable `program' as a -string. +is put into the global variable `program' as a string. +.PP +Expressions/files are evaluated/loaded in order as provided. +.PP +The current-library-collections-path is automatically set before any +expressions/files are evaluated/loaded, unless the -x or --no-lib-path +switch is used. +.PP .PP For further information on .I MzScheme, @@ -126,13 +142,13 @@ documentation and other information available at .ce 1 http://www.cs.rice.edu/CS/PLT/packages/mzscheme/ .SH FILES -The file "~/.mzschemerc" is loaded before any expressions/files are -evaluated/loaded, unless the -q or --no-init-file flag is used. -(Under Windows and MacOS, "mzscheme.rc" is loaded from the -start-up working directory or preferences directory.) +The file "~/.mzschemerc" is loaded before any provided +expressions/files are evaluated/loaded, unless the -q or +--no-init-file switch is used. (Under Windows and MacOS, "mzscheme.rc" +is loaded from the start-up working directory.) .PP .I MzScheme -looks for the "mzlib" library directory using the +looks for the library collections directory using the following search path: .IP If @@ -150,12 +166,12 @@ a file with the name of the program as invoked (usually "mzscheme") are checked. Links are followed as in the first case. .IP -The path in the environment variable MZLIB is tried. +The path in the environment variable MZCOLS is tried. .IP The path in the environment variable PLTHOME is checked -for a "mzscheme" and then "mzlib" subdirectory. +for a "mzscheme" and then "collects" subdirectory. .IP -The "/usr/local/lib/plt/mzscheme/mzlib" directory is +The "/usr/local/lib/plt/mzscheme/collects" directory is tried. .PP Please consult your local administrator to determine whether @@ -171,4 +187,4 @@ Boehm and extended by John Ellis. MzScheme was originally based on libscheme, written by Brent Benson. .SH SEE ALSO .BR drscheme(1), -.BR mzscheme(1) +.BR mred(1)