GNU Info

(emacs-lisp-intro.info)beginning-of-buffer

---

Next: Second Buffer Related Review Prev: insert-buffer Up: More Complex

---

Enter node , (file) or (file)node

Complete Definition of `beginning-of-buffer'
============================================

   The basic structure of the `beginning-of-buffer' function has
already been discussed.  (Note: A Simplified `beginning-of-buffer'
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.

Optional Arguments

beginning-of-buffer opt arg

Example with optional argument.

beginning-of-buffer complete