7.1 Starting Edwin

To use Edwin, start Scheme with the following command-line options:

mit-scheme-pucked --edit

Alternatively, you can load Edwin by calling the procedure edit:

procedure: edit

procedure: edwin

Load and enter the Edwin text editor. If entering for the first time, the editor is loaded and initialized (by calling create-editor with no arguments). Otherwise, the previously-initialized editor is reentered.

The procedure edwin is an alias for edit.

variable: inhibit-editor-init-file?

When Edwin is first initialized, it loads your init file (called ~/.edwin) if you have one. If the Scheme variable inhibit-editor-init-file? is true, however, your init file will not be loaded even if it exists. By default, this variable is false.

Note that you can set this variable in your Scheme init file (see Customizing Scheme).

procedure: create-editor arg …

Initializes Edwin, or reinitializes it if already initialized. create-editor is normally invoked automatically by edit.

If no args are given, the value of create-editor-args is used instead. In other words, the following are equivalent:

(create-editor)
(apply create-editor create-editor-args)

On the other hand, if args are given, they are used to update create-editor-args, making the following equivalent:

(apply create-editor args)
(begin (set! create-editor-args args) (create-editor))

variable: create-editor-args

This variable controls the initialization of Edwin. The following values are defined:

(#f)

This is the default. Creates a window of some default size, and uses that window as Edwin’s main window. If Gtk and X11 are not available or if the DISPLAY environment variable is undefined, Edwin will run on Scheme’s console.

(gtk)

Creates an X window containing Gtk widgets, mostly Scheme canvases. This requires the DISPLAY environment variable to have been set to the appropriate value before Scheme was started, and the gtk-screen plugin to have been loaded.

(x)

Creates an X window and uses it as Edwin’s main window. This requires the DISPLAY environment variable to have been set to the appropriate value before Scheme was started.

(x geometry)

Like ‘(x)’ except that geometry specifies the window’s geometry in the usual way. Geometry must be a character string whose contents is an X geometry specification.

(console)

Causes Edwin to run on Scheme’s console, i.e. the standard input and output. If the console is not a terminal device, or is not powerful enough to run Edwin, an error will be signalled at initialization time.