elisp: A Sample Variable Description

 
 1.3.7.2 A Sample Variable Description
 .....................................
 
 A “variable” is a name that can be “bound” (or “set”) to an object.  The
 object to which a variable is bound is called a “value”; we say also
 that variable holds that value.  Although nearly all variables can be
 set by the user, certain variables exist specifically so that users can
 change them; these are called “user options”.  Ordinary variables and
 user options are described using a format like that for functions,
 except that there are no arguments.
 
    Here is a description of the imaginary ‘electric-future-map’
 variable.
 
  -- Variable: electric-future-map
      The value of this variable is a full keymap used by Electric
      Command Future mode.  The functions in this map allow you to edit
      commands you have not yet thought about executing.
 
    User option descriptions have the same format, but ‘Variable’ is
 replaced by ‘User Option’.