From 11858440c69658eb0838623ddcf278a378328f1a Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Fri, 1 Feb 2002 20:39:33 +0000 Subject: [PATCH] . original commit: ad0dfc4ef6708e24aa874a03de13a23ecfb6a35f --- man/man1/mred.1 | 54 +++++++++++++++++++----------- man/man1/mzscheme.1 | 81 +++++++++++++++++++++++++++++++++------------ 2 files changed, 95 insertions(+), 40 deletions(-) diff --git a/man/man1/mred.1 b/man/man1/mred.1 index 56ad3f4c..7ec828ab 100644 --- a/man/man1/mred.1 +++ b/man/man1/mred.1 @@ -68,9 +68,8 @@ MrEd accepts the following standard These flags must appear before all other flags. .PP -.SH OPTIONS +.SH STARTUP FILE AND EXPRESSION OPTIONS -Startup file and expression switches: .TP .BI \-e \ expr .TP @@ -200,27 +199,33 @@ Load executable-embedded code from file offset .I n to .IR m . +.TP +.B \-C +.TP +.B \--main +Call `main' with a list of argument strings, but only if +there have been no uncaught exceptions from previous file loads or evaluations. .PP -Initialization switches: +.SH INITIALIZATION OPTIONS .TP .B \-x .TP .B \--no-lib-path -Does not try to set current-library-collection-paths. +Skips trying to set current-library-collection-paths. .TP .B \-q .TP .B \--no-init-file -Does not try to load "~/.mredrc". +Skips trying to load "~/.mredrc". .TP .B \-A .TP .B \--no-argv -Does not set `argv' or `program'. +Skips defining `argv' and `program'. .PP -Language setting switches: +.SH LANGUAGE SETTING OPTIONS .TP .B \-g .TP @@ -233,7 +238,7 @@ Identifiers and symbols are initially case-sensitive. Set! works on undefined identifiers. .PP -Miscellaneous switches: +.SH MISCELLANEOUS OPTIONS .TP .B \-- .br @@ -270,7 +275,8 @@ Shows help for command-line arguments and exits, ignoring other switches. .TP .BI \--restore \ file Restores an image; must be the only switch. (Special versions only) -.PP + +.SH OPTION CONVENTIONS Multiple single-letter switches can be collapsed, with arguments placed after the collapsed switches; the first collapsed switch cannot be .BR -- . @@ -299,15 +305,20 @@ expressions/files are evaluated/loaded, unless the or .B --no-lib-path switch is used. -.PP -.PP -For further information on -.IR MrEd , -please consult the on-line -documentation and other information available at -.PP + +.SH EXECUTABLE NAME +If the executable name has the form scheme-\|\c +.I dialect\|\c +, then the command line is effectively prefixed with .ce 1 -http://www.plt-scheme.org/software/mred/ +-qAerC '(require (lib "init.ss" "script-lang" "\|\c +.I dialect\|\c +"))' +so that the first actual command-line argument is the name of a file +to load; the file should define `main', which is called with the +remaining arguments in a list. + + .SH FILES The file "~/.mredrc" is loaded before any provided expressions/files are evaluated/loaded, unless the @@ -351,9 +362,14 @@ followed as in the first case. .IP The "/usr/local/lib/plt/collects" directory is tried. +.SH FURTHER INFORMATION +For further information on +.IR MrEd , +please consult the on-line +documentation and other information available at .PP -Please consult your local administrator to determine whether -the on-line documentation has been installed locally. +.ce 1 +http://www.plt-scheme.org/software/mred/ .SH BUGS Submit bug reports via .ce 1 diff --git a/man/man1/mzscheme.1 b/man/man1/mzscheme.1 index 107476db..cc7e5b47 100644 --- a/man/man1/mzscheme.1 +++ b/man/man1/mzscheme.1 @@ -28,9 +28,9 @@ is the graphical development environment for creating and .I MrEd applications. -.SH OPTIONS -Startup file and expression switches: +.SH STARTUP FILE AND EXPRESSION OPTIONS + .TP .BI \-e \ expr .TP @@ -118,14 +118,14 @@ Same as .TP .B \-r .TP -.B --script +.B \--script Script mode: use as last flag for scripts. Same as .BR -fmv- . .TP .B \-i .TP -.B --script-cd +.B \--script-cd Like -r, but also sets the directory. Same as .BR -dmv- . @@ -151,27 +151,33 @@ Load executable-embedded code from file offset .I n to .IR m . +.TP +.B \-C +.TP +.B \--main +Call `main' with a list of argument strings, but only if +there have been no uncaught exceptions from previous file loads or evaluations. .PP -Initialization switches: +.SH INITIALIZATION OPTIONS .TP .B \-x .TP .B \--no-lib-path -Does not try to set current-library-collection-paths. +Skips trying to set current-library-collection-paths. .TP .B \-q .TP .B \--no-init-file -Does not try to load "~/.mzschemerc". +Skips trying to load "~/.mzschemerc". .TP .B \-A .TP .B \--no-argv -Does not set `argv' or `program'. +Skips defining `argv' and `program'. .PP -Language setting switches: +.SH LANGUAGE SETTING OPTIONS .TP .B \-g .TP @@ -183,7 +189,7 @@ Identifiers and symbols are initially case-sensitive. Set! works on undefined identifiers. .PP -Miscellaneous switches: +.SH MISCELLANEOUS OPTIONS .TP .B \-- .br @@ -213,7 +219,9 @@ Shows help for command-line arguments. .TP .BI \--restore \ file Restores an image; must be the only switch. (Special versions only) -.PP + +.SH OPTION CONVENTIONS + Multiple single-letter switches can be collapsed, with arguments placed after the collapsed switches; the first collapsed switch cannot be .BR -- . @@ -242,15 +250,19 @@ expressions/files are evaluated/loaded, unless the or .B --no-lib-path switch is used. -.PP -.PP -For further information on -.IR MzScheme , -please consult the on-line -documentation and other information available at -.PP + +.SH EXECUTABLE NAME +If the executable name has the form scheme-\|\c +.I dialect\|\c +, then the command line is effectively prefixed with .ce 1 -http://www.plt-scheme.org/software/mzscheme/ +-qAerC '(require (lib "init.ss" "script-lang" "\|\c +.I dialect\|\c +"))' +so that the first actual command-line argument is the name of a file +to load; the file should define `main', which is called with the +remaining arguments in a list. + .SH FILES The file "~/.mzschemerc" is loaded before any provided expressions/files are evaluated/loaded, unless the @@ -294,9 +306,36 @@ are followed as in the first case. .IP The "/usr/local/lib/plt/collects" directory is tried. + +.SH EXECUTABLE SCRIPTS +The most flexible way to create an executable script file is to +trampoline through /bin/sh, using a #| ... |# block-comment trick to make the first few lines +parseable by both /bin/sh and mzscheme. Here's an example: .PP -Please consult your local administrator to determine whether -the on-line documentation has been installed locally. +.PD 0 +.PP + #! /bin/sh +.PP + #| +.PP + exec mzscheme -qr "$0" ${1+"$@"} +.PP + |# +.PP + (display "Hello, world!") +.PP + (newline) +.PD + +.SH MORE INFORMATION +For further information on +.IR MzScheme , +please consult the on-line +documentation and other information available at +.PP +.ce 1 +http://www.plt-scheme.org/software/mzscheme/ + .SH BUGS Submit bug reports via .ce 1