3.17 Buffers

This section contains details of commands used to manipulate buffers.

Select Buffer

Editor Command

Arguments: buffer-name
Key sequence: Ctrl+X B buffer-name

Displays a buffer called buffer-name in the current window. If no buffer name is provided, the last buffer accessed in the current window is displayed. If the buffer that is selected is already being displayed in another window, any modifications to that buffer are shown simultaneously in both windows.

Select Buffer Other Window

Editor Command

Arguments: buffer-name
Key sequence: None

Displays a buffer called buffer-name in a new window. If no buffer name is provided, the last buffer displayed in the current window is selected. If the buffer that is selected is already being displayed in another window, any modifications to that buffer are shown simultaneously in both windows.

Select Previous Buffer

Editor Command

Arguments: None
Key sequence: Meta+Ctrl+L

Displays the last buffer accessed in a new window. If the buffer that is selected is already being displayed in another window, any modifications to that buffer are shown simultaneously in both windows.

A prefix argument causes the appropriately numbered buffer, from the top of the buffer history, to be selected.

Circulate Buffers

Editor Command

Arguments: None
Key sequence: Meta+Ctrl+Shift+L

Move through the buffer history, selecting the successive previous buffers.

Kill Buffer

Editor Command

Arguments: buffer-name
Key sequence: Ctrl+X K buffer-name

Deletes a buffer called buffer-name . If no buffer name is provided, the current buffer is deleted. If the buffer that is selected for deletion has been modified then confirmation is asked for before deletion takes place.

List Buffers

Editor Command

Arguments: None
Key sequence: Ctrl+X Ctrl+B

Displays a list of all the existing buffers in the Buffers window in the Editor tool. Information is given on the name of the buffer, its mode, whether it has been modified or not, the pathname of any file it is associated with, and its size.

A buffer can be selected by clicking the left mouse button on the buffer name. The buttons on the toolbar can then be used to modify the selected buffer.

Create Buffer

Editor Command

Arguments: buffer-name
Key sequence: None

Creates a buffer called buffer-name . If no buffer name is provided then the current buffer is selected. If a buffer with the specified name already exists then this becomes the current buffer instead, and no new buffer is created.

New Buffer

Editor Command

Arguments: None
Key sequence: None

Creates a new unnamed buffer. The buffer is in Lisp mode.

Insert Buffer

Editor Command

Arguments: buffer-name
Key sequence: None

Inserts the contents of a buffer called buffer-name at the current point. If no buffer name is provided, the contents of the last buffer displayed in the current window are inserted.

Rename Buffer

Editor Command

Arguments: new-name
Key sequence: None

Changes the name of the current buffer to new-name .

Print Buffer

Editor Command

Arguments: None
Key sequence: None

Prints the current buffer, using capi:print-text . See the LispWorks CAPI Reference Manual for details of this function.

Toggle Buffer Read-Only

Editor Command

Arguments: None
Key sequence: Ctrl+X Ctrl+Q

Makes the current buffer read only, so that no modification to its contents are allowed. If it is already read only, this restriction is removed.

Check Buffer Modified

Editor Command

Arguments: None
Key sequence: Ctrl+X Shift+~

Checks whether the current buffer is modified or not.

Buffer Not Modified

Editor Command

Arguments: None
Key sequence: Meta+Shift+~

Makes the current buffer not modified.

The argument buffer is the name of the buffer to be un-modified. The default is the current buffer.