change-buffer-name(2)

NAME

change-buffer-name - Change name of current buffer

SYNOPSIS

n change-buffer-name "buffer-name" (esc C-n) 

DESCRIPTION

change-buffer-name changes the name of the current buffer to buffer-name. Buffer names must be unique as they act as the identity handle. By default the buffer name is derived from the buffer's file name excluding the path. This can lead to conflicts, when editing files with the same name and different paths, in which case a counter is appended to the end of the buffer name to make the name unique. For example:

File Name               Buffer Name 

/etc/file.c             file.c 
/tmp/file.c             file.c<1> 

By default, or an argument is given with bit 1 set, change-buffer-name will fail if a buffer with the given name already exists. This behavior can be changed by giving an argument with the first bit cleared, e.g. 0, in which case if a buffer with that name already exists then a counter as appended.

SEE ALSO

$buffer-fname(5), change-file-name(2). delete-buffer(2).

(c) Copyright JASSPA 1999
Last Modified: 1998/08/12
Generated On: 1999/12/01