4 Editing Lisp Programs

4.5 Comments

Set Comment Column

Editor Command

: Argument: None
Key sequence:Ctrl+X ;
: Sets the comment column to the current column. A positive prefix argument causes the comment column to be set to the value of the prefix argument.

Indent for Comment

Editor Command

: Argument: None
Key sequence: +;
: Creates a new comment or moves to the beginning of an existing comment, indenting it appropriately (seeSet Comment Column).
: If the current point is in a line already containing a comment, that comment is indented as appropriate, and the current point is moved to the beginning of the comment. An existing double semicolon comment is aligned as for a line of code. An existing triple semicolon comment or a comment starting in column 0, is not moved.
: A prefix argument causes comments on the next relevant number of lines to be indented. The current point is moved down the relevant number of lines.
: If characters not associated with the comment extend past the comment column, a space is added before starting the comment.

Up Comment Line

Editor Command

Down Comment Line

Editor Command

Indent New Comment Line

Editor Command

: Argument: None
Key sequence: +J or +Newline
: Ends the current comment and starts a new comment on the next line, using the indentation and number of comment start characters from the previous line's comment. IfIndent New Comment Line is performed when the current point is not in a comment line, it simply acts as aReturn.

Kill Comment

Editor Command

: Argument: None
Key sequence: +Ctrl+;
: Kills the comment on the current line and moves the current point to the next line. If there is no comment on the current line, the point is simply moved onto the next line. A prefix argument causes the comments on the relevant number of lines to be killed and the current point to be moved appropriately.