Go to the previous, next section.

Complete Definition of  beginning-of-buffer

The basic structure of the  beginning-of-buffer function has already been discussed. (See section A Simplified  beginning-of-buffer Definition Definition}.) This section describes the complex part of the definition.

As previously described, when invoked without an argument,  beginning-of-buffer moves the cursor to the beginning of the buffer, leaving the mark at the previous position. However, when the command is invoked with a number between one and ten, the function considers that number to be a fraction of the length of the buffer, measured in tenths, and Emacs moves the cursor that fraction of the way from the beginning of the buffer. Thus, you can either call this function with the key command M-<, which will move the cursor to the beginning of the buffer, or with a key command such as C-u 7 M-< which will move the cursor to a point 70% of the way through the buffer. If a number bigger than ten is used for the argument, it moves to the end of the buffer.

The  beginning-of-buffer function can be called with or without an argument. The use of the argument is optional.

Go to the previous, next section.