1MRED(1) General Commands Manual MRED(1)
3
7 mred - The PLT Graphical Scheme implementation
8
10 mred [ Xoption ... ] [ option ... ] [ argument ... ]
11
14 MrEd is the PLT's graphical Scheme implementation. It embeds and
15 extends MzScheme with a graphical user interface (GUI) toolbox.
16 DrScheme is the graphical development environment for creating MzScheme
18 and MrEd applications.
19
22 When running in X11, MrEd accepts the following standard Xoptions:
23 -display disp, -geometry geom, -bg color, -background color, -fg color,
24 -foreground color, -fn font, -font font, -iconic, -name name, -rv,
25 -reverse, +rv, -selectionTimeout time, -synchronous, -title name, -xnl‐
26 language lang, -xrm file. These options must appear before all other
27 options.
28 In addition, the option -singleInstance is treated like an X option (it
30 must appear before all other options), and it runs MrEd in single-
31 instance mode. In single-instance mode, when an existing instance is
32 running with the same host and executable name, all non-option argu‐
33 ments are treated as file names and sent to the existing instance.
34
36 -e expr, --eval expr
37 Evaluates expr after MrEd starts.
38 -f file, --load file
40 Loads file after MrEd starts.
41 -d file, --load-cd file
43 Load/cds file after MrEd starts.
44 -t file, --require file
46 Requires file after MrEd starts.
47 -F, --Load
49 Loads all remaining arguments after MrEd starts.
50 -D, --Load-cd
52 Load/cds all remaining arguments after MrEd starts.
53 -T, --Require
55 Requires all remaining arguments after MrEd starts.
56 -l file, --mzlib file
58 Same as -e '(require (lib "file"))'.
59 -L file coll
61 Same as -e '(require (lib "file" "coll"))'.
62 -M coll
64 Same as -e '(require (lib "coll.ss" "coll"))'.
65 -p file user package
67 Same as -e '(require (planet "file" "user" "package"))'.
68 -P name user
70 Same as -e '(require (planet "name.ss" "user" "name.plt"))'.
71 -r, --script
73 Script mode: use as last flag for scripts. Same as -fmv-.
74 -i, --script-cd
76 Like -r, but also sets the directory. Same as -dmv-.
77 -u, --require-script
79 Like -r, but requires a module. Same as -tmv-.
80 -Z, --nogui
82 Skip "class.ss" and "mred.ss" require.
83 -z, --stdio
85 Use stdio REPL. Same as -ve '(read-eval-print-loop)'.
86 -K, --back
88 Under Mac OS X, skip bringing the application to the foreground
89 (in case it was started from a command line). -w, --awk Same as
90 -l awk.ss.
91 -k n m
93 Load executable-embedded code from file offset n to m.
94 -C, --main
96 Like -r, then calls `main' with a list of argument strings. The
97 first string in the list is the name of the loaded file, and the
98 rest of the list contains leftover command-line arguments.
99
101 -X dir, --collects dir
102 Sets dir as the location of the main "collects" directory. If
103 dir is relative, it is relative to the executable.
104 -S dir
106 --search dir
108 Adds dir to the search path for library collections. If dir is
109 relative, it is relative to the executable.
110 -U, --no-user-path
112 Ignores PLTHOME, and omits the user-specific "collects" direc‐
113 tory from the search path for library collections.
114 -x, --no-lib-path
116 Skips trying to set current-library-collection-paths.
117 -q, --no-init-file
119 Skips trying to load "~/.mredrc".
120 -N file, --name file
122 Sets the program name to name.
123 -A, --no-argv
125 Skips defining `argv' and `program'.
126
128 -Q, --prim
129 Assume primitive bindings at top level by initializing the envi‐
130 ronment with `(require mzscheme)'.
131 -g, --case-sens
133 Identifiers and symbols are initially case-sensitive (the
134 default).
135 -G, --case-insens
137 Identifiers and symbols are initially case-insensitive.
138 -s, --set-undef
140 Set! works on undefined identifiers.
141
143 --
144 No argument following this switch is used as a switch.
145 -p, --persistent
147 Catches AIX SIGDANGER (low page space) signal. (AIX only)
148 -m, --mute-banner
150 Suppresses the startup banner.
151 -v, --version
153 Suppresses the read-eval-print loop.
154 -V, --yield
156 Like -v, also suppresses (yield 'wait).
157 -h, --help
159 Shows help for command-line arguments.
160
163 Multiple single-letter switches can be collapsed, with arguments placed
164 after the collapsed switches; the first collapsed switch cannot be --.
165 E.g.: -vfme file expr is the same as -v -f file -m -e expr.
166 Extra arguments following the last option are put into the Scheme
168 global variable `argv' as a vector of strings. The name used to start
169 MrEd is put into the global variable `program' as a string.
170 Expressions/files are evaluated/loaded in order as provided, including
172 calls to main implied by --main, embedded segments loaded by -k, and so
173 on. An uncaught exception during an evaluation/load causes later evalu‐
174 ations/loads to be skipped.
175 The current-library-collections-paths parameter is automatically set
177 before any expressions/files are evaluated/loaded, unless the -x or
178 --no-lib-path option is used.
179
182 If the executable name has the form scheme-dialect, then the command
183 line is effectively prefixed with
184 -qAeC '(require (lib "init.ss" "script-lang" "dialect"))'
185 The first actual command-line argument thus serves as the name of a
186 file to load. The file should define main, which is called with the
187 command-line arguments---starting with the loaded file name---as a list
188 of immutable strings.
189
192 The file "~/.mredrc" is loaded before any provided expressions/files
193 are evaluated/loaded, unless the -q or --no-init-file option is used.
194 Unless the -U or --no-user-path option is provided, the library collec‐
196 tions search path is read from the PLTCOLLECTS environment variable (as
197 a colon-separated list of paths). Where the empty path appears in PLT‐
198 COLLECTS, it is replaced with the default collections directory search
199 path.
200
203 For further information on MrEd, please consult the on-line documenta‐
204 tion and other information available at
205 http://www.plt-scheme.org/software/mred/
207
209 Submit bug reports via
210 http://bugs.plt-scheme.org/ (encouraged)
211 or by e-mail to
212 bugs@plt-scheme.org (discouraged)
213
215 MrEd was implemented by Matthew Flatt (mflatt@plt-scheme.org), Robert
216 Bruce Findler (robby@plt-scheme.org), and John Clements (clements@plt-
217 scheme.org), based on MzScheme.
218
220 help-desk(1), mzscheme(1), drscheme(1)
2214th Berkeley Distribution February 2007 MRED(1)