-- Auto-generated for Macaulay2-1.21. Do not modify this file manually. --

                       Editing Macaulay2 code with emacs

editing Macaulay2 code with emacs
*********************************

In this section we learn how to use emacs to edit Macaulay2 code. Assuming you
have set up your emacs init file as described in "setting up the Macaulay2
emacs interface" when you visit a file whose name ends with .m2 you will see on
the mode line the name Macaulay2 in parentheses, indicating that the file is
being edited in Macaulay2 mode.

To see how electric parentheses, electric semicolons, and indentation work,
move to a blank line of this file and type the following text.

f = () -> (
     a := 4;
     b := {6,7};
     a+b)

Observe carefully how matching left parentheses are indicated briefly when a
right parenthesis is typed.

Now position your cursor in between the 6 and 7.  Notice how pressing M-C-u
moves you up out of the list to its left.  Do it again.  Experiment with M-C-f
and M-C-b to move forward and back over complete parenthesized expressions.
(In the emacs manual a complete parenthesized expression is referred to as an
sexp, which is an abbreviation for S-expression.)  Try out C-u 2 M-C-@ as a way
of marking the next two complete parenthesized expression, and see how to use
C-w to kill them and C-y to yank them back.  Experiment with M-C-k to kill the
next complete parenthesized expression.

Position your cursor on the 4 and observe how M-; will start a comment for you
with two hyphens, and position the cursor at the point where commentary may be
entered.

Type res somewhere and then press C-c TAB to bring up the possible completions
of the word to documented Macaulay2 symbols.

Notice how C-h m or F1 m will display the keystrokes peculiar to the mode in a
help window.
