home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / msdos / winemacs / etc / doc < prev    next >
Encoding:
Text File  |  1993-06-08  |  421.2 KB  |  10,058 lines
  1. Fmake-abbrev-table
  2. Create a new, empty abbrev table object.
  3.  
  4. arguments:()
  5. Fclear-abbrev-table
  6. Undefine all abbrevs in abbrev table TABLE, leaving it empty.
  7.  
  8. arguments:(table)
  9. Fdefine-abbrev
  10. Define an abbrev in TABLE named NAME, to expand to EXPANSION and call HOOK.
  11. NAME and EXPANSION are strings.
  12. To undefine an abbrev, define it with EXPANSION = nil.
  13. If HOOK is non-nil, it should be a function of no arguments;
  14. it is called after EXPANSION is inserted.
  15.  
  16. arguments:(table name expansion &optional hook count)
  17. Fdefine-global-abbrev
  18. Define ABBREV as a global abbreviation for EXPANSION.
  19.  
  20. arguments:(name expansion)
  21. Fdefine-mode-abbrev
  22. Define ABBREV as a mode-specific abbreviation for EXPANSION.
  23.  
  24. arguments:(name expansion)
  25. Fabbrev-symbol
  26. Return the symbol representing abbrev named ABBREV.
  27. This symbol's name is ABBREV, but it is not the canonical symbol of that name;
  28. it is interned in an abbrev-table rather than the normal obarray.
  29. The value is nil if that abbrev is not defined.
  30. Optional second arg TABLE is abbrev table to look it up in.
  31. The default is to try buffer's mode-specific abbrev table, then global table.
  32.  
  33. arguments:(abbrev &optional table)
  34. Fabbrev-expansion
  35. Return the string that ABBREV expands into in the current buffer.
  36. Optionally specify an abbrev table as second arg;
  37. then ABBREV is looked up in that table only.
  38.  
  39. arguments:(abbrev &optional table)
  40. Fexpand-abbrev
  41. Expand the abbrev before point, if there is an abbrev there.
  42. Effective when explicitly called even when `abbrev-mode' is nil.
  43. Returns t if expansion took place.
  44.  
  45. arguments:()
  46. Funexpand-abbrev
  47. Undo the expansion of the last abbrev that expanded.
  48. This differs from ordinary undo in that other editing done since then
  49. is not undone.
  50.  
  51. arguments:()
  52. Finsert-abbrev-table-description
  53. Insert before point a full description of abbrev table named NAME.
  54. NAME is a symbol whose value is an abbrev table.
  55. If optional 2nd arg HUMAN is non-nil, a human-readable description is inserted.
  56. Otherwise the description is an expression,
  57. a call to `define-abbrev-table', which would
  58. define the abbrev table NAME exactly as it is currently defined.
  59.  
  60. arguments:(name &optional readable)
  61. Fdefine-abbrev-table
  62. Define TABNAME (a symbol) as an abbrev table name.
  63. Define abbrevs in it according to DEFINITIONS, which is a list of elements
  64. of the form (ABBREVNAME EXPANSION HOOK USECOUNT).
  65.  
  66. arguments:(tabname defns)
  67. Vabbrev-table-name-list
  68. List of symbols whose values are abbrev tables.Vglobal-abbrev-table
  69. The abbrev table whose abbrevs affect all buffers.
  70. Each buffer may also have a local abbrev table.
  71. If it does, the local table overrides the global one
  72. for any particular abbrev defined in both.Vfundamental-mode-abbrev-table
  73. The abbrev table of mode-specific abbrevs for Fundamental Mode.Vlast-abbrev
  74. The abbrev-symbol of the last abbrev expanded.  See `abbrev-symbol'.Vlast-abbrev-text
  75. The exact text of the last abbrev expanded.
  76. nil if the abbrev has already been unexpanded.Vlast-abbrev-location
  77. The location of the start of the last abbrev expanded.Vabbrev-start-location
  78. Buffer position for `expand-abbrev' to use as the start of the abbrev.
  79. nil means use the word before point as the abbrev.
  80. Calling `expand-abbrev' sets this to nil.Vabbrev-start-location-buffer
  81. Buffer that `abbrev-start-location' has been set for.
  82. Trying to expand an abbrev in any other buffer clears `abbrev-start-location'.Vabbrevs-changed
  83. Set non-nil by defining or altering any word abbrevs.
  84. This causes `save-some-buffers' to offer to save the abbrevs.Vabbrev-all-caps
  85. *Set non-nil means expand multi-word abbrevs all caps if abbrev was so.Vpre-abbrev-expand-hook
  86. Function or functions to be called before abbrev expansion is done.
  87. This is the first thing that `expand-abbrev' does, and so this may change
  88. the current abbrev table before abbrev lookup happens.Fcons
  89. Create a new cons, give it CAR and CDR as components, and return it.
  90.  
  91. arguments:(car cdr)
  92. Flist
  93. Return a newly created list with specified arguments as elements.
  94. Any number of arguments, even zero arguments, are allowed.
  95.  
  96. arguments: (&rest args)
  97. Fmake-list
  98. Return a newly created list of length LENGTH, with each element being INIT.
  99.  
  100. arguments:(length init)
  101. Fmake-vector
  102. Return a newly created vector of length LENGTH, with each element being INIT.
  103. See also the function `vector'.
  104.  
  105. arguments:(length init)
  106. Fvector
  107. Return a newly created vector with specified arguments as elements.
  108. Any number of arguments, even zero arguments, are allowed.
  109.  
  110. arguments: (&rest args)
  111. Fmake-byte-code
  112. Create a byte-code object with specified arguments as elements.
  113. At least four arguments are required; only six have any significance.
  114.  
  115. arguments: (arg1 arg2 arg3 arg4 &rest args)
  116. Fmake-symbol
  117. Return a newly allocated uninterned symbol whose name is NAME.
  118. Its value and function definition are void, and its property list is nil.
  119.  
  120. arguments:(str)
  121. Fmake-marker
  122. Return a newly allocated marker which does not point at any place.
  123.  
  124. arguments:()
  125. Fmake-string
  126. Return a newly created string of length LENGTH, with each element being INIT.
  127. Both LENGTH and INIT must be numbers.
  128.  
  129. arguments:(length init)
  130. Fpurecopy
  131. Make a copy of OBJECT in pure storage.
  132. Recursively copies contents of vectors and cons cells.
  133. Does not copy symbols.
  134.  
  135. arguments:(obj)
  136. Fgarbage-collect
  137. Reclaim storage for Lisp objects no longer needed.
  138. Returns info on amount of space in use:
  139.  ((USED-CONSES . FREE-CONSES) (USED-SYMS . FREE-SYMS)
  140.   (USED-MARKERS . FREE-MARKERS) USED-STRING-CHARS USED-VECTOR-SLOTS
  141.   (USED-FLOATS . FREE-FLOATS) (USED-EVENTS . FREE-EVENTS))
  142. Garbage collection happens automatically if you cons more than
  143. `gc-cons-threshold' bytes of Lisp data since previous garbage collection.
  144.  
  145. arguments:()
  146. Vgc-cons-threshold
  147. *Number of bytes of consing between garbage collections.
  148. Garbage collection can happen automatically once this many bytes have been
  149. allocated since the last garbage collection.  All data types count.
  150.  
  151. Garbage collection happens automatically when `eval' or `funcall' are
  152. called.  (Note that `funcall' is called implicitly.)
  153. By binding this temporarily to a large number, you can effectively
  154. prevent garbage collection during a part of the program.Vpure-bytes-used
  155. Number of bytes of sharable Lisp data allocated so far.Vdata-bytes-used
  156. Number of bytes of unshared memory allocated in this session.Vdata-bytes-free
  157. Number of bytes of unshared memory remaining available in this session.Vpurify-flag
  158. Non-nil means loading Lisp code in order to dump an executable.
  159. This means that certain objects should be allocated in shared (pure) space.Vundo-threshold
  160. Keep no more undo information once it exceeds this size.
  161. This threshold is applied when garbage collection happens.
  162. The size is counted as the number of bytes occupied,
  163. which includes both saved text and other data.Vundo-high-threshold
  164. Don't keep more than this much size of undo information.
  165. A command which pushes past this size is itself forgotten.
  166. This threshold is applied when garbage collection happens.
  167. The size is counted as the number of bytes occupied,
  168. which includes both saved text and other data.V   gc-currently-forbidden
  169. internal variable used to control undoFbuffer-list
  170. Return a list of all existing live buffers.
  171. The order is specific to the selected screen; if the optional SCREEN
  172. argument is provided, the ordering for that screen is returned instead.
  173. If the SCREEN argument is t, then the global (non-screen) ordering is
  174. returned instead.
  175.  
  176. arguments:(&optional screen)
  177. Fget-buffer
  178. Return the buffer named NAME (a string).
  179. If there is no live buffer named NAME, return nil.
  180. NAME may also be a buffer; if so, the value is that buffer.
  181.  
  182. arguments:(name)
  183. Fget-file-buffer
  184. Return the buffer visiting file FILENAME (a string).
  185. If there is no such live buffer, return nil.
  186.  
  187. arguments:(filename)
  188. Fget-buffer-create
  189. Return the buffer named NAME, or create such a buffer and return it.
  190. A new buffer is created if there is no live buffer named NAME.
  191. If NAME starts with a space, the new buffer does not keep undo information.
  192. If NAME is a buffer instead of a string, then it is the value returned.
  193. The value is never nil.
  194.  
  195. arguments:(name)
  196. Fgenerate-new-buffer-name
  197. Return a string that is the name of no existing buffer based on NAME.
  198. If there is no live buffer named NAME, then return NAME.
  199. Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
  200. until an unused name is found, and then return that name.
  201.  
  202. arguments:(name)
  203. Fbuffer-name
  204. Return the name of BUFFER, as a string.
  205. With no argument or nil as argument, return the name of the current buffer.
  206.  
  207. arguments:(&optional buffer)
  208. Fbuffer-file-name
  209. Return name of file BUFFER is visiting, or nil if none.
  210. No argument or nil as argument means use the current buffer.
  211.  
  212. arguments:(&optional buffer)
  213. Fbuffer-local-variables
  214. Return an alist of variables that are buffer-local in BUFFER.
  215. Each element looks like (SYMBOL . VALUE) and describes one variable.
  216. Note that storing new VALUEs in these elements doesn't change the variables.
  217. No argument or nil as argument means use current buffer as BUFFER.
  218.  
  219. arguments:(&optional buffer)
  220. Fbuffer-dedicated-screen
  221. Return the screen dedicated to this BUFFER, or nil if there is none.
  222. No argument or nil as argument means use current buffer as BUFFER.
  223.  
  224. arguments:(&optional buffer)
  225. Fset-buffer-dedicated-screen
  226. For this BUFFER, set the SCREEN dedicated to it.
  227. SCREEN must be a screen or nil.
  228.  
  229. arguments:(buffer screen)
  230. Fbuffer-modified-p
  231. Return t if BUFFER was modified since its file was last read or saved.
  232. No argument or nil as argument means use current buffer as BUFFER.
  233.  
  234. arguments:(&optional buffer)
  235. Fset-buffer-modified-p
  236. Mark current buffer as modified or unmodified according to FLAG.
  237. A non-nil FLAG means mark the buffer modified.
  238.  
  239. arguments:(flag)
  240. Fbuffer-modified-tick
  241. Return BUFFER's tick counter, incremented for each change in text.
  242. Each buffer has a tick counter which is incremented each time the text in
  243. that buffer is changed.  It wraps around occasionally.
  244. No argument or nil as argument means use current buffer as BUFFER.
  245.  
  246. arguments:(&optional buffer)
  247. Frename-buffer
  248. Change current buffer's name to NEWNAME (a string).
  249. If second arg DISTINGUISH is nil or omitted, it is an error if a
  250. buffer named NEWNAME already exists.
  251. If DISTINGUISH is non-nil, come up with a new name using
  252. `generate-new-buffer-name'.
  253. Return the name we actually gave the buffer.
  254. This does not change the name of the visited file (if any).
  255.  
  256. arguments:(name &optional distinguish)
  257. Fother-buffer
  258. Return most recently selected buffer other than BUFFER.
  259. Buffers not visible in windows are preferred to visible buffers.
  260. If no other buffer exists, the buffer `*scratch*' is returned.
  261. If BUFFER is omitted or nil, some interesting buffer is returned.
  262.  
  263. The ordering is for this screen; If second optional argument SCREEN
  264. is provided, then the ordering is for that screen.  If the second arg
  265. is t, then the global ordering is returned.
  266.  
  267. arguments:(&optional buffer screen)
  268. Fbuffer-disable-undo
  269. Make BUFFER stop keeping undo information.
  270. Any undo records it already has are discarded.
  271.  
  272. arguments:(buffer)
  273. Fbuffer-enable-undo
  274. Start keeping undo information for buffer BUFFER.
  275. No argument or nil as argument means do this for the current buffer.
  276.  
  277. arguments:(&optional buffer)
  278. Fkill-buffer
  279. Kill the buffer BUFFER.
  280. The argument may be a buffer or may be the name of a buffer.
  281. An argument of nil means kill the current buffer.
  282.  
  283. Value is t if the buffer is actually killed, nil if user says no.
  284.  
  285. The value of `kill-buffer-hook' (which may be local to that buffer),
  286. if not void, is a list of functions to be called, with no arguments,
  287. before the buffer is actually killed.  The buffer to be killed is current
  288. when the hook functions are called.
  289.  
  290. Any processes that have this buffer as the `process-buffer' are killed
  291. with `delete-process'.
  292.  
  293. arguments:(bufname)
  294. Fswitch-to-buffer
  295. Select buffer BUFFER in the current window.
  296. BUFFER may be a buffer or a buffer name.
  297. Optional second arg NORECORD non-nil means
  298. do not put this buffer at the front of the list of recently selected ones.
  299.  
  300. WARNING: This is NOT the way to work on another buffer temporarily
  301. within a Lisp program!  Use `set-buffer' instead.  That avoids messing with
  302. the window-buffer correspondences.
  303.  
  304. arguments:(bufname &optional norecord)
  305. Fpop-to-buffer
  306. Select buffer BUFFER in some window, preferably a different one.
  307. If BUFFER is nil, then some other buffer is chosen.
  308. If `pop-up-windows' is non-nil, windows can be split to do this.
  309. If optional second arg WINDOW is non-nil, insist on finding another
  310. window even if BUFFER is already visible in the selected window.
  311. If optional third arg is non-nil, it is the screen to pop to this
  312. buffer on.
  313.  
  314. arguments:(bufname &optional not_this_window_p on_screen)
  315. Fcurrent-buffer
  316. Return the current buffer as a Lisp object.
  317.  
  318. arguments:()
  319. Fset-buffer
  320. Make the buffer BUFFER current for editing operations.
  321. BUFFER may be a buffer or the name of an existing buffer.
  322. See also `save-excursion' when you want to make a buffer current temporarily.
  323. This function does not display the buffer, so its effect ends
  324. when the current command terminates.
  325. Use `switch-to-buffer' or `pop-to-buffer' to switch buffers permanently.
  326.  
  327. arguments:(bufname)
  328. Fbarf-if-buffer-read-only
  329. Signal a `buffer-read-only' error if the current buffer is read-only.
  330.  
  331. arguments:()
  332. Fbury-buffer
  333. Put BUFFER at the end of the list of all buffers.
  334. There it is the least likely candidate for `other-buffer' to return;
  335. thus, the least likely buffer for \[switch-to-buffer] to select by default.
  336.  
  337. arguments:(&optional buffer)
  338. Ferase-buffer
  339. Delete the entire contents of the current buffer.
  340. Any clipping restriction in effect (see `narrow-to-buffer') is removed,
  341. so the buffer is truly empty after this.
  342.  
  343. arguments:()
  344. Fkill-all-local-variables
  345. Switch to Fundamental mode by killing current buffer's local variables.
  346. Most local variable bindings are eliminated so that the default values
  347. become effective once more.  Also, the syntax table is set from
  348. `standard-syntax-table', the local keymap is set to nil,
  349. and the abbrev table from `fundamental-mode-abbrev-table'.
  350. This function also forces redisplay of the mode line.
  351.  
  352. Every function to select a new major mode starts by
  353. calling this function.
  354.  
  355. As a special exception, local variables whose names have
  356. a non-nil `permanent-local' property are not eliminated by this function.
  357.  
  358. arguments:()
  359. Fregion-fields
  360. Return list of fields overlapping a given portion of a buffer.
  361. The portion is specified by arguments START, END and BUFFER.
  362. BUFFER defaults to the current buffer.
  363. Optional 4th arg ERROR-CHECK non nil means just report an error
  364. if any protected fields overlap this portion.
  365.  
  366. arguments:(start end &optional buffer error_check)
  367. Vdefault-mode-line-format
  368. Default value of `mode-line-format' for buffers that don't override it.
  369. This is the same as (default-value 'mode-line-format).Vdefault-abbrev-mode
  370. Default value of `abbrev-mode' for buffers that do not override it.
  371. This is the same as (default-value 'abbrev-mode).Vdefault-ctl-arrow
  372. Default value of `ctl-arrow' for buffers that do not override it.
  373. This is the same as (default-value 'ctl-arrow).Vdefault-truncate-lines
  374. Default value of `truncate-lines' for buffers that do not override it.
  375. This is the same as (default-value 'truncate-lines).Vdefault-fill-column
  376. Default value of `fill-column' for buffers that do not override it.
  377. This is the same as (default-value 'fill-column).Vdefault-left-margin
  378. Default value of `left-margin' for buffers that do not override it.
  379. This is the same as (default-value 'left-margin).Vdefault-tab-width
  380. Default value of `tab-width' for buffers that do not override it.
  381. This is the same as (default-value 'tab-width).Vdefault-case-fold-search
  382. Default value of `case-fold-search' for buffers that don't override it.
  383. This is the same as (default-value 'case-fold-search).Vdefault-file-type
  384. Default value of `file-type' for buffers that do not override it.
  385. This is the same as (default-value 'file-type).Vmode-line-format
  386. Template for displaying mode line for current buffer.
  387. Each buffer has its own value of this variable.
  388. Value may be a string, a symbol or a list or cons cell.
  389. For a symbol, its value is used (but it is ignored if t or nil).
  390.  A string appearing directly as the value of a symbol is processed verbatim
  391.  in that the %-constructs below are not recognized.
  392. For a list whose car is a symbol, the symbol's value is taken,
  393.  and if that is non-nil, the cadr of the list is processed recursively.
  394.  Otherwise, the caddr of the list (if there is one) is processed.
  395. For a list whose car is a string or list, each element is processed
  396.  recursively and the results are effectively concatenated.
  397. For a list whose car is an integer, the cdr of the list is processed
  398.   and padded (if the number is positive) or truncated (if negative)
  399.   to the width specified by that number.
  400. A string is printed verbatim in the mode line except for %-constructs:
  401.   (%-constructs are allowed when the string is the entire mode-line-format
  402.    or when it is found in a cons-cell or a list)
  403.   %b -- print buffer name.      %f -- print visited file name.
  404.   %* -- print *, % or hyphen.   %m -- print value of mode-name (obsolete).
  405.   %s -- print process status.   %M -- print value of global-mode-string. (obs)
  406.   %S -- print name of selected screen (only meaningful under X Windows).
  407.   %p -- print percent of buffer above top of window, or top, bot or all.
  408.   %n -- print Narrow if appropriate.
  409.   %[ -- print one [ for each recursive editing level.  %] similar.
  410.   %% -- print %.   %- -- print infinitely many dashes.
  411. Decimal digits after the % specify field width to which to pad.Vdefault-major-mode
  412. *Major mode for new buffers.  Defaults to `fundamental-mode'.
  413. nil here means use current buffer's major mode.Vmajor-mode
  414. Symbol for current buffer's major mode.Vmode-name
  415. Pretty name of current buffer's major mode (a string).Vabbrev-mode
  416. Non-nil turns on automatic expansion of abbrevs as they are inserted.
  417. Automatically becomes buffer-local when set in any fashion.Vcase-fold-search
  418. *Non-nil if searches should ignore case.
  419. Automatically becomes buffer-local when set in any fashion.Vfill-column
  420. *Column beyond which automatic line-wrapping should happen.
  421. Automatically becomes buffer-local when set in any fashion.Vleft-margin
  422. *Column for the default indent-line-function to indent to.
  423. Linefeed indents to this column in Fundamental mode.
  424. Automatically becomes buffer-local when set in any fashion.Vtab-width
  425. *Distance between tab stops (for display of tab characters), in columns.
  426. Automatically becomes buffer-local when set in any fashion.Vctl-arrow
  427. *Non-nil means display control chars with uparrow.
  428. Nil means use backslash and octal digits.
  429. An integer means characters >= ctl-arrow are assumed to be printable, and
  430. will be displayed as a single glyph.
  431. Any other value is the same as 160 - the code SPC with the high bit on.
  432.  
  433. The interpretation of this variable is likely to change in the future.
  434.  
  435. Automatically becomes buffer-local when set in any fashion.
  436. This variable does not apply to characters whose display is specified
  437. in the current display table (if there is one).Vtruncate-lines
  438. *Non-nil means do not display continuation lines;
  439. give each line of text one screen line.
  440. Automatically becomes buffer-local when set in any fashion.
  441.  
  442. Note that this is overridden by the variable
  443. `truncate-partial-width-windows' if that variable is non-nil
  444. and this buffer is not full-screen width.Vfile-type
  445. *file-type for file and process input/output.Vdefault-directory
  446. Name of default directory of current buffer.  Should end with slash.
  447. Each buffer has its own value of this variable.Vauto-fill-function
  448. Function called (if non-nil) to perform auto-fill.
  449. It is called after self-inserting a space at a column beyond `fill-column'.
  450. Each buffer has its own value of this variable.
  451. NOTE: This variable is not an ordinary hook;
  452. It may not be a list of functions.Vbuffer-file-name
  453. Name of file visited in current buffer, or nil if not visiting a file.
  454. Each buffer has its own value of this variable.Vbuffer-file-truename
  455. The real name of the file visited in the current buffer, 
  456. or nil if not visiting a file.  This is the result of passing 
  457. buffer-file-name to the real-path-name function.  Every buffer 
  458. has its own value of this variable.  This variable is automatically 
  459. maintained by the functions that change the file name associated 
  460. with a buffer.Vbuffer-auto-save-file-name
  461. Name of file for auto-saving current buffer,
  462. or nil if buffer should not be auto-saved.
  463. Each buffer has its own value of this variable.Vbuffer-read-only
  464. Non-nil if this buffer is read-only.
  465. Each buffer has its own value of this variable.Vbuffer-backed-up
  466. Non-nil if this buffer's file has been backed up.
  467. Backing up is done before the first time the file is saved.
  468. Each buffer has its own value of this variable.Vbuffer-saved-size
  469. Length of current buffer when last read in, saved or auto-saved.
  470. 0 initially.
  471. Each buffer has its own value of this variable.Vselective-display
  472. Non-nil enables selective display:
  473. Integer N as value means display only lines
  474.  that start with less than n columns of space.
  475. A value of t means, after a ^M, all the rest of the line is invisible.
  476.  Then ^M's in the file are written into files as newlines.
  477.  
  478. Automatically becomes buffer-local when set in any fashion.Vlocal-abbrev-table
  479. Local (mode-specific) abbrev table of current buffer.Vselective-display-ellipses
  480. t means display ... on previous line when a line is invisible.
  481. Automatically becomes buffer-local when set in any fashion.Voverwrite-mode
  482. Non-nil if self-insertion should replace existing text.
  483. Automatically becomes buffer-local when set in any fashion.Vbuffer-display-table
  484. Display table that controls display of the contents of current buffer.
  485. Automatically becomes buffer-local when set in any fashion.
  486. The display table is a vector created with `make-display-table'.
  487. The first 256 elements control how to display each possible text character.
  488. The value should be a "rope" (see `make-rope') or nil;
  489. nil means display the character in the default fashion.
  490. The remaining five elements are ropes that control the display of
  491.   the end of a truncated screen line (element 256);
  492.   the end of a continued line (element 257);
  493.   the escape character used to display character codes in octal (element 258);
  494.   the character used as an arrow for control characters (element 259);
  495.   the decoration indicating the presence of invisible lines (element 260).
  496. If this variable is nil, the value of `standard-display-table' is used.
  497. Each window can have its own, overriding display table.Vbuffer-field-list
  498. List of fields in the current buffer.  See `add-field'.Vfind-file-compare-truenames
  499. If this is true, then the find-file command will check the truenames
  500. of all visited files when deciding whether a given file is already in
  501. a buffer, instead of just the buffer-file-name.  This means that if you
  502. attempt to visit another file which is a hard-link or symbolic-link to a
  503. file which is already in a buffer, the existing buffer will be found instead
  504. of a newly-created one.
  505.  
  506. See also the variable find-file-use-truenames.Vfind-file-use-truenames
  507. If this is true, then a buffer's visited file-name will always be
  508. chased back to the real file; it will never be a symbolic link, and there
  509. will never be a symbolic link anywhere in its directory path.
  510. That is, the buffer-file-name and buffer-file-truename will be equal.
  511.  
  512. See also the variable find-file-compare-truenames.Vbefore-change-function
  513. Function to call before each text change.
  514. Two arguments are passed to the function: the positions of
  515. the beginning and end of the range of old text to be changed.
  516. For an insertion, the beginning and end are at the same place.
  517. No information is given about the length of the text after the change.
  518. position of the change
  519.  
  520. While executing the `before-change-function', changes to buffers do not
  521. cause calls to any `before-change-function' or `after-change-function'.Vafter-change-function
  522. Function to call after each text change.
  523. Three arguments are passed to the function: the positions of
  524. the beginning and end of the range of changed text,
  525. and the length of the pre-change text replaced by that range.
  526. For an insertion, the pre-change length is zero;
  527. for a deletion, that length is the number of characters deleted,
  528. and the post-change beginning and end are at the same place.
  529.  
  530. While executing the `after-change-function', changes to buffers do not
  531. cause calls to any `before-change-function' or `after-change-function'.Vfirst-change-function
  532. Function to call before changing a buffer which is unmodified.
  533. The function is called, with no arguments, if it is non-nil.Vbuffer-undo-list
  534. List of undo entries in current buffer.Fbyte-code
  535. Function used internally in byte-compiled code.
  536. The first argument is a string of byte code; the second, a vector of constants;
  537. the third, the maximum stack depth used in this function.
  538. If the third argument is incorrect, Emacs may crash.
  539.  
  540. arguments:(bytestr vector maxdepth)
  541. Vbyte-code-meter
  542. A vector of vectors which holds a histogram of byte-code usage.Vbyte-metering-on
  543. Finteractive
  544. Specify a way of parsing arguments for interactive use of a function.
  545. For example, write
  546.   (defun foo (arg) "Doc string" (interactive "p") ...use arg...)
  547. to make ARG be the prefix argument when `foo' is called as a command.
  548. The "call" to `interactive' is actually a declaration rather than a function;
  549.  it tells `call-interactively' how to read arguments
  550.  to pass to the function.
  551. When actually called, `interactive' just returns nil.
  552.  
  553. The argument of `interactive' is usually a string containing a code letter
  554.  followed by a prompt.  (Some code letters do not use I/O to get
  555.  the argument and do not need prompts.)  To prompt for multiple arguments,
  556.  give a code letter, its prompt, a newline, and another code letter, etc.
  557.  Prompts are passed to format, and may use % escapes to print the
  558.  arguments that have already been read.
  559. If the argument is not a string, it is evaluated to get a list of
  560.  arguments to pass to the function.
  561. Just `(interactive)' means pass no args when calling interactively.
  562.  
  563. Code letters available are:
  564. a -- Function name: symbol with a function definition.
  565. b -- Name of existing buffer.
  566. B -- Name of buffer, possibly nonexistent.
  567. c -- Character.
  568. C -- Command name: symbol with interactive function definition.
  569. d -- Value of point as number.  Does not do I/O.
  570. D -- Directory name.
  571. e -- Last mouse event.
  572. f -- Existing file name.
  573. F -- Possibly nonexistent file name.
  574. k -- Key sequence (a vector of events).
  575. m -- Value of mark as number.  Does not do I/O.
  576. n -- Number read using minibuffer.
  577. N -- Prefix arg converted to number, or if none, do like code `n'.
  578. p -- Prefix arg converted to number.  Does not do I/O.
  579. P -- Prefix arg in raw form.  Does not do I/O.
  580. r -- Region: point and mark as 2 numeric args, smallest first.  Does no I/O.
  581. s -- Any string.
  582. S -- Any symbol.
  583. v -- Variable name: symbol that is user-variable-p.
  584. x -- Lisp expression read but not evaluated.
  585. X -- Lisp expression read and evaluated.
  586. In addition, if the string begins with `*'
  587.  then an error is signaled if the buffer is read-only.
  588.  This happens before reading any arguments.
  589. If the string begins with `@', then the window the mouse is over is selected
  590.  before anything else is done.  You may use both `@' and `*';
  591. they are processed in the order that they appear.
  592.  
  593. arguments:(args)
  594. Fcall-interactively
  595. Call FUNCTION, reading args according to its interactive calling specs.
  596. The function contains a specification of how to do the argument reading.
  597. In the case of user-defined functions, this is specified by placing a call
  598. to the function `interactive' at the top level of the function body.
  599. See `interactive'.
  600.  
  601. If optional second arg RECORD-FLAG is `t' then unconditionally put this
  602. ommand in the command-history.  Otherwise, this is done only if an arg is
  603. read using the minibuffer.
  604.  
  605. arguments:(function &optional record_flag)
  606. Fprefix-numeric-value
  607. Return numeric meaning of raw prefix argument ARG.
  608. A raw prefix argument is what you get from `(interactive "P")'.
  609. Its numeric meaning is what you would get from `(interactive "p")'.
  610.  
  611. arguments:(raw)
  612. Vprefix-arg
  613. The value of the prefix argument for the next editing command.
  614. It may be a number, or the symbol `-' for just a minus sign as arg,
  615. or a list whose car is a number for just one or more C-U's
  616. or nil if no argument has been specified.
  617.  
  618. You cannot examine this variable to find the argument for this command
  619. since it has been set to nil by the time you can look.
  620. Instead, you should use the variable `current-prefix-arg', although
  621. normally commands can get this prefix argument with (interactive "P").Vcurrent-prefix-arg
  622. The value of the prefix argument for this editing command.
  623. It may be a number, or the symbol `-' for just a minus sign as arg,
  624. or a list whose car is a number for just one or more C-U's
  625. or nil if no argument has been specified.
  626. This is what `(interactive "P")' returns.Vcurrent-mouse-event
  627. The mouse-button event which invoked this command, or nil.
  628. This is what `(interactive "e")' returns.Vcommand-history
  629. List of recent commands that read arguments from terminal.
  630. Each command is represented as a form to evaluate.Vcommand-debug-status
  631. Debugging status of current interactive command.
  632. Bound each time `call-interactively' is called;
  633. may be set by the debugger as a reminder for itself.Fcall-process
  634. Call PROGRAM synchronously in separate process.
  635. The program's input comes from file INFILE (nil means `/dev/null').
  636. Insert output in BUFFER before point; t means current buffer;
  637.  nil for BUFFER means discard it; 0 means discard and don't wait.
  638. Fourth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  639. Remaining arguments are strings passed as command arguments to PROGRAM.
  640. If BUFFER is nil or 0, returns immediately with value nil.
  641. Otherwise waits for PROGRAM to terminate
  642. and returns a numeric exit status or a signal name as a string.
  643. If you quit, the process is killed with SIGKILL.
  644.  
  645. arguments: (arg1 &rest args)
  646. Fcall-process-region
  647. Send text from START to END to a synchronous process running PROGRAM.
  648. Delete the text if fourth arg DELETE is non-nil.
  649. Insert output in BUFFER before point; t means current buffer;
  650.  nil for BUFFER means discard it; 0 means discard and don't wait.
  651. Sixth arg DISPLAY non-nil means redisplay buffer as output is inserted.
  652. Remaining args are passed to PROGRAM at startup as command args.
  653. If BUFFER is nil, returns immediately with value nil.
  654. Otherwise waits for PROGRAM to terminate
  655. and returns a numeric exit status or a signal name as a string.
  656. If you quit, the process is killed with SIGKILL.
  657.  
  658. arguments: (arg1 arg2 arg3 &rest args)
  659. Vshell-file-name
  660. *File name to load inferior shells from.
  661. Initialized from the SHELL environment variable.Vexec-path
  662. *List of directories to search programs to run in subprocesses.
  663. Each element is a string (directory name) or nil (try default directory).Vexec-directory
  664. Directory that holds programs that come with GNU Emacs,
  665. intended for Emacs to invoke.Vprocess-environment
  666. List of strings to append to environment of subprocesses that are started.
  667. Each string should have the format ENVVARNAME=VALUE.Fupcase
  668. Convert argument to upper case and return that.
  669. The argument may be a character or string.  The result has the same type.
  670. The argument object is not altered.  See also `capitalize'.
  671.  
  672. arguments:(obj)
  673. Fdowncase
  674. Convert argument to lower case and return that.
  675. The argument may be a character or string.  The result has the same type.
  676. The argument object is not altered.
  677.  
  678. arguments:(obj)
  679. Fcapitalize
  680. Convert argument to capitalized form and return that.
  681. This means that each word's first character is upper case
  682. and the rest is lower case.
  683. The argument may be a character or string.  The result has the same type.
  684. The argument object is not altered.
  685.  
  686. arguments:(obj)
  687. Fupcase-region
  688. Convert the region to upper case.  In programs, wants two arguments.
  689. These arguments specify the starting and ending character numbers of
  690. the region to operate on.  When used as a command, the text between
  691. point and the mark is operated on.
  692. See also `capitalize-region'.
  693.  
  694. arguments:(b e)
  695. Fdowncase-region
  696. Convert the region to lower case.  In programs, wants two arguments.
  697. These arguments specify the starting and ending character numbers of
  698. the region to operate on.  When used as a command, the text between
  699. point and the mark is operated on.
  700.  
  701. arguments:(b e)
  702. Fcapitalize-region
  703. Convert the region to capitalized form.
  704. Capitalized form means each word's first character is upper case
  705. and the rest of it is lower case.
  706. In programs, give two arguments, the starting and ending
  707. character positions to operate on.
  708.  
  709. arguments:(b e)
  710. Fupcase-word
  711. Convert following word (or ARG words) to upper case, moving over.
  712. With negative argument, convert previous words but do not move.
  713. See also `capitalize-word'.
  714.  
  715. arguments:(arg)
  716. Fdowncase-word
  717. Convert following word (or ARG words) to lower case, moving over.
  718. With negative argument, convert previous words but do not move.
  719.  
  720. arguments:(arg)
  721. Fcapitalize-word
  722. Capitalize the following word (or ARG words), moving over.
  723. This gives the word(s) a first character in upper case
  724. and the rest lower case.
  725. With negative argument, capitalize previous words but do not move.
  726.  
  727. arguments:(arg)
  728. Fcase-table-p
  729. Return t iff ARG is a case table.
  730. See `set-case-table' for more information on these data structures.
  731.  
  732. arguments:(table)
  733. Fcurrent-case-table
  734. Return the case table of the current buffer.
  735.  
  736. arguments:()
  737. Fstandard-case-table
  738. Return the standard case table.
  739. This is the one used for new buffers.
  740.  
  741. arguments:()
  742. Fset-case-table
  743. Select a new case table for the current buffer.
  744. A case table is a list (DOWNCASE UPCASE CANONICALIZE EQUIVALENCES)
  745.  where each element is either nil or a string of length 256.
  746. DOWNCASE maps each character to its lower-case equivalent.
  747. UPCASE maps each character to its upper-case equivalent;
  748.  if lower and upper case characters are in 1-1 correspondence,
  749.  you may use nil and the upcase table will be deduced from DOWNCASE.
  750. CANONICALIZE maps each character to a canonical equivalent;
  751.  any two characters that are related by case-conversion have the same
  752.  canonical equivalent character.
  753. EQUIVALENCES is a map that cyclicly permutes each equivalence class
  754.  (of characters with the same canonical equivalent).
  755. Both CANONICALIZE and EQUIVALENCES may be nil, in which case
  756.  both are deduced from DOWNCASE and UPCASE.
  757.  
  758. arguments:(table)
  759. Fset-standard-case-table
  760. Select a new standard case table for new buffers.
  761. See `set-case-table' for more info on case tables.
  762.  
  763. arguments:(table)
  764. Vascii-downcase-table
  765. String mapping ASCII characters to lowercase equivalents.Vascii-upcase-table
  766. String mapping ASCII characters to uppercase equivalents.Fforward-char
  767. Move point right ARG characters (left if ARG negative).
  768. On reaching end of buffer, stop and signal error.
  769.  
  770. arguments:(&optional n)
  771. Fbackward-char
  772. Move point left ARG characters (right if ARG negative).
  773. On attempt to pass beginning or end of buffer, stop and signal error.
  774.  
  775. arguments:(&optional n)
  776. Fforward-line
  777. Move ARG lines forward (backward if ARG is negative).
  778. Precisely, if point is on line I, move to the start of line I + ARG.
  779. If there isn't room, go as far as possible (no error).
  780. Returns the count of lines left to move.  If moving forward,
  781. that is ARG - number of lines moved; if backward, ARG + number moved.
  782. With positive ARG, a non-empty line at the end counts as one line
  783.   successfully moved (for the return value).
  784.  
  785. arguments:(&optional n)
  786. Fbeginning-of-line
  787. Move point to beginning of current line.
  788. With argument ARG not nil or 1, move forward ARG - 1 lines first.
  789. If scan reaches end of buffer, stop there without error.
  790.  
  791. arguments:(&optional n)
  792. Fend-of-line
  793. Move point to end of current line.
  794. With argument ARG not nil or 1, move forward ARG - 1 lines first.
  795. If scan reaches end of buffer, stop there without error.
  796.  
  797. arguments:(&optional n)
  798. Fdelete-char
  799. Delete the following ARG characters (previous, with negative arg).
  800. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  801. Interactively, ARG is the prefix arg, and KILLFLAG is set if
  802. ARG was explicitly specified.
  803.  
  804. arguments:(n &optional killflag)
  805. Fdelete-backward-char
  806. Delete the previous ARG characters (following, with negative ARG).
  807. Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
  808. Interactively, ARG is the prefix arg, and KILLFLAG is set if
  809. ARG was explicitly specified.
  810.  
  811. arguments:(n &optional killflag)
  812. Fself-insert-command
  813. Insert the character you type.
  814. Whichever character you type to run this command is inserted.
  815.  
  816. arguments:(arg)
  817. Fnewline
  818. Insert a newline.  With arg, insert that many newlines.
  819. In Auto Fill mode, if no numeric arg, break the preceding line if it's long.
  820.  
  821. arguments:(&optional arg1)
  822. Vblink-paren-function
  823. Function called, if non-nil, whenever a close parenthesis is inserted.
  824. More precisely, a char with closeparen syntax is self-inserted.Feq
  825. T if the two args are the same Lisp object.
  826.  
  827. arguments:(obj1 obj2)
  828. Fnull
  829. T if OBJECT is nil.
  830.  
  831. arguments:(obj)
  832. Fconsp
  833. T if OBJECT is a cons cell.
  834.  
  835. arguments:(obj)
  836. Fatom
  837. T if OBJECT is not a cons cell.  This includes nil.
  838.  
  839. arguments:(obj)
  840. Flistp
  841. T if OBJECT is a list.  This includes nil.
  842.  
  843. arguments:(obj)
  844. Fnlistp
  845. T if OBJECT is not a list.  Lists include nil.
  846.  
  847. arguments:(obj)
  848. Fsymbolp
  849. T if OBJECT is a symbol.
  850.  
  851. arguments:(obj)
  852. Fvectorp
  853. T if OBJECT is a vector.
  854.  
  855. arguments:(obj)
  856. Fstringp
  857. T if OBJECT is a string.
  858.  
  859. arguments:(obj)
  860. Farrayp
  861. T if OBJECT is an array (string or vector).
  862.  
  863. arguments:(obj)
  864. Fsequencep
  865. T if OBJECT is a sequence (list or array).
  866.  
  867. arguments:(obj)
  868. Fbufferp
  869. T if OBJECT is an editor buffer.
  870.  
  871. arguments:(obj)
  872. Fmarkerp
  873. T if OBJECT is a marker (editor pointer).
  874.  
  875. arguments:(obj)
  876. Finteger-or-marker-p
  877. T if OBJECT is an integer or a marker (editor pointer).
  878.  
  879. arguments:(obj)
  880. Fsubrp
  881. T if OBJECT is a built-in function.
  882.  
  883. arguments:(obj)
  884. Fcompiled-function-p
  885. T if OBJECT is a compiled function object (as returned by make-byte-code.)
  886.  
  887. arguments:(obj)
  888. Fchar-or-string-p
  889. T if OBJECT is a character (a number) or a string.
  890.  
  891. arguments:(obj)
  892. Fintegerp
  893. T if OBJECT is a number.
  894.  
  895. arguments:(obj)
  896. Fnatnump
  897. T if OBJECT is a nonnegative number.
  898.  
  899. arguments:(obj)
  900. Ffloatp
  901. T if OBJECT is a floating point number.
  902.  
  903. arguments:(obj)
  904. Fnumberp
  905. T if OBJECT is a number (floating point or integer).
  906.  
  907. arguments:(obj)
  908. Fnumber-or-marker-p
  909. T if OBJECT is a number or a marker.
  910.  
  911. arguments:(obj)
  912. Fextentp
  913. T if OBJECT is an extent..
  914.  
  915. arguments:(extent)
  916. Fcar
  917. Return the car of CONSCELL.  If arg is nil, return nil.
  918. Error if arg is not nil and not a cons cell.  See also `car-safe'.
  919.  
  920. arguments:(list)
  921. Fcar-safe
  922. Return the car of OBJECT if it is a cons cell, or else nil.
  923.  
  924. arguments:(object)
  925. Fcdr
  926. Return the cdr of CONSCELL.  If arg is nil, return nil.
  927. Error if arg is not nil and not a cons cell.  See also `cdr-safe'.
  928.  
  929. arguments:(list)
  930. Fcdr-safe
  931. Return the cdr of OBJECT if it is a cons cell, or else  nil.
  932.  
  933. arguments:(object)
  934. Fsetcar
  935. Set the car of CONSCELL to be NEWCAR.  Returns NEWCAR.
  936.  
  937. arguments:(cell newcar)
  938. Fsetcdr
  939. Set the cdr of CONSCELL to be NEWCDR.  Returns NEWCDR.
  940.  
  941. arguments:(cell newcdr)
  942. Fboundp
  943. T if SYMBOL's value is not void.
  944.  
  945. arguments:(sym)
  946. Ffboundp
  947. T if SYMBOL's function definition is not void.
  948.  
  949. arguments:(sym)
  950. Fmakunbound
  951. Make SYMBOL's value be void.
  952.  
  953. arguments:(sym)
  954. Ffmakunbound
  955. Make SYMBOL's function definition be void.
  956.  
  957. arguments:(sym)
  958. Fsymbol-function
  959. Return SYMBOL's function definition.  Error if that is void.
  960.  
  961. arguments:(sym)
  962. Fsymbol-plist
  963. Return SYMBOL's property list.
  964.  
  965. arguments:(sym)
  966. Fsymbol-name
  967. Return SYMBOL's name, a string.
  968.  
  969. arguments:(sym)
  970. Ffset
  971. Set SYMBOL's function definition to NEWVAL, and return NEWVAL.
  972.  
  973. arguments:(sym newdef)
  974. Fsetplist
  975. Set SYMBOL's property list to NEWVAL, and return NEWVAL.
  976.  
  977. arguments:(sym newplist)
  978. Fsymbol-value
  979. Return SYMBOL's value.  Error if that is void.
  980.  
  981. arguments:(sym)
  982. Fset
  983. Set SYMBOL's value to NEWVAL, and return NEWVAL.
  984.  
  985. arguments:(sym newval)
  986. Fdefault-boundp
  987. Return T if SYMBOL has a non-void default value.
  988. This is the value that is seen in buffers that do not have their own values
  989. for this variable.
  990.  
  991. arguments:(sym)
  992. Fdefault-value
  993. Return SYMBOL's default value.
  994. This is the value that is seen in buffers that do not have their own values
  995. for this variable.  The default value is meaningful for variables with
  996. local bindings in certain buffers.
  997.  
  998. arguments:(sym)
  999. Fset-default
  1000. Set SYMBOL's default value to VAL.  SYMBOL and VAL are evaluated.
  1001. The default value is seen in buffers that do not have their own values
  1002. for this variable.
  1003.  
  1004. arguments:(sym value)
  1005. Fsetq-default
  1006. Set SYMBOL's default value to VAL.  VAL is evaluated; SYMBOL is not.
  1007. The default value is seen in buffers that do not have their own values
  1008. for this variable.
  1009.  
  1010. arguments: (arg1 arg2 &rest args)
  1011. Fmake-variable-buffer-local
  1012. Make VARIABLE have a separate value for each buffer.
  1013. At any time, the value for the current buffer is in effect.
  1014. There is also a default value which is seen in any buffer which has not yet
  1015. set its own value.
  1016. Using `set' or `setq' to set the variable causes it to have a separate value
  1017. for the current buffer if it was previously using the default value.
  1018. The function `default-value' gets the default value and `set-default' sets it.
  1019.  
  1020. arguments:(sym)
  1021. Fmake-local-variable
  1022. Make VARIABLE have a separate value in the current buffer.
  1023. Other buffers will continue to share a common default value.
  1024. See also `make-variable-buffer-local'.
  1025.  
  1026. arguments:(sym)
  1027. Fkill-local-variable
  1028. Make VARIABLE no longer have a separate value in the current buffer.
  1029. From now on the default value will apply in this buffer.
  1030.  
  1031. arguments:(sym)
  1032. Findirect-function
  1033. Return the function at the end of OBJECT's function chain.
  1034. If OBJECT is a symbol, follow all function indirections and return
  1035. the final function binding.
  1036. If OBJECT is not a symbol, just return it.
  1037. Signal a void-function error if the final symbol is unbound.
  1038. Signal a cyclic-function-indirection error if there is a loop in the
  1039. function chain of symbols.
  1040.  
  1041. arguments:(object)
  1042. Faref
  1043. Return the element of ARRAY at index INDEX.
  1044. ARRAY may be a vector or a string, or a byte-code object.  INDEX starts at 0.
  1045.  
  1046. arguments:(array idx)
  1047. Faset
  1048. Store into the element of ARRAY at index INDEX the value NEWVAL.
  1049. ARRAY may be a vector or a string.  INDEX starts at 0.
  1050.  
  1051. arguments:(array idx newelt)
  1052. F=
  1053. T if two args, both numbers or markers, are equal.
  1054.  
  1055. arguments:(num1 num2)
  1056. F<
  1057. T if first arg is less than second arg.  Both must be numbers or markers.
  1058.  
  1059. arguments:(num1 num2)
  1060. F>
  1061. T if first arg is greater than second arg.  Both must be numbers or markers.
  1062.  
  1063. arguments:(num1 num2)
  1064. F<=
  1065. T if first arg is less than or equal to second arg.
  1066. Both must be numbers or markers.
  1067.  
  1068. arguments:(num1 num2)
  1069. F>=
  1070. T if first arg is greater than or equal to second arg.
  1071. Both must be numbers or markers.
  1072.  
  1073. arguments:(num1 num2)
  1074. F/=
  1075. T if first arg is not equal to second arg.  Both must be numbers or markers.
  1076.  
  1077. arguments:(num1 num2)
  1078. Fzerop
  1079. T if NUMBER is zero.
  1080.  
  1081. arguments:(num)
  1082. Fint-to-string
  1083. Convert INT to a string by printing it in decimal.
  1084. Uses a minus sign if negative.
  1085.  
  1086. arguments:(num)
  1087. Fstring-to-int
  1088. Convert STRING to an integer by parsing it as a decimal number.
  1089.  
  1090. arguments:(str)
  1091. F+
  1092. Return sum of any number of arguments, which are numbers or markers.
  1093.  
  1094. arguments: (&rest args)
  1095. F-
  1096. Negate number or subtract numbers or markers.
  1097. With one arg, negates it.  With more than one arg,
  1098. subtracts all but the first from the first.
  1099.  
  1100. arguments: (&rest args)
  1101. F*
  1102. Returns product of any number of arguments, which are numbers or markers.
  1103.  
  1104. arguments: (&rest args)
  1105. F/
  1106. Returns first argument divided by all the remaining arguments.
  1107. The arguments must be numbers or markers.
  1108.  
  1109. arguments: (arg1 arg2 &rest args)
  1110. F%
  1111. Returns remainder of first arg divided by second.
  1112. Both must be numbers or markers.
  1113.  
  1114. arguments:(num1 num2)
  1115. Fmax
  1116. Return largest of all the arguments (which must be numbers or markers).
  1117. The value is always a number; markers are converted to numbers.
  1118.  
  1119. arguments: (arg1 &rest args)
  1120. Fmin
  1121. Return smallest of all the arguments (which must be numbers or markers).
  1122. The value is always a number; markers are converted to numbers.
  1123.  
  1124. arguments: (arg1 &rest args)
  1125. Flogand
  1126. Return bitwise-and of all the arguments.
  1127. Arguments may be integers, or markers converted to integers.
  1128.  
  1129. arguments: (&rest args)
  1130. Flogior
  1131. Return bitwise-or of all the arguments.
  1132. Arguments may be integers, or markers converted to integers.
  1133.  
  1134. arguments: (&rest args)
  1135. Flogxor
  1136. Return bitwise-exclusive-or of all the arguments.
  1137. Arguments may be integers, or markers converted to integers.
  1138.  
  1139. arguments: (&rest args)
  1140. Fash
  1141. Return VALUE with its bits shifted left by COUNT.
  1142. If COUNT is negative, shifting is actually to the right.
  1143. In this case, the sign bit is duplicated.
  1144.  
  1145. arguments:(num1 num2)
  1146. Flsh
  1147. Return VALUE with its bits shifted left by COUNT.
  1148. If COUNT is negative, shifting is actually to the right.
  1149. In this case,  zeros are shifted in on the left.
  1150.  
  1151. arguments:(num1 num2)
  1152. F1+
  1153. Return NUMBER plus one.  NUMBER may be a number or a marker.
  1154. Markers are converted to integers.
  1155.  
  1156. arguments:(num)
  1157. F1-
  1158. Return NUMBER minus one.  NUMBER may be a number or a marker.
  1159. Markers are converted to integers.
  1160.  
  1161. arguments:(num)
  1162. Flognot
  1163. Return the bitwise complement of ARG.  ARG must be an integer.
  1164.  
  1165. arguments:(num)
  1166. Fdirectory-files
  1167. Return a list of names of files in DIRECTORY.
  1168. There are four optional arguments:
  1169. If FULL is non-nil, absolute pathnames of the files are returned.
  1170. If MATCH is non-nil, only pathnames containing that regexp are returned.
  1171. If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
  1172.  NOSORT is useful if you plan to sort the result yourself.
  1173. If FILES-ONLY is the symbol t, then only the "files" in the directory
  1174.  will be returned; subdirectories will be excluded.  If FILES-ONLY is not
  1175.  nil and not t, then only the subdirectories will be returned.  Otherwise,
  1176.  if FILES-ONLY is nil (the default) then both files and subdirectories will
  1177.  be returned.
  1178.  
  1179. arguments:(dirname &optional full match nosort files_only)
  1180. Ffile-name-completion
  1181. Complete file name FILE in directory DIR.
  1182. Returns the longest string
  1183. common to all filenames in DIR that start with FILE.
  1184. If there is only one and FILE matches it exactly, returns t.
  1185. Returns nil if DIR contains no name starting with FILE.
  1186.  
  1187. arguments:(file dirname)
  1188. Ffile-name-all-completions
  1189. Return a list of all completions of file name FILE in directory DIR.
  1190. These are all file names in directory DIR which begin with FILE.
  1191.  
  1192. arguments:(file dirname)
  1193. Ffile-name-all-versions
  1194. Return a list of all versions of file name FILE in directory DIR.
  1195.  
  1196. arguments:(file dirname)
  1197. Ffile-attributes
  1198. Return a list of attributes of file FILENAME.
  1199. Value is nil if specified file cannot be opened.
  1200. Otherwise, list elements are:
  1201.  0. t for directory, string (name linked to) for symbolic link, or nil.
  1202.  1. Number of links to file.
  1203.  2. File uid.
  1204.  3. File gid.
  1205.  4. Last access time, as a list of two integers.
  1206.   First integer has high-order 16 bits of time, second has low 16 bits.
  1207.  5. Last modification time, likewise.
  1208.  6. Last status change time, likewise.
  1209.  7. Size in bytes.
  1210.  8. File modes, as a string of ten letters or dashes as in ls -l.
  1211.  9. t iff file's gid would change if file were deleted and recreated.
  1212. 10. inode number.
  1213.  
  1214. If file does not exists, returns nil.
  1215.  
  1216. arguments:(filename)
  1217. Ftime-to-string
  1218.  
  1219.  
  1220. arguments:(time)
  1221. Vcompletion-ignored-extensions
  1222. *Completion ignores filenames ending in any string in this list.
  1223. This variable does not affect lists of possible completions,
  1224. but does affect the commands that actually do completions.Fopen-termscript
  1225. Start writing all terminal output to FILE as well as the terminal.
  1226. FILE = nil means just close any termscript file currently open.
  1227.  
  1228. arguments:(file)
  1229. Fsend-string-to-terminal
  1230. Send STRING to the terminal without alteration.
  1231. Control characters in STRING will have terminal-dependent effects.
  1232.  
  1233. arguments:(str)
  1234. Fding
  1235. Beep, or flash the screen.
  1236. Also, unless an argument is given,
  1237. terminate any keyboard macro currently executing.
  1238. When called from lisp, the second argument is what sound to make.
  1239.  
  1240. arguments:(&optional arg sound)
  1241. Finitialize-first-screen
  1242. Make redisplay work on the first screen (do this early.)
  1243.  
  1244. arguments:()
  1245. Vbaud-rate
  1246. The output baud rate of the terminal.
  1247. On most systems, changing this value will affect the amount of padding
  1248. and the other strategic decisions made during redisplay.Vinverse-video
  1249. *Non-nil means invert the entire screen display.
  1250. This means everything is in inverse video which otherwise would not be.Vvisible-bell
  1251. *Non-nil means try to flash the screen to represent a bell.Vno-redraw-on-reenter
  1252. *Non-nil means no need to redraw entire screen after suspending.
  1253. A non-nil value is useful if the terminal can automatically preserve
  1254. Emacs's screen display when you reenter Emacs.
  1255. It is up to you to set this variable if your terminal can do that.Vwindow-system
  1256. A symbol naming the window-system under which Emacs is running,
  1257. such as `x', or nil if emacs is running on an ordinary terminal.Vwindow-system-version
  1258. The version number of the window system in use.
  1259. For X windows, this is 10 or 11.Vcursor-in-echo-area
  1260. Non-nil means put cursor in minibuffer, at end of any message there.Vglyph-table
  1261. Table defining how to output a glyph code to the screen.
  1262. If not nil, this is a vector indexed by glyph code to define the glyph.
  1263. Each element can be:
  1264.  integer: a glyph code which this glyph is an alias for.
  1265.  string: output this glyph using that string (not impl. in X windows).
  1266.  nil: this glyph mod 256 is char code to output,
  1267.     and this glyph / 256 is face code for X windows (see `x-set-face').Vstandard-display-table
  1268. Display table to use for buffers that specify none.
  1269. See `buffer-display-table' for more information.Fdocumentation
  1270. Return the documentation string of FUNCTION.
  1271.  
  1272. arguments:(fun1)
  1273. Fdocumentation-property
  1274. Return the documentation string that is SYMBOL's PROP property.
  1275. This differs from using `get' only in that it can refer to strings
  1276. stored in the `etc/DOC' file.
  1277.  
  1278. arguments:(sym prop)
  1279. FSnarf-documentation
  1280. Used during Emacs initialization, before dumping runnable Emacs,
  1281. to find pointers to doc strings stored in `etc/DOC...' and
  1282. record them in function definitions.
  1283. One arg, FILENAME, a string which does not include a directory.
  1284. The file is found in `../etc' now; found in the `exec-directory'
  1285. when doc strings are referred to later in the dumped Emacs.
  1286.  
  1287. arguments:(filename)
  1288. FVerify-documentation
  1289. Used to make sure everything went well with Snarf-documentation.
  1290. Writes to stderr if not.
  1291.  
  1292. arguments:()
  1293. Fsubstitute-command-keys
  1294. Substitute key descriptions for command names in STRING.
  1295. Return a new string which is STRING with substrings of the form \=\[COMMAND]
  1296. replaced by either:  a keystroke sequence that will invoke COMMAND,
  1297. or "M-x COMMAND" if COMMAND is not on any keys.
  1298. Substrings of the form \=\{MAPVAR} are replaced by summaries
  1299. (made by describe-bindings) of the value of MAPVAR, taken as a keymap.
  1300. Substrings of the form \=\<MAPVAR> specify to use the value of MAPVAR
  1301. as the keymap for future \=\[COMMAND] substrings.
  1302. \=\= quotes the following character and is discarded;
  1303. thus, \=\=\=\= puts \=\= into the output, and \=\=\=\[ puts \=\[ into the output.
  1304.  
  1305. arguments:(str)
  1306. Vinternal-doc-file-name
  1307. Name of file containing documentation strings of built-in symbols.Fint86
  1308.  
  1309.  
  1310. arguments:(intno regs)
  1311. Ffep-init
  1312.  
  1313.  
  1314. arguments:()
  1315. Ffep-term
  1316.  
  1317.  
  1318. arguments:()
  1319. Ffep-on
  1320.  
  1321.  
  1322. arguments:()
  1323. Ffep-off
  1324.  
  1325.  
  1326. arguments:()
  1327. Ffep-force-on
  1328.  
  1329.  
  1330. arguments:()
  1331. Ffep-force-off
  1332.  
  1333.  
  1334. arguments:()
  1335. Fpc98-assign-special-key
  1336.  
  1337.  
  1338. arguments:()
  1339. Fpc98-cancel-special-key
  1340.  
  1341.  
  1342. arguments:()
  1343. Vdos-machine-type
  1344. A symbol naming the dos-machine-type under which Emacs is running,
  1345. (such as `ibmpc'), or nil means running on dos generic mode.Vdos-inhibit-setdisk
  1346. *Non-nil means that changing current drive is inhibited.Vinhibit-fep-control
  1347. *Non-nil means that Kana-Kanji FEP control is inhibited.Fchar-to-string
  1348. Convert arg CHAR to a one-character string containing that character.
  1349.  
  1350. arguments:(n)
  1351. Fstring-to-char
  1352. Convert arg STRING to a character, the first character of that string.
  1353.  
  1354. arguments:(str)
  1355. Fpoint
  1356. Return value of point, as an integer.
  1357. Beginning of buffer is position (point-min)
  1358.  
  1359. arguments:()
  1360. Fpoint-marker
  1361. Return value of point, as a marker object.
  1362. This marker is a copy; you may modify it with reckless abandon.
  1363. If the argument to this function is non-nil, then it returns the real
  1364. point-marker; modifying the position of this marker willl move point.
  1365. It is illegal to change the buffer of it, or make it point nowhere.
  1366.  
  1367. arguments:(&optional dont_copy_p)
  1368. Fgoto-char
  1369. Set point to POSITION, a number or marker.
  1370. Beginning of buffer is position (point-min), end is (point-max).
  1371.  
  1372. arguments:(n)
  1373. Fregion-beginning
  1374. Return position of beginning of region, as an integer.
  1375.  
  1376. arguments:()
  1377. Fregion-end
  1378. Return position of end of region, as an integer.
  1379.  
  1380. arguments:()
  1381. Fzmacs-activate-region
  1382. Make the region between `point' and `mark' be in the active (hilighted)
  1383. state, if `zmacs-regions' is true.  Only a very small number of commands
  1384. should ever do this.
  1385.  
  1386. arguments:()
  1387. Fzmacs-deactivate-region
  1388. Make the region between `point' and `mark' no longer be in the active
  1389. (hilighted) state, if `zmacs-regions' is true.  You shouldn't need to call
  1390. this; the command loop calls it when appropriate.
  1391. Returns t if the region had been active, nil otherwise.
  1392.  
  1393. arguments:()
  1394. Fmark-marker
  1395. Return this buffer's mark, as a marker object.
  1396. If `zmacs-regions' is true, then this returns nil unless the region is
  1397. currently in the active (hilighted) state.  With an argument of t, this
  1398. returns the mark (if there is one) regardless of the zmacs-region state.
  1399. You should *generally* not use the mark unless the region is active, if
  1400. the user has expressed a preference for the zmacs-region model.
  1401. Watch out!  Moving this marker changes the mark position.
  1402. If you set the marker not to point anywhere, the buffer will have no mark.
  1403.  
  1404. arguments:(&optional inactive_p)
  1405. Fsave-excursion
  1406. Save point (and mark), execute BODY, then restore point and mark.
  1407. Executes BODY just like `progn'.  Point and mark values are restored
  1408. even in case of abnormal exit (throw or error).
  1409.  
  1410. arguments: (&rest args)
  1411. Fbuffer-size
  1412. Return the number of characters in the current buffer.
  1413.  
  1414. arguments:()
  1415. Fpoint-min
  1416. Return the minimum permissible value of point in the current buffer.
  1417. This is 1, unless a clipping restriction is in effect.
  1418.  
  1419. arguments:()
  1420. Fpoint-min-marker
  1421. Return a marker to the minimum permissible value of point in this buffer.
  1422. This is the beginning, unless a clipping restriction is in effect.
  1423.  
  1424. arguments:()
  1425. Fpoint-max
  1426. Return the maximum permissible value of point in the current buffer.
  1427. This is (1+ (buffer-size)), unless a clipping restriction is in effect,
  1428. in which case it is less.
  1429.  
  1430. arguments:()
  1431. Fpoint-max-marker
  1432. Return a marker to the maximum permissible value of point in this buffer.
  1433. This is (1+ (buffer-size)), unless a clipping restriction is in effect,
  1434. in which case it is less.
  1435.  
  1436. arguments:()
  1437. Ffollowing-char
  1438. Return the character following point, as a number.
  1439.  
  1440. arguments:()
  1441. Fpreceding-char
  1442. Return the character preceding point, as a number.
  1443.  
  1444. arguments:()
  1445. Fbobp
  1446. Return T if point is at the beginning of the buffer.
  1447. If the buffer is narrowed, this means the beginning of the narrowed part.
  1448.  
  1449. arguments:()
  1450. Feobp
  1451. Return T if point is at the end of the buffer.
  1452. If the buffer is narrowed, this means the end of the narrowed part.
  1453.  
  1454. arguments:()
  1455. Fbolp
  1456. Return T if point is at the beginning of a line.
  1457.  
  1458. arguments:()
  1459. Feolp
  1460. Return T if point is at the end of a line.
  1461. `End of a line' includes point being at the end of the buffer.
  1462.  
  1463. arguments:()
  1464. Fchar-after
  1465. Return character in current buffer at position POS.
  1466. POS is an integer or a buffer pointer.
  1467. If POS is out of range, the value is nil.
  1468.  
  1469. arguments:(pos)
  1470. Fuser-login-name
  1471. Return the name under which the user logged in, as a string.
  1472. This is based on the effective uid, not the real uid.
  1473. Also, if the environment variable USER or LOGNAME is set,
  1474. that determines the value of this function.
  1475.  
  1476. arguments:()
  1477. Fuser-real-login-name
  1478. Return the name of the user's real uid, as a string.
  1479. Differs from `user-login-name' when running under `su'.
  1480.  
  1481. arguments:()
  1482. Fuser-uid
  1483. Return the effective uid of Emacs, as an integer.
  1484.  
  1485. arguments:()
  1486. Fuser-real-uid
  1487. Return the real uid of Emacs, as an integer.
  1488.  
  1489. arguments:()
  1490. Fuser-full-name
  1491. Return the full name of the user logged in, as a string.
  1492.  
  1493. arguments:()
  1494. Fsystem-name
  1495. Return the name of the machine you are running on, as a string.
  1496.  
  1497. arguments:()
  1498. Fcurrent-time-seconds
  1499. Returns the current time as the number of seconds since Jan. 1, 1970, 00:00,
  1500. Greenwich Mean Time.  Since emacs can't represent integers that large, this
  1501. is returned as a cons of two 16-bit numbers.  You can pass this value as an
  1502. argument to current-time-string to get that time as a string.
  1503.  
  1504. arguments:(&optional cons)
  1505. Fcurrent-time-string
  1506. Return the current time, as a human-readable string.
  1507. Programs can use it too, since the number of columns in each field is fixed.
  1508. The format is `Sun Sep 16 01:03:52 1973'.
  1509. If the optional argument is non-nil, it must be a cons of two integers, which
  1510. are the upper and lower 16 bits of a time in seconds (such as the value 
  1511. returned by the current-time-seconds function.
  1512. In a future Emacs version, the time zone may be added at the end,
  1513. if we can figure out a reasonably easy way to get that information.
  1514.  
  1515. arguments:(&optional arg)
  1516. Fset-default-file-mode
  1517. Set Unix `umask' value to ARGUMENT, and return old value.
  1518. The `umask' value is the default protection mode for new files.
  1519.  
  1520. arguments:(nmask)
  1521. Funix-sync
  1522. Tell Unix to finish all pending disk updates.
  1523.  
  1524. arguments:()
  1525. Finsert
  1526. Insert the arguments, either strings or characters, at point.
  1527. Point moves forward so that it ends up after the inserted text.
  1528. Any other markers at the point of insertion remain before the text.
  1529.  
  1530. arguments: (&rest args)
  1531. Finsert-before-markers
  1532. Insert strings or characters at point, relocating markers after the text.
  1533. Point moves forward so that it ends up after the inserted text.
  1534. Any other markers at the point of insertion also end up after the text.
  1535.  
  1536. arguments: (&rest args)
  1537. Finsert-char
  1538. Insert COUNT (second arg) copies of CHAR (first arg).
  1539. Point and all markers are affected as in the function `insert'.
  1540. Both arguments are required.
  1541.  
  1542. arguments:(chr count)
  1543. Fbuffer-substring
  1544. Return the contents of part of the current buffer as a string.
  1545. The two arguments START and END are character positions;
  1546. they can be in either order.
  1547.  
  1548. arguments:(b e)
  1549. Fbuffer-string
  1550. Return the contents of the current buffer as a string.
  1551.  
  1552. arguments:()
  1553. Finsert-buffer-substring
  1554. Insert before point a substring of the contents buffer BUFFER.
  1555. BUFFER may be a buffer or a buffer name.
  1556. Arguments START and END are character numbers specifying the substring.
  1557. They default to the beginning and the end of BUFFER.
  1558.  
  1559. arguments:(buf &optional b e)
  1560. Fsubst-char-in-region
  1561. From START to END, replace FROMCHAR with TOCHAR each time it occurs.
  1562. If optional arg NOUNDO is non-nil, don't record this change for undo
  1563. and don't mark the buffer as really changed.
  1564.  
  1565. arguments:(start end fromchar tochar &optional noundo)
  1566. Ftranslate-region
  1567. From START to END, translate characters according to TABLE.
  1568. TABLE is a string; the Nth character in it is the mapping
  1569. for the character with code N.  Returns the number of characters changed.
  1570.  
  1571. arguments:(start end table)
  1572. Fdelete-region
  1573. Delete the text between point and mark.
  1574. When called from a program, expects two arguments,
  1575. positions (integers or markers) specifying the stretch to be deleted.
  1576.  
  1577. arguments:(b e)
  1578. Fwiden
  1579. Remove restrictions (narrowing) from current buffer.
  1580. This allows the buffer's full text to be seen and edited.
  1581.  
  1582. arguments:()
  1583. Fnarrow-to-region
  1584. Restrict editing in this buffer to the current region.
  1585. The rest of the text becomes temporarily invisible and untouchable
  1586. but is not deleted; if you save the buffer in a file, the invisible
  1587. text is included in the file.  \[widen] makes all visible again.
  1588. See also `save-restriction'.
  1589.  
  1590. When calling from a program, pass two arguments; positions (integers
  1591. or markers) bounding the text that should remain visible.
  1592.  
  1593. arguments:(b e)
  1594. Fsave-restriction
  1595. Execute BODY, saving and restoring current buffer's restrictions.
  1596. The buffer's restrictions make parts of the beginning and end invisible.
  1597. (They are set up with `narrow-to-region' and eliminated with `widen'.)
  1598. This special form, `save-restriction', saves the current buffer's restrictions
  1599. when it is entered, and restores them when it is exited.
  1600. So any `narrow-to-region' within BODY lasts only until the end of the form.
  1601. The old restrictions settings are restored
  1602. even in case of abnormal exit (throw or error).
  1603.  
  1604. The value returned is the value of the last form in BODY.
  1605.  
  1606. `save-restriction' can get confused if, within the BODY, you widen
  1607. and then make changes outside the area within the saved restrictions.
  1608.  
  1609. Note: if you are using both `save-excursion' and `save-restriction',
  1610. use `save-excursion' outermost:
  1611.     (save-excursion (save-restriction ...))
  1612.  
  1613. arguments: (&rest args)
  1614. Fmessage
  1615. Print a one-line message at the bottom of the screen.
  1616. The first argument is a control string.
  1617. It may contain %s or %d or %c to print successive following arguments.
  1618. %s means print an argument as a string, %d means print as number in decimal,
  1619. %c means print a number as a single character.
  1620. The argument used by %s must be a string or a symbol;
  1621. the argument used by %d or %c must be a number.
  1622.  
  1623. arguments: (arg1 &rest args)
  1624. Fformat
  1625. Format a string out of a control-string and arguments.
  1626. The first argument is a control string.
  1627. The other arguments are substituted into it to make the result, a string.
  1628. It may contain %-sequences meaning to substitute the next argument.
  1629. %s means print strings using princ, and any other objects using prin1.
  1630. %S means print all objects using prin1 (strings too).
  1631. %d means print as number in decimal (%o octal, %x hex).
  1632. %c means print a number as a single character.
  1633. The argument used for %d, %o, %x or %c must be a number.
  1634.  
  1635. arguments: (arg1 &rest args)
  1636. Fchar-equal
  1637. Return t if two characters match, optionally ignoring case.
  1638. Both arguments must be characters (i.e. integers).
  1639. Case is ignored if `case-fold-search' is non-nil in the current buffer.
  1640.  
  1641. arguments:(c1 c2)
  1642. Fgetenv
  1643. Return the value of environment variable VAR, as a string.
  1644. VAR should be a string.  Value is nil if VAR is undefined in the environment.
  1645.  
  1646. arguments:(str ignored)
  1647. Vsystem-name
  1648. The name of the machine Emacs is running on.Vuser-full-name
  1649. The full name of the user logged in.Vuser-name
  1650. The user's name, based on the effective uid.Vuser-real-name
  1651. The user's name, base upon the real uid.Vzmacs-regions
  1652. *Whether LISPM-style active regions should be used.
  1653. This means that commands which operate on the region (the area between the
  1654. point and the mark) will only work while the region is in the ``active''
  1655. state, which is indicated by hilighting.  Executing most commands causes
  1656. the region to not be in the active state, so (for example) \[kill-region] will only
  1657. work immediately after activating the region.
  1658.  
  1659. More specifically:
  1660.  
  1661.  - Commands which operate on the region only work if the region is active.
  1662.  - Only a very small set of commands cause the region to become active:
  1663.    Those commands whose semantics are to mark an area, like mark-defun.
  1664.  - The region is deactivated after each command that is executed, except that:
  1665.  - "Motion" commands do not change whether the region is active or not.
  1666.  
  1667. set-mark-command (C-SPC) pushes a mark and activates the region.  Moving the
  1668. cursor with normal motion commands (C-n, C-p, etc) will cause the region
  1669. between point and the recently-pushed mark to be highlighted.  It will
  1670. remain highlighted until some non-motion comand is executed.
  1671.  
  1672. exchange-point-and-mark (\[exchange-point-and-mark]) activates the region.  So if you mark a
  1673. region and execute a command that operates on it, you can reactivate the
  1674. same region with \[exchange-point-and-mark] (or perhaps \[exchange-point-and-mark] \[exchange-point-and-mark]) to operate on it
  1675. again.
  1676.  
  1677. Generally, commands which push marks as a means of navigation (like
  1678. beginning-of-buffer and end-of-buffer (M-< and M->)) do not activate the
  1679. region.  But commands which push marks as a means of marking an area of
  1680. text (like mark-defun (\[mark-defun]), mark-word (\[mark-word]) or mark-whole-buffer (\[mark-whole-buffer]))
  1681. do activate the region.Vzmacs-activate-region-hook
  1682. Function or functions called when the region becomes active;
  1683. see the variable `zmacs-regions'.Vzmacs-deactivate-region-hook
  1684. Function or functions called when the region becomes inactive;
  1685. see the variable `zmacs-regions'.Vzmacs-update-region-hook
  1686. Function or functions called when the active region changes.
  1687. This is called after each command that sets `region-stays' to t.
  1688. See the variable `zmacs-regions'.Vzmacs-region-stays
  1689. Commands which do not wish to affect whether the region is currently
  1690. hilighted should set this to t.  Normally, the region is turned off after
  1691. executing each command that did not explicitly turn it on with the function
  1692. zmacs-activate-region. Setting this to true lets a command be non-intrusive.
  1693. See the variable `zmacs-regions'.Fhashtablep
  1694. Returns T if OBJ is a hashtable, else NIL.
  1695.  
  1696. arguments:(obj)
  1697. Fmake-hashtable
  1698. Make a hashtable of initial size SIZE.
  1699.  
  1700. arguments:(size)
  1701. Fcopy-hashtable
  1702. Make a new hashtable which contains the same keys and values
  1703. as the given table.  The keys and values will not themselves be copied.
  1704.  
  1705. arguments:(old_table)
  1706. Fgethash
  1707. Find hash value for KEY in TABLE.
  1708. If there is no corresponding value, return DEFAULT (default nil)
  1709.  
  1710. arguments:(key table &optional defalt)
  1711. Fremhash
  1712. Remove hash value for KEY in TABLE.
  1713.  
  1714. arguments:(key table)
  1715. Fputhash
  1716. Hash KEY to VAL in TABLE.
  1717.  
  1718. arguments:(key val table)
  1719. Fclrhash
  1720. Flush TABLE.
  1721.  
  1722. arguments:(table)
  1723. Fhashtable-fullness
  1724. Returns number of entries in TABLE.
  1725.  
  1726. arguments:(table)
  1727. Fmaphash
  1728. Map FUNCTION over entries in TABLE, calling it with two args,
  1729. each key and value in the table.
  1730.  
  1731. arguments:(function table)
  1732. Frun-emacs-from-temacs
  1733. Do not call this.  It will reinitialize your Emacs.  You'll be sorry.
  1734.  
  1735. arguments: (&rest args)
  1736. Fkill-emacs
  1737. Exit the Emacs job and kill it.  Ask for confirmation, without argument.
  1738. If ARG is an integer, return ARG as the exit program code.
  1739. If ARG is a  string, stuff it as keyboard input.
  1740.  
  1741. The value of `kill-emacs-hook', if not void,
  1742. is a list of functions (of no args),
  1743. all of which are called before Emacs is actually killed.
  1744.  
  1745. arguments:(&optional arg)
  1746. Fdump-emacs
  1747. Dump current state of Emacs into executable file FILENAME.
  1748. Take symbols from SYMFILE (presumably the file you executed to run Emacs).
  1749. This is used in the file `loadup.el' when building Emacs.
  1750.  
  1751. Bind `command-line-processed' to nil before dumping,
  1752. if you want the dumped Emacs to process its command line
  1753. and announce itself normally when it is run.
  1754.  
  1755. arguments:(intoname symname)
  1756. Fnoninteractive
  1757. Non-nil return value means Emacs is running without interactive terminal.
  1758.  
  1759. arguments:()
  1760. Vcommand-line-args
  1761. Args passed by shell to Emacs, as a list of strings.Vinvocation-name
  1762. Name of file used to invoke editing session.
  1763. This is the same as `(file-name-nondirectory execution-path)'.Vexecution-path
  1764. Pathname of executable emacs program now running.Vsystem-type
  1765. Value is symbol indicating type of operating system you are using.Vnoninteractive
  1766. Non-nil means Emacs is running without interactive terminal.Fgetenv
  1767. Return the value of environment variable VAR, as a string.
  1768. When invoked interactively, print the value in the echo area.
  1769. VAR is a string, the name of the variable,
  1770.  or the symbol t, meaning to return an alist representing the
  1771.  current environment.
  1772.  
  1773. arguments:(str &optional interactivep)
  1774. Fsetenv
  1775. Set the value of environment variable VAR to VALUE.
  1776. Both args must be strings.  Returns VALUE.
  1777.  
  1778. arguments:(str &optional val)
  1779. For
  1780. Eval args until one of them yields non-nil, then return that value.
  1781. The remaining args are not evalled at all.
  1782. If all args return nil, return nil.
  1783.  
  1784. arguments: (&rest args)
  1785. Fand
  1786. Eval args until one of them yields nil, then return nil.
  1787. The remaining args are not evalled at all.
  1788. If no arg yields nil, return the last arg's value.
  1789.  
  1790. arguments: (&rest args)
  1791. Fif
  1792. (if COND THEN ELSE...): if COND yields non-nil, do THEN, else do ELSE...
  1793. Returns the value of THEN or the value of the last of the ELSE's.
  1794. THEN must be one expression, but ELSE... can be zero or more expressions.
  1795. If COND yields nil, and there are no ELSE's, the value is nil.
  1796.  
  1797. arguments: (arg1 arg2 &rest args)
  1798. Fcond
  1799. (cond CLAUSES...): try each clause until one succeeds.
  1800. Each clause looks like (CONDITION BODY...).  CONDITION is evaluated
  1801. and, if the value is non-nil, this clause succeeds:
  1802. then the expressions in BODY are evaluated and the last one's
  1803. value is the value of the cond-form.
  1804. If no clause succeeds, cond returns nil.
  1805. If a clause has one element, as in (CONDITION),
  1806. CONDITION's value if non-nil is returned from the cond-form.
  1807.  
  1808. arguments: (&rest args)
  1809. Fprogn
  1810. (progn BODY...): eval BODY forms sequentially and return value of last one.
  1811.  
  1812. arguments: (&rest args)
  1813. Fprog1
  1814. (prog1 FIRST BODY...): eval FIRST and BODY sequentially; value from FIRST.
  1815. The value of FIRST is saved during the evaluation of the remaining args,
  1816. whose values are discarded.
  1817.  
  1818. arguments: (arg1 &rest args)
  1819. Fprog2
  1820. (prog1 X Y BODY...): eval X, Y and BODY sequentially; value from Y.
  1821. The value of Y is saved during the evaluation of the remaining args,
  1822. whose values are discarded.
  1823.  
  1824. arguments: (arg1 arg2 &rest args)
  1825. Fsetq
  1826. (setq SYM VAL SYM VAL ...): set each SYM to the value of its VAL.
  1827. The SYMs are not evaluated.  Thus (setq x y) sets x to the value of y.
  1828. Each SYM is set before the next VAL is computed.
  1829.  
  1830. arguments: (&rest args)
  1831. Fquote
  1832. Return the argument, without evaluating it.  `(quote x)' yields `x'.
  1833.  
  1834. arguments: (arg1 &rest args)
  1835. Ffunction
  1836. Like `quote', but preferred for objects which are functions.
  1837. In byte compilation, `function' causes its argument to be compiled.
  1838. `quote' cannot do that.
  1839.  
  1840. arguments: (arg1 &rest args)
  1841. Finteractive-p
  1842. Return t if function in which this appears was called interactively.
  1843. This means that the function was called with call-interactively (which
  1844. includes being called as the binding of a key)
  1845. and input is currently coming from the keyboard (not in keyboard macro).
  1846.  
  1847. arguments:()
  1848. Fdefun
  1849. (defun NAME ARGLIST [DOCSTRING] BODY...): define NAME as a function.
  1850. The definition is (lambda ARGLIST [DOCSTRING] BODY...).
  1851. See also the function `interactive'.
  1852.  
  1853. arguments: (arg1 arg2 &rest args)
  1854. Fdefmacro
  1855. (defmacro NAME ARGLIST [DOCSTRING] BODY...): define NAME as a macro.
  1856. The definition is (macro lambda ARGLIST [DOCSTRING] BODY...).
  1857. When the macro is called, as in (NAME ARGS...),
  1858. the function (lambda ARGLIST BODY...) is applied to
  1859. the list ARGS... as it appears in the expression,
  1860. and the result should be a form to be evaluated instead of the original.
  1861.  
  1862. arguments: (arg1 arg2 &rest args)
  1863. Fdefvar
  1864. (defvar SYMBOL INITVALUE DOCSTRING): define SYMBOL as a variable.
  1865. You are not required to define a variable in order to use it,
  1866. but the definition can supply documentation and an initial value
  1867. in a way that tags can recognize.
  1868.  
  1869. INITVALUE is evaluated, and used to set SYMBOL, only if SYMBOL's value is void.
  1870. If SYMBOL is buffer-local, its default value is what is set;
  1871.  buffer-local values are not affected.
  1872. INITVALUE and DOCSTRING are optional.
  1873. If DOCSTRING starts with *, this variable is identified as a user option.
  1874.  This means that M-x set-variable and M-x edit-options recognize it.
  1875. If INITVALUE is missing, SYMBOL's value is not set.
  1876.  
  1877. arguments: (arg1 &rest args)
  1878. Fdefconst
  1879. (defconst SYMBOL INITVALUE DOCSTRING): define SYMBOL as a constant variable.
  1880. The intent is that programs do not change this value, but users may.
  1881. Always sets the value of SYMBOL to the result of evalling INITVALUE.
  1882. If SYMBOL is buffer-local, its default value is what is set;
  1883.  buffer-local values are not affected.
  1884. DOCSTRING is optional.
  1885. If DOCSTRING starts with *, this variable is identified as a user option.
  1886.  This means that M-x set-variable and M-x edit-options recognize it.
  1887.  
  1888. Note: do not use `defconst' for user options in libraries that are not
  1889. normally loaded, since it is useful for users to be able to specify
  1890. their own values for such variables before loading the library.
  1891. Since `defconst' unconditionally assigns the variable,
  1892. it would override the user's choice.
  1893.  
  1894. arguments: (arg1 arg2 &rest args)
  1895. Fuser-variable-p
  1896. Returns t if VARIABLE is intended to be set and modified by users.
  1897. (The alternative is a variable used internally in a Lisp program.)
  1898. Determined by whether the first character of the documentation
  1899. for the variable is "*"
  1900.  
  1901. arguments:(variable)
  1902. Flet*
  1903. (let* VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  1904. The value of the last form in BODY is returned.
  1905. Each element of VARLIST is a symbol (which is bound to nil)
  1906. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  1907. Each VALUEFORM can refer to the symbols already bound by this VARLIST.
  1908.  
  1909. arguments: (arg1 &rest args)
  1910. Flet
  1911. (let VARLIST BODY...): bind variables according to VARLIST then eval BODY.
  1912. The value of the last form in BODY is returned.
  1913. Each element of VARLIST is a symbol (which is bound to nil)
  1914. or a list (SYMBOL VALUEFORM) (which binds SYMBOL to the value of VALUEFORM).
  1915. All the VALUEFORMs are evalled before any symbols are bound.
  1916.  
  1917. arguments: (arg1 &rest args)
  1918. Fwhile
  1919. (while TEST BODY...): if TEST yields non-nil, eval BODY... and repeat.
  1920. The order of execution is thus TEST, BODY, TEST, BODY and so on
  1921. until TEST returns nil.
  1922.  
  1923. arguments: (arg1 &rest args)
  1924. Fmacroexpand
  1925. Return result of expanding macros at top level of FORM.
  1926. If FORM is not a macro call, it is returned unchanged.
  1927. Otherwise, the macro is expanded and the expansion is considered
  1928. in place of FORM.  When a non-macro-call results, it is returned.
  1929.  
  1930. The second optional arg ENVIRONMENT species an environment of macro
  1931. definitions to shadow the loaded ones for use in file byte-compilation.
  1932.  
  1933. arguments:(form &optional env)
  1934. Fcatch
  1935. (catch TAG BODY...): eval BODY allowing nonlocal exits using `throw'.
  1936. TAG is evalled to get the tag to use.  Then the BODY is executed.
  1937. Within BODY, (throw TAG) with same tag exits BODY and exits this `catch'.
  1938. If no throw happens, `catch' returns the value of the last BODY form.
  1939. If a throw happens, it specifies the value to return from `catch'.
  1940.  
  1941. arguments: (arg1 &rest args)
  1942. Fthrow
  1943. (throw TAG VALUE): throw to the catch for TAG and return VALUE from it.
  1944. Both TAG and VALUE are evalled.
  1945.  
  1946. arguments:(tag val)
  1947. Funwind-protect
  1948. Do BODYFORM, protecting with UNWINDFORMS.
  1949. Usage looks like (unwind-protect BODYFORM UNWINDFORMS...).
  1950. If BODYFORM completes normally, its value is returned
  1951. after executing the UNWINDFORMS.
  1952. If BODYFORM exits nonlocally, the UNWINDFORMS are executed anyway.
  1953.  
  1954. arguments: (arg1 &rest args)
  1955. Fcondition-case
  1956. Regain control when an error is signaled.
  1957. Usage looks like (condition-case VAR BODYFORM HANDLERS...).
  1958. executes BODYFORM and returns its value if no error happens.
  1959. Each element of HANDLERS looks like (CONDITION-NAME BODY...)
  1960. where the BODY is made of Lisp expressions.
  1961.  
  1962. A handler is applicable to an error
  1963. if CONDITION-NAME is one of the error's condition names.
  1964. If an error happens, the first applicable handler is run.
  1965.  
  1966. When a handler handles an error,
  1967. control returns to the condition-case and the handler BODY... is executed
  1968. with VAR bound to (SIGNALED-CONDITIONS . SIGNAL-DATA).
  1969. VAR may be nil; then you do not get access to the signal information.
  1970.  
  1971. The value of the last BODY form is returned from the condition-case.
  1972. See also the function `signal' for more info.
  1973.  
  1974. arguments: (arg1 arg2 &rest args)
  1975. Fsignal
  1976. Signal an error.  Args are SIGNAL-NAME, and associated DATA.
  1977. A signal name is a symbol with an `error-conditions' property
  1978. that is a list of condition names.
  1979. A handler for any of those names will get to handle this signal.
  1980. The symbol `error' should normally be one of them.
  1981.  
  1982. DATA should be a list.  Its elements are printed as part of the error message.
  1983. If the signal is handled, DATA is made available to the handler.
  1984. See also the function `condition-case'.
  1985.  
  1986. arguments:(sig data)
  1987. Fcommandp
  1988. T if FUNCTION makes provisions for interactive calling.
  1989. This means it contains a description for how to read arguments to give it.
  1990. The value is nil for an invalid function or a symbol with no function
  1991. definition.
  1992.  
  1993. Interactively callable functions include strings and vectors (treated
  1994. as keyboard macros), lambda-expressions that contain a top-level call
  1995. to `interactive', autoload definitions made by `autoload' with non-nil
  1996. fourth argument, and some of the built-in functions of Lisp.
  1997.  
  1998. Also, a symbol satisfies `commandp' if its function definition does so.
  1999.  
  2000. arguments:(function)
  2001. Fautoload
  2002. Define FUNCTION to autoload from FILE.
  2003. FUNCTION is a symbol; FILE is a file name string to pass to `load'.
  2004. Third arg DOCSTRING is documentation for the function.
  2005. Fourth arg INTERACTIVE if non-nil says function can be called interactively.
  2006. Fifth arg MACRO if non-nil says the function is really a macro.
  2007. Third through fifth args give info about the real definition.
  2008. They default to nil.
  2009. If FUNCTION is already defined other than as an autoload,
  2010. this does nothing and returns nil.
  2011.  
  2012. arguments:(function file &optional docstring interactive macro)
  2013. Feval
  2014. Evaluate FORM and return its value.
  2015.  
  2016. arguments:(form)
  2017. Fapply
  2018. Call FUNCTION with our remaining args, using our last arg as list of args.
  2019. Thus, (apply '+ 1 2 '(3 4)) returns 10.
  2020.  
  2021. arguments: (arg1 arg2 &rest args)
  2022. Ffuncall
  2023. Call first argument as a function, passing remaining arguments to it.
  2024. Thus,  (funcall 'cons 'x 'y)  returns  (x . y).
  2025.  
  2026. arguments: (arg1 &rest args)
  2027. Fbacktrace-debug
  2028. Set the debug-on-exit flag of eval frame LEVEL levels down to FLAG.
  2029. The debugger is entered when that frame exits, if the flag is non-nil.
  2030.  
  2031. arguments:(level flag)
  2032. Fbacktrace
  2033. Print a trace of Lisp function calls currently active.
  2034. Output stream used is value of `standard-output'.
  2035.  
  2036. arguments:(&optional stream)
  2037. Fbacktrace-frame
  2038. Return the function and arguments N frames up from current execution point.
  2039. If that frame has not evaluated the arguments yet (or is a special form),
  2040. the value is (nil FUNCTION ARG-FORMS...).
  2041. If that frame has evaluated its arguments and called its function already,
  2042. the value is (t FUNCTION ARG-VALUES...).
  2043. A &rest arg is represented as the tail of the list ARG-VALUES.
  2044. FUNCTION is whatever was supplied as car of evaluated list,
  2045. or a lambda expression for macro calls.
  2046. If N is more than the number of frames, the value is nil.
  2047.  
  2048. arguments:(nframes)
  2049. Vmax-specpdl-size
  2050. Limit on number of Lisp variable bindings & unwind-protects before error.Vmax-lisp-eval-depth
  2051. Limit on depth in `eval', `apply' and `funcall' before error.
  2052. This limit is to catch infinite recursions for you before they cause
  2053. actual stack overflow in C, which would be fatal for Emacs.
  2054. You can safely make it considerably larger than its default value,
  2055. if that proves inconveniently small.Vquit-flag
  2056. Non-nil causes `eval' to abort, unless `inhibit-quit' is non-nil.
  2057. Typing C-G sets `quit-flag' non-nil, regardless of `inhibit-quit'.Vinhibit-quit
  2058. Non-nil inhibits C-g quitting from happening immediately.
  2059. Note that `quit-flag' will still be set by typing C-g,
  2060. so a quit will be signalled as soon as `inhibit-quit' is nil.
  2061. To prevent this happening, set `quit-flag' to nil
  2062. before making `inhibit-quit' nil.Vstack-trace-on-error
  2063. *Non-nil means automatically display a backtrace buffer
  2064. after any error that is handled by the editor command loop.
  2065. If the value is a list, an error only means to display a backtrace
  2066. if one of its condition symbols appears in the list.Vdebug-on-error
  2067. *Non-nil means enter debugger if an error is signalled.
  2068. Does not apply to errors handled by `condition-case'.
  2069. If the value is a list, an error only means to enter the debugger
  2070. if one of its condition symbols appears in the list.
  2071. See also variable `debug-on-quit'.Vdebug-on-quit
  2072. *Non-nil means enter debugger if quit is signalled (C-G, for example).
  2073. Does not apply if quit is handled by a `condition-case'.Vdebug-on-next-call
  2074. Non-nil means enter debugger before next `eval', `apply' or `funcall'.Vdebugger
  2075. Function to call to invoke debugger.
  2076. If due to frame exit, args are `exit' and the value being returned;
  2077.  this function's value will be returned instead of that.
  2078. If due to error, args are `error' and a list of the args to `signal'.
  2079. If due to `apply' or `funcall' entry, one arg, `lambda'.
  2080. If due to `eval' entry, one arg, t.Vmocklisp-arguments
  2081. While in a mocklisp function, the list of its unevaluated args.Vrun-hooks
  2082. Set to the function `run-hooks', if that function has been defined.
  2083. Otherwise, nil (in a bare Emacs without preloaded Lisp code).Fallocate-event
  2084. Returns an empty event structure.
  2085. WARNING, the event object returned may be a reused one; see the function
  2086. `deallocate-event'.
  2087.  
  2088. arguments:()
  2089. Fdeallocate-event
  2090. Allow the given event structure to be reused.  You MUST NOT use this 
  2091. event object after calling this function with it.  You will lose.
  2092. It is not necessary to call this function, as event objects are garbage-
  2093. collected like all other objects; however, it may be more efficient to
  2094. explicitly deallocate events when you are sure that that is safe.
  2095.  
  2096. arguments:(event)
  2097. Fcopy-event
  2098. Make a copy of the given event object.  If a second argument is given,
  2099. the first event is copied into the second and the second is returned.
  2100. If the second argument is not supplied (or is nil) then a new event will
  2101. be made as with `allocate-event.'  See also the function `deallocate-event'.
  2102.  
  2103. arguments:(event1 &optional event2)
  2104. Finput-pending-p
  2105. T if command input is currently available with no waiting.
  2106. Actually, the value is nil only if we can be sure that no input is available.
  2107.  
  2108. arguments:()
  2109. Fenqueue-eval-event
  2110. Add an eval event to the back of the queue.
  2111. (enqueue-eval-event <function> <object>)
  2112. It will be the next event read after all pending events.
  2113.  
  2114. arguments:(function object)
  2115. Fnext-event
  2116. Given an event structure, fills it in with the next event available
  2117. from the window system or terminal driver.  Pass this object to
  2118. dispatch-event to handle it.  See also the function next-command-event,
  2119. which is often more appropriate.
  2120.  
  2121. arguments:(event)
  2122. Fnext-command-event
  2123. Given an event structure, fills it in with the next keyboard, mouse
  2124. press, or mouse release event available from the user.  If there are
  2125. non-command events available (mouse motion, sub-process output, etc) then
  2126. these will be executed (with `dispatch-event') and discarded.  This 
  2127. function is provided as a convenience; it is equivalent to the elisp code
  2128.  
  2129.     (while (progn
  2130.         (next-event event)
  2131.             (not (or (key-press-event-p event)
  2132.                      (button-press-event-p event)
  2133.                      (button-release-event-p event)
  2134.                      (menu-event-p event))))
  2135.       (dispatch-event event))
  2136.  
  2137.  
  2138. arguments:(event)
  2139. Fread-char
  2140. Read a character from the command input (keyboard or macro).
  2141. If a mouse click is detected, an error is signalled.  The character typed
  2142. is returned as an ASCII value.  This is most likely the wrong thing for you
  2143. to be using: consider using the `next-command-event' function instead.
  2144.  
  2145. arguments:()
  2146. Fdiscard-input
  2147. Discard the contents of the terminal input buffer.
  2148. Also cancel any kbd macro being defined.
  2149.  
  2150. arguments:()
  2151. Faccept-process-output
  2152. Allow any pending output from subprocesses to be read by Emacs.
  2153. It is read into the process' buffers or given to their filter functions.
  2154. Non-nil arg PROCESS means do not return until some output has been received
  2155. from PROCESS.
  2156.  
  2157. arguments:(&optional proc)
  2158. Fsleep-for
  2159. Pause, without updating display, for ARG seconds.
  2160. ARG may be a float, meaning pause for some fractional part of a second.
  2161.  
  2162. arguments:(n)
  2163. Fsit-for
  2164. Perform redisplay, then wait for ARG seconds or until user input is
  2165. available.  ARG may be a float, meaning a fractional part of a second.
  2166. Optional second arg non-nil means don't redisplay, just wait for input.
  2167. Redisplay is preempted as always if user input arrives, and does not
  2168. happen if input is available before it starts.
  2169. Value is t if waited the full time with no input arriving.
  2170.  
  2171. arguments:(n &optional nodisp)
  2172. Fsleep-for-millisecs
  2173. Pause, without updating display, for ARG milliseconds.
  2174. This function is obsolete; call `sleep-for' with a float instead.
  2175.  
  2176. arguments:(n)
  2177. Fadd-timeout
  2178. SECS is a number of seconds, expressed as an integer or a float.
  2179. FUNCTION will be called after that many seconds have elapsed, with one
  2180. argument, the given OBJECT.  If the optional RESIGNAL argument is provided,
  2181. then after this timeout expires, `add-timeout' will automatically be called
  2182. again with RESIGNAL as the first argument.
  2183.  
  2184. This function returns an object which is the `id' of this particular timeout.
  2185. You can pass that object to `disable-timeout' to turn off the timeout before
  2186. it has been signalled.
  2187.  
  2188. The number of seconds may be expressed as a floating-point number, in which
  2189. case some fractional part of a second will be used.  Caveat: the usable
  2190. timeout granularity will vary from system to system.
  2191.  
  2192. Adding a timeout causes a timeout event to be returned by `next-event', and
  2193. the function will be invoked by `dispatch-event,' so if emacs is in a tight
  2194. loop, the function will not be invoked until the next call to sit-for or
  2195. until the return to top-level (the same is true of process filters.)
  2196.  
  2197. arguments:(secs function object &optional resignal)
  2198. Fdisable-timeout
  2199. Given a timeout id number as returned by `add-timeout', this function
  2200. will cause that timeout to not be signalled if it hasn't been already.
  2201.  
  2202. arguments:(id)
  2203. Fdispatch-event
  2204. Given an event object returned by next-event, execute it.
  2205.  
  2206. arguments:(event)
  2207. Fread-key-sequence
  2208. Read a sequence of keystrokes or mouse clicks and return a vector of the
  2209. event objects read.  The vector is newly created, but the event objects are
  2210. reused: if you want to hold a pointer to them beyond the next call to this
  2211. function, you must copy them first.
  2212.  
  2213. The sequence read is sufficient to specify a non-prefix command starting
  2214. from the current local and global keymaps.  A C-g typed while in this
  2215. function is treated like any other character, and `quit-flag' is not set.
  2216. One arg, PROMPT, is a prompt string, or nil meaning do not prompt specially.
  2217.  
  2218. If the user selects a menu item while we are prompting for a key-sequence,
  2219. the returned value will be a vector of a single menu-selection event.
  2220. An error will be signalled if you pass this value to `lookup-key' or a
  2221. related function.
  2222.  
  2223. arguments:(prompt)
  2224. Vecho-keystrokes
  2225. *Nonzero means echo unfinished commands after this many seconds of pause.Vauto-save-interval
  2226. *Number of keyboard input characters between auto-saves.
  2227. Zero means disable autosaving due to number of characters typed.
  2228. See also the variable `auto-save-timeout'.Fevent-to-character
  2229. Returns the closest ASCII approximation to the given event object.
  2230. If the event isn't a keypress, this returns nil.
  2231. If the second argument is non-nil, then this is lenient in its 
  2232. translation; it will ignore modifier keys other than control and meta,
  2233. and will ignore the shift modifier on those characters which have no 
  2234. shifted ASCII equivalent (Control-Shift-A for example, will be mapped to 
  2235. the same ASCII code as Control-A.)  If the second arg is nil, then nil 
  2236. will be returned for events which have no direct ASCII equivalent.
  2237.  
  2238. arguments:(event &optional lenient)
  2239. Fcharacter-to-event
  2240. Converts a numeric ASCII value to an event structure, replete with
  2241. bucky bits.  The character is the first argument, and the event to fill
  2242. in is the second.  This function contains knowledge about what the codes
  2243. ``mean'' -- for example, the number 9 is converted to the character ``Tab'',
  2244. not the distinct character ``Control-I''.
  2245.  
  2246. If the optional second argument is an event, it is modified; otherwise, a
  2247. new event object is created.
  2248.  
  2249. Beware that character-to-event and event-to-character are not strictly 
  2250. inverse functions, since events contain much more information than the 
  2251. ASCII character set can encode.
  2252.  
  2253. arguments:(ch &optional event)
  2254. Feventp
  2255. True if the argument is an event object.
  2256.  
  2257. arguments:(obj)
  2258. Fkey-press-event-p
  2259. True if the argument is a key-press event object.
  2260.  
  2261. arguments:(obj)
  2262. Fbutton-press-event-p
  2263. True if the argument is a mouse-button-press event object.
  2264.  
  2265. arguments:(obj)
  2266. Fbutton-release-event-p
  2267. True if the argument is a mouse-button-release event object.
  2268.  
  2269. arguments:(obj)
  2270. Fbutton-event-p
  2271. True if the argument is a button-press or button-release event object.
  2272.  
  2273. arguments:(obj)
  2274. Fmotion-event-p
  2275. True if the argument is a mouse-motion event object.
  2276.  
  2277. arguments:(obj)
  2278. Fprocess-event-p
  2279. True if the argument is a process-output event object.
  2280.  
  2281. arguments:(obj)
  2282. Ftimeout-event-p
  2283. True if the argument is a timeout event object.
  2284.  
  2285. arguments:(obj)
  2286. Fmenu-event-p
  2287. True if the argument is a menu event object.
  2288.  
  2289. arguments:(obj)
  2290. Feval-event-p
  2291. True if the argument is an `eval' or `menu' event object.
  2292.  
  2293. arguments:(obj)
  2294. Fevent-timestamp
  2295. Returns the timestamp of the given event object.
  2296.  
  2297. arguments:(event)
  2298. Fevent-key
  2299. Returns the KeySym of the given key-press event.  This will be the
  2300. ASCII code of a printing character, or a symbol.
  2301.  
  2302. arguments:(event)
  2303. Fevent-button
  2304. Returns the button-number of the given mouse-button-press event.
  2305.  
  2306. arguments:(event)
  2307. Fevent-modifier-bits
  2308. Returns a number representing the modifier keys which were down 
  2309. when the given mouse or keyboard event was produced.  See also the function
  2310. event-modifiers.
  2311.  
  2312. arguments:(event)
  2313. Fevent-modifiers
  2314. Returns a list of symbols, the names of the modifier keys which 
  2315. were down when the given mouse or keyboard event was produced.
  2316. See also the function event-modifier-bits.
  2317.  
  2318. arguments:(event)
  2319. Fevent-x-pixel
  2320. Returns the X position of the given mouse-motion, button-press, or
  2321. button-release event in pixels.
  2322.  
  2323. arguments:(event)
  2324. Fevent-y-pixel
  2325. Returns the Y position of the given mouse-motion, button-press, or
  2326. button-release event in pixels.
  2327.  
  2328. arguments:(event)
  2329. Fevent-window
  2330. Given a mouse motion, button press, or button release event, compute
  2331. and return the window on which that event occurred.  This may be nil if
  2332. the event did not occur in an emacs window (in the border or modeline.)
  2333.  
  2334. arguments:(event)
  2335. Fevent-point
  2336. Returns the character position of the given mouse-motion, button-press,
  2337. or button-release event.  If the event did not occur over a window, or did
  2338. not occur over text, then this returns nil.  Otherwise, it returns an index
  2339. into the buffer visible in the event's window.
  2340.  
  2341. arguments:(event)
  2342. Fevent-x
  2343. Returns the X position of the given mouse-motion, button-press, or
  2344. button-release event in characters.
  2345.  
  2346. arguments:(event)
  2347. Fevent-y
  2348. Returns the Y position of the given mouse-motion, button-press, or
  2349. button-release event in characters.
  2350.  
  2351. arguments:(event)
  2352. Fevent-glyph
  2353. If the given mouse-motion, button-press, or button-release event happened
  2354. on top of a glyph, this returns it; else nil.
  2355.  
  2356. arguments:(event)
  2357. Fevent-process
  2358. Returns the process of the given proces-output event.
  2359.  
  2360. arguments:(event)
  2361. Fevent-function
  2362. Returns the callback function of the given timeout, menu, or eval event.
  2363.  
  2364. arguments:(event)
  2365. Fevent-object
  2366. Returns the callback function argument of the given timeout, menu, or
  2367. eval event.
  2368.  
  2369. arguments:(event)
  2370. Vcharacter-set-property
  2371. A symbol used to look up the 8-bit character of a keysym.
  2372. To convert a keysym symbol to an 8-bit code, as when that key is
  2373. bound to self-insert-command, we will look up the property that this
  2374. variable names on the property list of the keysym-symbol.  The window-
  2375. system-specific code will set up appropriate properties and set this
  2376. variable.Fmap-extents
  2377. Usage: (map-extents FUNCTION BUFFER FROM TO MAPARG) 
  2378. Map FUNCTION over the extents which overlap region in BUFFER starting at
  2379.  FROM and ending at TO.  FUNCTION is called with arguments (extent, MAPARG).
  2380. All arguments except FUNCTION are optional, with FROM, TO, MAPARG, and
  2381.  BUFFER defaulting to the beginning of BUFFER, the end of BUFFER, NIL, and
  2382.  current buffer, respectively.
  2383. If the function returns non-nil, then map-extents returns immediately.
  2384. map-extents always returns nil.
  2385.  
  2386. arguments:(function &optional buffer from to maparg closed_end)
  2387. Fhighlight-extent
  2388. If EXTENT is `highlightable' (has the 'highlight property) then highlight
  2389. it (by using merging it with 'highlight face.)  If FLAG is nil, then
  2390. unhighlight it instead.
  2391.  
  2392. arguments:(extent_obj &optional flag)
  2393. Fforce-highlight-extent
  2394. Highlight any EXTENT if FLAG is not nil, else unhighlight it.
  2395. This is the same as `highlight-extent', except that it will work even
  2396. on extents without the 'highlight property.
  2397.  
  2398. arguments:(extent_obj &optional flag)
  2399. Fextent-start-position
  2400. Return start position of EXTENT.
  2401.  
  2402. arguments:(extent_obj)
  2403. Fextent-end-position
  2404. Return first position after EXTENT.
  2405.  
  2406. arguments:(extent_obj)
  2407. Fextent-length
  2408. Return length of EXTENT in characters.
  2409.  
  2410. arguments:(extent_obj)
  2411. Fextent-buffer
  2412. Return buffer of EXTENT.
  2413.  
  2414. arguments:(extent_obj)
  2415. Fextent-to-generic-id
  2416. Return Energize ID of buffer of EXTENT.
  2417.  
  2418. arguments:(extent_obj)
  2419. Fmake-extent
  2420. Make extent for range [FROM, TO) in BUFFER -- BUFFER defaults to 
  2421. current buffer.  Insertions at point TO will be outside of the extent;
  2422. insertions at FROM will be inside the extent (and the extent will grow.)
  2423.  
  2424. arguments:(from to &optional buffer)
  2425. Fdelete-extent
  2426. Remove EXTENT from its buffer; this does not modify the buffer's text,
  2427. only its display properties.
  2428.  
  2429. arguments:(extent_obj)
  2430. Fupdate-extent
  2431. Set the endpoints of EXTENT to START, END.
  2432.  
  2433. arguments:(extent_obj start end)
  2434. Fset-extent-attribute
  2435. Make EXTENT have ATTRIBUTE.
  2436. ATTRIBUTE must be one of the following symbols:
  2437.  
  2438.     highlight        highlight when the mouse moves over it
  2439.     write-protected    text within this extent will be unmodifyable
  2440.     invisible        don't display the text in this region
  2441.     unhighlight        turn off `highlight'
  2442.     writable        turn off `write-protected'
  2443.     visible        turn off `invisible'
  2444.  
  2445. arguments:(extent_obj attr)
  2446. Fextent-attributes
  2447. Return a list of attributes of EXTENT.
  2448. This list may contain any or none of the following symbols:
  2449.  
  2450.     highlight        highlight when the mouse moves over it
  2451.     write-protected    text within this extent will be unmodifyable
  2452.     invisible        don't display the text in this region
  2453.     begin-glyph        there is a begin-glyph
  2454.     end-glyph        there is an end-glyph
  2455.     detached        the text around the extent has been deleted
  2456.  
  2457. arguments:(extent_obj &optional raw_p)
  2458. Fset-extent-begin-glyph
  2459. Display a bitmap at the beginning of the given extent.
  2460. The begin-glyph should be a string naming a bitmap file (or nil.)
  2461.  
  2462. arguments:(extent_obj begin_glyph)
  2463. Fset-extent-end-glyph
  2464. Display a bitmap at the end of the given extent.
  2465. The end-glyph should be a string naming a bitmap file (or nil.)
  2466.  
  2467. arguments:(extent_obj end_glyph)
  2468. Fextent-data
  2469. Return the user data associated with the given extent.
  2470. Set this using the `set-extent-data' function.
  2471.  
  2472. arguments:(extent)
  2473. Fset-extent-data
  2474. Set the user data slot of the given extent.
  2475. Access this using the `extent-data' function.
  2476.  
  2477. arguments:(extent data)
  2478. Fextent-priority
  2479. Returns the display priority of EXTENT; see `set-extent-priority'.
  2480.  
  2481. arguments:(extent)
  2482. Fset-extent-priority
  2483. Changes the display priority of EXTENT.
  2484. When the extent attributes are being merged for display, the priority
  2485. is used to determine which extent takes precedence in the event of a
  2486. conflict (two extents whose faces both specify font, for example: the
  2487. font of the extent with the higher priority will be used.)
  2488. Extents are created with priority 0; priorities may be negative.
  2489.  
  2490. arguments:(extent pri)
  2491. Fextent-at
  2492. Find "smallest" extent at POS in BUFFER having FLAG set.  BUFFER
  2493. defaults to the current buffer, FLAG defaults to nil, meaning that any
  2494. extent will do. Possible values for FLAG are nil, 'menu, 'highlight,
  2495. 'invisible, and 'write-protected. Returns nil if there is no matching
  2496. extent at POS.
  2497.  
  2498. arguments:(pos &optional buffer flag)
  2499. Fnext-extent
  2500. Find next extent after EXTENT. If EXTENT is a buffer
  2501. return the first extent in the buffer.
  2502.  
  2503. arguments:(extent_obj)
  2504. Fnext-e-extent
  2505. Find next extent after EXTENT using the "e" order. If 
  2506. EXTENT is a buffer, return the first extent in the buffer.
  2507.  
  2508. arguments:(extent_obj)
  2509. Fstack-of-extents
  2510. Return stack of extents for BUFFER. Optional arg POSITION supplied
  2511. means compute the correct stack of extents for POSITION in BUFFER.
  2512.  
  2513. arguments:(buffer &optional position)
  2514. V   buffer-of-current-extent-fragment
  2515. Buffer for current extent fragment -- this is a GC hack.Fscreen-face-alist
  2516.  
  2517.  
  2518. arguments:(screen)
  2519. Fset-screen-face-alist
  2520.  
  2521.  
  2522. arguments:(screen value)
  2523. Fmake-face-internal
  2524.  
  2525.  
  2526. arguments:(name object id_number)
  2527. Fset-face-attribute-internal
  2528.  
  2529.  
  2530. arguments:(face_id attr_name attr_value screen)
  2531. Vmouse-highlight-priority
  2532. The priority to use for the mouse-highlighting pseudo-extent
  2533. that is used to highlight extents with the `highlight' attribute set.
  2534. See `set-extent-priority'.Ffile-name-directory
  2535. Return the directory component in file name NAME.
  2536. Return nil if NAME does not include a directory.
  2537. Otherwise return a directory spec.
  2538. Given a Unix syntax file name, returns a string ending in slash;
  2539. on VMS, perhaps instead a string ending in `:', `]' or `>'.
  2540.  
  2541. arguments:(file)
  2542. Ffile-name-nondirectory
  2543. Return file name NAME sans its directory.
  2544. For example, in a Unix-syntax file name,
  2545. this is everything after the last slash,
  2546. or the entire name if it contains no slash.
  2547.  
  2548. arguments:(file)
  2549. Ffile-name-as-directory
  2550. Return a string representing file FILENAME interpreted as a directory.
  2551. This operation exists because a directory is also a file, but its name as
  2552. a directory is different from its name as a file.
  2553. The result can be used as the value of `default-directory'
  2554. or passed as second argument to `expand-file-name'.
  2555. For a Unix-syntax file name, just appends a slash.
  2556. On VMS, converts "[X]FOO.DIR" to "[X.FOO]", etc.
  2557.  
  2558. arguments:(file)
  2559. Fdirectory-file-name
  2560. Returns the file name of the directory named DIR.
  2561. This is the name of the file that holds the data for the directory DIR.
  2562. This operation exists because a directory is also a file, but its name as
  2563. a directory is different from its name as a file.
  2564. In Unix-syntax, this function just removes the final slash.
  2565. On VMS, given a VMS-syntax directory name such as "[X.Y]",
  2566. it returns a file name such as "[X]Y.DIR.1".
  2567.  
  2568. arguments:(directory)
  2569. Fmake-temp-name
  2570. Generate temporary file name (string) starting with PREFIX (a string).
  2571. The Emacs process number forms part of the result,
  2572. so there is no danger of generating a name being used by another process.
  2573.  
  2574. arguments:(prefix)
  2575. Fexpand-file-name
  2576. Convert FILENAME to absolute, and canonicalize it.
  2577. Second arg DEFAULT is directory to start with if FILENAME is relative
  2578.  (does not start with slash); if DEFAULT is nil or missing,
  2579. the current buffer's value of default-directory is used.
  2580. Path components that are `.' are removed, and 
  2581. path components followed by `..' are removed, along with the `..' itself;
  2582. note that these simplifications are done without checking the resulting
  2583. paths in the file system.
  2584. An initial `~/' expands to your home directory.
  2585. An initial `~USER/' expands to USER's home directory.
  2586. See also the function `substitute-in-file-name'.
  2587.  
  2588. arguments:(name &optional defalt)
  2589. Ftruename
  2590. Returns the canonical name of the given FILE.
  2591. Second arg DEFAULT is directory to start with if FILE is relative
  2592.  (does not start with slash); if DEFAULT is nil or missing,
  2593.  the current buffer's value of default-directory is used.
  2594. No component of the resulting pathname will be a symbolic link, as
  2595.  in the realpath() function.
  2596. If the file does not exist, or is otherwise unable to be resolved,
  2597.  nil is returned.
  2598.  
  2599. arguments:(name &optional defalt)
  2600. Fsubstitute-in-file-name
  2601. Substitute environment variables referred to in FILENAME.
  2602. `$FOO' where FOO is an environment variable name means to substitute
  2603. the value of that variable.  The variable name should be terminated
  2604. with a character not a letter, digit or underscore; otherwise, enclose
  2605. the entire variable name in braces.
  2606. If `/~' appears, all of FILENAME through that `/' is discarded.
  2607.  
  2608. On VMS, `$' substitution is not done; this function does little and only
  2609. duplicates what `expand-file-name' does.
  2610.  
  2611. arguments:(string)
  2612. Fcopy-file
  2613. Copy FILE to NEWNAME.  Both args must be strings.
  2614. Signals a `file-already-exists' error if file NEWNAME already exists,
  2615. unless a third argument OK-IF-ALREADY-EXISTS is supplied and non-nil.
  2616. A number as third arg means request confirmation if NEWNAME already exists.
  2617. This is what happens in interactive use with M-x.
  2618. Fourth arg KEEP-TIME non-nil means give the new file the same
  2619. last-modified time as the old one.  (This works on only some systems.)
  2620. A prefix arg makes KEEP-TIME non-nil.
  2621.  
  2622. arguments:(filename newname &optional ok_if_already_exists keep_date)
  2623. Fmake-directory
  2624. Create a directory.  One argument, a file name string.
  2625.  
  2626. arguments:(dirname)
  2627. Fremove-directory
  2628. Remove a directory.  One argument, a file name string.
  2629.  
  2630. arguments:(dirname)
  2631. Fdelete-file
  2632. Delete specified file.  One argument, a file name string.
  2633. If file has multiple names, it continues to exist with the other names.
  2634.  
  2635. arguments:(filename)
  2636. Frename-file
  2637. Rename FILE as NEWNAME.  Both args strings.
  2638. If file has names other than FILE, it continues to have those names.
  2639. Signals a `file-already-exists' error if a file NEWNAME already exists
  2640. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2641. A number as third arg means request confirmation if NEWNAME already exists.
  2642. This is what happens in interactive use with M-x.
  2643.  
  2644. arguments:(filename newname &optional ok_if_already_exists)
  2645. Fadd-name-to-file
  2646. Give FILE additional name NEWNAME.  Both args strings.
  2647. Signals a `file-already-exists' error if a file NEWNAME already exists
  2648. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2649. A number as third arg means request confirmation if NEWNAME already exists.
  2650. This is what happens in interactive use with M-x.
  2651.  
  2652. arguments:(filename newname &optional ok_if_already_exists)
  2653. Fmake-symbolic-link
  2654. Make a symbolic link to FILENAME, named LINKNAME.  Both args strings.
  2655. Signals a `file-already-exists' error if a file NEWNAME already exists
  2656. unless optional third argument OK-IF-ALREADY-EXISTS is non-nil.
  2657. A number as third arg means request confirmation if NEWNAME already exists.
  2658. This happens for interactive use with M-x.
  2659.  
  2660. arguments:(filename newname &optional ok_if_already_exists)
  2661. Fdefine-logical-name
  2662. Define the job-wide logical name NAME to have the value STRING.
  2663. If STRING is nil or a null string, the logical name NAME is deleted.
  2664.  
  2665. arguments:(varname string)
  2666. Fsysnetunam
  2667. Open a network connection to PATH using LOGIN as the login string.
  2668.  
  2669. arguments:(path login)
  2670. Ffile-name-absolute-p
  2671. Return t if file FILENAME specifies an absolute path name.
  2672. On Unix, this is a name starting with a `/' or a `~'.
  2673.  
  2674. arguments:(filename)
  2675. Ffile-exists-p
  2676. Return t if file FILENAME exists.  (This does not mean you can read it.)
  2677. See also `file-readable-p' and `file-attributes'.
  2678.  
  2679. arguments:(filename)
  2680. Ffile-executable-p
  2681. Return t if FILENAME can be executed by you.
  2682. For directories this means you can change to that directory.
  2683.  
  2684. arguments:(filename)
  2685. Ffile-readable-p
  2686. Return t if file FILENAME exists and you can read it.
  2687. See also `file-exists-p' and `file-attributes'.
  2688.  
  2689. arguments:(filename)
  2690. Ffile-symlink-p
  2691. If file FILENAME is the name of a symbolic link
  2692. returns the name of the file to which it is linked.
  2693. Otherwise returns NIL.
  2694.  
  2695. arguments:(filename)
  2696. Ffile-writable-p
  2697. Return t if file FILENAME can be written or created by you.
  2698.  
  2699. arguments:(filename)
  2700. Ffile-directory-p
  2701. Return t if file FILENAME is the name of a directory as a file.
  2702. A directory name spec may be given instead; then the value is t
  2703. if the directory so specified exists and really is a directory.
  2704.  
  2705. arguments:(filename)
  2706. Ffile-modes
  2707. Return mode bits of FILE, as an integer.
  2708.  
  2709. arguments:(filename)
  2710. Fset-file-modes
  2711. Set mode bits of FILE to MODE (an integer).
  2712. Only the 12 low bits of MODE are used.
  2713.  
  2714. arguments:(filename mode)
  2715. Ffile-newer-than-file-p
  2716. Return t if file FILE1 is newer than file FILE2.
  2717. If FILE1 does not exist, the answer is nil;
  2718. otherwise, if FILE2 does not exist, the answer is t.
  2719.  
  2720. arguments:(file1 file2)
  2721. Finsert-file-contents
  2722. Insert contents of file FILENAME after point.
  2723. Returns list of absolute pathname and length of data inserted.
  2724. If second argument VISIT is non-nil, the buffer's visited filename
  2725. and last save file modtime are set, and it is marked unmodified.
  2726. If visiting and the file does not exist, visiting is completed
  2727. before the error is signaled.
  2728.  
  2729. arguments:(filename &optional visit)
  2730. Fwrite-region
  2731. Write current region into specified file.
  2732. When called from a program, takes three arguments:
  2733. START, END and FILENAME.  START and END are buffer positions.
  2734. Optional fourth argument APPEND if non-nil means
  2735.   append to existing file contents (if any).
  2736. Optional fifth argument VISIT if t means
  2737.   set the last-save-file-modtime of buffer to this file's modtime
  2738.   and mark buffer not modified.
  2739. If VISIT is neither t nor nil, it means do not print
  2740.   the "Wrote file" message.
  2741. Kludgy feature: if START is a string, then that string is written
  2742. to the file, instead of any buffer contents, and END is ignored.
  2743.  
  2744. arguments:(start end filename &optional append visit)
  2745. Fencrypt-string
  2746. Encrypt STRING using KEY.
  2747.  
  2748. arguments:(string key)
  2749. Fdecrypt-string
  2750. Decrypt STRING using KEY.
  2751.  
  2752. arguments:(string key)
  2753. Fverify-visited-file-modtime
  2754. Return t if last mod time of BUF's visited file matches what BUF records.
  2755. This means that the file has not been changed since it was visited or saved.
  2756.  
  2757. arguments:(buf)
  2758. Fclear-visited-file-modtime
  2759. Clear out records of last mod time of visited file.
  2760. Next attempt to save will certainly not complain of a discrepancy.
  2761.  
  2762. arguments:()
  2763. Fset-visited-file-modtime
  2764. Update buffer's recorded modification time from the visited file's time.
  2765. Useful if the buffer was not read from the file normally
  2766. or if the file itself has been changed for some known benign reason.
  2767.  
  2768. arguments:()
  2769. Fset-buffer-modtime
  2770. Update BUFFER's recorded modification time from the associated 
  2771. file's modtime, if there is an associated file. If not, use the 
  2772. current time. In either case, if the optional arg TIME is supplied, use 
  2773. that is it is either an integer or a cons of two integers.
  2774.  
  2775. arguments:(buf &optional in_time)
  2776. Fdo-auto-save
  2777. Auto-save all buffers that need it.
  2778. This is all buffers that have auto-saving enabled
  2779. and are changed since last auto-saved.
  2780. Auto-saving writes the buffer into a file
  2781. so that your editing is not lost if the system crashes.
  2782. This file is not the file you visited; that changes only when you save.
  2783.  
  2784. Non-nil first argument means do not print any message if successful.
  2785.  
  2786. arguments:(&optional nomsg)
  2787. Fset-buffer-auto-saved
  2788. Mark current buffer as auto-saved with its current text.
  2789. No auto-save file will be written until the buffer changes again.
  2790.  
  2791. arguments:()
  2792. Frecent-auto-save-p
  2793. Return t if buffer has been auto-saved since last read in or saved.
  2794.  
  2795. arguments:()
  2796. Vvms-stmlf-recfm
  2797. *Non-nil means write new files with record format `stmlf'.
  2798. nil means use format `var'.  This variable is meaningful only on VMS.Flock-buffer
  2799. Lock FILE, if current buffer is modified.
  2800. FILE defaults to current buffer's visited file,
  2801. or else nothing is done if current buffer isn't visiting a file.
  2802.  
  2803. arguments:(&optional fn)
  2804. Funlock-buffer
  2805. Unlock the file visited in the current buffer,
  2806. if it should normally be locked.
  2807.  
  2808. arguments:()
  2809. Ffile-locked-p
  2810. Return nil if the FILENAME is not locked,
  2811. t if it is locked by you, else a string of the name of the locker.
  2812.  
  2813. arguments:(&optional fn)
  2814. Vlock-directory
  2815. Don't change thisVsuperlock-path
  2816. Don't change thisFacos
  2817. Return the inverse cosine of ARG.
  2818.  
  2819. arguments:(arg)
  2820. Facosh
  2821. Return the inverse hyperbolic cosine of ARG.
  2822.  
  2823. arguments:(arg)
  2824. Fasin
  2825. Return the inverse sine of ARG.
  2826.  
  2827. arguments:(arg)
  2828. Fasinh
  2829. Return the inverse hyperbolic sine of ARG.
  2830.  
  2831. arguments:(arg)
  2832. Fatan
  2833. Return the inverse tangent of ARG.
  2834.  
  2835. arguments:(arg1 &optional arg2)
  2836. Fatanh
  2837. Return the inverse hyperbolic tangent of ARG.
  2838.  
  2839. arguments:(arg)
  2840. Fcos
  2841. Return the cosine of ARG.
  2842.  
  2843. arguments:(arg)
  2844. Fcosh
  2845. Return the hyperbolic cosine of ARG.
  2846.  
  2847. arguments:(arg)
  2848. Fcube-root
  2849. Return the cube root of ARG.
  2850.  
  2851. arguments:(arg)
  2852. Fexp
  2853. Return the exponential base e of ARG.
  2854.  
  2855. arguments:(arg)
  2856. Flog
  2857. Return the natural logarithm of ARG.
  2858. With two arguments, return the logarithm of ARG to the base ARG2.
  2859.  
  2860. arguments:(arg1 &optional arg2)
  2861. Flog10
  2862. Return the logarithm base 10 of ARG.
  2863.  
  2864. arguments:(arg)
  2865. Fexpt
  2866. Return the exponential x ** y.
  2867.  
  2868. arguments:(arg1 arg2)
  2869. Fsin
  2870. Return the sine of ARG.
  2871.  
  2872. arguments:(arg)
  2873. Fsinh
  2874. Return the hyperbolic sine of ARG.
  2875.  
  2876. arguments:(arg)
  2877. Fsqrt
  2878. Return the square root of ARG.
  2879.  
  2880. arguments:(arg)
  2881. Ftan
  2882. Return the tangent of ARG.
  2883.  
  2884. arguments:(arg)
  2885. Ftanh
  2886. Return the hyperbolic tangent of ARG.
  2887.  
  2888. arguments:(arg)
  2889. Fabs
  2890. Return the absolute value of ARG.
  2891.  
  2892. arguments:(arg)
  2893. Ffloat
  2894. Return the floating point number equal to ARG.
  2895.  
  2896. arguments:(arg)
  2897. Fceiling
  2898. Return the smallest integer no less than ARG.  (Round toward +inf.)
  2899.  
  2900. arguments:(arg)
  2901. Ffloor
  2902. Return the largest integer no greater than ARG.  (Round towards -inf.)
  2903.  
  2904. arguments:(arg)
  2905. Fround
  2906. Return the nearest integer to ARG.
  2907.  
  2908. arguments:(arg)
  2909. Ftruncate
  2910. Truncate a floating point number to an int.
  2911. Rounds the value toward zero.
  2912.  
  2913. arguments:(arg)
  2914. Ffceiling
  2915. Return the smallest integer no less than ARG, as a float.
  2916. (Round toward +inf.)
  2917.  
  2918. arguments:(arg)
  2919. Fffloor
  2920. Return the largest integer no greater than ARG, as a float.
  2921. (Round towards -inf.)
  2922.  
  2923. arguments:(arg)
  2924. Ffround
  2925. Return the nearest integer to ARG, as a float.
  2926.  
  2927. arguments:(arg)
  2928. Fftruncate
  2929. Truncate a floating point number to an integral float value.
  2930. Rounds the value toward zero.
  2931.  
  2932. arguments:(arg)
  2933. Fidentity
  2934. Return the argument unchanged.
  2935.  
  2936. arguments:(arg)
  2937. Frandom
  2938. Return a pseudo-random number.
  2939. On most systems all integers representable in Lisp are equally likely.
  2940.   This is 24 bits' worth.
  2941. With argument N, return random number in interval [0,N).
  2942. With argument t, set the random number seed from the current time and pid.
  2943.  
  2944. arguments:(&optional arg)
  2945. Flength
  2946. Return the length of vector, list or string SEQUENCE.
  2947. A byte-code function object is also allowed.
  2948.  
  2949. arguments:(obj)
  2950. Fstring-equal
  2951. T if two strings have identical contents.
  2952. Case is significant.
  2953. Symbols are also allowed; their print names are used instead.
  2954.  
  2955. arguments:(s1 s2)
  2956. Fstring-lessp
  2957. T if first arg string is less than second in lexicographic order.
  2958. Case is significant.
  2959. Symbols are also allowed; their print names are used instead.
  2960.  
  2961. arguments:(s1 s2)
  2962. Fappend
  2963. Concatenate all the arguments and make the result a list.
  2964. The result is a list whose elements are the elements of all the arguments.
  2965. Each argument may be a list, vector or string.
  2966. The last argument is not copied if it is a list.
  2967.  
  2968. arguments: (&rest args)
  2969. Fconcat
  2970. Concatenate all the arguments and make the result a string.
  2971. The result is a string whose elements are the elements of all the arguments.
  2972. Each argument may be a string, a list of numbers, or a vector of numbers.
  2973.  
  2974. arguments: (&rest args)
  2975. Fvconcat
  2976. Concatenate all the arguments and make the result a vector.
  2977. The result is a vector whose elements are the elements of all the arguments.
  2978. Each argument may be a list, vector or string.
  2979.  
  2980. arguments: (&rest args)
  2981. Fcopy-sequence
  2982. Return a copy of a list, vector or string.
  2983. The elements of a list or vector are not copied; they are shared
  2984. with the original.
  2985.  
  2986. arguments:(arg)
  2987. Fcopy-alist
  2988. Return a copy of ALIST.
  2989. This is an alist which represents the same mapping from objects to objects,
  2990. but does not share the alist structure with ALIST.
  2991. The objects mapped (cars and cdrs of elements of the alist)
  2992. are shared, however.
  2993.  
  2994. arguments:(alist)
  2995. Fcopy-tree
  2996. Return a copy of a list or vector, and substructures.
  2997. The argument is copied, and any lists or vectors contained within it
  2998. are copied recursively.  Circularities and shared substructures are
  2999. not preserved.  Strings are not copied.
  3000.  
  3001. arguments:(arg)
  3002. Fsubstring
  3003. Return a substring of STRING, starting at index FROM and ending before TO.
  3004. TO may be nil or omitted; then the substring runs to the end of STRING.
  3005. If FROM or TO is negative, it counts from the end.
  3006.  
  3007. arguments:(string from &optional to)
  3008. Fnthcdr
  3009. Take cdr N times on LIST, returns the result.
  3010.  
  3011. arguments:(n list)
  3012. Fnth
  3013. Return the Nth element of LIST.
  3014. N counts from zero.  If LIST is not that long, nil is returned.
  3015.  
  3016. arguments:(n list)
  3017. Felt
  3018. Return element of SEQUENCE at index N.
  3019.  
  3020. arguments:(seq n)
  3021. Fmember
  3022. Return non-nil if ELT is an element of LIST.  Comparison done with EQUAL.
  3023. The value is actually the tail of LIST whose car is ELT.
  3024.  
  3025. arguments:(elt list)
  3026. Fmemq
  3027. Return non-nil if ELT is an element of LIST.  Comparison done with EQ.
  3028. The value is actually the tail of LIST whose car is ELT.
  3029.  
  3030. arguments:(elt list)
  3031. Fassq
  3032. Return non-nil if ELT is `eq' to the car of an element of LIST.
  3033. The value is actually the element of LIST whose car is ELT.
  3034.  
  3035. arguments:(key list)
  3036. Fassoc
  3037. Return non-nil if ELT is `equal' to the car of an element of LIST.
  3038. The value is actually the element of LIST whose car is ELT.
  3039.  
  3040. arguments:(key list)
  3041. Frassq
  3042. Return non-nil if ELT is `eq' to the cdr of an element of LIST.
  3043. The value is actually the element of LIST whose cdr is ELT.
  3044.  
  3045. arguments:(key list)
  3046. Fdelq
  3047. Delete by side effect any occurrences of ELT as a member of LIST.
  3048. The modified LIST is returned.  Comparison is done with `eq'.
  3049. If the first member of LIST is ELT, there is no way to remove it by side effect;
  3050. therefore, write `(setq foo (delq element foo))'
  3051. to be sure of changing the value of `foo'.
  3052.  
  3053. arguments:(elt list)
  3054. Fdelete
  3055. Delete by side effect any occurrences of ELT as a member of LIST.
  3056. The modified LIST is returned.  Comparison is done with `equal'.
  3057. If the first member of LIST is ELT, there is no way to remove it by side effect;
  3058. therefore, write `(setq foo (delete element foo))'
  3059. to be sure of changing the value of `foo'.
  3060.  
  3061. arguments:(elt list)
  3062. Fnreverse
  3063. Reverse LIST by modifying cdr pointers.
  3064. Returns the beginning of the reversed list.
  3065.  
  3066. arguments:(list)
  3067. Freverse
  3068. Reverse LIST, copying.  Returns the beginning of the reversed list.
  3069. See also the function `nreverse', which is used more often.
  3070.  
  3071. arguments:(list)
  3072. Fsort
  3073. Sort LIST, stably, comparing elements using PREDICATE.
  3074. Returns the sorted list.  LIST is modified by side effects.
  3075. PREDICATE is called with two elements of LIST, and should return T
  3076. if the first element is "less" than the second.
  3077.  
  3078. arguments:(list pred)
  3079. Fget
  3080. Return the value of SYMBOL's PROPNAME property.
  3081. This is the last VALUE stored with `(put SYMBOL PROPNAME VALUE)'.
  3082.  
  3083. arguments:(sym prop)
  3084. Fput
  3085. Store SYMBOL's PROPNAME property with value VALUE.
  3086. It can be retrieved with `(get SYMBOL PROPNAME)'.
  3087.  
  3088. arguments:(sym prop val)
  3089. Fremprop
  3090. Remove from SYMBOL's plist the property PROP and its value.
  3091.  
  3092. arguments:(symbol property)
  3093. Fequal
  3094. T if two Lisp objects have similar structure and contents.
  3095. They must have the same data type.
  3096. Conses are compared by comparing the cars and the cdrs.
  3097. Vectors and strings are compared element by element.
  3098. Numbers are compared by value.  Symbols must match exactly.
  3099.  
  3100. arguments:(o1 o2)
  3101. Ffillarray
  3102. Store each element of ARRAY with ITEM.  ARRAY is a vector or string.
  3103.  
  3104. arguments:(array item)
  3105. Fnconc
  3106. Concatenate any number of lists by altering them.
  3107. Only the last argument is not altered, and need not be a list.
  3108.  
  3109. arguments: (&rest args)
  3110. Fmapconcat
  3111. Apply FN to each element of SEQ, and concat the results as strings.
  3112. In between each pair of results, stick in SEP.
  3113. Thus, " " as SEP results in spaces between the values return by FN.
  3114.  
  3115. arguments:(fn seq sep)
  3116. Fmapcar
  3117. Apply FUNCTION to each element of SEQUENCE, and make a list of the results.
  3118. The result is a list just as long as SEQUENCE.
  3119. SEQUENCE may be a list, a vector or a string.
  3120.  
  3121. arguments:(fn seq)
  3122. Fload-average
  3123. Return list of 1 minute, 5 minute and 15 minute load averages.
  3124. Each of the three load averages is multiplied by 100,
  3125. then converted to integer.
  3126.  
  3127. This won't work unless the emacs executable is setgid kmem
  3128. (assuming that /dev/kmem is in the group kmem.)
  3129.  
  3130. arguments:()
  3131. Ffeaturep
  3132. Returns t if FEATURE is present in this Emacs.
  3133. Use this to conditionalize execution of lisp code based on the presence or
  3134. absence of emacs or environment extensions.
  3135. Use `provide' to declare that a feature is available.
  3136. This function looks at the value of the variable `features'.
  3137.  
  3138. arguments:(feature)
  3139. Fprovide
  3140. Announce that FEATURE is a feature of the current Emacs.
  3141.  
  3142. arguments:(feature)
  3143. Frequire
  3144. If feature FEATURE is not loaded, load it from FILENAME.
  3145. If FEATURE is not a member of the list `features', then the feature
  3146. is not loaded; so load the file FILENAME.
  3147. If FILENAME is omitted, the printname of FEATURE is used as the file name.
  3148.  
  3149. arguments:(feature &optional file_name)
  3150. Fplay-sound-file
  3151. Play the named sound file on the console speaker at the specified volume
  3152. (0-100, default specified by the `bell-volume' variable).
  3153. The sound file must be in the Sun/NeXT U-LAW format.
  3154.  
  3155. arguments:(file &optional vol)
  3156. Fplay-sound
  3157. Play a sound of the provided type.
  3158. See the variable sound-alist.
  3159.  
  3160. arguments:(sound &optional volume)
  3161. Vfeatures
  3162. A list of symbols which are the features of the executing emacs.
  3163. Used by `featurep' and `require', and altered by `provide'.Vbell-volume
  3164. How loud to be, from 0 to 100.Vsound-alist
  3165. An alist associating symbols with strings of audio-data.
  3166. When `beep' or `ding' is called with one of the symbols, the associated
  3167. sound data will be played instead of the standard beep.  This only works
  3168. if you are logged in on the console of a Sun SparcStation or SGI machine.
  3169.  
  3170. Elements of this list should be of one of the following forms:
  3171.  
  3172.    ( symbol . string-or-symbol )
  3173.    ( symbol integer string-or-symbol )
  3174.  
  3175. If the `string-or-symbol' is a string, then it should contain raw sound data,
  3176. the contents of a `.au' file.  If it is a symbol, then that means that this
  3177. element is an alias for some other element, and the sound-player will look
  3178. for that next.  If the integer is provided, it is the volume at which the
  3179. sound should be played, from 0 to 100.  
  3180.  
  3181. If an element of this alist begins with the symbol `default', then that sound
  3182. will be used when no other sound is appropriate.
  3183.  
  3184. The symbol `t' in place of a sound-string means to use the default X beep.
  3185. In this way, you can define beep-types to have different volumes even when
  3186. not running on the console of a Sun4.
  3187.  
  3188. You should probably add things to this list by calling the function
  3189. load-sound-file.
  3190.  
  3191. The following beep-types are used by emacs itself:
  3192.  
  3193.     auto-save-error    when an auto-save does not succeed
  3194.     command-error    when the emacs command loop catches an error
  3195.     undefined-key    when you type a key that is undefined
  3196.     undefined-click    when you use an undefined mouse-click combination
  3197.     no-completion    during completing-read
  3198.     y-or-n-p        when you type something other than 'y' or 'n'
  3199.     yes-or-no-p      when you type something other than 'yes' or 'no'
  3200.  
  3201. Other lisp packages may use other beep types, but these are the ones that
  3202. the C kernel of emacs uses.Fbuffer-syntactic-context-flush-cache
  3203. Flush the cache used by `buffer-syntactic-context-flush-cache'.
  3204. Call this when deletions occur.  This is a kludge.
  3205.  
  3206. arguments:()
  3207. Fbuffer-syntactic-context
  3208. Returns the syntactic context of the current buffer at point.
  3209. The returned value is one of the following symbols:
  3210.  
  3211.     nil        ; meaning no special interpretation
  3212.     string        ; meaning point is within a string
  3213.     comment        ; meaning point is within a line comment
  3214.     block-comment    ; meaning point is within a block comment
  3215.  
  3216. See also the function `buffer-syntactic-context-depth', which returns
  3217. the current nesting-depth within all parenthesis-syntax delimiters
  3218. and the function `syntactically-sectionize', which will map a function
  3219. over each syntactic context in a region.
  3220.  
  3221. arguments:()
  3222. Fbuffer-syntactic-context-depth
  3223. Returns the depth within all parenthesis-syntax delimiters at point.
  3224.  
  3225. arguments:()
  3226. Fsyntactically-sectionize
  3227. Creates extents for each contiguous syntactic context in the region.
  3228. Calls the given function when each extent is created with three arguments:
  3229. the extent, a symbol representing the syntactic context, and the current
  3230. depth (as returned by the functions `buffer-syntactic-context' and
  3231. `buffer-syntactic-context-depth').  If the optional arg `extent-data' is
  3232. provided, the extent will be created with that in its data slot.
  3233.  
  3234. arguments:(start end function &optional extent_data)
  3235. Fcurrent-column
  3236. Return the horizontal position of point.  Beginning of line is column 0.
  3237. This is calculated by adding together the widths of all the displayed
  3238. representations of the character between the start of the previous line
  3239. and point.  (eg control characters will have a width of 2 or 4, tabs
  3240. will have a variable width)
  3241. Ignores finite width of screen, which means that this function may return
  3242. values greater than (screen-width).
  3243. Whether the line is visible (if `selective-display' is t) has no effect;
  3244. however, ^M is treated as end of line when `selective-display' is t.
  3245.  
  3246. arguments:()
  3247. Findent-to
  3248. Indent from point with tabs and spaces until COLUMN is reached.
  3249. Optional second argument MIN says always do at least MIN spaces
  3250. even if that goes past COLUMN; by default, MIN is zero.
  3251.  
  3252. arguments:(col &optional minimum)
  3253. Fcurrent-indentation
  3254. Return the indentation of the current line.
  3255. This is the horizontal position of the character
  3256. following any initial whitespace.
  3257.  
  3258. arguments:()
  3259. Fmove-to-column
  3260. Move point to column COLUMN in the current line.
  3261. The column of a character is calculated by adding together the widths
  3262. as displayed of the previous characters in the line.
  3263. This function ignores line-continuation;
  3264. there is no upper limit on the column number a character can have
  3265. and horizontal scrolling has no effect.
  3266.  
  3267. If specified column is within a character, point goes after that character.
  3268. If it's past end of line, point goes to end of line.
  3269.  
  3270. A non-nil second (optional) argument FORCE means, if the line
  3271. is too short to reach column COLUMN then add spaces/tabs to get there,
  3272. and if COLUMN is in the middle of a tab character, change it to spaces.
  3273.  
  3274. arguments:(column &optional force)
  3275. Fmotion
  3276. Move forward from point by N characters.  Stop if we reach
  3277. TOHPOS, TOVPOS first.
  3278.  
  3279. arguments:(n tohpos tovpos)
  3280. Fvertical-motion
  3281. Move to start of screen line LINES lines down.
  3282. If LINES is negative, this is moving up.
  3283. Sets point to position found; this may be start of line
  3284.  or just the start of a continuation line.
  3285. Returns number of lines moved; may be closer to zero than LINES
  3286.  if beginning or end of buffer was reached.
  3287. Optional second argument is WINDOW to move in.
  3288.  
  3289. arguments:(lines &optional window)
  3290. Vindent-tabs-mode
  3291. *Indentation can insert tabs if this is non-nil.
  3292. Setting this variable automatically makes it local to the current buffer.Frecursive-edit
  3293. Invoke the editor command loop recursively.
  3294. To get out of the recursive edit, a command can do `(throw 'exit nil)';
  3295. that tells this function to return.
  3296. Alternately, `(throw 'exit t)' makes this function signal an error.
  3297. This function is called by the editor initialization to begin editing.
  3298.  
  3299. arguments:()
  3300. Ftop-level
  3301. Exit all recursive editing levels.
  3302.  
  3303. arguments:()
  3304. Fexit-recursive-edit
  3305. Exit from the innermost recursive edit or minibuffer.
  3306.  
  3307. arguments:()
  3308. Fabort-recursive-edit
  3309. Abort the command that requested this recursive edit or minibuffer input.
  3310.  
  3311. arguments:()
  3312. Fcommand-execute
  3313. Execute CMD as an editor command.
  3314. CMD must be a symbol that satisfies the `commandp' predicate.
  3315. Optional second arg RECORD-FLAG non-nil
  3316. means unconditionally put this command in `command-history'.
  3317. Otherwise, that is done only if an arg is read using the minibuffer.
  3318.  
  3319. arguments:(cmd &optional record)
  3320. Frecent-keys
  3321. Return vector of last 100 keyboard or mouse button events read.
  3322. This copies 100 event objects and a vector; it is safe to keep and modify
  3323. them.
  3324.  
  3325. arguments:()
  3326. Fthis-command-keys
  3327. Returns a vector of the keyboard or mouse button events that were used
  3328. to invoke this command.  This copies the vector and the events; it is safe
  3329. to keep and modify them.
  3330.  
  3331. arguments:()
  3332. Frecursion-depth
  3333. Return the current depth in recursive edits.
  3334.  
  3335. arguments:()
  3336. Fopen-dribble-file
  3337. Start writing all keyboard characters to FILE.
  3338.  
  3339. arguments:(file)
  3340. Fsuspend-emacs
  3341. Stop Emacs and return to superior process.  You can resume later.
  3342. If optional arg STUFFSTRING is non-nil, its characters are stuffed
  3343. to be read as terminal input by Emacs's superior shell.
  3344. Before suspending, if `suspend-hook' is bound and value is non-nil
  3345. call the value as a function of no args.  Don't suspend if it returns non-nil.
  3346. Otherwise, suspend normally and after resumption call
  3347. `suspend-resume-hook' if that is bound and non-nil.
  3348.  
  3349. arguments:(&optional stuffstring)
  3350. Fset-input-mode
  3351. Set mode of reading keyboard input.
  3352. First arg non-nil means use input interrupts; nil means use CBREAK mode.
  3353. Second arg non-nil means use ^S/^Q flow control for output to terminal
  3354.  (no effect except in CBREAK mode).
  3355. Third arg non-nil means accept 8-bit input (for a Meta key).
  3356.  Otherwise, the top bit is ignored, on the assumption it is parity.
  3357.  
  3358. arguments:(intrrupt flow meta)
  3359. Fset-interrupt-character
  3360. Change the interrupt character.  Arg is an ASCII code or nil.
  3361. Among other system-dependent things, this changes the value of the
  3362. variable `interrupt-char'.
  3363.  
  3364. arguments:(new_interrupt_char)
  3365. Vdisabled-command-hook
  3366. Value is called instead of any command that is disabled,
  3367. i.e. has a non-nil `disabled' property.Vlast-command-event
  3368. Last keyboard or mouse button event that was part of a command.  This
  3369. variable is off limits: you may not set its value or modify the event that
  3370. is its value, as it is destructively modified by `read-key-sequence'.  If
  3371. you want to keep a pointer to this value, you must use `copy-event'.Vlast-command-char
  3372. If the value of `last-command-event' is a keyboard event, then
  3373. this is the nearest ASCII equivalent to it.  This the the value that
  3374. `self-insert-command' will put in the buffer.  Remember that there is
  3375. NOT a 1:1 mapping between keyboard events and ASCII characters: the set
  3376. of keyboard events is much larger, so writing code that examines this
  3377. variable to determine what key has been typed is bad practice, unless
  3378. you are certain that it will be one of a small set of characters.Vlast-input-event
  3379. Last keyboard or mouse button event recieved.  This variable is off
  3380. limits: you may not set its value or modify the event that is its value, as
  3381. it is destructively modified by `next-event'.  If you want to keep a pointer
  3382. to this value, you must use `copy-event'.Vlast-input-char
  3383. If the value of `last-input-event' is a keyboard event, then
  3384. this is the nearest ASCII equivalent to it.  Remember that there is
  3385. NOT a 1:1 mapping between keyboard events and ASCII characters: the set
  3386. of keyboard events is much larger, so writing code that examines this
  3387. variable to determine what key has been typed is bad practice, unless
  3388. you are certain that it will be one of a small set of characters.Vlast-input-time
  3389. The time (in seconds since Jan 1, 1970) of the last-command-event,
  3390. represented as a cons of two 16-bit integers.  This is destructively
  3391. modified, so copy it if you want to keep it.Vunread-command-event
  3392. Set this to an event object to simulate the reciept of an event from
  3393. the user.  Normally this is nil.Vlast-command
  3394. The last command executed.  Normally a symbol with a function definition,
  3395. but can be whatever was found in the keymap, or whatever the variable
  3396. `this-command' was set to by that command.Vthis-command
  3397. The command now being executed.
  3398. The command can set this variable; whatever is put here
  3399. will be in `last-command' during the following command.Vhelp-char
  3400. Character to recognize as meaning Help.
  3401. When it is read, do `(eval help-form)', and display result if it's a string.
  3402. If the value of `help-form' is nil, this char can be read normally.Vinterrupt-char
  3403. Character which interrupts emacs.
  3404. Do not setq this variable: use the function `set-interrupt-character' instead.
  3405. Depending on the system you are on, this may need to do magic like changing
  3406. interrupt handlers.Vhelp-form
  3407. Form to execute when character help-char is read.
  3408. If the form returns a string, that string is displayed.
  3409. If `help-form' is nil, the help char is not recognized.Vpre-command-hook
  3410. Function or functions to run before every command.
  3411. This may examine the `this-command' variable to find out what command
  3412. is about to be run, or may change it to cause a different command to run.
  3413. Function on this hook must be careful to avoid signalling errors!Vpost-command-hook
  3414. Function or functions to run after every command.
  3415. This may examine the `this-command' variable to find out what command
  3416. was just executed.Vtop-level
  3417. Form to evaluate when Emacs starts up.
  3418. Useful to set before you dump a modified Emacs.Vkeyboard-translate-table
  3419. String used as translate table for keyboard input, or nil.
  3420. Each character is looked up in this string and the contents used instead.
  3421. If string is of length N, character codes N and up are untranslated.
  3422. This is the right thing to use only if you are on a dumb tty, as it cannot
  3423. handle input which cannot be represented as ASCII.  If you are running emacs
  3424. under X, you should do the translations with the `xmodmap' program instead.Fmake-keymap
  3425. Construct and return a new keymap object.  All entries in it are nil,
  3426. meaning "command undefined".
  3427.  
  3428. arguments:()
  3429. Fmake-sparse-keymap
  3430. Construct and return a new keymap object.  All entries in it are nil,
  3431. meaning "command undefined".  The only difference between this function
  3432. and make-keymap is that this function returns a "smaller" keymap (one
  3433. that is expected to contain less entries.)  As keymaps dynamically resize,
  3434. the distinction is not great.
  3435.  
  3436. arguments:()
  3437. Fkeymap-parent
  3438. Returns the `parent' keymap of the given keymap, or nil.
  3439. The parent of a keymap is searched for keybindings when a key sequence
  3440. isn't bound in this one.  The (current-global-map) is the default parent
  3441. of all keymaps.
  3442.  
  3443. arguments:(keymap)
  3444. Fset-keymap-parent
  3445. Sets the `parent' keymap of the given keymap.
  3446. The parent of a keymap is searched for keybindings when a key sequence
  3447. isn't bound in this one.  The (current-global-map) is the default parent
  3448. of all keymaps.
  3449.  
  3450. arguments:(keymap parent)
  3451. Fset-keymap-name
  3452. Sets the `name' of the given keymap to NEW-NAME
  3453. The name is only a debugging convenience; it is not used except
  3454. when printing the keymap.
  3455.  
  3456. arguments:(keymap new_name)
  3457. Fkeymapp
  3458. Return t if ARG is a keymap object.
  3459.  
  3460. arguments:(object)
  3461. Fcopy-keymap
  3462. Return a copy of the keymap KEYMAP.
  3463. The copy starts out with the same definitions of KEYMAP,
  3464. but changing either the copy or KEYMAP does not affect the other.
  3465. Any key definitions that are subkeymaps are recursively copied.
  3466.  
  3467. arguments:(keymap)
  3468. Fkeymap-fullness
  3469. Returns the number of bindings in the keymap.
  3470.  
  3471. arguments:(keymap)
  3472. Fdefine-key
  3473. Args KEYMAP, KEYS, DEF.  Define key sequence KEYS, in KEYMAP, as DEF.
  3474. KEYMAP is a keymap object.
  3475. KEYS is the sequence of keystrokes to bind, described below.
  3476. DEF is anything that can be a key's definition:
  3477.  nil (means key is undefined in this keymap);
  3478.  a command (a Lisp function suitable for interactive calling);
  3479.  a string or key sequence vector (treated as a keyboard macro);
  3480.  a keymap (to define a prefix key);
  3481.  a symbol; when the key is looked up, the symbol will stand for its
  3482.     function definition, that should at that time be one of the above,
  3483.     or another symbol whose function definition is used, and so on.
  3484.  a cons (STRING . DEFN), meaning that DEFN is the definition
  3485.     (DEFN should be a valid definition in its own right);
  3486.  or a cons (KEYMAP . CHAR), meaning use definition of CHAR in map KEYMAP.
  3487.  
  3488. Contrary to popular belief, the world is not ASCII.  When running under a
  3489. window manager, Emacs can tell the difference between, for example, the
  3490. keystrokes control-h, control-shift-h, and backspace.  You can, in fact,
  3491. bind different commands to each of these.
  3492.  
  3493. A `key sequence' is a set of keystrokes.  A `keystroke' is a keysym and some
  3494. set of modifiers (such as control and meta).  A `keysym' is what is printed
  3495. on the keys on your keyboard.
  3496.  
  3497. A keysym may be represented by a symbol, or (if and only if it is equivalent
  3498. to a printing ASCII character) by its ASCII code.  The `A' key may be
  3499. represented by the symbol `A' or by the number 65.  The `break' key may be
  3500. represented only by the symbol `break'.
  3501.  
  3502. A keystroke may be represented by a list: the last element of the list is
  3503. the key (a symbol or number, as above) and the preceding elements are the
  3504. symbolic names of modifier keys (control, meta, super, hyper, and shift.)
  3505. Thus, the sequence control-b is represented by the forms `(control b)' 
  3506. and `(control 98)'.  A keystroke may also be represented by an event object,
  3507. as returned by the `next-command-event' and `read-key-sequence' functions.
  3508.  
  3509. Note that in this context, the keystroke `control-b' is *not* represented
  3510. by the number 2 (the ASCII code for ^B).  See below.
  3511.  
  3512. The `shift' modifier is somewhat of a special case.  You should not (and
  3513. cannot) use `(meta shift a)' to mean `(meta A)', since for characters that
  3514. have printing ASCII equivalents, the state of the shift key is implicit in
  3515. the keysym (a vs. A).  You also cannot say `(shift =)' to mean `+', as that
  3516. sort of thing varies from keyboard to keyboard.  The shift modifier is for
  3517. use only with characters that do not have a second keysym on the same key,
  3518. such as `backspace' and `tab'.
  3519.  
  3520. A key sequence is a vector of keystrokes.  As a degenerate case, elements
  3521. of this vector may also be keysyms if they have no modifiers.  That is,
  3522. the `A' keystroke is represented by all of these forms:
  3523.     A    65    (A)    (65)    [A]    [65]    [(A)]    [(65)]
  3524. the `control-a' keystroke is represented by these forms:
  3525.     (control A)    (control 65)    [(control A)]    [(control 65)]
  3526. the key sequence `control-c control-a' is represented by these forms:
  3527.     [(control c) (control a)]    [(control 99) (control 65)]
  3528.  
  3529. Mouse button clicks work just like keypresses: (control button1) means
  3530. pressing the left mouse button while holding down the control key.
  3531. [(control c) (shift button3)] means control-c, hold shift, click right.
  3532.  
  3533. Commands may be bound to the mouse-button up-stroke rather than the down-
  3534. stroke as well.  `button1' means the down-stroke, and `button1up' means the
  3535. up-stroke.  Different commands may be bound to the up and down strokes,
  3536. though that is probably not what you want, so be careful.
  3537.  
  3538. For backward compatibility, a key sequence may also be represented by a
  3539. string.  In this case, it represents the key sequence(s) that would
  3540. produce that sequence of ASCII characters in a purely ASCII world.  For
  3541. example, a string containing the ASCII backspace character, "\^H", would
  3542. represent two key sequences: `(control h)' and `backspace'.  Binding a
  3543. command to this will actually bind both of those key sequences.  Likewise
  3544. for the following pairs:
  3545.  
  3546.         control h    backspace
  3547.         control i       tab
  3548.         control m       return
  3549.         control j       linefeed
  3550.         control [       escape
  3551.         control @    control space
  3552.  
  3553. After binding a command to two key sequences with a form like
  3554.  
  3555.     (define-key global-map "\^X\^I" 'command-1)
  3556.  
  3557. it is possible to redefine only one of those sequences like so:
  3558.  
  3559.     (define-key global-map [(control x) (control i)] 'command-2)
  3560.     (define-key global-map [(control x) tab] 'command-3)
  3561.  
  3562. Of course, all of this applies only when running under a window system.  If
  3563. you're talking to emacs through an ASCII-only channel, you don't get any of
  3564. these features.
  3565.  
  3566. arguments:(keymap keys def)
  3567. Flookup-key
  3568. In keymap KEYMAP, look up key sequence KEYS.  Return the definition.
  3569. nil means undefined.  See doc of `define-key' for kinds of definitions
  3570. and key-sequence specifications.
  3571. Number as value means KEYS is "too long";
  3572. that is, characters in it except for the last one
  3573. fail to be a valid sequence of prefix characters in KEYMAP.
  3574. The number is how many characters at the front of KEYS
  3575. it takes to reach a non-prefix command.
  3576.  
  3577. arguments:(keymap keys)
  3578. Fkey-binding
  3579. Return the binding for command KEYS in current keymaps.
  3580. KEYS is a string, a vector of events, or a vector of key-description lists
  3581. as described in the documentation for the `define-key' function.
  3582. The binding is probably a symbol with a function definition.
  3583.  
  3584. arguments:(keys)
  3585. Fuse-global-map
  3586. Select KEYMAP as the global keymap.
  3587.  
  3588. arguments:(keymap)
  3589. Fuse-local-map
  3590. Select KEYMAP as the local keymap.
  3591. If KEYMAP is nil, that means no local keymap.
  3592.  
  3593. arguments:(keymap)
  3594. Fcurrent-local-map
  3595. Return current buffer's local keymap, or nil if it has none.
  3596.  
  3597. arguments:()
  3598. Fcurrent-global-map
  3599. Return the current global keymap.
  3600.  
  3601. arguments:()
  3602. Fmap-keymap
  3603. Apply FUNCTION to each element of KEYMAP.  FUNCTION will be called with
  3604. two arguments: a key-description list, and the binding.  The order in which
  3605. the elements of the keymap are passed to the function is unspecified.  If
  3606. the function inserts new elements into the keymap, it may or may not
  3607. be called with them later.  No element of the keymap will ever be passed to
  3608. the function more than once.
  3609.  
  3610. The function will not be called on elements of this keymap's parent (see the
  3611. function `keymap-parent') or upon keymaps which are contained within this
  3612. keymap (multi-character definitions).  It will be called on "meta"
  3613. characters, however, since they are not really two-character sequences.
  3614.  
  3615. If the optional third argument SORT-FIRST is non-nil, then the elements of
  3616. the keymap will be passed to the mapper function in a canonical order.
  3617. Otherwise, they will be passed in hash (that is, random) order, which is
  3618. faster.
  3619.  
  3620. arguments:(function keymap &optional sort_first)
  3621. Faccessible-keymaps
  3622. Find all keymaps accessible via prefix characters from KEYMAP.
  3623. Returns a list of elements of the form (KEYS . MAP), where the sequence
  3624. KEYS starting from KEYMAP gets you to MAP.  These elements are ordered
  3625. so that the KEYS increase in length.  The first element is ([] . KEYMAP).
  3626.  
  3627. arguments:(startmap)
  3628. Fkey-description
  3629. Return a pretty description of key-sequence KEYS.
  3630. Control characters turn into "C-foo" sequences, meta into "M-foo"
  3631. spaces are put between sequence elements, etc.
  3632.  
  3633. arguments:(keys)
  3634. Fsingle-key-description
  3635. Return a pretty description of command character KEY.
  3636. Control characters turn into C-whatever, etc.
  3637.  
  3638. arguments:(key)
  3639. Ftext-char-description
  3640. Return a pretty description of file-character CHAR.
  3641. Control characters turn into "^char", etc.
  3642.  
  3643. arguments:(chr)
  3644. Fwhere-is-internal
  3645. Return list of keys that invoke DEFINITION in optional 2nd argument KEYMAP
  3646. or optional 4th argument GLOBAL_KEYMAP.
  3647. If KEYMAP is nil, search only GLOBAL_KEYMAP.
  3648. If GLOBAL_KEYMAP is nil, use the current global map.
  3649.  
  3650. If optional 3rd arg FIRSTONLY is non-nil,
  3651. return the first key sequence found, rather than a list of all possible
  3652. key sequences.
  3653.  
  3654. arguments:(definition &optional local_keymap firstonly global_keymap noindirect)
  3655. Fdescribe-bindings
  3656. Show a list of all defined keys, and their definitions.
  3657. The list is put in a buffer, which is displayed.
  3658. If the argument is non-null, then only the mouse bindings are displayed.
  3659.  
  3660. arguments:(&optional mice_only_p)
  3661. Fapropos-internal
  3662. Show all symbols whose names contain match for REGEXP.
  3663. If optional 2nd arg PRED is non-nil, (funcall PRED SYM) is done
  3664. for each symbol and a symbol is mentioned only if that returns non-nil.
  3665. Return list of symbols found.
  3666.  
  3667. arguments:(string &optional pred)
  3668. Vmeta-prefix-char
  3669. Meta-prefix character code.  Must be an ASCII integer.
  3670. This character followed by some character `foo' turns into `Meta-foo'.
  3671. To disable the meta-prefix-char, set it to a negative number.Vkeymap-tick
  3672. Incremented for each change to any keymap.Fread-char
  3673.  
  3674.  
  3675. arguments:()
  3676. Fget-file-char
  3677. Don't use this yourself.
  3678.  
  3679. arguments:()
  3680. Fload
  3681. Execute a file of Lisp code named FILE.
  3682. First try FILE with `.elc' appended, then try with `.el',
  3683.  then try FILE unmodified.
  3684. This function searches the directories in `load-path'.
  3685. If optional second arg MISSING-OK is non-nil,
  3686.  report no error if FILE doesn't exist.
  3687. Print messages at start and end of loading unless
  3688.  optional third arg NOMESSAGE is non-nil.
  3689. If optional fourth arg NOSUFFIX is non-nil, don't try adding
  3690.  suffixes `.elc' or `.el' to the specified name FILE.
  3691. Return t if file exists.
  3692.  
  3693. arguments:(str &optional missing_ok nomessage nosuffix)
  3694. Flocate-file
  3695. Search for FILENAME through PATH-LIST, expanded by one of the optional
  3696. SUFFIXES (string of suffixes separated by ":"s), checking for access
  3697. MODE (0|1|2|4 = exists|executable|writeable|readable), default readable.
  3698.  
  3699. arguments:(file path &optional suff mode)
  3700. Feval-buffer
  3701. Execute BUFFER as Lisp code.
  3702. Programs can pass argument PRINTFLAG which controls printing of output:
  3703. nil means discard it; anything else is stream for print.
  3704.  
  3705. arguments:(bufname &optional printflag)
  3706. Feval-region
  3707. Execute the region as Lisp code.
  3708. When called from programs, expects two arguments,
  3709. giving starting and ending indices in the current buffer
  3710. of the text to be executed.
  3711. Programs can pass third argument PRINTFLAG which controls output:
  3712. nil means discard it; anything else is stream for printing it.
  3713.  
  3714. If there is no error, point does not move.  If there is an error,
  3715. point remains at the end of the last character read from the buffer.
  3716.  
  3717. arguments:(b e &optional printflag)
  3718. Fread
  3719. Read one Lisp expression as text from STREAM, return as Lisp object.
  3720. If STREAM is nil, use the value of `standard-input' (which see).
  3721. STREAM or the value of `standard-input' may be:
  3722.  a buffer (read from point and advance it)
  3723.  a marker (read from where it points and advance it)
  3724.  a function (call it with no arguments for each character,
  3725.      call it with a char as argument to push a char back)
  3726.  a string (takes text from string, starting at the beginning)
  3727.  t (read text line using minibuffer and use it).
  3728.  
  3729. arguments:(&optional readcharfun)
  3730. Fread-from-string
  3731. Read one Lisp expression which is represented as text by STRING.
  3732. Returns a cons: (OBJECT-READ . FINAL-STRING-INDEX).
  3733. START and END optionally delimit a substring of STRING from which to read;
  3734.  they default to 0 and (length STRING) respectively.
  3735.  
  3736. arguments:(string &optional start end)
  3737. Fintern
  3738. Return the canonical symbol whose name is STRING.
  3739. If there is none, one is created by this function and returned.
  3740. A second optional argument specifies the obarray to use;
  3741. it defaults to the value of `obarray'.
  3742.  
  3743. arguments:(str &optional obarray)
  3744. Fintern-soft
  3745. Return the canonical symbol whose name is STRING, or nil if none exists.
  3746. A second optional argument specifies the obarray to use;
  3747. it defaults to the value of `obarray'.
  3748.  
  3749. arguments:(str &optional obarray)
  3750. Fmapatoms
  3751. Call FUNCTION on every symbol in OBARRAY.
  3752. OBARRAY defaults to the value of `obarray'.
  3753.  
  3754. arguments:(function &optional obarray)
  3755. Vobarray
  3756. Symbol table for use by `intern' and `read'.
  3757. It is a vector whose length ought to be prime for best results.
  3758. The vector's contents don't make sense if examined from Lisp programs;
  3759. to find all the symbols in an obarray, use `mapatoms'.Vvalues
  3760. List of values of all expressions which were read, evaluated and printed.
  3761. Order is reverse chronological.Vstandard-input
  3762. Stream for read to get input from.
  3763. See documentation of `read' for possible values.Vload-path
  3764. *List of directories to search for files to load.
  3765. Each element is a string (directory name) or nil (try default directory).
  3766.  
  3767. Note that the elements of this list *may not* begin with "~", so you must
  3768. call `expand-file-name' on them before adding them to this list.
  3769.  
  3770. Initialized based on EMACSLOADPATH environment variable, if any,
  3771. otherwise to default specified in by file `paths.h' when Emacs was built.
  3772. If there were no paths specified in `paths.h', then emacs chooses a default
  3773. value for this variable by looking around in the file-system near the
  3774. directory in which the emacs executable resides.Vload-in-progress
  3775. Non-nil iff inside of `load'.Vafter-load-alist
  3776. An alist of expressions to be evalled when particular files are loaded.
  3777. Each element looks like (FILENAME FORMS...).
  3778. When `load' is run and the file-name argument is FILENAME,
  3779. the FORMS in the corresponding element are executed at the end of loading.
  3780.  
  3781. FILENAME must match exactly!  Normally FILENAME is the name of a library,
  3782. with no directory specified, since that is how `load' is normally called.
  3783. An error in FORMS does not undo the load,
  3784. but does prevent execution of the rest of the FORMS.Vload-warn-when-source-newer
  3785. *Whether `load' should check whether the source is newer than the binary;
  3786. If this variable is true, then when a `.elc' file is being loaded and the
  3787. corresponding `.el' is newer, a warning message will be printed.Vload-warn-when-source-only
  3788. *Whether `load' should warn when loading a .el file instead of an .elc.
  3789. If this variable is true, then when load is called with a filename without
  3790. an extension, and the .elc version doesn't exist but the .el version does,
  3791. then a message will be printed.  If an explicit extension is passed to load,
  3792. no warning will be printed.Fstart-kbd-macro
  3793. Record subsequent keyboard and menu input, defining a keyboard macro.
  3794. The commands are recorded even as they are executed.
  3795. Use \[end-kbd-macro] to finish recording and make the macro available.
  3796. Use \[name-last-kbd-macro] to give it a permanent name.
  3797. Non-nil arg (prefix arg) means append to last macro defined;
  3798.  This begins by re-executing that macro as if you typed it again.
  3799.  
  3800. arguments:(append)
  3801. Fend-kbd-macro
  3802. Finish defining a keyboard macro.
  3803. The definition was started by \[start-kbd-macro].
  3804. The macro is now available for use via \[call-last-kbd-macro],
  3805. or it can be given a name with \[name-last-kbd-macro] and then invoked
  3806. under that name.
  3807.  
  3808. With numeric arg, repeat macro now that many times,
  3809. counting the definition just completed as the first repetition.
  3810. An argument of zero means repeat until error.
  3811.  
  3812. arguments:(&optional arg)
  3813. Fcall-last-kbd-macro
  3814. Call the last keyboard macro that you defined with \[start-kbd-macro].
  3815.  
  3816. A prefix argument serves as a repeat count.  Zero means repeat until error.
  3817.  
  3818. To make a macro permanent so you can call it even after
  3819. defining others, use \[name-last-kbd-macro].
  3820.  
  3821. arguments:(&optional prefix)
  3822. Fexecute-kbd-macro
  3823. Execute MACRO as string of editor command characters.
  3824. If MACRO is a symbol, its function definition is used.
  3825. COUNT is a repeat count, or nil for once, or 0 for infinite loop.
  3826.  
  3827. arguments:(macro &optional prefixarg)
  3828. Vdefining-kbd-macro
  3829. Non-nil while a keyboard macro is being defined.  Don't set this!Vexecuting-macro
  3830. Currently executing keyboard macro (a vector of events);
  3831. nil if none executing.Vexecuting-kbd-macro
  3832. Currently executing keyboard macro (a vector of events);
  3833. nil if none executing.Vlast-kbd-macro
  3834. Last kbd macro defined, as a vector of events; nil if none defined.Fmarker-buffer
  3835. Return the buffer that MARKER points into, or nil if none.
  3836. Returns nil if MARKER points into a dead buffer.
  3837.  
  3838. arguments:(marker)
  3839. Fmarker-position
  3840. Return the position MARKER points at, as a character number.
  3841.  
  3842. arguments:(marker)
  3843. Fset-marker
  3844. Position MARKER before character number NUMBER in BUFFER.
  3845. BUFFER defaults to the current buffer.
  3846. If NUMBER is nil, makes marker point nowhere.
  3847. Then it no longer slows down editing in any buffer.
  3848. If this marker was returned by (point-marker t), then changing its position
  3849. moves point.  You cannot change its buffer or make it point nowhere.
  3850. Returns MARKER.
  3851.  
  3852. arguments:(marker pos &optional buffer)
  3853. Fcopy-marker
  3854. Return a new marker pointing at the same place as MARKER.
  3855. If argument is a number, makes a new marker pointing
  3856. at that position in the current buffer.
  3857.  
  3858. arguments:(marker)
  3859. Fset-menubar-dirty-flag
  3860. Tells emacs that the menubar widget has to be updated
  3861.  
  3862. arguments:()
  3863. Fpopup-menu
  3864. Pop up the given menu.
  3865. A menu description is a list of menu items, strings, and submenus.
  3866.  
  3867. The first element of a menu must be a string, which is the name of the
  3868. menu.  This is the string that will be displayed in the parent menu, if
  3869. any.  For toplevel menus, it is ignored.  This string is not displayed
  3870. in the menu itself.
  3871.  
  3872. A menu item is a vector of three or four elements:
  3873.  
  3874.  - the name of the menu item (a string);
  3875.  - the `callback' of that item;
  3876.  - whether this item is active (selectable);
  3877.  - and an optional string to append to the name.
  3878.  
  3879. If the `callback' of a menu item is a symbol, then it must name a command.
  3880. It will be invoked with `call-interactively'.  If it is a list, then it is
  3881. evaluated with `eval'.
  3882.  
  3883. The fourth element of a menu item is a convenient way of adding the name
  3884. of a command's ``argument'' to the menu, like ``Kill Buffer NAME''.
  3885.  
  3886. If an element of a menu is a string, then that string will be presented in
  3887. the menu as unselectable text.
  3888.  
  3889. If an element of a menu is a string consisting solely of hyphens, then that
  3890. item will be presented as a solid horizontal line.
  3891.  
  3892. If an element of a menu is a list, it is treated as a submenu.  The name of
  3893. that submenu (the first element in the list) will be used as the name of the
  3894. item representing this menu on the parent.
  3895.  
  3896. The syntax, more precisely:
  3897.  
  3898.    form        :=  <something to pass to `eval'>
  3899.    command    :=  <a symbol or string, to pass to `call-interactively'>
  3900.    callback     :=  command | form
  3901.    active-p    :=  <t or nil, whether this thing is selectable>
  3902.    text        :=  <string, non selectable>
  3903.    name        :=  <string>
  3904.    argument    :=  <string>
  3905.    menu-item    :=  '['  name callback active-p [ argument ]  ']'
  3906.    menu        :=  '(' name [ menu-item | menu | text ]+ ')'
  3907.  
  3908. arguments:(menu_desc)
  3909. Fpopup-menu-up-p
  3910. Returns T if a popup menu is up, NIL otherwise.
  3911. See popup-menu.
  3912.  
  3913. arguments:()
  3914. Fpopup-dialog-box
  3915. Pop up a dialog box.
  3916. A dialog box description is a list.
  3917.  
  3918.  - The first element of the list is a string to display in the dialog box.
  3919.  - The rest of the elements are descriptions of the dialog box's buttons.
  3920.    Each one is a vector of three elements:
  3921.    - The first element is the text of the button.
  3922.    - The second element is the `callback'.
  3923.    - The third element is t or nil, whether this button is selectable.
  3924.  
  3925. If the `callback' of a button is a symbol, then it must name a command.
  3926. It will be invoked with `call-interactively'.  If it is a list, then it is
  3927. evaluated with `eval'.
  3928.  
  3929. One (and only one) of the buttons may be `nil'.  This marker means that all
  3930. following buttons should be flushright instead of flushleft.
  3931.  
  3932. The syntax, more precisely:
  3933.  
  3934.    form        :=  <something to pass to `eval'>
  3935.    command    :=  <a symbol or string, to pass to `call-interactively'>
  3936.    callback     :=  command | form
  3937.    active-p    :=  <t or nil, whether this thing is selectable>
  3938.    name        :=  <string>
  3939.    partition    :=  'nil'
  3940.    button    :=  '['  name callback active-p ']'
  3941.    dialog    :=  '(' name [ button ]+ [ partition [ button ]+ ] ')'
  3942.  
  3943. arguments:(dbox_desc)
  3944. Vcurrent-menubar
  3945. The current menubar.  This may be buffer-local.
  3946.  
  3947. When the menubar is changed, the function `set-menubar-dirty-flag' has to
  3948. be called for the menubar to be updated on the screen.  See `set-menubar'
  3949. and `set-buffer-menubar'.
  3950.  
  3951. A menubar is a list of menus and menu-items.
  3952. A menu is a list of menu items, strings, and submenus.
  3953.  
  3954. The first element of a menu must be a string, which is the name of the
  3955. menu.  This is the string that will be displayed in the menubar, or in
  3956. the parent menu.  This string is not displayed in the menu itself.
  3957.  
  3958. A menu item is a vector of three or four elements:
  3959.  
  3960.  - the name of the menu item (a string);
  3961.  - the `callback' of that item;
  3962.  - whether this item is active (selectable);
  3963.  - and an optional string to append to the name.
  3964.  
  3965. If the `callback' of a menu item is a symbol, then it must name a command.
  3966. It will be invoked with `call-interactively'.  If it is a list, then it is
  3967. evaluated with `eval'.
  3968.  
  3969. The fourth element of a menu item is a convenient way of adding the name
  3970. of a command's ``argument'' to the menu, like ``Kill Buffer NAME''.
  3971.  
  3972. If an element of a menu (or menubar) is a string, then that string will be
  3973. presented in the menu (or menubar) as unselectable text.
  3974.  
  3975. If an element of a menu is a string consisting solely of hyphens, then that
  3976. item will be presented as a solid horizontal line.
  3977.  
  3978. If an element of a menu is a list, it is treated as a submenu.  The name of
  3979. that submenu (the first element in the list) will be used as the name of
  3980. the item representing this menu on the parent.
  3981.  
  3982. If an element of a menubar is `nil', then it is used to represent the
  3983. division between the set of menubar-items which are flushleft and those
  3984. which are flushright.  (Note: this isn't completely implemented yet.)
  3985.  
  3986. After the menubar is clicked upon, but before any menus are popped up,
  3987. the functions on the `activate-menubar-hook' are invoked to make changes
  3988. to the menus and menubar.  This is intended to implement lazy alteration
  3989. of the sensitivity of menu items.
  3990.  
  3991. The syntax, more precisely:
  3992.  
  3993.    form        :=  <something to pass to `eval'>
  3994.    command    :=  <a symbol or string, to pass to `call-interactively'>
  3995.    callback     :=  command | form
  3996.    active-p    :=  <t or nil, whether this thing is selectable>
  3997.    text        :=  <string, non selectable>
  3998.    name        :=  <string>
  3999.    argument    :=  <string>
  4000.    menu-item    :=  '['  name callback active-p [ argument ]  ']'
  4001.    menu        :=  '(' name [ menu-item | menu | text ]+ ')'
  4002.    partition    :=  'nil'
  4003.    menubar    :=  '(' [ menu-item | menu | text ]* [ partition ]
  4004.                 [ menu-item | menu | text ]*
  4005.              ')'Vactivate-menubar-hook
  4006. Function or functions called before a menubar menu is pulled down.
  4007. These functions are called with no arguments, and should interrogate and
  4008. modify the value of `current-menubar' as desired.
  4009.  
  4010. The functions on this hook are invoked after the mouse goes down, but before
  4011. the menu is mapped, and may be used to activate, deactivate, add, or delete
  4012. items from the menus.
  4013.  
  4014. These functions may return the symbol `t' to assert that they have made
  4015. no changes to the menubar.  If any other value is returned, the menubar is
  4016. recomputed.  If `t' is returned but the menubar has been changed, then the
  4017. changes may not show up right away.  Returning `nil' when the menubar has
  4018. not changed is not so bad; more computation will be done, but redisplay of
  4019. the menubar will still be performed optimally.Vmenu-no-selection-hook
  4020. Function or functions to call when a menu or dialog box is dismissed
  4021. without a selecting having been made.Vmenubar-show-keybindings
  4022. If true, the menubar will display keyboard equivalents.
  4023. If false, only the command names will be displayed.Fminibuffer-depth
  4024. Return current depth of activations of minibuffer, a nonnegative integer.
  4025.  
  4026. arguments:()
  4027. Fread-minibuffer-internal
  4028. Lowest-level interface to minibuffers.  Don't call this.
  4029.  
  4030. arguments:(prompt)
  4031. Ftry-completion
  4032. Return common substring of all completions of STRING in ALIST.
  4033. Each car of each element of ALIST is tested to see if it begins with STRING.
  4034. All that match are compared together; the longest initial sequence
  4035. common to all matches is returned as a string.
  4036. If there is no match at all, nil is returned.
  4037. For an exact match, t is returned.
  4038.  
  4039. ALIST can be an obarray instead of an alist.
  4040. Then the print names of all symbols in the obarray are the possible matches.
  4041.  
  4042. ALIST can also be a function to do the completion itself.
  4043. It receives three arguments: the values STRING, PREDICATE and nil.
  4044. Whatever it returns becomes the value of `try-completion'.
  4045.  
  4046. If optional third argument PREDICATE is non-nil,
  4047. it is used to test each possible match.
  4048. The match is a candidate only if PREDICATE returns non-nil.
  4049. The argument given to PREDICATE is the alist element or the symbol from the obarray.
  4050.  
  4051. arguments:(string alist &optional pred)
  4052. Fall-completions
  4053. Search for partial matches to STRING in ALIST.
  4054. Each car of each element of ALIST is tested to see if it begins with STRING.
  4055. The value is a list of all the strings from ALIST that match.
  4056. ALIST can be an obarray instead of an alist.
  4057. Then the print names of all symbols in the obarray are the possible matches.
  4058.  
  4059. ALIST can also be a function to do the completion itself.
  4060. It receives three arguments: the values STRING, PREDICATE and t.
  4061. Whatever it returns becomes the value of `all-completions'.
  4062.  
  4063. If optional third argument PREDICATE is non-nil,
  4064. it is used to test each possible match.
  4065. The match is a candidate only if PREDICATE returns non-nil.
  4066. The argument given to PREDICATE is the alist element or
  4067. the symbol from the obarray.
  4068.  
  4069. arguments:(string alist &optional pred)
  4070. Vcompletion-ignore-case
  4071. Non-nil means don't consider case significant in completion.Fml-if
  4072. Mocklisp version of `if'.
  4073.  
  4074. arguments: (&rest args)
  4075. Fml-nargs
  4076. Number of arguments to currently executing mocklisp function.
  4077.  
  4078. arguments:()
  4079. Fml-arg
  4080. Argument number N to currently executing mocklisp function.
  4081.  
  4082. arguments:(n &optional prompt)
  4083. Fml-interactive
  4084. True if currently executing mocklisp function was called interactively.
  4085.  
  4086. arguments:()
  4087. Fml-provide-prefix-argument
  4088. Evaluate second argument, using first argument as prefix arg value.
  4089.  
  4090. arguments: (arg1 arg2 &rest args)
  4091. Fml-prefix-argument-loop
  4092.  
  4093.  
  4094. arguments: (&rest args)
  4095. Fml-substr
  4096. Return a substring of STRING, starting at index FROM and of length LENGTH.
  4097. If either FROM or LENGTH is negative, the length of STRING is added to it.
  4098.  
  4099. arguments:(string from to)
  4100. Finsert-string
  4101. Mocklisp-compatibility insert function.
  4102. Like the function `insert' except that any argument that is a number
  4103. is converted into a string by expressing it in decimal.
  4104.  
  4105. arguments: (&rest args)
  4106. Fwrite-char
  4107. Output character CHAR to stream STREAM.
  4108. STREAM defaults to the value of `standard-output' (which see).
  4109.  
  4110. arguments:(ch &optional printcharfun)
  4111. Fwith-output-to-temp-buffer
  4112. Bind `standard-output' to buffer BUFNAME, eval BODY, then show that buffer.
  4113. The buffer is cleared out initially, and marked as unmodified when done.
  4114. All output done by BODY is inserted in that buffer by default.
  4115. The buffer is displayed in another window, but not selected.
  4116. The value of the last form in BODY is returned.
  4117. If BODY does not finish normally, the buffer BUFNAME is not displayed.
  4118.  
  4119. If variable `temp-buffer-show-function' is non-nil, call it at the end
  4120. to get the buffer displayed.  It gets one argument, the buffer to display.
  4121.  
  4122. arguments: (arg1 &rest args)
  4123. Fterpri
  4124. Output a newline to STREAM.
  4125. If STREAM is omitted or nil, the value of `standard-output' is used.
  4126.  
  4127. arguments:(&optional printcharfun)
  4128. Fprin1
  4129. Output the printed representation of OBJECT, any Lisp object.
  4130. Quoting characters are printed when needed to make output that `read'
  4131. can handle, whenever this is possible.
  4132. Output stream is STREAM, or value of `standard-output' (which see).
  4133.  
  4134. arguments:(obj &optional printcharfun)
  4135. Fprin1-to-string
  4136. Return a string containing the printed representation of OBJECT,
  4137. any Lisp object.  Quoting characters are used when needed to make output
  4138. that `read' can handle, whenever this is possible, unless the optional
  4139. second argument NOESCAPE is non-nil.
  4140.  
  4141. arguments:(obj &optional noescape)
  4142. Fprinc
  4143. Output the printed representation of OBJECT, any Lisp object.
  4144. No quoting characters are used; no delimiters are printed around
  4145. the contents of strings.
  4146. Output stream is STREAM, or value of standard-output (which see).
  4147.  
  4148. arguments:(obj &optional printcharfun)
  4149. Fprint
  4150. Output the printed representation of OBJECT, with newlines around it.
  4151. Quoting characters are printed when needed to make output that `read'
  4152. can handle, whenever this is possible.
  4153. Output stream is STREAM, or value of `standard-output' (which see).
  4154.  
  4155. arguments:(obj &optional printcharfun)
  4156. Falternate-debugging-output
  4157. Append CHARACTER to a string.
  4158. You can call print while debugging emacs, and pass it this function
  4159. to make it write to the debugging output.
  4160.  
  4161.  
  4162. arguments:(character)
  4163. Fexternal-debugging-output
  4164. Write CHARACTER to stderr.
  4165. You can call print while debugging emacs, and pass it this function
  4166. to make it write to the debugging output.
  4167.  
  4168.  
  4169. arguments:(character)
  4170. Vstandard-output
  4171. Output stream `print' uses by default for outputting a character.
  4172. This may be any function of one argument.
  4173. It may also be a buffer (output is inserted before point)
  4174. or a marker (output is inserted and the marker is advanced)
  4175. or the symbol t (output appears in the minibuffer line).Vfloat-output-format
  4176. The format descriptor string that lisp uses to print floats.
  4177. This is a %-spec like those accepted by `printf' in C,
  4178. but with some restrictions.  It must start with the two characters `%.'.
  4179. After that comes an integer precision specification,
  4180. and then a letter which controls the format.
  4181. The letters allowed are `e', `f' and `g'.
  4182. Use `e' for exponential notation "DIG.DIGITSeEXPT"
  4183. Use `f' for decimal point notation "DIGITS.DIGITS".
  4184. Use `g' to choose the shorter of those two formats for the number at hand.
  4185. The precision in any of these cases is the number of digits following
  4186. the decimal point.  With `f', a precision of 0 means to omit the
  4187. decimal point.  0 is not allowed with `f' or `g'.
  4188.  
  4189. A value of nil means to use `%.16g'.
  4190.  
  4191. Regardless of the value of `float-output-format', a floating point number
  4192. will never be printed in such a way that it is ambiguous with an integer;
  4193. that is, a floating-point number will always be printed with a decimal
  4194. point and/or an exponent, even if the digits following the decimal point
  4195. are all zero.  This is to preserve read-equivalence.Vprint-length
  4196. Maximum length of list to print before abbreviating.A value of nil means no limit.Vprint-level
  4197. Maximum depth of list nesting to print before abbreviating.A value of nil means no limit.Vprint-escape-newlines
  4198. Non-nil means print newlines in strings as backslash-n.Vprint-readably
  4199. If non-nil, then all objects will be printed in a readable form.
  4200. If an object has no readable representation, then an error is signalled.
  4201. When this is true, compiled-function objects will be written in #[...] form
  4202. instead of in #<byte-code [...]> form.
  4203. Do not SET this variable; bind it instead.Vprint-gensym
  4204. If non-nil, then uninterned symbols (those made with `make-symbol'
  4205. instead of `intern') will be preceeded by "#:", which tells the reader to
  4206. create a new symbol instead of interning.  Beware: the #: syntax creates a
  4207. new symbol each time it is seen, so if you print an object which contains
  4208. two pointers to the same uninterned symbol, `read' will not duplicate that
  4209. structure.Fprocessp
  4210. Return t if OBJECT is a process.
  4211.  
  4212. arguments:(obj)
  4213. Fget-process
  4214. Return the process named NAME, or nil if there is none.
  4215.  
  4216. arguments:(name)
  4217. Fget-buffer-process
  4218. Return the (or, a) process associated with BUFFER.
  4219. BUFFER may be a buffer or the name of one.
  4220.  
  4221. arguments:(name)
  4222. Fdelete-process
  4223. Delete PROCESS: kill it and forget about it immediately.
  4224. PROCESS may be a process or the name of one, or a buffer name.
  4225.  
  4226. arguments:(proc)
  4227. Fprocess-status
  4228. Return the status of PROCESS: a symbol, one of these:
  4229. run  -- for a process that is running.
  4230. stop -- for a process stopped but continuable.
  4231. exit -- for a process that has exited.
  4232. signal -- for a process that has got a fatal signal.
  4233. open -- for a network stream connection that is open.
  4234. closed -- for a network stream connection that is closed.
  4235. nil -- if arg is a process name and no such process exists.
  4236.  
  4237. arguments:(proc)
  4238. Fprocess-exit-status
  4239. Return the exit status of PROCESS or the signal number that killed it.
  4240. If PROCESS has not yet exited or died, return 0.
  4241. If PROCESS is a net connection that was closed remotely, return 256.
  4242.  
  4243. arguments:(proc)
  4244. Fprocess-id
  4245. Return the process id of PROCESS.
  4246. This is the pid of the Unix process which PROCESS uses or talks to.
  4247. For a network connection, this value is nil.
  4248.  
  4249. arguments:(proc)
  4250. Fprocess-name
  4251. Return the name of PROCESS, as a string.
  4252. This is the name of the program invoked in PROCESS,
  4253. possibly modified to make it unique among process names.
  4254.  
  4255. arguments:(proc)
  4256. Fprocess-command
  4257. Return the command that was executed to start PROCESS.
  4258. This is a list of strings, the first string being the program executed
  4259. and the rest of the strings being the arguments given to it.
  4260. For a non-child channel, this is nil.
  4261.  
  4262. arguments:(proc)
  4263. Fset-process-buffer
  4264. Set buffer associated with PROCESS to BUFFER (a buffer, or nil).
  4265.  
  4266. arguments:(proc buffer)
  4267. Fprocess-buffer
  4268. Return the buffer PROCESS is associated with.
  4269. Output from PROCESS is inserted in this buffer
  4270. unless PROCESS has a filter.
  4271.  
  4272. arguments:(proc)
  4273. Fprocess-mark
  4274. Return the marker for the end of the last output from PROCESS.
  4275.  
  4276. arguments:(proc)
  4277. Fset-process-filter
  4278. Give PROCESS the filter function FILTER; nil means no filter.
  4279. When a process has a filter, each time it does output
  4280. the entire string of output is passed to the filter.
  4281. The filter gets two arguments: the process and the string of output.
  4282. If the process has a filter, its buffer is not used for output.
  4283.  
  4284. arguments:(proc filter)
  4285. Fprocess-filter
  4286. Returns the filter function of PROCESS; nil if none.
  4287. See `set-process-filter' for more info on filter functions.
  4288.  
  4289. arguments:(proc)
  4290. Fset-process-sentinel
  4291. Give PROCESS the sentinel SENTINEL; nil for none.
  4292. The sentinel is called as a function when the process changes state.
  4293. It gets two arguments: the process, and a string describing the change.
  4294.  
  4295. arguments:(proc sentinel)
  4296. Fprocess-sentinel
  4297. Return the sentinel of PROCESS; nil if none.
  4298. See `set-process-sentinel' for more info on sentinels.
  4299.  
  4300. arguments:(proc)
  4301. Fprocess-kill-without-query
  4302. Say no query needed if PROCESS is running when Emacs is exited.
  4303. Optional second argument if non-nil says to require a query.
  4304. Value is t if a query was formerly required.
  4305.  
  4306. arguments:(proc &optional value)
  4307. Fprocess-kill-without-query-p
  4308. Return t or nil, depending on whether or not PROCESS will be killed
  4309. without query.
  4310.  
  4311. arguments:(proc)
  4312. Flist-processes
  4313. Display a list of all processes.
  4314. (Any processes listed as Exited or Signaled are actually eliminated
  4315. after the listing is made.)
  4316.  
  4317. arguments:()
  4318. Fprocess-list
  4319. Return a list of all processes.
  4320.  
  4321. arguments:()
  4322. Fstart-process
  4323. Start a program in a subprocess.  Return the process object for it.
  4324. Args are NAME BUFFER PROGRAM &rest PROGRAM-ARGS
  4325. NAME is name for process.  It is modified if necessary to make it unique.
  4326. BUFFER is the buffer or (buffer-name) to associate with the process.
  4327.  Process output goes at end of that buffer, unless you specify
  4328.  an output stream or filter function to handle the output.
  4329.  BUFFER may be also nil, meaning that this process is not associated
  4330.  with any buffer
  4331. Third arg is program file name.  It is searched for as in the shell.
  4332. Remaining arguments are strings to give program as arguments.
  4333.  
  4334. arguments: (arg1 arg2 arg3 &rest args)
  4335. Fopen-network-stream
  4336. Open a TCP connection for a service to a host.
  4337. Returns a subprocess-object to represent the connection.
  4338. Input and output work as for subprocesses; `delete-process' closes it.
  4339. Args are NAME BUFFER HOST SERVICE.
  4340. NAME is name for process.  It is modified if necessary to make it unique.
  4341. BUFFER is the buffer (or buffer-name) to associate with the process.
  4342.  Process output goes at end of that buffer, unless you specify
  4343.  an output stream or filter function to handle the output.
  4344.  BUFFER may be also nil, meaning that this process is not associated
  4345.  with any buffer
  4346. Third arg is name of the host to connect to.
  4347. Fourth arg SERVICE is name of the service desired, or an integer
  4348.  specifying a port number to connect to.
  4349.  
  4350. arguments:(name buffer host service)
  4351. Fwaiting-for-user-input-p
  4352. Returns non-NIL if emacs is waiting for input from the user.
  4353. This is intended for use by asynchronous process output filters and sentinels.
  4354.  
  4355. arguments:()
  4356. Fprocess-send-region
  4357. Send current contents of region as input to PROCESS.
  4358. PROCESS may be a process name or an actual process.
  4359. Called from program, takes three arguments, PROCESS, START and END.
  4360. If the region is more than 500 characters long,
  4361. it is sent in several bunches.  This may happen even for shorter regions.
  4362. Output from processes can arrive in between bunches.
  4363.  
  4364. arguments:(process start end)
  4365. Fprocess-send-string
  4366. Send PROCESS the contents of STRING as input.
  4367. PROCESS may be a process name or an actual process.
  4368. If STRING is more than 500 characters long,
  4369. it is sent in several bunches.  This may happen even for shorter strings.
  4370. Output from processes can arrive in between bunches.
  4371.  
  4372. arguments:(process string)
  4373. Finterrupt-process
  4374. Interrupt process PROCESS.  May be process or name of one.
  4375. Nil or no arg means current buffer's process.
  4376. Second arg CURRENT-GROUP non-nil means send signal to
  4377. the current process-group of the process's controlling terminal
  4378. rather than to the process's own process group.
  4379. If the process is a shell, this means interrupt current subjob
  4380. rather than the shell.
  4381.  
  4382. arguments:(&optional process current_group)
  4383. Fkill-process
  4384. Kill process PROCESS.  May be process or name of one.
  4385. See function `interrupt-process' for more details on usage.
  4386.  
  4387. arguments:(&optional process current_group)
  4388. Fquit-process
  4389. Send QUIT signal to process PROCESS.  May be process or name of one.
  4390. See function `interrupt-process' for more details on usage.
  4391.  
  4392. arguments:(&optional process current_group)
  4393. Fstop-process
  4394. Stop process PROCESS.  May be process or name of one.
  4395. See function `interrupt-process' for more details on usage.
  4396.  
  4397. arguments:(&optional process current_group)
  4398. Fcontinue-process
  4399. Continue process PROCESS.  May be process or name of one.
  4400. See function `interrupt-process' for more details on usage.
  4401.  
  4402. arguments:(&optional process current_group)
  4403. Fsignal-process
  4404. Send the process with number PID the signal with code CODE.
  4405. Both PID and CODE are integers.
  4406.  
  4407. arguments:(pid sig)
  4408. Fprocess-send-eof
  4409. Make PROCESS see end-of-file in its input.
  4410. Eof comes after any text already sent to it.
  4411. nil or no arg means current buffer's process.
  4412.  
  4413. arguments:(&optional process)
  4414. Fprocess-connection
  4415. Return the connection type of `PROCESS'.  This can be nil (pipe),
  4416. t or pty (pty) or stream (socket connection).
  4417.  
  4418. arguments:(&optional process)
  4419. Vdelete-exited-processes
  4420. *Non-nil means delete processes immediately when they exit.
  4421. nil means don't delete them until `list-processes' is run.Vprocess-connection-type
  4422. Control type of device used to communicate with subprocesses.
  4423. Values are nil to use a pipe, and t or 'pty for a pty.  Note that if
  4424. pty's are not available, this variable will be ignored. The value takes
  4425. effect when `start-process' is called.Fscreenp
  4426. Return non-nil if OBJECT is a screen.
  4427. Value is t for a termcap screen (a character-only terminal),
  4428. `x' for an Emacs screen that is really an X window.
  4429.  
  4430. arguments:(screen)
  4431. Fselect-screen
  4432. Select the screen S.
  4433. S's selected window becomes the selected window.
  4434.  
  4435. arguments:(screen)
  4436. Fselected-screen
  4437. Return the screen that is now selected.
  4438.  
  4439. arguments:()
  4440. Fwindow-screen
  4441. Return the screen that window WINDOW is on.
  4442.  
  4443. arguments:(window)
  4444. Fscreen-root-window
  4445. Returns the root-window of SCREEN.
  4446.  
  4447. arguments:(&optional screen)
  4448. Fscreen-selected-window
  4449. Return the selected window of screen SCREEN.
  4450.  
  4451. arguments:(&optional screen)
  4452. Fscreen-list
  4453. Return a list of all screens.
  4454.  
  4455. arguments:()
  4456. Fnext-screen
  4457. Return the next screen in the screen list after SCREEN.
  4458. If MINISCREEN is non-nil, include the global-minibuffer-screen if it
  4459. has its own screen.
  4460. If VISIBLE-ONLY-P is non-nil, then cycle through the visible screens,
  4461. instead of all screens.
  4462.  
  4463. arguments:(&optional screen miniscreen visible_only_p)
  4464. Fprevious-screen
  4465. Return the previous screen in the screen list after SCREEN.
  4466. If MINISCREEN is non-nil, include the global-minibuffer-screen if it
  4467. has its own screen.
  4468. If VISIBLE-ONLY-P is non-nil, then cycle through the visible screens,
  4469. instead of all screens.
  4470.  
  4471. arguments:(&optional screen miniscreen visible_only_p)
  4472. Fdelete-screen
  4473. Delete SCREEN, permanently eliminating it from use.
  4474. Default is current screen.
  4475.  
  4476. arguments:(&optional screen)
  4477. Fread-mouse-position
  4478. Return a cons (x . y) which represents the position of the mouse.
  4479.  
  4480. arguments:(screen)
  4481. Fset-mouse-position
  4482. Move the mouse pointer to the center of character cell (X,Y) in SCREEN.
  4483.  
  4484. arguments:(screen x y)
  4485. Fscreen-configuration
  4486. Return object describing current screen configuration.
  4487. The screen configuration is the current mouse position and selected screen.
  4488. This object can be given to `restore-screen-configuration'
  4489. to restore this screen configuration.
  4490.  
  4491. arguments:()
  4492. Frestore-screen-configuration
  4493. Restores screen configuration CONFIGURATION.
  4494.  
  4495. arguments:(config)
  4496. Fmake-screen-visible
  4497. Make the screen SCREEN visible (assuming it is an X-window).
  4498. Also raises the screen so that nothing obscures it.
  4499.  
  4500. arguments:(screen)
  4501. Fmake-screen-invisible
  4502. Unconditionally removes screen from the display (assuming it is an X-window).
  4503. If what you want to do is iconify the screen (if the window manager uses
  4504. icons) then you should call `iconify-screen' instead.
  4505.  
  4506. arguments:(screen)
  4507. Ficonify-screen
  4508. Make the screen SCREEN into an icon, if the window manager supports icons.
  4509.  
  4510. arguments:(screen)
  4511. Fdeiconify-screen
  4512. Open (de-iconify) the iconified screen SCREEN.
  4513.  
  4514. arguments:(screen)
  4515. Fscreen-visible-p
  4516. Return t if SCREEN is now "visible" (actually in use for display).
  4517. A screen that is not "visible" is not updated and, if it works through
  4518. a window system, it may not show at all.
  4519. Return the symbol `icon' if window is visible only as an icon.
  4520.  
  4521. arguments:(screen)
  4522. Fvisible-screen-list
  4523. Return a list of all screens now "visible" (being updated).
  4524.  
  4525. arguments:()
  4526. Fscreen-parameters
  4527. Return the parameters-alist of screen SCREEN.
  4528. It is a list of elements of the form (PARM . VALUE), where PARM is a symbol.
  4529. The meaningful PARMs depend on the kind of screen.
  4530.  
  4531. arguments:(&optional screen)
  4532. Fmodify-screen-parameters
  4533. Modify the parameters of screen SCREEN according to ALIST.
  4534. ALIST is an alist of parameters to change and their new values.
  4535. Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol.
  4536. The meaningful PARMs depend on the kind of screen; undefined PARMs are ignored.
  4537.  
  4538. arguments:(screen alist)
  4539. Fscreen-height
  4540. Return number of lines available for display on SCREEN.
  4541.  
  4542. arguments:(&optional screen)
  4543. Fscreen-width
  4544. Return number of columns available for display on SCREEN.
  4545.  
  4546. arguments:(&optional screen)
  4547. Fscreen-name
  4548. Returns the name of SCREEN (defaulting to the selected screen).
  4549. This is not the same as the `title' of the screen.
  4550.  
  4551. arguments:(&optional screen)
  4552. Fscreen-totally-visible-p
  4553. Return T if screen is not obscured by any other X windows, NIL otherwise
  4554.  
  4555. arguments:(&optional screen)
  4556. Fset-screen-height
  4557. Specify that the screen SCREEN has LINES lines.
  4558. Optional third arg non-nil means that redisplay should use LINES lines
  4559. but that the idea of the actual height of the screen should not be changed.
  4560.  
  4561. arguments:(screen rows &optional pretend)
  4562. Fset-screen-width
  4563. Specify that the screen SCREEN has COLS columns.
  4564. Optional third arg non-nil means that redisplay should use COLS columns
  4565. but that the idea of the actual width of the screen should not be changed.
  4566.  
  4567. arguments:(screen cols &optional pretend)
  4568. Fset-screen-size
  4569. Sets size of SCREEN to COLS by ROWS.
  4570. Optional fourth arg non-nil means that redisplay should use COLS by ROWS
  4571. but that the idea oft eh acrual size of the screen should not be changed.
  4572.  
  4573. arguments:(screen cols rows &optional pretend)
  4574. Fset-screen-position
  4575. Sets position of SCREEN in pixels to XOFFSET by YOFFSET.
  4576.  
  4577. arguments:(screen xoffset yoffset)
  4578. Fraise-screen
  4579. Make the window of SCREEN be the uppermost one (fully visible).
  4580.  
  4581. arguments:(screen)
  4582. Flower-screen
  4583. Make the window of SCREEN be the bottommost one.
  4584.  
  4585. arguments:(screen)
  4586. Fcoordinates-in-window-p
  4587. Return non-nil if COORDINATES are in WINDOW.
  4588. COORDINATES is a cons of the form (X Y), X and Y being screen-relative.
  4589. If COORDINATES are in the text portion of WINDOW, the coordinates relative
  4590. to the window are returned.  If they are in the modeline of WINDOW, t is
  4591. returned.
  4592.  
  4593. arguments:(coordinates window)
  4594. Flocate-window-from-coordinates
  4595. Return window on SCREEN containing position COORDINATES.
  4596. COORDINATES is a list (SCREEN-X SCREEN-Y) of coordinates
  4597. which are relative to 0,0 at the top left corner of the screen.
  4598.  
  4599. arguments:(screen coordinates)
  4600. Vterminal-screen
  4601. The initial screen-object, which represents Emacs's stdout.Vglobal-minibuffer-screen
  4602. A screen-object holding the default minibuffer for minibufferless screens.
  4603. When you create a minibufferless screen, by default it will use the
  4604. minibuffer of this screen.  It is up to you to create a suitable screen
  4605. and store it in this variable.Vallow-deletion-of-last-visible-screen
  4606. *If nil, the last visible screen may not be deleted by `delete-window'
  4607. You can never delete the last screen, but setting this to t will allow you
  4608. to delete the last non-iconified screen.Vcreate-screen-hook
  4609. Function or functions of one argument, called with each newly-created screen.Vmouse-enter-screen-hook
  4610. Function or functions to call when mouse enters a screen.  One arg, the screen.
  4611. Be careful not to make assumptions about the window manger's focus model.
  4612. In most cases, the `deselect-screen-hook' is more appropriate.Vmouse-leave-screen-hook
  4613. Function or functions to call when mouse leaves screen.  One arg, the screen.
  4614. Be careful not to make assumptions about the window manger's focus model.
  4615. In most cases, the `select-screen-hook' is more appropriate.Vmap-screen-hook
  4616. Function or functions to call when screen is mapped.
  4617. One arg, the screen.Vunmap-screen-hook
  4618. Function or functions to call when screen is unmapped.
  4619. One arg, the screen.Vmouse-motion-handler
  4620. Handler for motion events.  One arg, the event.
  4621. For most applications, you should use `mode-motion-hook' instead of this.Vmouse-grabbed-buffer
  4622. A buffer which should be consulted first for all mouse activity.
  4623. When a mouse-clicked it processed, it will first be looked up in the
  4624. local-map of this buffer, and then through the normal mechanism if there
  4625. is no binding for that click.  This buffer's value of `mode-motion-hook'
  4626. will be consulted instead of the `mode-motion-hook' of the buffer of the
  4627. window under the mouse.  You should *bind* this, not set it.Flooking-at
  4628. t if text after point matches regular expression PAT.
  4629.  
  4630. arguments:(string)
  4631. Fstring-match
  4632. Return index of start of first match for REGEXP in STRING, or nil.
  4633. If third arg START is non-nil, start search at that index in STRING.
  4634. For index of first char beyond the match, do (match-end 0).
  4635. match-end and match-beginning also give indices of substrings
  4636. matched by parenthesis constructs in the pattern.
  4637.  
  4638. arguments:(regexp string &optional start)
  4639. Fskip-chars-forward
  4640. Move point forward, stopping before a char not in CHARS, or at position LIM.
  4641. CHARS is like the inside of a [...] in a regular expression
  4642. except that ] is never special and \ quotes ^, - or \.
  4643. Thus, with arg "a-zA-Z", this skips letters stopping before first nonletter.
  4644. With arg "^a-zA-Z", skips nonletters stopping before first letter.
  4645.  
  4646. arguments:(string &optional lim)
  4647. Fskip-chars-backward
  4648. Move point backward, stopping after a char not in CHARS, or at position LIM.
  4649. See skip-chars-forward for details.
  4650.  
  4651. arguments:(string &optional lim)
  4652. Fsearch-backward
  4653. Search backward from point for STRING.
  4654. Set point to the beginning of the occurrence found, and return t.
  4655. An optional second argument bounds the search; it is a buffer position.
  4656. The match found must not extend before that position.
  4657. Optional third argument, if t, means if fail just return nil (no error).
  4658.  If not nil and not t, position at limit of search and return nil.
  4659. Optional fourth argument is repeat count--search for successive occurrences.
  4660.  
  4661. arguments:(string &optional bound noerror count)
  4662. Fsearch-forward
  4663. Search forward from point for STRING.
  4664. Set point to the end of the occurrence found, and return t.
  4665. An optional second argument bounds the search; it is a buffer position.
  4666. The match found must not extend after that position.
  4667. Optional third argument, if t, means if fail just return nil (no error).
  4668.   If not nil and not t, move to limit of search and return nil.
  4669. Optional fourth argument is repeat count--search for successive occurrences.
  4670.  
  4671. arguments:(string &optional bound noerror count)
  4672. Fword-search-backward
  4673. Search backward from point for STRING, ignoring differences in punctuation.
  4674. Set point to the beginning of the occurrence found, and return t.
  4675. An optional second argument bounds the search; it is a buffer position.
  4676. The match found must not extend before that position.
  4677. Optional third argument, if t, means if fail just return nil (no error).
  4678.   If not nil and not t, move to limit of search and return nil.
  4679. Optional fourth argument is repeat count--search for successive occurrences.
  4680.  
  4681. arguments:(string &optional bound noerror count)
  4682. Fword-search-forward
  4683. Search forward from point for STRING, ignoring differences in punctuation.
  4684. Set point to the end of the occurrence found, and return t.
  4685. An optional second argument bounds the search; it is a buffer position.
  4686. The match found must not extend after that position.
  4687. Optional third argument, if t, means if fail just return nil (no error).
  4688.   If not nil and not t, move to limit of search and return nil.
  4689. Optional fourth argument is repeat count--search for successive occurrences.
  4690.  
  4691. arguments:(string &optional bound noerror count)
  4692. Fre-search-backward
  4693. Search backward from point for match for regular expression REGEXP.
  4694. Set point to the beginning of the match, and return t.
  4695. The match found is the one starting last in the buffer
  4696. and yet ending before the place the origin of the search.
  4697. An optional second argument bounds the search; it is a buffer position.
  4698. The match found must start at or after that position.
  4699. Optional third argument, if t, means if fail just return nil (no error).
  4700.   If not nil and not t, move to limit of search and return nil.
  4701. Optional fourth argument is repeat count--search for successive occurrences.
  4702. See also the functions match-beginning and match-end and replace-match.
  4703.  
  4704. arguments:(string &optional bound noerror count)
  4705. Fre-search-forward
  4706. Search forward from point for regular expression REGEXP.
  4707. Set point to the end of the occurrence found, and return t.
  4708. An optional second argument bounds the search; it is a buffer position.
  4709. The match found must not extend after that position.
  4710. Optional third argument, if t, means if fail just return nil (no error).
  4711.   If not nil and not t, move to limit of search and return nil.
  4712. Optional fourth argument is repeat count--search for successive occurrences.
  4713. See also the functions match-beginning and match-end and replace-match.
  4714.  
  4715. arguments:(string &optional bound noerror count)
  4716. Freplace-match
  4717. Replace text matched by last search with NEWTEXT.
  4718. If second arg FIXEDCASE is non-nil, do not alter case of replacement text.
  4719. Otherwise convert to all caps or cap initials, like replaced text.
  4720. If third arg LITERAL is non-nil, insert NEWTEXT literally.
  4721. Otherwise treat \ as special:
  4722.   \& in NEWTEXT means substitute original matched text,
  4723.   \N means substitute match for \(...\) number N,
  4724.   \\ means insert one \.
  4725. Leaves point at end of replacement text.
  4726.  
  4727. arguments:(string &optional fixedcase literal)
  4728. Fmatch-beginning
  4729. Return the character number of start of text matched by last regexp searched for.
  4730. ARG, a number, specifies which parenthesized expression in the last regexp.
  4731.  Value is nil if ARGth pair didn't match, or there were less than ARG pairs.
  4732. Zero means the entire text matched by the whole regexp.
  4733.  
  4734. arguments:(num)
  4735. Fmatch-end
  4736. Return the character number of end of text matched by last regexp searched for.
  4737. ARG, a number, specifies which parenthesized expression in the last regexp.
  4738.  Value is nil if ARGth pair didn't match, or there were less than ARG pairs.
  4739. Zero means the entire text matched by the whole regexp.
  4740.  
  4741. arguments:(num)
  4742. Fmatch-data
  4743. Return list containing all info on what the last search matched.
  4744. Element 2N is (match-beginning N); element 2N + 1 is (match-end N).
  4745. All the elements are normally markers, or nil if the Nth pair didn't match.
  4746. 0 is also possible, when matching was done with `string-match',
  4747. if a match began at index 0 in the string.
  4748.  
  4749. arguments:()
  4750. Fstore-match-data
  4751. Set internal data on last search match from elements of LIST.
  4752. LIST should have been created by calling match-data previously.
  4753.  
  4754. arguments:(list)
  4755. Fregexp-quote
  4756. Return a regexp string which matches exactly STRING and nothing else.
  4757.  
  4758. arguments:(str)
  4759. Fsyntax-table-p
  4760. Return t if ARG is a syntax table.
  4761. Any vector of 256 elements will do.
  4762.  
  4763. arguments:(obj)
  4764. Fsyntax-table
  4765. Return the current syntax table.
  4766. This is the one specified by the current buffer.
  4767.  
  4768. arguments:()
  4769. Fstandard-syntax-table
  4770. Return the standard syntax table.
  4771. This is the one used for new buffers.
  4772.  
  4773. arguments:()
  4774. Fcopy-syntax-table
  4775. Construct a new syntax table and return it.
  4776. It is a copy of the TABLE, which defaults to the standard syntax table.
  4777.  
  4778. arguments:(&optional table)
  4779. Fset-syntax-table
  4780. Select a new syntax table for the current buffer.
  4781. One argument, a syntax table.
  4782.  
  4783. arguments:(table)
  4784. Fchar-syntax
  4785. Return the syntax code of CHAR, described by a character.
  4786. For example, if CHAR is a word constituent, the character `?w' is returned.
  4787. The characters that correspond to various syntax codes
  4788. are listed in the documentation of `modify-syntax-entry'.
  4789.  
  4790. arguments:(ch)
  4791. Fmodify-syntax-entry
  4792. Set syntax for character CHAR according to string S.
  4793. The syntax is changed only for table TABLE, which defaults to
  4794.  the current buffer's syntax table.
  4795. The first character of S should be one of the following:
  4796.   Space    whitespace syntax.    w   word constituent.
  4797.   _        symbol constituent.   .   punctuation.
  4798.   (        open-parenthesis.     )   close-parenthesis.
  4799.   "        string quote.         \   character-quote.
  4800.   $        paired delimiter.     '   expression quote or prefix operator.
  4801.   <       comment starter.     >   comment ender.
  4802. Only single-character comment start and end sequences are represented thus.
  4803. Two-character sequences are represented as described below.
  4804. The second character of S is the matching parenthesis,
  4805.  used only if the first character is `(' or `)'.
  4806. Any additional characters are flags.
  4807. Defined flags are the characters 1, 2, 3, 4, 5, 6, 7, 8, p, a, and b.
  4808.  1 means C is the first of a two-char comment start sequence of style a.
  4809.  2 means C is the second character of such a sequence.
  4810.  3 means C is the first of a two-char comment end sequence of style a.
  4811.  4 means C is the second character of such a sequence.
  4812.  5 means C is the first of a two-char comment start sequence of style b.
  4813.  6 means C is the second character of such a sequence.
  4814.  7 means C is the first of a two-char comment end sequence of style b.
  4815.  8 means C is the second character of such a sequence.
  4816.  p means C is a prefix character for `backward-prefix-chars';
  4817.    such characters are treated as whitespace when they occur
  4818.    between expressions.
  4819.  a means C is comment starter or comment ender for comment style a (default)
  4820.  b means C is comment starter or comment ender for comment style b.
  4821.  
  4822. arguments:(c newentry syntax_table)
  4823. Fdescribe-syntax
  4824. Describe the syntax specifications in the syntax table.
  4825. The descriptions are inserted in a buffer, which is then displayed.
  4826.  
  4827. arguments:()
  4828. Fforward-word
  4829. Move point forward ARG words (backward if ARG is negative).
  4830. Normally returns t.
  4831. If an edge of the buffer is reached, point is left there
  4832. and nil is returned.
  4833.  
  4834. arguments:(count)
  4835. Fbackward-syntactic-ws
  4836. Move point backward over all syntactic whitespace.
  4837. This includes all chars with "whitespace" syntax (Space), and, if
  4838. parse-sexp-ignore-comments is non-nil, all characters within comments.
  4839.  
  4840. arguments:()
  4841. Fforward-syntactic-ws
  4842. Move point forward over all syntactic whitespace.
  4843. This includes all chars with "whitespace" syntax (Space), and, if
  4844. parse-sexp-ignore-comments is non-nil, all characters within comments.
  4845.  
  4846. arguments:()
  4847. Fscan-lists
  4848. Scan from character number FROM by COUNT lists.
  4849. Returns the character number of the position thus found.
  4850.  
  4851. If DEPTH is nonzero, paren depth begins counting from that value,
  4852. only places where the depth in parentheses becomes zero
  4853. are candidates for stopping; COUNT such places are counted.
  4854. Thus, a positive value for DEPTH means go out levels.
  4855.  
  4856. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  4857.  
  4858. If the beginning or end of (the accessible part of) the buffer is reached
  4859. and the depth is wrong, an error is signaled.
  4860. If the depth is right but the count is not used up, nil is returned.
  4861.  
  4862. arguments:(from count depth)
  4863. Fscan-sexps
  4864. Scan from character number FROM by COUNT balanced expressions.
  4865. If COUNT is negative, scan backwards.
  4866. Returns the character number of the position thus found.
  4867.  
  4868. Comments are ignored if `parse-sexp-ignore-comments' is non-nil.
  4869.  
  4870. If the beginning or end of (the accessible part of) the buffer is reached
  4871. in the middle of a parenthetical grouping, an error is signaled.
  4872. If the beginning or end is reached between groupings
  4873. but before count is used up, nil is returned.
  4874.  
  4875. arguments:(from count)
  4876. Fbackward-prefix-chars
  4877. Move point backward over any number of chars with prefix syntax.
  4878. This includes chars with "quote" or "prefix" syntax (' or p).
  4879.  
  4880. arguments:()
  4881. Fparse-partial-sexp
  4882. Parse Lisp syntax starting at FROM until TO; return status of parse at TO.
  4883. Parsing stops at TO or when certain criteria are met;
  4884.  point is set to where parsing stops.
  4885. If fifth arg STATE is omitted or nil,
  4886.  parsing assumes that FROM is the beginning of a function.
  4887. Value is a list of eight elements describing final state of parsing:
  4888.  1. depth in parens.
  4889.  2. character address of start of innermost containing list; nil if none.
  4890.  3. character address of start of last complete sexp terminated.
  4891.  4. non-nil if inside a string.
  4892.     (it is the character that will terminate the string.)
  4893.  5. t if inside a comment.
  4894.  6. t if following a quote character.
  4895.  7. the minimum paren-depth encountered during this scan.
  4896.  8. nil if in comment style a, or not in a comment; t if in comment style b
  4897. If third arg TARGETDEPTH is non-nil, parsing stops if the depth
  4898. in parentheses becomes equal to TARGETDEPTH.
  4899. Fourth arg STOPBEFORE non-nil means stop when come to
  4900.  any character that starts a sexp.
  4901. Fifth arg STATE is a seven-list like what this function returns.
  4902. It is used to initialize the state of the parse.
  4903.  
  4904. arguments:(from to &optional targetdepth stopbefore oldstate)
  4905. Vparse-sexp-ignore-comments
  4906. Non-nil means `forward-sexp', etc., should treat comments as whitespace.Vwords-include-escapes
  4907. Non-nil means `forward-word', etc., should treat escape chars part of words.Fundo-boundary
  4908. Mark a boundary between units of undo.
  4909. An undo command will stop at this point,
  4910. but another undo command will undo to the previous boundary.
  4911.  
  4912. arguments:()
  4913. Fprimitive-undo
  4914. Undo N records from the front of the list LIST.
  4915. Return what remains of the list.
  4916.  
  4917. arguments:(count list)
  4918. V   inside-undo
  4919. internal variable used to control undoFwindowp
  4920. Returns t if OBJ is a window.
  4921.  
  4922. arguments:(obj)
  4923. Fselected-window
  4924. Return the window that the cursor now appears in and commands apply to.
  4925.  
  4926. arguments:()
  4927. Fminibuffer-window
  4928. Return the window used now for minibuffers.
  4929.  
  4930. arguments:()
  4931. Fwindow-minibuffer-p
  4932. Returns non-nil if WINDOW is a minibuffer window.
  4933.  
  4934. arguments:(window)
  4935. Fpos-visible-in-window-p
  4936. Return t if position POS is currently on the screen in WINDOW.
  4937. Returns nil if that position is scrolled vertically out of view.
  4938. POS defaults to point; WINDOW, to the selected window.
  4939.  
  4940. arguments:(&optional pos window)
  4941. Fwindow-buffer
  4942. Return the buffer that WINDOW is displaying.
  4943.  
  4944. arguments:(&optional window)
  4945. Fwindow-height
  4946. Return the number of lines in WINDOW (including its mode line).
  4947.  
  4948. arguments:(&optional window)
  4949. Fwindow-width
  4950. Return the number of columns in WINDOW.
  4951.  
  4952. arguments:(&optional window)
  4953. Fwindow-hscroll
  4954. Return the number of columns by which WINDOW is scrolled from left margin.
  4955.  
  4956. arguments:(&optional window)
  4957. Fset-window-hscroll
  4958. Set number of columns WINDOW is scrolled from left margin to NCOL.
  4959. NCOL should be zero or positive.
  4960.  
  4961. arguments:(window ncol)
  4962. Fwindow-edges
  4963. Return a list of the edge coordinates of WINDOW.
  4964. (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of screen.
  4965. RIGHT is one more than the rightmost column used by WINDOW,
  4966. and BOTTOM is one more than the bottommost row used by WINDOW
  4967.  and its mode-line.
  4968.  
  4969. arguments:(&optional window)
  4970. Fwindow-point
  4971. Return current value of point in WINDOW.
  4972. For a nonselected window, this is the value point would have
  4973. if that window were selected.
  4974.  
  4975. Note that, when WINDOW is the selected window and its buffer
  4976. is also currently selected, the value returned is the same as (point).
  4977. It would be more strictly correct to return the `top-level' value
  4978. of point, outside of any save-excursion forms.
  4979. But that is hard to define.
  4980.  
  4981. arguments:(&optional window)
  4982. Fwindow-start
  4983. Return position at which display currently starts in WINDOW.
  4984.  
  4985. arguments:(&optional window)
  4986. Fwindow-end
  4987. Return position at which display currently ends in WINDOW.
  4988.  
  4989. arguments:(&optional window)
  4990. Fset-window-point
  4991. Make point value in WINDOW be at position POS in WINDOW's buffer.
  4992.  
  4993. arguments:(window pos)
  4994. Fset-window-start
  4995. Make display in WINDOW start at position POS in WINDOW's buffer.
  4996. Optional third arg NOFORCE non-nil inhibits next redisplay
  4997. from overriding motion of point in order to display at this exact start.
  4998.  
  4999. arguments:(window pos &optional noforce)
  5000. Fwindow-dedicated-p
  5001. Return WINDOW's dedicated object, usually t or nil.
  5002. See also `set-window-buffer-dedicated'.
  5003.  
  5004. arguments:(window)
  5005. Fset-window-buffer-dedicated
  5006. Make WINDOW display BUFFER and be dedicated to that buffer.
  5007. Then Emacs will not automatically change which buffer appears in WINDOW.
  5008. If BUFFER is nil, make WINDOW not be dedicated (but don't change which
  5009. buffer appears in it currently).
  5010.  
  5011. arguments:(window arg)
  5012. Fwindow-display-table
  5013. Return the display-table that WINDOW is using.
  5014.  
  5015. arguments:(&optional window)
  5016. Fset-window-display-table
  5017. Set WINDOW's display-table to TABLE.
  5018.  
  5019. arguments:(window table)
  5020. Fdelete-window
  5021. Remove WINDOW from the display.  Default is selected window.
  5022. If window is the only one on the screen, the screen is destroyed.
  5023.  
  5024. arguments:(&optional window)
  5025. Fnext-window
  5026. Return next window after WINDOW in canonical ordering of windows.
  5027. Optional second arg MINIBUF t means count the minibuffer window
  5028. even if not active.  If MINIBUF is neither t nor nil it means
  5029. not to count the minibuffer even if it is active.
  5030. Optional third arg ALL-SCREENS t means include all windows in all visible
  5031. screens; otherwise cycle within the selected screen, with the exception that
  5032. if a global minibuffer screen is in use, all screens are used.
  5033. Optional fourth argument INVISIBLE-TOO t means also visit invisible screens.
  5034.  
  5035. arguments:(&optional window mini all_screens invisible_too)
  5036. Fprevious-window
  5037. Return previous window before WINDOW in canonical ordering of windows.
  5038. Optional second arg MINIBUF t means count the minibuffer window
  5039. even if not active.  If MINIBUF is neither t nor nil it means
  5040. not to count the minibuffer even if it is active.
  5041. Optional third arg ALL-SCREENS t means include all windows in all visible
  5042. screens; otherwise cycle within the selected screen, with the exception
  5043. that if a global minibuffer screen is in use, all visible screens are used.
  5044. If optional fourth argument INVISIBLE-TOO is t also visit invisible screens.
  5045.  
  5046. arguments:(&optional window mini all_screens invisible_too)
  5047. Fother-window
  5048. Select the ARG'th different window on this screen.
  5049. All windows on current screen are arranged in a cyclic order.
  5050. This command selects the window ARG steps away in that order.
  5051. A negative ARG moves in the opposite order.  If the optional second
  5052. argument ALL_SCREENS is non-nil, cycle through all visible screens.
  5053. If optional third argument INVISIBLE-TOO is t also search invisible screens.
  5054.  
  5055. arguments:(n &optional all_screens invisible_too)
  5056. Fget-lru-window
  5057. Return the window least recently selected or used for display.
  5058. If optional argument SCREENS is non-nil, search only that screen.
  5059.  
  5060. arguments:(&optional screens)
  5061. Fget-largest-window
  5062. Return the window largest in area.  If optional argument SCREENS
  5063. is non-nil, search only that screen.
  5064.  
  5065. arguments:(&optional screens)
  5066. Fget-buffer-window
  5067. Return a window currently displaying BUFFER, or nil if none.
  5068. Only the selected screen is searched; if the optional second argument
  5069. SCREEN is non-nil, then that screen is searched instead.  If SCREEN is t,
  5070. then all visible screens are searched.  If FORCE is t invisible screens
  5071. are searched too.
  5072.  
  5073. arguments:(buffer &optional screen force)
  5074. Fdelete-other-windows
  5075. Make WINDOW (or the selected window) fill its screen.
  5076.  
  5077. arguments:(&optional window)
  5078. Fdelete-windows-on
  5079. Delete all windows showing BUFFER.
  5080.  
  5081. arguments:(buffer)
  5082. Freplace-buffer-in-windows
  5083. Replace BUFFER with some other buffer in all windows showing it.
  5084.  
  5085. arguments:(buffer)
  5086. Fset-window-buffer
  5087. Make WINDOW display BUFFER as its contents.
  5088. BUFFER can be a buffer or buffer name.
  5089.  
  5090. arguments:(window buffer)
  5091. Fselect-window
  5092. Select WINDOW.  Most editing will apply to WINDOW's buffer.
  5093. The main editor command loop selects the buffer of the selected window
  5094. before each command.
  5095.  
  5096. arguments:(window)
  5097. Fdisplay-buffer
  5098. Make BUFFER appear in some window on the current screen, but don't select it.
  5099. BUFFER can be a buffer or a buffer name.
  5100. If BUFFER is shown already in some window in the current screen, just uses
  5101.  that one, unless the window is the selected window and NOT_THIS_WINDOW_P
  5102.  is non-nil.
  5103. If ON_SCREEN is non-nil, display on that screen instead of the current
  5104.  screen (or the dedicated screen).
  5105. If BUFFER has a dedicated screen, display on that screen instead of the
  5106.  current screen, unless ON_SCREEN was specified.
  5107. If pop-up-windows is non-nil, and the buffer is not visible in some window
  5108.  on the target screen, then windows will be split (a new window will be
  5109.  created) if there is room.  Otherwise, the least-recently-used window will
  5110.  be reused.
  5111. Returns the window displaying BUFFER.
  5112.  
  5113. arguments:(buffer &optional not_this_window_p on_screen)
  5114. Fsplit-window
  5115. Split WINDOW, putting SIZE lines in the first of the pair.
  5116. WINDOW defaults to selected one and SIZE to half its size.
  5117. If optional third arg HOR-FLAG is non-nil, split side by side
  5118. and put SIZE columns in the first of the pair.
  5119.  
  5120. arguments:(&optional window chsize horflag)
  5121. Fenlarge-window
  5122. Make current window ARG lines bigger.
  5123. From program, optional second arg non-nil means grow sideways ARG columns.
  5124.  
  5125. arguments:(n &optional side)
  5126. Fshrink-window
  5127. Make current window ARG lines smaller.
  5128. From program, optional second arg non-nil means shrink sideways ARG columns.
  5129.  
  5130. arguments:(n &optional side)
  5131. Fscroll-up
  5132. Scroll text of current window upward ARG lines; or near full screen if no ARG.
  5133. A near full screen is `next-screen-context-lines' less than a full screen.
  5134. When calling from a program, supply a number as argument or nil.
  5135.  
  5136. arguments:(&optional n)
  5137. Fscroll-down
  5138. Scroll text of current window downward ARG lines; or near full screen if no ARG.
  5139. A near full screen is `next-screen-context-lines' less than a full screen.
  5140. When calling from a program, supply a number as argument or nil.
  5141.  
  5142. arguments:(&optional n)
  5143. Fscroll-other-window
  5144. Scroll text of next window upward ARG lines; or near full screen if no ARG.
  5145. The next window is the one below the current one; or the one at the top
  5146. if the current one is at the bottom.
  5147. When calling from a program, supply a number as argument or nil.
  5148.  
  5149. If in the minibuffer, `minibuf-scroll-window' if non-nil
  5150. specifies the window to scroll.
  5151. If `other-window-scroll-buffer' is non-nil, scroll the window
  5152. showing that buffer, popping the buffer up if necessary.
  5153.  
  5154. arguments:(&optional n)
  5155. Fscroll-left
  5156. Scroll selected window display ARG columns left.
  5157. Default for ARG is window width minus 2.
  5158.  
  5159. arguments:(arg)
  5160. Fscroll-right
  5161. Scroll selected window display ARG columns right.
  5162. Default for ARG is window width minus 2.
  5163.  
  5164. arguments:(arg)
  5165. Frecenter
  5166. Center point in window and redisplay screen.  With ARG, put point on line ARG.
  5167. The desired position of point is always relative to the current window.
  5168. Just C-u as prefix means put point in the center of the screen.
  5169. No arg (i.e., it is nil) erases the entire screen and then
  5170. redraws with point in the center.
  5171.  
  5172. arguments:(&optional n)
  5173. Fmove-to-window-line
  5174. Position point relative to window.
  5175. With no argument, position text at center of window.
  5176. An argument specifies screen line; zero means top of window,
  5177. negative means relative to bottom of window.
  5178.  
  5179. arguments:(arg)
  5180. Fset-window-configuration
  5181. Set the configuration of windows and buffers as specified by CONFIGURATION.
  5182. CONFIGURATION must be a value previously returned
  5183. by `current-window-configuration' (which see).
  5184.  
  5185. arguments:(arg)
  5186. Fcurrent-window-configuration
  5187. Return an object representing Emacs' current window configuration.
  5188. This describes the number of windows, their sizes and current buffers,
  5189. and for each displayed buffer, where display starts, and the positions of
  5190. point and mark.  An exception is made for point in the current buffer:
  5191. its value is -not- saved.
  5192.  
  5193. arguments:()
  5194. Fsave-window-excursion
  5195. Execute body, preserving window sizes and contents.
  5196. Restores which buffer appears in which window, where display starts,
  5197. as well as the current buffer.
  5198. Does not restore the value of point in current buffer.
  5199.  
  5200. arguments: (&rest args)
  5201. Vtemp-buffer-show-function
  5202. Non-nil means call as function to display a help buffer.
  5203. Used by `with-output-to-temp-buffer'.Vdisplay-buffer-function
  5204. If non-nil, function to call to handle `display-buffer'.
  5205. It will receive three args, the same args as display-buffer.Vpre-display-buffer-function
  5206. If non-nil, function that will be called from `display-buffer' as the
  5207. first action.  It will receive three args, the same arguments as 
  5208. `display-buffer' -- the buffer, a flag which if non-nil means that the
  5209. currently selected window is not acceptable, and a screen to use (or nil,
  5210. meaning unspecified.)  This function may be used to select an appropriate
  5211. screen for the buffer, for example.  See also the variable
  5212. `display-buffer-function', which may be used to completely replace
  5213. display-buffer.Vminibuffer-scroll-window
  5214. Non-nil means it is the window that C-M-v in minibuffer should scroll.Vother-window-scroll-buffer
  5215. If non-nil, this is a buffer and \[scroll-other-window] should scroll its window.Vpop-up-windows
  5216. *Non-nil means display-buffer should make new windows.Vnext-screen-context-lines
  5217. *Number of lines of continuity when scrolling by screenfuls.Vsplit-height-threshold
  5218. *display-buffer would prefer to split the largest window if this large.
  5219. If there is only one window, it is split regardless of this value.Vwindow-min-height
  5220. *Delete any window less than this tall (including its mode line).Vwindow-min-width
  5221. *Delete any window less than this wide.Fredraw-screen
  5222. Clear screen SCREEN and output again what is supposed to appear on it.
  5223.  
  5224. arguments:(screen)
  5225. Fredraw-display
  5226. Redraw all screens marked as having their images garbled.
  5227.  
  5228. arguments:()
  5229. Fredraw-display
  5230. Clear the screen and output again what is supposed to appear on it.
  5231.  
  5232. arguments:()
  5233. Vglobal-mode-string
  5234. String displayed by mode-line-format's "%m" specification.Voverlay-arrow-position
  5235. Marker for where to display an arrow on top of the buffer text.
  5236. This must be the beginning of a line in order to work.
  5237. See also `overlay-arrow-string'.Voverlay-arrow-string
  5238. String to display as an arrow.  See also `overlay-arrow-position'.Vscroll-step
  5239. *The number of lines to try scrolling a window by when point moves out.
  5240. If that fails to bring point back on screen, point is centered instead.
  5241. If this is zero, point is always centered after it moves off screen.Vtruncate-partial-width-windows
  5242. *Non-nil means truncate lines in all windows less than full screen wide.Vmode-line-inverse-video
  5243. *Non-nil means use inverse video for the mode line.Vscreen-title-format
  5244. Controls the title of the X window corresponding to the selected screen.
  5245. This is the same format as `mode-line-format'.Vscreen-icon-title-format
  5246. Controls the title of the icon corresponding to the selected screen.
  5247. See also the variable `screen-title-format'Fenergize-toggle-psheet
  5248.  
  5249.  
  5250. arguments:()
  5251. Fx-create-screen
  5252. Make a new X window, which is considered a "screen" in Emacs terms.
  5253. Return an Emacs screen object representing the X window.
  5254. ALIST is an alist of screen parameters.
  5255. The value of `x-screen-defaults' is an additional alist
  5256. of default parameters which apply when not overridden by ALIST.
  5257. Optional second argument is the numerical ID of the X window to use for this
  5258. screen (in order to run Emacs on a window created by some other program).
  5259. Since this ID number is an unsigned long, you must pass it as a string.
  5260. It may be a string of decimal numbers, or a string of hex numbers beginning
  5261. with "0x".
  5262.  
  5263. arguments:(parms &optional lisp_window_id)
  5264. Fx-focus-screen
  5265. Obsolete function.  Superceded by select-screen
  5266.  
  5267. arguments:(focus_p &optional screen)
  5268. Fx-show-lineinfo-column
  5269. Make the current emacs screen have a lineinfo column.
  5270.  
  5271. arguments:(&optional screen)
  5272. Fx-hide-lineinfo-column
  5273. Make the given emacs screen not have a lineinfo column.
  5274.  
  5275. arguments:(&optional screen)
  5276. Fx-display-visual-class
  5277. Returns the visual class of the display `screen' is on.
  5278. The returned value will be one of the symbols StaticGray, GrayScale,
  5279. StaticColor, PseudoColor, TrueColor, or DirectColor.
  5280.  
  5281. arguments:(&optional screen)
  5282. Fx-color-display-p
  5283. Returns t if the X display of the given screen supports color.
  5284.  
  5285. arguments:(&optional screen)
  5286. Fx-pixel-width
  5287. Returns the width in pixels of the given screen.
  5288.  
  5289. arguments:(&optional screen)
  5290. Fx-pixel-height
  5291. Returns the height in pixels of the given screen.
  5292.  
  5293. arguments:(&optional screen)
  5294. Fx-display-pixel-width
  5295. Returns the width in pixels of the display `screen' is on.
  5296.  
  5297. arguments:(&optional screen)
  5298. Fx-display-pixel-height
  5299. Returns the height in pixels of the display `screen' is on.
  5300.  
  5301. arguments:(&optional screen)
  5302. Fx-display-planes
  5303. Returns the number of bitplanes of the display `screen' is on.
  5304.  
  5305. arguments:(&optional screen)
  5306. Fx-display-color-cells
  5307. Returns the number of color cells of the display `screen' is on.
  5308.  
  5309. arguments:(&optional screen)
  5310. Fx-server-vendor
  5311. Returns the vendor ID string of the X server `screen' is on.
  5312.  
  5313. arguments:(&optional screen)
  5314. Fx-server-version
  5315. Returns the version numbers of the X server `screen' is on.
  5316. The returned value is a list of three integers: the major and minor
  5317. version numbers of the X Protocol in use, and the vendor-specific release
  5318. number.  See also `x-server-vendor'.
  5319.  
  5320. arguments:(&optional screen)
  5321. Fx-set-screen-icon-pixmap
  5322. Set the icon-pixmap of the given screen.
  5323. This should be the name of a bitmap file, or a bitmap description list
  5324. of the form (width height "bitmap-data").
  5325. If the optional third argument is specified, it is the bitmap to use for
  5326. the icon-pixmap-mask (not all window managers obey this.)
  5327. Warning: when you call this function, the pixmap of the previous icon
  5328. of this screen (if any) is currently not freed.
  5329.  
  5330. arguments:(screen pixmap &optional mask)
  5331. Fx-grab-pointer
  5332. Grab the pointer and restrict it to its current window.  If optional
  5333. SHAPE is non-nil, change the pointer shape to that.  If second optional
  5334. argument MOUSE-ONLY is non-nil, ignore keyboard events during the grab.
  5335.  
  5336. arguments:(&optional shape ignore_keyboard)
  5337. Fx-ungrab-pointer
  5338. Release the pointer.
  5339.  
  5340. arguments:()
  5341. Fx-EnterNotify-internal
  5342. hands off
  5343.  
  5344. arguments:(screen)
  5345. Fx-LeaveNotify-internal
  5346. hands off
  5347.  
  5348. arguments:(screen)
  5349. Fx-FocusIn-internal
  5350. hands off
  5351.  
  5352. arguments:(screen)
  5353. Fx-FocusOut-internal
  5354. hands off
  5355.  
  5356. arguments:(screen)
  5357. Fx-VisibilityNotify-internal
  5358. hands off
  5359.  
  5360. arguments:(screen)
  5361. Fx-non-VisibilityNotify-internal
  5362. hands off
  5363.  
  5364. arguments:(screen)
  5365. Fx-MapNotify-internal
  5366. hands off
  5367.  
  5368. arguments:(screen)
  5369. Fx-UnmapNotify-internal
  5370. hands off
  5371.  
  5372. arguments:(screen)
  5373. Fx-rebind-key
  5374. Rebind X keysym KEYSYM, with MODIFIERS, to generate NEWSTRING.
  5375. KEYSYM is a string which conforms to the X keysym definitions found
  5376. in X11/keysymdef.h, sans the initial XK_. MODIFIERS is nil or a
  5377. list of strings specifying modifier keys such as Control_L, which must
  5378. also be depressed for NEWSTRING to appear.
  5379.  
  5380. arguments:(x_keysym modifiers newstring)
  5381. Fx-rebind-keys
  5382. Rebind KEYCODE to list of strings STRINGS.
  5383. STRINGS should be a list of 16 elements, one for each shift combination.
  5384. nil as element means don't change.
  5385. See the documentation of `x-rebind-key' for more information.
  5386.  
  5387. arguments:(keycode strings)
  5388. Fx-get-resource
  5389. Retrieve an X resource from the resource manager.
  5390. The first arg is the name of the resource to retrieve, such as "font".
  5391. The second arg is the class of the resource to retrieve, like "Font".
  5392. The third arg should be one of the symbols string, integer, or boolean,
  5393. specifying the type of object that the database is searched for.
  5394. The fourth arg is the screen to search for the resources on, defaulting
  5395. to the selected screen.
  5396.  
  5397. The call
  5398.     (x-get-resource "font" "Font" 'string)
  5399.  
  5400. is an interface to the C call
  5401.  
  5402.     XrmGetResource (db, "emacs.this_screen_name.font",
  5403.             "Emacs.EmacsScreen.Font",
  5404.             "String");
  5405.  
  5406. Therefore if you want to retrieve a deeper resource, for example,
  5407. "Emacs.foo.foreground", you need to specify the same number of links
  5408. in the class path:
  5409.     (x-get-resource "foo.foreground" "Thing.Foreground" 'string)
  5410.  
  5411. which is equivalent to 
  5412.  
  5413.     XrmGetResource (db, "emacs.screen_name.foo.foreground",
  5414.             "Emacs.EmacsScreen.Thing.Foreground",
  5415.             "String");
  5416.  
  5417.  
  5418. The returned value of this function is nil if the queried resource is not
  5419. found.  If the third arg is `string', a string is returned, and if it is
  5420. `integer', an integer is returned.  If the third arg is `boolean', then the
  5421. returned value is the list (t) for true, (nil) for false, and is nil to
  5422. mean ``unspecified.''
  5423.  
  5424. arguments:(name class type &optional screen)
  5425. Fx-valid-color-name-p
  5426. Returns true if COLOR names a color that X knows about.
  5427. Valid color names are listed in the file /usr/lib/X11/rgb.txt, or
  5428. whatever the equivalent is on your system.
  5429.  
  5430. arguments:(color &optional screen)
  5431. Fx-valid-keysym-name-p
  5432. Returns true if KEYSYM names a keysym that the X library knows about.
  5433. Valid keysyms are listed in the files /usr/include/X11/keysymdef.h and in
  5434. /usr/lib/X11/XKeysymDB, or whatever the equivalents are on your system.
  5435.  
  5436. arguments:(keysym)
  5437. Fx-set-screen-pointer
  5438. Set the mouse cursor of SCREEN to the cursor named CURSOR-NAME,
  5439. with colors FOREGROUND and BACKGROUND.  The string may be any of the
  5440. standard cursor names from appendix B of the Xlib manual (also known as
  5441. the file <X11/cursorfont.h>) minus the XC_ prefix, or it may be a font
  5442. name and glyph index of the form "FONT fontname index [[font] index]",
  5443. or it may be a bitmap file acceptable to XmuLocateBitmapFile().
  5444. If it is a bitmap file, and if a bitmap file whose name is the name of
  5445. the cursor with "msk" exists, then it is used as the mask.  For example,
  5446. a pair of files may be named "cursor.xbm" and "cursor.xbmmsk".
  5447.  
  5448. arguments:(screen cursor_name &optional fg bg)
  5449. Fx-open-connection
  5450. Open a connection to an X server.
  5451. Argument ARGV is a list of strings describing the command line options.
  5452. Returns a copy of ARGV from which the arguments used by the Xt code
  5453. to open the connect have been removed.
  5454.  
  5455. arguments:(argv_list)
  5456. Fx-window-id
  5457. Get the ID of the X11 window. This gives us a chance to manipulate
  5458. the Emacs window from within a different program. Since the id is an
  5459. unsigned long, we return it as a string.
  5460.  
  5461. arguments:(screen)
  5462. Fx-close-current-connection
  5463. Close the connection to the current X server.
  5464.  
  5465. arguments:()
  5466. Fx-debug-mode
  5467. With a true arg, put the connection to the X server in synchronous
  5468. mode; this is slower.  False turns it off.
  5469. Do not simply call XSynchronize() from gdb; that won't work.
  5470.  
  5471. arguments:(arg)
  5472. Vx-gc-pointer-shape
  5473. The shape of the mouse-pointer during garbage collection.
  5474. If this is nil, then the cursor will not be changed, and echo-area messages
  5475. will be used instead.Vbar-cursor
  5476. Use vertical bar cursor if non-nil.Vx-screen-defaults
  5477. Alist of default screen-creation parameters for X-window screens.
  5478. These override what is specified in `~/.Xdefaults' but are overridden
  5479. by the arguments to the particular call to `x-create-screen'.Vdefault-screen-name
  5480. The default name to assign to newly-created screens.
  5481. This can be overridden by arguments to `x-create-screen'.
  5482. This must be a string.Vx-emacs-application-class
  5483. The X application class of the Emacs process.
  5484. This controls, among other things, the name of the `app-defaults' file
  5485. that emacs will use.  For changes to this variable to take effect, they
  5486. must be made before the connection to the X server is initialized, that is,
  5487. this variable may only be changed before emacs is dumped, or by setting it
  5488. in the file lisp/term/x-win.el.Vx-bitmap-file-path
  5489. A list of the directories in which X bitmap files may be found.
  5490. If nil, this is initialized from the "*bitmapFilePath" resource.Vx-allow-sendevents
  5491. *Non-nil means to allow synthetic events.  Nil means they are ignored.
  5492. Beware: allowing emacs to process SendEvents opens a big security hole.Fx-selection-reply-timeout-internal
  5493.  
  5494.  
  5495. arguments:(arg)
  5496. Fx-own-selection-internal
  5497. Assert an X selection of the given TYPE with the given VALUE.
  5498. TYPE is a symbol, typically PRIMARY, SECONDARY, or CLIPBOARD.
  5499. VALUE is typically a string, or a cons of two markers, but may be
  5500. anything that the functions on selection-converter-alist know about.
  5501.  
  5502. arguments:(selection_name selection_value)
  5503. Fx-get-selection-internal
  5504. Return text selected from some X window.
  5505. SELECTION is a symbol, typically PRIMARY, SECONDARY, or CLIPBOARD.
  5506. TYPE is the type of data desired, typically STRING.
  5507.  
  5508. arguments:(selection_symbol target_type)
  5509. Fx-disown-selection-internal
  5510. If we own the named selection, then disown it (make there be no selection).
  5511.  
  5512. arguments:(selection &optional time)
  5513. Fx-selection-owner-p
  5514. Whether the current emacs process owns the given X Selection.
  5515. The arg should be the name of the selection in question, typically one of
  5516. the symbols PRIMARY, SECONDARY, or CLIPBOARD.  (For convenience, the symbol
  5517. nil is the same as PRIMARY, and t is the same as SECONDARY.)
  5518.  
  5519. arguments:(&optional selection)
  5520. Fx-selection-exists-p
  5521. Whether there is an owner for the given X Selection.
  5522. The arg should be the name of the selection in question, typically one of
  5523. the symbols PRIMARY, SECONDARY, or CLIPBOARD.  (For convenience, the symbol
  5524. nil is the same as PRIMARY, and t is the same as SECONDARY.)
  5525.  
  5526. arguments:(&optional selection)
  5527. Fx-get-cutbuffer-internal
  5528. Returns the value of the named cutbuffer (typically CUT_BUFFER0).
  5529.  
  5530. arguments:(buffer)
  5531. Fx-store-cutbuffer-internal
  5532. Sets the value of the named cutbuffer (typically CUT_BUFFER0).
  5533.  
  5534. arguments:(buffer string)
  5535. Fx-rotate-cutbuffers-internal
  5536. Rotate the values of the cutbuffers by the given number of steps;
  5537. positive means move values forward, negative means backward.
  5538.  
  5539. arguments:(n)
  5540. Vselection-converter-alist
  5541. An alist associating selection-types (such as STRING and TIMESTAMP) with
  5542. functions.  These functions will be called with three args: the name of the
  5543. selection (typically PRIMARY, SECONDARY, or CLIPBOARD); a desired type to
  5544. which the selection should be converted; and the local selection value
  5545. (whatever had been passed to `x-own-selection').  These functions should
  5546. return the value to send to the X server (typically a string).  A return
  5547. value of nil means that the conversion could not be done.  A return value
  5548. which is the symbol NULL means that a side-effect was executed, and there
  5549. is no meaningful return value.Vx-lost-selection-hooks
  5550. A function or functions to be called after the X server has notified us
  5551. that we have lost the selection.  The function(s) will be called with one
  5552. argument, a symbol naming the selection (typically PRIMARY, SECONDARY, or
  5553. CLIPBOARD.)Vx-sent-selection-hooks
  5554. A function or functions to be called after we have responded to some
  5555. other client's request for the value of a selection that we own.  The
  5556. function(s) will be called with four arguments:
  5557.   - the name of the selection (typically PRIMARY, SECONDARY, or CLIPBOARD);
  5558.   - the name of the selection-type which we were requested to convert the
  5559.     selection into before sending (for example, STRING or LENGTH);
  5560.   - and whether we successfully transmitted the selection.
  5561. We might have failed (and declined the request) for any number of reasons,
  5562. including being asked for a selection that we no longer own, or being asked
  5563. to convert into a type that we don't know about or that is inappropriate.
  5564. This hook doesn't let you change the behavior of emacs's selection replies,
  5565. it merely informs you that they have happened.Vx-selection-timeout
  5566. If the selection owner doens't reply in this many seconds, we give up.
  5567. A value of 0 means wait as long as necessary.  This is initialized from the
  5568. "*selectionTimeout" resource (which is expressed in milliseconds).
  5569. Vemacs-version
  5570. Version numbers of this version of Emacs.
  5571. Vemacs-build-time
  5572. Time at which Emacs was dumped out.
  5573. Femacs-version
  5574. Return string describing the version of Emacs that is running.
  5575. Vglobal-map
  5576. Default global keymap mapping Emacs keyboard input into commands.
  5577. The value is a keymap which is usually (but not necessarily) Emacs's
  5578. global map.
  5579. Vesc-map
  5580. Default keymap for ESC (meta) commands.
  5581. The normal global definition of the character ESC indirects to this keymap.
  5582. Vctl-x-map
  5583. Default keymap for C-x commands.
  5584. The normal global definition of the character C-x indirects to this keymap.
  5585. Vctl-x-4-map
  5586. Keymap for subcommands of C-x 4
  5587. Vmode-specific-map
  5588. Keymap for characters following C-c.
  5589. Vkill-buffer-hook
  5590. Function or functions to be called when a buffer is killed.
  5591. The value of this variable may be buffer-local.
  5592. The buffer about to be killed is current when this hook is run.
  5593. Fgenerate-new-buffer
  5594. Create and return a buffer with a name based on NAME.
  5595. Choose the buffer's name using `generate-new-buffer-name'.
  5596. Fone-window-p
  5597. Returns non-nil if there is only one window.
  5598. Optional arg NOMINI non-nil means don't count the minibuffer
  5599. even if it is active.
  5600. Fwalk-windows
  5601. Cycle through all visible windows, calling PROC for each one.
  5602. PROC is called with a window as argument.
  5603. Optional second arg MINIBUF t means count the minibuffer window
  5604. even if not active.  If MINIBUF is neither t nor nil it means
  5605. not to count the minibuffer even if it is active.
  5606. Optional third arg ALL-SCREENS t means include all windows in all screens;
  5607. otherwise cycle within the selected screen.
  5608. Fread-quoted-char
  5609. Like `read-char', except that if the first character read is an octal
  5610. digit, we read up to two more octal digits and return the character
  5611. represented by the octal number consisting of those digits.
  5612. Optional argument PROMPT specifies a string to use to prompt the user.
  5613. Ferror
  5614. Signal an error, making error message by passing all args to `format'.
  5615. Fbaud-rate
  5616. Obsolete function returning the value of the `baud-rate' variable.
  5617. Fsuppress-keymap
  5618. Make MAP override all normally self-inserting keys to be undefined.
  5619. Normally, as an exception, digits and minus-sign are set to make prefix args,
  5620. but optional second arg NODIGITS non-nil treats them like other chars.
  5621. Fsubstitute-key-definition
  5622. Replace OLDDEF with NEWDEF for any keys in KEYMAP now defined as OLDDEF.
  5623. In other words, OLDDEF is replaced with NEWDEF where ever it appears.
  5624. Prefix keymaps reached from KEYMAP are not checked recursively;
  5625. perhaps they ought to be.
  5626. Fsave-match-data
  5627. Execute the BODY forms, restoring the global value of the match data.
  5628. Frun-hooks
  5629. Takes hook names and runs each one in turn.  Major mode functions use this.
  5630. Each argument should be a symbol, a hook variable.
  5631. These symbols are processed in the order specified.
  5632. If a hook symbol has a non-nil value, that value may be a function
  5633. or a list of functions to be called to run the hook.
  5634. If the value is a function, it is called with no arguments.
  5635. If it is a list, the elements are called, in order, with no arguments.
  5636. Vrun-hooks
  5637. Variable by which C primitives find the function `run-hooks'.
  5638. Don't change it.
  5639. Fadd-hook
  5640. Add a function to a hook.
  5641. First argument HOOK-VAR (a symbol) is the name of a hook, second
  5642.  argument FUNCTION is the function to add.
  5643. Third (optional) argument AT-END means to add the function at the end
  5644.  of the hook list instead of the beginning.  If the function is already
  5645.  present, this has no effect.
  5646. Returns nil if FUNCTION was already present in HOOK-VAR, else new
  5647.  value of HOOK-VAR.
  5648. Fremove-hook
  5649. Remove a function from a hook, if it is present.
  5650. First argument HOOK-VAR (a symbol) is the name of a hook, second
  5651.  argument FUNCTION is the function to remove (compared with `eq').
  5652. Fmomentary-string-display
  5653. Momentarily display STRING in the buffer at POS.
  5654. Display remains until next character is typed.
  5655. If the char is EXIT-CHAR (optional third arg, default is SPC) it is swallowed;
  5656. otherwise it is then available as input (as a command if nothing else).
  5657. Display MESSAGE (optional fourth arg) in the echo area.
  5658. If MESSAGE is nil, instructions to type EXIT-CHAR are displayed there.
  5659. Fstart-process-shell-command
  5660. Start a program in a subprocess.  Return the process object for it.
  5661. Args are NAME BUFFER COMMAND &rest COMMAND-ARGS.
  5662. NAME is name for process.  It is modified if necessary to make it unique.
  5663. BUFFER is the buffer or (buffer-name) to associate with the process.
  5664.  Process output goes at end of that buffer, unless you specify
  5665.  an output stream or filter function to handle the output.
  5666.  BUFFER may be also nil, meaning that this process is not associated
  5667.  with any buffer
  5668. Third arg is command name, the name of a shell command.
  5669. Remaining arguments are the arguments for the command.
  5670. Wildcards and redirection are handle as usual in the shell.
  5671. Fuser-original-login-name
  5672. Return user's login name from original login.
  5673. This tries to remain unaffected by `su', by looking in environment variables.
  5674. Fredraw-mode-line
  5675. Force the mode-line of the current buffer to be redisplayed.
  5676. With optional non-nil ALL then force then force redisplay of all mode-lines.
  5677. Flocal-key-binding
  5678. Return the binding for command KEYS in current local keymap only.
  5679. KEYS is a string, a vector of events, or a vector of key-description lists
  5680. as described in the documentation for the `define-key' function.
  5681. The binding is probably a symbol with a function definition; see
  5682. the documentation for `lookup-key' for more information.
  5683. Fglobal-key-binding
  5684. Return the binding for command KEYS in current global keymap only.
  5685. KEYS is a string or vector of events, a sequence of keystrokes.
  5686. The binding is probably a symbol with a function definition; see
  5687. the documentation for `lookup-key' for more information.
  5688. Fglobal-set-key
  5689. Give KEY a global binding as COMMAND.
  5690. COMMAND is a symbol naming an interactively-callable function.
  5691. KEYS is a string, a vector of events, or a vector of key-description lists
  5692. as described in the documentation for the `define-key' function.
  5693. Note that if KEY has a local binding in the current buffer
  5694. that local binding will continue to shadow any global binding.
  5695. Flocal-set-key
  5696. Give KEY a local binding as COMMAND.
  5697. COMMAND is a symbol naming an interactively-callable function.
  5698. KEYS is a string, a vector of events, or a vector of key-description lists
  5699. as described in the documentation for the `define-key' function.
  5700. The binding goes in the current buffer's local map,
  5701. which is shared with other buffers in the same major mode.
  5702. Fglobal-unset-key
  5703. Remove global binding of KEY.
  5704. KEYS is a string, a vector of events, or a vector of key-description lists
  5705. as described in the documentation for the `define-key' function.
  5706. Flocal-unset-key
  5707. Remove local binding of KEY.
  5708. KEYS is a string, a vector of events, or a vector of key-description lists
  5709. as described in the documentation for the `define-key' function.
  5710. Fdefine-prefix-command
  5711. Define COMMAND as a prefix command.
  5712. A new sparse keymap is stored as COMMAND's function definition.
  5713. If second optional argument MAPVAR is not specified,
  5714.  COMMAND's value (as well as its function definition) is set to the keymap.
  5715. If a second optional argument MAPVAR is given and is not `t',
  5716.   the map is stored as its value.
  5717. Regardless of MAPVAR, COMMAND's function-value is always set to the keymap.
  5718. Vinsert-default-directory
  5719. *Non-nil means when reading a filename start with default dir in minibuffer.
  5720. Vminibuffer-completion-table
  5721. Alist or obarray used for completion in the minibuffer.
  5722. This becomes the ALIST argument to `try-completion' and `all-completions'.
  5723.  
  5724. The value may alternatively be a function, which is given three arguments:
  5725.   STRING, the current buffer contents;
  5726.   PREDICATE, the predicate for filtering possible matches;
  5727.   CODE, which says what kind of things to do.
  5728. CODE can be nil, t or `lambda'.
  5729. nil means to return the best completion of STRING, nil if there is none,
  5730.   or t if it is was already a unique completion.
  5731. t means to return a list of all possible completions of STRING.
  5732. `lambda' means to return t if STRING is a valid completion as it stands.
  5733. Vminibuffer-completion-predicate
  5734. Within call to `completing-read', this holds the PREDICATE argument.
  5735. Vminibuffer-completion-confirm
  5736. Non-nil => demand confirmation of completion before exiting minibuffer.
  5737. Vminibuffer-confirm-incomplete
  5738. If true, then in contexts where completing-read allows answers which
  5739. are not valid completions, an extra RET must be typed to confirm the
  5740. response.  This is helpful for catching typos, etc.
  5741. Vcompletion-auto-help
  5742. *Non-nil means automatically provide help for invalid completion input.
  5743. Venable-recursive-minibuffers
  5744. *Non-nil means to allow minibuffer commands while in the minibuffer.
  5745. More precisely, this variable makes a difference when the minibuffer window
  5746. is the selected window.  If you are in some other window, minibuffer commands
  5747. are allowed even if a minibuffer is active.
  5748. Vminibuffer-help-form
  5749. Value that `help-form' takes on inside the minibuffer.
  5750. Vminibuffer-local-map
  5751. Default keymap to use when reading from the minibuffer.
  5752. Vminibuffer-local-completion-map
  5753. Local keymap for minibuffer input with completion.
  5754. Vminibuffer-local-must-match-map
  5755. Local keymap for minibuffer input with completion, for exact match.
  5756. Vread-expression-map
  5757. Minibuffer keymap used for reading Lisp expressions.
  5758. Vread-shell-command-map
  5759. Minibuffer keymap used by shell-command and related commands.
  5760. Fread-from-minibuffer
  5761. Read a string from the minibuffer, prompting with string PROMPT.
  5762. If optional second arg INITIAL-CONTENTS is non-nil, it is a string
  5763.   to be inserted into the minibuffer before reading input.
  5764.   If INITIAL-CONTENTS is (STRING . POSITION), the initial input
  5765.   is STRING, but point is placed POSITION characters into the string.
  5766. Third arg KEYMAP is a keymap to use whilst reading;
  5767.   if omitted or nil, the default is `minibuffer-local-map'.
  5768. If fourth arg READ is non-nil, then interpret the result as a lisp object
  5769.   and return that object:
  5770.   in other words, do `(car (read-from-string INPUT-STRING))'
  5771. Fifth arg HIST, if non-nil, specifies a history list
  5772.   and optionally the initial position in the list.
  5773.   It can be a symbol, which is the history list variable to use,
  5774.   or it can be a cons cell (HISTVAR . HISTPOS).
  5775.   In that case, HISTVAR is the history list variable to use,
  5776.   and HISTPOS is the initial position (the position in the list
  5777.   which INITIAL-CONTENTS corresponds to).
  5778.   If HIST is t, no history will be recorded.
  5779.   Positions are counted starting from 1 at the beginning of the list.
  5780. Fcompleting-read
  5781. Read a string in the minibuffer, with completion.
  5782. Args: PROMPT, TABLE, PREDICATE, REQUIRE-MATCH, INITIAL-CONTENTS, HIST.
  5783. PROMPT is a string to prompt with; normally it ends in a colon and a space.
  5784. TABLE is an alist whose elements' cars are strings, or an obarray.
  5785. PREDICATE limits completion to a subset of TABLE.
  5786. See `try-completion' for more details on completion, TABLE, and PREDICATE.
  5787. If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
  5788.  the input is (or completes to) an element of TABLE.
  5789.  If it is also not t, Return does not exit if it does non-null completion.
  5790. If INITIAL-CONTENTS is non-nil, insert it in the minibuffer initially.
  5791.   If it is (STRING . POSITION), the initial input
  5792.   is STRING, but point is placed POSITION characters into the string.
  5793. HIST, if non-nil, specifies a history list
  5794.   and optionally the initial position in the list.
  5795.   It can be a symbol, which is the history list variable to use,
  5796.   or it can be a cons cell (HISTVAR . HISTPOS).
  5797.   In that case, HISTVAR is the history list variable to use,
  5798.   and HISTPOS is the initial position (the position in the list
  5799.   which INITIAL-CONTENTS corresponds to).
  5800.   If HIST is t, no history will be recorded.
  5801.   Positions are counted starting from 1 at the beginning of the list.
  5802. Completion ignores case if the ambient value of
  5803.   `completion-ignore-case' is non-nil.
  5804. Fminibuffer-complete
  5805. Complete the minibuffer contents as far as possible.
  5806. Fminibuffer-complete-and-exit
  5807. Complete the minibuffer contents, and maybe exit.
  5808. Exit if the name is valid with no completion needed.
  5809. If name was completed to a valid match,
  5810. a repetition of this command will exit.
  5811. Fself-insert-and-exit
  5812. Terminate minibuffer input.
  5813. Fexit-minibuffer
  5814. Terminate this minibuffer argument.
  5815. If minibuffer-confirm-incomplete is true, and we are in a completing-read
  5816. of some kind, and the contents of the minibuffer is not an existing
  5817. completion, requires an additional RET before the minibuffer will be exited
  5818. (assuming that RET was the character that invoked this command:
  5819. the character in question must be typed again).
  5820. Fminibuffer-complete-word
  5821. Complete the minibuffer contents at most a single word.
  5822. After one word is completed as much as possible, a space or hyphen
  5823. is added, provided that matches some possible completion.
  5824. Fdisplay-completion-list
  5825. Display the list of completions, COMPLETIONS, using `standard-output'.
  5826. Each element may be just a symbol or string
  5827. or may be a list of two strings to be printed as if concatenated.
  5828. Fminibuffer-completion-help
  5829. Display a list of possible completions of the current minibuffer contents.
  5830. Vminibuffer-history
  5831. Default minibuffer history list.
  5832. This is used for all minibuffer input except when an alternate history
  5833. list is specified.
  5834. Vminibuffer-history-sexp-flag
  5835. Non-nil when doing history operations on `command-history'.
  5836. More generally, indicates that the history list being acted on
  5837. contains expressions rather than strings.
  5838. Vminibuffer-history-variable
  5839. History list symbol to add minibuffer values to.
  5840. Each minibuffer output is added with
  5841.   (set minibuffer-history-variable
  5842.        (cons STRING (symbol-value minibuffer-history-variable)))
  5843. Fprevious-matching-history-element
  5844. Find the previous history element that matches REGEXP.
  5845. (Previous history elements refer to earlier actions.)
  5846. With prefix argument N, search for Nth previous match.
  5847. If N is negative, find the next or Nth next match.
  5848. Fnext-matching-history-element
  5849. Find the next history element that matches REGEXP.
  5850. (The next history element refers to a more recent action.)
  5851. With prefix argument N, search for Nth next match.
  5852. If N is negative, find the previous or Nth previous match.
  5853. Fnext-history-element
  5854. Insert the next element of the minibuffer history into the minibuffer.
  5855. Fprevious-history-element
  5856. Inserts the previous element of the minibuffer history into the minibuffer.
  5857. Fread-minibuffer
  5858. Return a Lisp object read using the minibuffer.
  5859. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  5860. is a string to insert in the minibuffer before reading.
  5861. Third arg HIST, if non-nil, specifies a history list.
  5862. Fread-string
  5863. Return a string from the minibuffer, prompting with string PROMPT.
  5864. If non-nil, optional second arg INITIAL-CONTENTS is a string to insert
  5865. in the minibuffer before reading.
  5866. Third arg HIST, if non-nil, specifies a history list.
  5867. Feval-minibuffer
  5868. Return value of Lisp expression read using the minibuffer.
  5869. Prompt with PROMPT.  If non-nil, optional second arg INITIAL-CONTENTS
  5870. is a string to insert in the minibuffer before reading.
  5871. Third arg HIST, if non-nil, specifies a history list.
  5872. Fread-command
  5873. Read the name of a command and return as a symbol.
  5874. Prompts with PROMPT.
  5875. Fread-function
  5876. Read the name of a function and return as a symbol.
  5877. Prompts with PROMPT.
  5878. Fread-variable
  5879. Read the name of a user variable and return it as a symbol.
  5880. Prompts with PROMPT.
  5881. A user variable is one whose documentation starts with a `*' character.
  5882. Fread-buffer
  5883. Read the name of a buffer and return as a string.
  5884. Prompts with PROMPT.  Optional second arg DEFAULT is value to return if user
  5885. enters an empty line.  If optional third arg REQUIRE-MATCH is non-nil,
  5886. only existing buffer names are allowed.
  5887. Fread-number
  5888. Reads a number from the minibuffer.
  5889. Fread-shell-command
  5890. Just like read-string, but uses read-shell-command-map:
  5891. \{read-shell-command-map}
  5892. Fread-file-name
  5893. Read file name, prompting with PROMPT and completing in directory DIR.
  5894. Value is not expanded---you must call `expand-file-name' yourself.
  5895. Value is subject to interpreted by substitute-in-file-name however.
  5896. Default name to DEFAULT if user enters a null string.
  5897.  (If DEFAULT is omitted, the visited file name is used.)
  5898. Fourth arg MUST-MATCH non-nil means require existing file's name.
  5899.  Non-nil and non-t means also require confirmation after completion.
  5900. Fifth arg INITIAL-CONTENTS specifies text to start with.
  5901. DIR defaults to current buffer's directory default.
  5902. Fy-or-n-p-minibuf
  5903. Ask user a "y or n" question.  Return t if answer is "y".
  5904. Takes one argument, which is the string to display to ask the question.
  5905. It should end in a space; `y-or-n-p' adds `(y or n) ' to it.
  5906. No confirmation of the answer is requested; a single character is enough.
  5907. Also accepts Space to mean yes, or Delete to mean no.
  5908. Fyes-or-no-p-minibuf
  5909. Ask user a yes-or-no question.  Return t if answer is yes.
  5910. Takes one argument, which is the string to display to ask the question.
  5911. It should end in a space; `yes-or-no-p' adds `(yes or no) ' to it.
  5912. The user must confirm the answer with RET,
  5913. and can edit it until it as been confirmed.
  5914. Vglobal-face-data
  5915. do not use this
  5916. Vface-id-tick
  5917. don't even think of using this
  5918. Flist-faces
  5919. Returns a list of the names of all of the defined faces.
  5920. Ffind-face
  5921. Retrieve the face of the given name.
  5922. If NAME is a symbol and SCREEN is provided, the face is looked up on
  5923. that screen; otherwise, the selected screen is used.
  5924. If there is no such face, returns nil.
  5925. If SCREEN is the symbol t, then the global, non-screen face is returned.
  5926. If NAME is already a face, it is simply returned.
  5927. Fget-face
  5928. Retrieve the face of the given name.
  5929. If NAME is a symbol and SCREEN is provided, the face is looked up on
  5930. that screen; otherwise, the selected screen is used.
  5931. If there is no such face, an error is signalled.  See also `find-face'.
  5932. If SCREEN is the symbol t, then the global, non-screen face is returned.
  5933. If NAME is already a face, it is simply returned.
  5934. Fface-name
  5935. Returns the name of the given face.
  5936. Fface-id
  5937. Returns the internal ID number of the given face.
  5938. Fface-font
  5939. Returns the font name of the given face, or nil if it is unspecified.
  5940. Fface-foreground
  5941. Returns the foreground color name of the given face, or nil if unspecified.
  5942. Fface-background
  5943. Returns the background color name of the given face, or nil if unspecified.
  5944. Fface-background-pixmap
  5945. Returns the background pixmap name of the given face, or nil if unspecified.
  5946. Fface-underline-p
  5947. Returns whether the given face is underlined.
  5948. Fset-face-font
  5949. Change the font of the given face.  The font should be a string, the name
  5950. string, the name of the font.  If the optional SCREEN argument is provided, 
  5951. this face will be changed only in that screen; otherwise it will be changed
  5952. in all screens.
  5953. Fset-face-foreground
  5954. Change the foreground color of the given face.  The color should be a 
  5955. string, the name of a color.  If the optional SCREEN argument is provided, 
  5956. this face will be changed only in that screen; otherwise it will be changed 
  5957. in all screens.
  5958. Fset-face-background
  5959. Change the background color of the given face.  The color should be a 
  5960. string, the name of a color.  If the optional SCREEN argument is provided, 
  5961. this face will be changed only in that screen; otherwise it will be changed 
  5962. in all screens.
  5963. Fset-face-background-pixmap
  5964. Change the background pixmap of the given face.  The pixmap name should be
  5965. a string, the name of a file of pixmap data.  The directories listed in the
  5966. x-bitmap-file-path variable will be searched.  The bitmap may also be a list
  5967. of the form (width height data) where width and height are the size in pixels,
  5968. and data is a string, containing the raw bits of the bitmap.  
  5969. If the optional SCREEN argument is provided, this face will be changed only
  5970. in that screen; otherwise it will be changed in all screens.
  5971. Fset-face-underline-p
  5972. Change whether the given face is underlined.  
  5973. If the optional SCREEN argument is provided, this face will be changed only
  5974. in that screen; otherwise it will be changed in all screens.
  5975. Fmake-face
  5976. Defines and returns a new FACE on all screens.  
  5977. You can modify the font, color, etc of this face with the set-face- functions.
  5978. Fcopy-face
  5979. Defines and returns a new face which is a copy of an existing one,
  5980. or makes an already-existing face be exactly like another.
  5981. Fset-extent-face
  5982. Make the given EXTENT have the graphic attributes specified by FACE.
  5983. Fextent-face
  5984. Returns the name of the face in which EXTENT is displayed.
  5985. Fface-equal
  5986. True if the given faces will display in the the same way.
  5987. Fface-differs-from-default-p
  5988. True if the given face will display differently from the default face.
  5989. A face is considered to be ``the same'' as the default face if it is 
  5990. actually specified in the same way (equivalent fonts, etc) or if it is 
  5991. fully unspecified, and thus will inherit the attributes of any face it 
  5992. is displayed on top of.
  5993. Finvert-face
  5994. Swap the foreground and background colors of the given face.
  5995. If the face doesn't specify both foreground and background, then
  5996. its foreground and background are set to the background and
  5997. foreground of the default face.
  5998. Ftry-face-font
  5999. Like set-face-font, but returns nil on failure instead of an error.
  6000. Fset-default-font
  6001. Sets the font used for normal text and the modeline to FONT in all screens.
  6002. For finer-grained control, use set-face-font.
  6003. Vmode-line-buffer-identification
  6004. Mode-line control for identifying the buffer being displayed.
  6005. Its default value is "Emacs: %17b".  Major modes that edit things
  6006. other than ordinary files may change this (e.g. Info, Dired,...)
  6007. Vmode-line-process
  6008. Mode-line control for displaying info on process status.
  6009. Normally nil in most modes, since there is no process to display.
  6010. Vmode-line-modified
  6011. Mode-line control for displaying whether current buffer is modified.
  6012. Vminor-mode-alist
  6013. Alist saying how to show minor modes in the mode line.
  6014. Each element looks like (VARIABLE STRING);
  6015. STRING is included in the mode line iff VARIABLE's value is non-nil.
  6016. Vparagraph-start
  6017. *Regexp for beginning of a line that starts OR separates paragraphs.
  6018. Vparagraph-separate
  6019. *Regexp for beginning of a line that separates paragraphs.
  6020. If you change this, you may have to change paragraph-start also.
  6021. Vsentence-end
  6022. *Regexp describing the end of a sentence.
  6023. All paragraph boundaries also end sentences, regardless.
  6024. Vpage-delimiter
  6025. *Regexp describing line-beginnings that separate pages.
  6026. Vcase-replace
  6027. *Non-nil means query-replace should preserve case in replacements.
  6028. Vindent-line-function
  6029. Function to indent current line.
  6030. Vonly-global-abbrevs
  6031. *t means user plans to use global abbrevs only.
  6032. Makes the commands to define mode-specific abbrevs define global ones instead.
  6033. Vgrep-command
  6034. *Name of the command to use to run the grep command;
  6035. typically "grep -n" or "egrep -n".
  6036. (The "-n" option tells grep to output line numbers.)
  6037. Vdired-listing-switches
  6038. *Switches passed to `ls' for Dired.  MUST contain the `l' option.
  6039. Vlpr-switches
  6040. *List of strings to pass as extra args to `lpr' when it is invoked.
  6041. Vtag-table-alist
  6042. *A list which determines which tags files should be active for a 
  6043. given buffer.  This is not really an association list, in that all 
  6044. elements are checked.  The CAR of each element of this list is a 
  6045. pattern against which the buffer's file name is compared; if it 
  6046. matches, then the CDR of the list should be the name of the tags
  6047. table to use.  If more than one element of this list matches the
  6048. buffer's file name, then all of the associated tags tables will be
  6049. used.  Earlier ones will be searched first.
  6050.  
  6051. If the CAR of elements of this list are strings, then they are treated
  6052. as regular-expressions against which the file is compared (like the
  6053. auto-mode-alist).  If they are not strings, then they are evaluated.
  6054. If they evaluate to non-nil, then the current buffer is considered to
  6055. match.
  6056.  
  6057. If the CDR of the elements of this list are strings, then they are
  6058. assumed to name a TAGS file.  If they name a directory, then the string
  6059. "TAGS" is appended to them to get the file name.  If they are not 
  6060. strings, then they are evaluated, and must return an appropriate string.
  6061.  
  6062. For example:
  6063.   (setq tag-table-alist
  6064.     '(("/usr/src/public/perl/" . "/usr/src/public/perl/perl-3.0/")
  6065.      ("\\.el$" . "/usr/local/emacs/src/")
  6066.      ("/jbw/gnu/" . "/usr15/degree/stud/jbw/gnu/")
  6067.      ("" . "/usr/local/emacs/src/")
  6068.      ))
  6069.  
  6070. This means that anything in the /usr/src/public/perl/ directory should use
  6071. the TAGS file /usr/src/public/perl/perl-3.0/TAGS; and file ending in .el should
  6072. use the TAGS file /usr/local/emacs/src/TAGS; and anything in or below the
  6073. directory /jbw/gnu/ should use the TAGS file /usr15/degree/stud/jbw/gnu/TAGS.
  6074. A file called something like "/usr/jbw/foo.el" would use both the TAGS files
  6075. /usr/local/emacs/src/TAGS and /usr15/degree/stud/jbw/gnu/TAGS (in that order)
  6076. because it matches both patterns.
  6077.  
  6078. If the buffer-local variable `buffer-tag-table' is set, then it names a tags
  6079. table that is searched before all others when find-tag is executed from this
  6080. buffer.
  6081.  
  6082. If there is a file called "TAGS" in the same directory as the file in 
  6083. question, then that tags file will always be used as well (after the
  6084. `buffer-tag-table' but before the tables specified by this list.)
  6085.  
  6086. If the variable tags-file-name is set, then the tags file it names will apply
  6087. to all buffers (for backwards compatibility.)  It is searched first.
  6088.  
  6089. Vtags-file-name
  6090. *The name of the tags-table used by all buffers.
  6091. This is for backward compatibility, and is largely supplanted by the
  6092. variable tag-table-alist.
  6093. Vshell-prompt-pattern
  6094. *Regexp used by Newline command in shell mode to match subshell prompts.
  6095. Anything from beginning of line up to the end of what this pattern matches
  6096. is deemed to be prompt, and is not reexecuted.
  6097. Vledit-save-files
  6098. *Non-nil means Ledit should save files before transferring to Lisp.
  6099. Vledit-go-to-lisp-string
  6100. *Shell commands to execute to resume Lisp job.
  6101. Vledit-go-to-liszt-string
  6102. *Shell commands to execute to resume Lisp compiler job.
  6103. Vdisplay-time-day-and-date
  6104. *Non-nil means M-x display-time should display day and date as well as time.
  6105. Vauto-mode-alist
  6106. Alist of filename patterns vs corresponding major mode functions.
  6107. Each element looks like (REGEXP . FUNCTION).
  6108. Visiting a file whose name matches REGEXP causes FUNCTION to be called.
  6109. Fadd-change-log-entry
  6110. Find change log file and add an entry for today.
  6111. First arg (interactive prefix) non-nil means prompt for user name and site.
  6112. Second arg is file name of change log.
  6113. Optional third arg OTHER-WINDOW non-nil means visit in other window.
  6114. Fadd-change-log-entry-other-window
  6115. Find change log file in other window, and add an entry for today.
  6116. Fapropos
  6117. Show all symbols whose names contain matches for REGEXP.
  6118. If optional argument DO-ALL is non-nil, does more (time-consuming) work such as
  6119. showing key bindings.  Optional argument PRED is called with each symbol, and
  6120. if it returns nil, the symbol is not shown.  Returns list of symbols and
  6121. documentation found.
  6122. Fsuper-apropos
  6123. Show symbols whose names/documentation contain matches for REGEXP.
  6124. If optional argument DO-ALL is non-nil, does more (time-consuming) work such as
  6125. showing key bindings and documentation that is not stored in the documentation
  6126. file.  Returns list of symbols and documentation found.
  6127. Fawk-mode
  6128. Major mode for editing AWK code.
  6129. This is much like C mode except for the syntax of comments.
  6130. It uses the same keymap as C mode and has the same variables
  6131. for customizing indentation.  It has its own abbrev table
  6132. and its own syntax table.
  6133.  
  6134. Turning on AWK mode calls the value of the variable `awk-mode-hook'
  6135. with no args, if that value is non-nil.
  6136. F`
  6137. (` FORM)  is a macro that expands to code to construct FORM.
  6138. Note that this is very slow in interpreted code, but fast if you compile.
  6139. FORM is one or more nested lists, which are `almost quoted':
  6140. They are copied recursively, with non-lists used unchanged in the copy.
  6141.  (` a b) == (list 'a 'b)  constructs a new list with two elements, `a' and `b'.
  6142.  (` a (b c)) == (list 'a (list 'b 'c))  constructs two nested new lists.
  6143.  
  6144. However, certain special lists are not copied.  They specify substitution.
  6145. Lists that look like (, EXP) are evaluated and the result is substituted.
  6146.  (` a (, (+ x 5))) == (list 'a (+ x 5))
  6147.  
  6148. Elements of the form (,@ EXP) are evaluated and then all the elements
  6149. of the result are substituted.  This result must be a list; it may
  6150. be `nil'.
  6151.  
  6152. As an example, a simple macro `push' could be written:
  6153.    (defmacro push (v l)
  6154.         (` (setq (, l) (cons (,@ (list v l))))))
  6155. or as
  6156.    (defmacro push (v l)
  6157.         (` (setq (, l) (cons (, v) (, l)))))
  6158.  
  6159. LIMITATIONS: "dotted lists" are not allowed in FORM.
  6160. The ultimate cdr of each list scanned by ` must be `nil'.
  6161. (This does not apply to constants inside expressions to be substituted.)
  6162.  
  6163. Substitution elements are not allowed as the cdr
  6164. of a cons cell.  For example, (` (A . (, B))) does not work.
  6165. Instead, write (` (A (,@ B))).
  6166.  
  6167. You cannot construct vectors, only lists.  Vectors are treated as
  6168. constants.
  6169.  
  6170. BEWARE BEWARE BEWARE
  6171. Inclusion of (,ATOM) rather than (, ATOM)
  6172. or of (,@ATOM) rather than (,@ ATOM)
  6173. will result in errors that will show up very late.
  6174. Fbyte-compile-file
  6175. Compile a file of Lisp code named FILENAME into a file of byte code.
  6176. The output file's name is made by appending "c" to the end of FILENAME.
  6177. With prefix arg (noninteractively: 2nd arg), load the file after compiling.
  6178. Fbyte-compile-and-load-file
  6179. Compile a file of Lisp code named FILENAME into a file of byte code,
  6180. and then load it.  The output file's name is made by appending "c" to 
  6181. the end of FILENAME.
  6182. Fbyte-compile-buffer
  6183. Byte-compile and evaluate contents of BUFFER (default: the current buffer).
  6184. Felisp-compile-defun
  6185. Compile and evaluate the current top-level form.
  6186. Print the result in the minibuffer.
  6187. With argument, insert value in current buffer after the form.
  6188. Fbyte-recompile-directory
  6189. Recompile every `.el' file in DIRECTORY that needs recompilation.
  6190. This is if a `.elc' file exists but is older than the `.el' file.
  6191.  
  6192. If the `.elc' file does not exist, normally the `.el' file is *not* compiled.
  6193. But a prefix argument (optional second arg) means ask user,
  6194. for each such `.el' file, whether to compile it.
  6195. Fbatch-byte-compile
  6196. Runs byte-compile-file on the files remaining on the command line.
  6197. Must be used only with -batch, and kills emacs on completion.
  6198. Each file will be processed even if an error occurred previously.
  6199. For example, invoke "emacs -batch -f batch-byte-compile $emacs/ ~/*.el"
  6200. Fbatch-byte-recompile-directory
  6201. Runs `byte-recompile-directory' on the dirs remaining on the command line.
  6202. Must be used only with -batch, and kills emacs on completion.
  6203. For example, invoke "emacs -batch -f batch-byte-recompile-directory ."
  6204. Fset-c-style
  6205. Specify a style of indentation for C code for the current buffer.
  6206. The argument STYLE should be a standard style name defined in
  6207. `c-style-alist', such as GNU, BSD, K&R, etc.  (These are Lisp symbols.)
  6208. An omitted arg, or nil, means to use the value of `default-c-style'.
  6209.  
  6210. Setting the style sets various C-mode customization parameters accordingly,
  6211. all local to the current buffer.
  6212. Ffont-lock-mode
  6213. Toggle Font Lock Mode.
  6214. With arg, turn font-lock mode on if and only if arg is positive.
  6215. In the font-lock minor mode, text is fontified as you type it:
  6216.  
  6217.  - comments are displayed in font-lock-comment-face;
  6218.  - strings are displayed in font-lock-string-face;
  6219.  - documentation strings are displayed in font-lock-doc-string-face;
  6220.  - function and variable names in their defining forms are displayed
  6221.    in font-lock-function-name-face;
  6222.  - and certain other expressions are displayed in other faces
  6223.    according to the value of the variable `font-lock-keywords'.
  6224.  
  6225. When font-lock mode is turned on/off, the buffer is fontified/defontified.
  6226. To fontify a buffer without having newly typed text become fontified, you
  6227. can use \[font-lock-fontify-buffer].
  6228. Ffont-lock-fontify-buffer
  6229. Fontify the current buffer the way `font-lock-mode' would:
  6230.  
  6231.  - comments are displayed in font-lock-comment-face;
  6232.  - strings are displayed in font-lock-string-face;
  6233.  - documentation strings are displayed in font-lock-doc-string-face;
  6234.  - function and variable names in their defining forms are displayed
  6235.    in font-lock-function-name-face;
  6236.  - and certain other expressions are displayed in other faces
  6237.    according to the value of the variable `font-lock-keywords'.
  6238.  
  6239. This can take a while for large buffers.
  6240. Vfont-lock-keywords
  6241. *The keywords to highlight.
  6242. If this is a list, then elements may be of the forms:
  6243.  
  6244.   "string"            ; a regexp to highlight in the 
  6245.                 ;  `font-lock-keyword-face'.
  6246.   ("string" . integer)      ; match N of the regexp will be highlighted
  6247.   ("string" . face-name)    ; use the named face
  6248.   ("string" integer face-name)  ; both of the above
  6249.  
  6250. These regular expressions should not match text which spans lines.  Multi-line
  6251. patterns will be correctly fontified when \[font-lock-fontify-buffer] is used,
  6252. but will not be matched by the auto-fontification that font-lock-mode does,
  6253. since it looks at only one line at a time.
  6254.  
  6255. The more patterns there are in this list, the slower the initial fontification
  6256. of the buffer will be.
  6257. Fcalendar
  6258. Display a three-month calendar in another window.
  6259. The three months appear side by side, with the current month in the middle
  6260. surrounded by the previous and next months.  The cursor is put on today's date.
  6261.  
  6262. This function is suitable for execution in a .emacs file; appropriate setting
  6263. of the variable view-diary-entries-initially will cause the diary entries for
  6264. the current date to be displayed in another window.  The value of the variable
  6265. number-of-diary-entries controls the number of days of diary entries displayed.
  6266.  
  6267. An optional prefix argument ARG causes the calendar displayed to be ARG
  6268. months in the future if ARG is positive or in the past if ARG is negative;
  6269. in this case the cursor goes on the first day of the month.
  6270.  
  6271. Once in the calendar window, future or past months can be moved into view.
  6272. Arbitrary months can be displayed, or the calendar can be scrolled forward
  6273. or backward.
  6274.  
  6275. The cursor can be moved forward or backward by one day, one week, one month,
  6276. or one year.  All of these commands take prefix arguments which, when negative,
  6277. cause movement in the opposite direction.  For convenience, the digit keys
  6278. and the minus sign are automatically prefixes.  The window is replotted as
  6279. necessary to display the desired date.
  6280.  
  6281. Diary entries can be marked on the calendar or displayed in another window.
  6282.  
  6283. Use describe-mode for details of the key bindings in the calendar window.
  6284.  
  6285. The Gregorian calendar is assumed.
  6286.  
  6287. After preparing the calendar window initially, the hooks
  6288. initial-calendar-window-hook are run.
  6289.  
  6290. The hooks today-visible-calendar-hook are run everytime the calendar window
  6291. gets shifted, if the current date is visible in the window.  If it is not
  6292. visible, the hooks today-invisible-calendar-hook are run.  Thus, for
  6293. example, setting today-visible-calendar-hook to 'calendar-star-date will
  6294. cause today's date to be replaced by asterisks to highlight it whenever it
  6295. is in the window.
  6296. Fdiary
  6297. Generate the diary window for the current date.
  6298. The number of days of diary entries is governed by number-of-diary-entries.
  6299. This function is suitable for execution in a .emacs file.
  6300. Fdiff
  6301. Find and display the differences between OLD and NEW files.
  6302. Interactively you are prompted with the current buffer's file name for NEW
  6303. and what appears to be it's backup for OLD.
  6304. Vdiff-switches
  6305. *A list of switches to pass to the diff program.
  6306. Vkill-emacs-hook
  6307. A list of functions (of no args) for `kill-emacs' to call before emacs is
  6308. actually killed.
  6309. Fholidays
  6310. Display the holidays for last month, this month, and next month.
  6311. This function is suitable for execution in a .emacs file.
  6312. Flist-command-history
  6313. List history of commands typed to minibuffer.
  6314. The number of commands listed is controlled by  list-command-history-max.
  6315. Calls value of  list-command-history-filter  (if non-nil) on each history
  6316. element to judge if that element should be excluded from the list.
  6317.  
  6318. The buffer is left in Command History mode.
  6319. Fcommand-history-mode
  6320. Major mode for examining commands from  command-history.
  6321. The number of commands listed is controlled by  list-command-history-max.
  6322. The command history is filtered by  list-command-history-filter  if non-nil.
  6323.  
  6324. Like Emacs-Lisp Mode except that characters do not insert themselves and
  6325. Digits provide prefix arguments.  Tab does not indent.
  6326. \{command-history-map}
  6327. Calls the value of  command-history-hook  if that is non-nil
  6328. The Command History listing is recomputed each time this mode is
  6329. invoked.
  6330. Frepeat-matching-complex-command
  6331. Edit and re-evaluate complex command with name matching PATTERN.
  6332. Matching occurrences are displayed, most recent first, until you
  6333. select a form for evaluation.  If PATTERN is empty (or nil), every form
  6334. in the command history is offered.  The form is placed in the minibuffer
  6335. for editing and the result is evaluated.
  6336. Fcommon-lisp-indent-function
  6337.  
  6338. Fcompare-windows
  6339. Compare text in current window with text in next window.
  6340. Compares the text starting at point in each window,
  6341. moving over text in each one as far as they match.
  6342. Fcompile
  6343. Compile the program including the current buffer.  Default: run `make'.
  6344. Runs COMMAND, a shell command, in a separate process asynchronously
  6345. with output going to the buffer *compilation*.
  6346. You can then use the command \[next-error] to find the next error message
  6347. and move to the source code that caused it.
  6348. Fgrep
  6349. Run grep, with user-specified args, and collect output in a buffer.
  6350. While grep runs asynchronously, you can use the \[next-error] command
  6351. to find the text that grep hits refer to.
  6352. Fnext-error
  6353. Visit next compilation error message and corresponding source code.
  6354. This operates on the output from the \[compile] command.
  6355. If all preparsed error messages have been processed,
  6356. the error message buffer is checked for new ones.
  6357. A non-nil argument (prefix arg, if interactive)
  6358. means reparse the error message buffer and start at the first error.
  6359. Fprevious-error
  6360. See \[next-error].
  6361. Fdabbrev-expand
  6362. Expand previous word "dynamically".
  6363. Expands to the most recent, preceding word for which this is a prefix.
  6364. If no suitable preceding word is found, words following point are considered.
  6365.  
  6366. A positive prefix argument, N, says to take the Nth backward DISTINCT
  6367. possibility.  A negative argument says search forward.  The variable
  6368. dabbrev-backward-only may be used to limit the direction of search to
  6369. backward if set non-nil.
  6370.  
  6371. If the cursor has not moved from the end of the previous expansion and
  6372. no argument is given, replace the previously-made expansion
  6373. with the next possible expansion not yet tried.
  6374. Fdebug
  6375. Enter debugger.  Returns if user says "continue".
  6376. Arguments are mainly for use when this is called
  6377.  from the internals of the evaluator.
  6378. You may call with no args, or you may
  6379.  pass nil as the first arg and any other args you like.
  6380.  In that case, the list of args after the first will 
  6381.  be printed into the backtrace buffer.
  6382. Fcancel-debug-on-entry
  6383. Undo effect of debug-on-entry on FUNCTION.
  6384. Fdebug-on-entry
  6385. Request FUNCTION to invoke debugger each time it is called.
  6386. If the user continues, FUNCTION's execution proceeds.
  6387. Works by modifying the definition of FUNCTION,
  6388. which must be written in Lisp, not predefined.
  6389. Use `cancel-debug-on-entry' to cancel the effect of this command.
  6390. Redefining FUNCTION also does that.
  6391. Fdired
  6392. "Edit" directory DIRNAME--delete, rename, print, etc. some files in it.
  6393. Dired displays a list of files in DIRNAME.
  6394. You can move around in it with the usual commands.
  6395. You can flag files for deletion with C-d
  6396. and then delete them by typing `x'.
  6397. Type `h' after entering dired for more info.
  6398. Fdired-other-window
  6399. "Edit" directory DIRNAME.  Like \[dired] but selects in another window.
  6400. Fdired-noselect
  6401. Like M-x dired but returns the dired buffer as value, does not select it.
  6402. Fdissociated-press
  6403. Dissociate the text of the current buffer.
  6404. Output goes in buffer named *Dissociation*,
  6405. which is redisplayed each time text is added to it.
  6406. Every so often the user must say whether to continue.
  6407. If ARG is positive, require ARG chars of continuity.
  6408. If ARG is negative, require -ARG words of continuity.
  6409. Default is 2.
  6410. Fdoctor
  6411. Switch to *doctor* buffer and start giving psychotherapy.
  6412. Fdisassemble
  6413. Print disassembled code for OBJECT on (optional) STREAM.
  6414. OBJECT can be a symbol defined as a function, or a function itself
  6415. (a lambda expression or a compiled-function object).
  6416. If OBJECT is not already compiled, we compile it, but do not
  6417. redefine OBJECT if it is a symbol.
  6418. Felectric-buffer-list
  6419. Vaguely like ITS lunar select buffer;
  6420. combining typeoutoid buffer listing with menuoid buffer selection.
  6421.  
  6422. This pops up a buffer describing the set of emacs buffers.
  6423. If the very next character typed is a space then the buffer list
  6424.  window disappears.
  6425.  
  6426. Otherwise, one may move around in the buffer list window, marking
  6427.  buffers to be selected, saved or deleted.
  6428.  
  6429. To exit and select a new buffer, type Space when the cursor is on the
  6430.  appropriate line of the buffer-list window.
  6431.  
  6432. Other commands are much like those of buffer-menu-mode.
  6433.  
  6434. Calls value of  electric-buffer-menu-mode-hook  on entry if non-nil.
  6435.  
  6436. \{electric-buffer-menu-mode-map}
  6437. Felectric-command-history
  6438. Major mode for examining and redoing commands from  command-history.
  6439. The number of command listed is controlled by  list-command-history-max.
  6440. The command history is filtered by  list-command-history-filter  if non-nil.
  6441. Combines typeout Command History list window with menu like selection
  6442. of an expression from the history for re-evaluation in the *original* buffer.
  6443.  
  6444. The history displayed is filtered by  list-command-history-filter  if non-nil.
  6445.  
  6446. This pops up a window with the Command History listing.  If the very
  6447. next character typed is Space, the listing is killed and the previous
  6448. window configuration is restored.  Otherwise, you can browse in the
  6449. Command History with  Return  moving down and  Delete  moving up, possibly
  6450. selecting an expression to be redone with Space or quitting with `Q'.
  6451.  
  6452. Like Emacs-Lisp Mode except that characters do not insert themselves and
  6453. Tab and linefeed do not indent.  Instead these commands are provided:
  6454. Space or !    edit then evaluate current line in history inside
  6455.            the ORIGINAL buffer which invoked this mode.
  6456.            The previous window configuration is restored
  6457.            unless the invoked command changes it.
  6458. C-c C-c, C-], Q    Quit and restore previous window configuration.
  6459. LFD, RET    Move to the next line in the history.
  6460. DEL        Move to the previous line in the history.
  6461. ?        Provides a complete list of commands.
  6462.  
  6463. Calls the value of  electric-command-history-hook  if that is non-nil
  6464. The Command History listing is recomputed each time this mode is invoked.
  6465. Fedt-emulation-on
  6466. Begin emulating DEC's EDT editor.
  6467. Certain keys are rebound; including nearly all keypad keys.
  6468. Use \[edt-emulation-off] to undo all rebindings except the keypad keys.
  6469. Note that this function does not work if called directly from the .emacs file.
  6470. Instead, the .emacs file should do (setq term-setup-hook 'edt-emulation-on)
  6471. Then this function will be called at the time when it will work.
  6472. Ffortran-mode
  6473. Major mode for editing fortran code.
  6474. Tab indents the current fortran line correctly. 
  6475. `do' statements must not share a common `continue'.
  6476.  
  6477. Type `;?' or `;\[help-command]' to display a list of built-in abbrevs for Fortran keywords.
  6478.  
  6479. Variables controlling indentation style and extra features:
  6480.  
  6481.  comment-start
  6482.     Normally nil in Fortran mode.  If you want to use comments
  6483.     starting with `!', set this to the string "!".
  6484.  fortran-do-indent
  6485.     Extra indentation within do blocks.  (default 3)
  6486.  fortran-if-indent
  6487.     Extra indentation within if blocks.  (default 3)
  6488.  fortran-continuation-indent
  6489.     Extra indentation appled to continuation statements.  (default 5)
  6490.  fortran-comment-line-column
  6491.     Amount of indentation for text within full-line comments. (default 6)
  6492.  fortran-comment-indent-style
  6493.     nil    means don't change indentation of text in full-line comments,
  6494.     fixed  means indent that text at column fortran-comment-line-column
  6495.     relative  means indent at fortran-comment-line-column beyond the
  6496.            indentation for a line of code.
  6497.     Default value is fixed.
  6498.  fortran-comment-indent-char
  6499.     Character to be inserted instead of space for full-line comment
  6500.     indentation.  (default is a space)
  6501.  fortran-minimum-statement-indent
  6502.     Minimum indentation for fortran statements. (default 6)
  6503.  fortran-line-number-indent
  6504.     Maximum indentation for line numbers.  A line number will get
  6505.     less than this much indentation if necessary to avoid reaching
  6506.     column 5.  (default 1)
  6507.  fortran-check-all-num-for-matching-do
  6508.     Non-nil causes all numbered lines to be treated as possible 'continue'
  6509.     statements.  (default nil)
  6510.  fortran-continuation-char
  6511.     character to be inserted in column 5 of a continuation line.
  6512.     (default $)
  6513.  fortran-comment-region
  6514.     String inserted by \[fortran-comment-region] at start of each line in 
  6515.     region.  (default "c$$$")
  6516.  fortran-electric-line-number
  6517.     Non-nil causes line number digits to be moved to the correct column 
  6518.     as typed.  (default t)
  6519.  fortran-startup-message
  6520.     Set to nil to inhibit message first time fortran-mode is used.
  6521.  
  6522. Turning on Fortran mode calls the value of the variable fortran-mode-hook 
  6523. with no args, if that value is non-nil.
  6524. \{fortran-mode-map}
  6525. Fgdb
  6526. Run gdb on program FILE in buffer *gdb-FILE*.
  6527. The directory containing FILE becomes the initial working directory
  6528. and source-file directory for GDB.  If you wish to change this, use
  6529. the GDB commands `cd DIR' and `directory'.
  6530. Fset-gosmacs-bindings
  6531. Rebind some keys globally to make GNU Emacs resemble Gosling Emacs.
  6532. Use \[set-gnu-bindings] to restore previous global bindings.
  6533. Fhanoi
  6534. Towers of Hanoi diversion.  Argument is number of rings.
  6535. FHelper-help
  6536. Provide help for current mode.
  6537. FHelper-describe-bindings
  6538. Describe local key bindings of current mode.
  6539. Finfo
  6540. Enter Info, the documentation browser.
  6541. FInfo-tagify
  6542. Create or update Info-file tag table in current buffer.
  6543. FInfo-validate
  6544. Check current buffer for validity as an Info file.
  6545. Check that every node pointer points to an existing node.
  6546. FInfo-split
  6547. Split an info file into an indirect file plus bounded-size subfiles.
  6548. Each subfile will be up to 50000 characters plus one node.
  6549.  
  6550. To use this command, first visit a large Info file that has a tag table.
  6551. The buffer is modified into a (small) indirect info file
  6552. which should be saved in place of the original visited file.
  6553.  
  6554. The subfiles are written in the same directory the original file is in,
  6555. with names generated by appending `-' and a number to the original file name.
  6556.  
  6557. The indirect file still functions as an Info file, but it contains
  6558. just the tag table and a directory of subfiles.
  6559. Fbatch-info-validate
  6560. Runs  Info-validate  on the files remaining on the command line.
  6561. Must be used only with -batch, and kills emacs on completion.
  6562. Each file will be processed even if an error occurred previously.
  6563. For example, invoke "emacs -batch -f batch-info-validate $info/ ~/*.info"
  6564. Fispell
  6565. Run ispell over a buffer.  (Actually over the buffer's file.)
  6566. First the file is scanned for misspelled words, then ispell
  6567. enters a loop with the following commands for every misspelled word:
  6568.  
  6569. DIGIT    Near miss selector.  If the misspelled word is 'close' to
  6570.     some words in the dictionary, they are offered as near misses.
  6571. r    Replace.  Replace the word with a string you type.  Each word
  6572.     of your new string is also checked.
  6573. i    Insert.  Insert this word in your private dictonary (kept in
  6574.     $HOME/ispell.words)
  6575. a    Accept.  Accept this word for the rest of this editing session,
  6576.      but don't put it in your private dictonary.
  6577. l    Lookup.  Look for a word in the dictionary by fast binary
  6578.     search, or search for a regular expression in the dictionary
  6579.     using grep.
  6580. SPACE    Accept the word this time, but complain if it is seen again.
  6581. q, C-G    Leave the command loop.  You can come back later with \[ispell-next].
  6582. Fispell-region
  6583. Check the spelling for all of the words in the region.
  6584. Fispell-word
  6585. Check the spelling of the word under the cursor.
  6586. See `ispell' for more documentation.
  6587. Fledit-mode
  6588. Major mode for editing text and stuffing it to a Lisp job.
  6589. Like Lisp mode, plus these special commands:
  6590.   M-C-d    -- record defun at or after point
  6591.        for later transmission to Lisp job.
  6592.   M-C-r -- record region for later transmission to Lisp job.
  6593.   C-x z -- transfer to Lisp job and transmit saved text.
  6594.   M-C-c -- transfer to Liszt (Lisp compiler) job
  6595.        and transmit saved text.
  6596. \{ledit-mode-map}
  6597. To make Lisp mode automatically change to Ledit mode,
  6598. do (setq lisp-mode-hook 'ledit-from-lisp-mode)
  6599. Fledit-from-lisp-mode
  6600.  
  6601. Flpr-buffer
  6602. Print buffer contents as with Unix command `lpr'.
  6603. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  6604. Fprint-buffer
  6605. Print buffer contents as with Unix command `lpr -p'.
  6606. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  6607. Flpr-region
  6608. Print region contents as with Unix command `lpr'.
  6609. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  6610. Fprint-region
  6611. Print region contents as with Unix command `lpr -p'.
  6612. `lpr-switches' is a list of extra switches (strings) to pass to lpr.
  6613. Finsert-kbd-macro
  6614. Insert in buffer the definition of kbd macro NAME, as Lisp code.
  6615. Second argument KEYS non-nil means also record the keys it is on.
  6616.  (This is the prefix argument, when calling interactively.)
  6617.  
  6618. This Lisp code will, when executed, define the kbd macro with the
  6619. same definition it has now.  If you say to record the keys,
  6620. the Lisp code will also rebind those keys to the macro.
  6621. Only global key bindings are recorded since executing this Lisp code
  6622. always makes global bindings.
  6623.  
  6624. To save a kbd macro, visit a file of Lisp code such as your ~/.emacs,
  6625. use this command, and then save the file.
  6626. Fkbd-macro-query
  6627. Query user during kbd macro execution.
  6628. With prefix argument, enters recursive edit,
  6629.  reading keyboard commands even within a kbd macro.
  6630.  You can give different commands each time the macro executes.
  6631. Without prefix argument, reads a character.  Your options are:
  6632.  Space -- execute the rest of the macro.
  6633.  DEL -- skip the rest of the macro; start next repetition.
  6634.  C-d -- skip rest of the macro and don't repeat it any more.
  6635.  C-r -- enter a recursive edit, then on exit ask again for a character
  6636.  C-l -- redisplay screen and ask again.
  6637. Fname-last-kbd-macro
  6638. Assign a name to the last keyboard macro defined.
  6639. One arg, a symbol, which is the name to define.
  6640. The symbol's function definition becomes the keyboard macro string.
  6641. Such a "function" cannot be called from Lisp, but it is a valid command
  6642. definition for the editor command loop.
  6643. Fmake-command-summary
  6644. Make a summary of current key bindings in the buffer *Summary*.
  6645. Previous contents of that buffer are killed first.
  6646. Fdefine-mail-alias
  6647. Define NAME as a mail-alias that translates to DEFINITION.
  6648. If DEFINITION contains multiple addresses, seperate them with commas.
  6649. Fmanual-entry
  6650. Display the Unix manual entry for TOPIC.
  6651. TOPIC is either the title of the entry, or has the form TITLE(SECTION)
  6652. where SECTION is the desired section of the manual, as in `tty(4)'.
  6653. Fmh-rmail
  6654. Inc(orporate) new mail (no arg) or scan a MH mail box (arg given).
  6655. This front end uses the MH mail system, which uses different conventions
  6656. from the usual mail system.
  6657. Fmh-smail
  6658. Send mail using the MH mail system.
  6659. Fconvert-mocklisp-buffer
  6660. Convert buffer of Mocklisp code to real Lisp that GNU Emacs can run.
  6661. Fmodula-2-mode
  6662. This is a mode intended to support program development in Modula-2.
  6663. All control constructs of Modula-2 can be reached by typing
  6664. Control-C followed by the first character of the construct.
  6665. \{m2-mode-map}
  6666.   Control-c b begin         Control-c c case
  6667.   Control-c d definition    Control-c e else
  6668.   Control-c f for           Control-c h header
  6669.   Control-c i if            Control-c m module
  6670.   Control-c l loop          Control-c o or
  6671.   Control-c p procedure     Control-c Control-w with
  6672.   Control-c r record        Control-c s stdio
  6673.   Control-c t type          Control-c u until
  6674.   Control-c v var           Control-c w while
  6675.   Control-c x export        Control-c y import
  6676.   Control-c { begin-comment Control-c } end-comment
  6677.   Control-c Control-z suspend-emacs     Control-c Control-t toggle
  6678.   Control-c Control-c compile           Control-x ` next-error
  6679.   Control-c Control-l link
  6680.  
  6681.    m2-indent controls the number of spaces for each indentation.
  6682.    m2-compile-command holds the command to compile a Modula-2 program.
  6683.    m2-link-command holds the command to link a Modula-2 program.
  6684. Fdisabled-command-hook
  6685.  
  6686. Fenable-command
  6687. Allow COMMAND to be executed without special confirmation from now on.
  6688. The user's .emacs file is altered so that this will apply
  6689. to future sessions.
  6690. Fdisable-command
  6691. Require special confirmation to execute COMMAND from now on.
  6692. The user's .emacs file is altered so that this will apply
  6693. to future sessions.
  6694. Fnroff-mode
  6695. Major mode for editing text intended for nroff to format.
  6696. \{nroff-mode-map}
  6697. Turning on Nroff mode runs text-mode-hook, then nroff-mode-hook.
  6698. Also, try nroff-electric-mode, for automatically inserting
  6699. closing requests for requests that are used in matched pairs.
  6700. Flist-options
  6701. Display a list of Emacs user options, with values and documentation.
  6702. Fedit-options
  6703. Edit a list of Emacs user option values.
  6704. Selects a buffer containing such a list,
  6705. in which there are commands to set the option values.
  6706. Type \[describe-mode] in that buffer for a list of commands.
  6707. Foutline-mode
  6708. Set major mode for editing outlines with selective display.
  6709. Headings are lines which start with asterisks: one for major headings,
  6710. two for subheadings, etc.  Lines not starting with asterisks are body lines. 
  6711.  
  6712. Body text or subheadings under a heading can be made temporarily
  6713. invisible, or visible again.  Invisible lines are attached to the end 
  6714. of the heading, so they move with it, if the line is killed and yanked
  6715. back.  A heading with text hidden under it is marked with an ellipsis (...).
  6716.  
  6717. Commands:
  6718. C-c C-n   outline-next-visible-heading      move by visible headings
  6719. C-c C-p   outline-previous-visible-heading
  6720. C-c C-f   outline-forward-same-level        similar but skip subheadings
  6721. C-c C-b   outline-backward-same-level
  6722. C-c C-u   outline-up-heading            move from subheading to heading
  6723.  
  6724. Meta-x hide-body    make all text invisible (not headings).
  6725. Meta-x show-all        make everything in buffer visible.
  6726.  
  6727. The remaining commands are used when point is on a heading line.
  6728. They apply to some of the body or subheadings of that heading.
  6729. C-c C-h   hide-subtree    make body and subheadings invisible.
  6730. C-c C-s   show-subtree    make body and subheadings visible.
  6731. C-c C-i   show-children    make direct subheadings visible.
  6732.          No effect on body, or subheadings 2 or more levels down.
  6733.          With arg N, affects subheadings N levels down.
  6734. M-x hide-entry       make immediately following body invisible.
  6735. M-x show-entry       make it visible.
  6736. M-x hide-leaves       make body under heading and under its subheadings invisible.
  6737.              The subheadings remain visible.
  6738. M-x show-branches  make all subheadings at all levels visible.
  6739.  
  6740. The variable outline-regexp can be changed to control what is a heading.
  6741. A line is a heading if outline-regexp matches something at the
  6742. beginning of the line.  The longer the match, the deeper the level.
  6743.  
  6744. Turning on outline mode calls the value of text-mode-hook and then of
  6745. outline-mode-hook, if they are non-nil.
  6746. Fcvs-update
  6747. Run a 'cvs update' in the current working directory. Feed the
  6748. output to a *cvs* buffer and run cvs-mode on it.
  6749. If optional prefix argument LOCAL is non-nil, 'cvs update -l' is run.
  6750. Fcvs-update-other-window
  6751. Run a 'cvs update' in the current working directory. Feed the
  6752. output to a *cvs* buffer, display it in the other window, and run
  6753. cvs-mode on it.
  6754.  
  6755. If optional prefix argument LOCAL is non-nil, 'cvs update -l' is run.
  6756. Fedit-picture
  6757. Switch to Picture mode, in which a quarter-plane screen model is used.
  6758. Printing characters replace instead of inserting themselves with motion
  6759. afterwards settable by these commands:
  6760.   C-c <      Move left after insertion.
  6761.   C-c >      Move right after insertion.
  6762.   C-c ^      Move up after insertion.
  6763.   C-c .      Move down after insertion.
  6764.   C-c `      Move northwest (nw) after insertion.
  6765.   C-c '      Move northeast (ne) after insertion.
  6766.   C-c /      Move southwest (sw) after insertion.
  6767.   C-c \   Move southeast (se) after insertion.
  6768. The current direction is displayed in the mode line.  The initial
  6769. direction is right.  Whitespace is inserted and tabs are changed to
  6770. spaces when required by movement.  You can move around in the buffer
  6771. with these commands:
  6772.   C-p      Move vertically to SAME column in previous line.
  6773.   C-n      Move vertically to SAME column in next line.
  6774.   C-e      Move to column following last non-whitespace character.
  6775.   C-f      Move right inserting spaces if required.
  6776.   C-b      Move left changing tabs to spaces if required.
  6777.   C-c C-f Move in direction of current picture motion.
  6778.   C-c C-b Move in opposite direction of current picture motion.
  6779.   Return  Move to beginning of next line.
  6780. You can edit tabular text with these commands:
  6781.   M-Tab      Move to column beneath (or at) next interesting charecter.
  6782.         `Indents' relative to a previous line.
  6783.   Tab      Move to next stop in tab stop list.
  6784.   C-c Tab Set tab stops according to context of this line.
  6785.         With ARG resets tab stops to default (global) value.
  6786.         See also documentation of variable    picture-tab-chars
  6787.         which defines "interesting character".  You can manually
  6788.         change the tab stop list with command \[edit-tab-stops].
  6789. You can manipulate text with these commands:
  6790.   C-d      Clear (replace) ARG columns after point without moving.
  6791.   C-c C-d Delete char at point - the command normally assigned to C-d.
  6792.   Delete  Clear (replace) ARG columns before point, moving back over them.
  6793.   C-k      Clear ARG lines, advancing over them.     The cleared
  6794.         text is saved in the kill ring.
  6795.   C-o      Open blank line(s) beneath current line.
  6796. You can manipulate rectangles with these commands:
  6797.   C-c C-k Clear (or kill) a rectangle and save it.
  6798.   C-c C-w Like C-c C-k except rectangle is saved in named register.
  6799.   C-c C-y Overlay (or insert) currently saved rectangle at point.
  6800.   C-c C-x Like C-c C-y except rectangle is taken from named register.
  6801.   \[copy-rectangle-to-register]   Copies a rectangle to a register.
  6802.   \[advertised-undo]   Can undo effects of rectangle overlay commands
  6803.         commands if invoked soon enough.
  6804. You can return to the previous mode with:
  6805.   C-c C-c Which also strips trailing whitespace from every line.
  6806.         Stripping is suppressed by supplying an argument.
  6807.  
  6808. Entry to this mode calls the value of  edit-picture-hook  if non-nil.
  6809.  
  6810. Note that Picture mode commands will work outside of Picture mode, but
  6811. they are not defaultly assigned to keys.
  6812. Fprolog-mode
  6813. Major mode for editing Prolog code for Prologs.
  6814. Blank lines and `%%...' separate paragraphs.  `%'s start comments.
  6815. Commands:
  6816. \{prolog-mode-map}
  6817. Entry to this mode calls the value of prolog-mode-hook
  6818. if that value is non-nil.
  6819. Frun-prolog
  6820. Run an inferior Prolog process, input and output via buffer *prolog*.
  6821. Fclear-rectangle
  6822. Blank out rectangle with corners at point and mark.
  6823. The text previously in the region is overwritten by the blanks.
  6824. Fdelete-rectangle
  6825. Delete (don't save) text in rectangle with point and mark as corners.
  6826. The same range of columns is deleted in each line
  6827. starting with the line where the region begins
  6828. and ending with the line where the region ends.
  6829. Fdelete-extract-rectangle
  6830. Return and delete contents of rectangle with corners at START and END.
  6831. Value is list of strings, one for each line of the rectangle.
  6832. Fextract-rectangle
  6833. Return contents of rectangle with corners at START and END.
  6834. Value is list of strings, one for each line of the rectangle.
  6835. Finsert-rectangle
  6836. Insert text of RECTANGLE with upper left corner at point.
  6837. RECTANGLE's first line is inserted at point,
  6838. its second line is inserted at a point vertically under point, etc.
  6839. RECTANGLE should be a list of strings.
  6840. Fkill-rectangle
  6841. Delete rectangle with corners at point and mark; save as last killed one.
  6842. Calling from program, supply two args START and END, buffer positions.
  6843. But in programs you might prefer to use delete-extract-rectangle.
  6844. Fopen-rectangle
  6845. Blank out rectangle with corners at point and mark, shifting text right.
  6846. The text previously in the region is not overwritten by the blanks,
  6847. but insted winds up to the right of the rectangle.
  6848. Fyank-rectangle
  6849. Yank the last killed rectangle with upper left corner at point.
  6850. Frnews
  6851. Read USENET news for groups for which you are a member and add or
  6852. delete groups.
  6853. You can reply to articles posted and send articles to any group.
  6854.  
  6855. Type \[describe-mode] once reading news to get a list of rnews commands.
  6856. Fnews-post-news
  6857. Begin editing a new USENET news article to be posted.
  6858. Type \[describe-mode] once editing the article to get a list of commands.
  6859. Frmail
  6860. Read and edit incoming mail.
  6861. Moves messages into file named by  rmail-file-name  (a babyl format file)
  6862.  and edits that file in RMAIL Mode.
  6863. Type \[describe-mode] once editing that file, for a list of RMAIL commands.
  6864.  
  6865. May be called with filename as argument;
  6866. then performs rmail editing on that file,
  6867. but does not copy any new mail into the file.
  6868. Frmail-input
  6869. Run RMAIL on file FILENAME.
  6870. Vrmail-dont-reply-to-names
  6871. *A regular expression specifying names to prune in replying to messages.
  6872. nil means don't reply to yourself.
  6873. Vrmail-default-dont-reply-to-names
  6874. A regular expression specifying part of the value of the default value of
  6875. the variable `rmail-dont-reply-to-names', for when the user does not set
  6876. `rmail-dont-reply-to-names' explicitly.  (The other part of the default
  6877. value is the user's name.)
  6878. It is useful to set this variable in the site customisation file.
  6879. Vrmail-primary-inbox-list
  6880. *List of files which are inboxes for user's primary mail file ~/RMAIL.
  6881. `nil' means the default, which is ("/usr/spool/mail/$USER" "~/mbox")
  6882. (the first name varies depending on the operating system,
  6883. and the value of the environment variable MAIL overrides it).
  6884. Vrmail-ignored-headers
  6885. *Gubbish header fields one would rather not see.
  6886. Vrmail-delete-after-output
  6887. *Non-nil means automatically delete a message that is copied to a file.
  6888. Fstart-timer
  6889. Start a timer.
  6890. Args are NAME, FUNCTION, VALUE &optional RESTART.
  6891. NAME is an identifier for the timer.  It must be a string.  If a timer
  6892.   already exists with this name, NAME will be modified slightly to until
  6893.   it is unique.
  6894. FUNCTION should be a function (or symbol naming one) of no arguments.  It
  6895.   will be called each time the timer expires.  The function can access
  6896.   timer that invoked it through the variable `current-timer'.
  6897. VALUE is the number of seconds until this timer expires.
  6898. Optional fourth arg RESTART non-nil means that this timer should be
  6899.   restarted automatically after its function is called.  Normally a timer
  6900.   is deleted at expiration after its function has returned. 
  6901.   If non-nil RESTART should be a number indicating the value at which the
  6902.   timer should be set at restart time.
  6903. Returns the newly created timer.
  6904. Vauto-save-timeout
  6905. *Number of seconds idle time before auto-save.
  6906. Zero or nil means disable auto-saving due to idleness.
  6907.  
  6908. The actual amount of idle time between auto-saves is logarithmically related
  6909. to the size of the current buffer.  This variable is the number of seconds
  6910. after which an auto-save will happen when the current buffer is 50k or less;
  6911. the timeout will be 2 1/4 times this in a 200k buffer, 3 3/4 times this in a
  6912. 1000k buffer, and 4 1/2 times this in a 2000k buffer.
  6913.  
  6914. For this variable to have any effect, you must do (require 'timer).
  6915.  
  6916. See also the variable `auto-save-interval', which controls auto-saving based
  6917. on the number of characters typed.
  6918. Frun-scheme
  6919. Run an inferior Scheme process.
  6920. Output goes to the buffer `*scheme*'.
  6921. With argument, asks for a command line.
  6922. Fscheme-mode
  6923. Major mode for editing Scheme code.
  6924. Editing commands are similar to those of lisp-mode.
  6925.  
  6926. In addition, if an inferior Scheme process is running, some additional
  6927. commands will be defined, for evaluating expressions and controlling
  6928. the interpreter, and the state of the process will be displayed in the
  6929. modeline of all Scheme buffers.  The names of commands that interact
  6930. with the Scheme process start with "xscheme-".  For more information
  6931. see the documentation for xscheme-interaction-mode.
  6932.  
  6933. Commands:
  6934. Delete converts tabs to spaces as it moves back.
  6935. Blank lines separate paragraphs.  Semicolons start comments.
  6936. \{scheme-mode-map}
  6937. Entry to this mode calls the value of scheme-mode-hook
  6938. if that value is non-nil.
  6939. Fscribe-mode
  6940. Major mode for editing files of Scribe (a text formatter) source.
  6941. Scribe-mode is similar text-mode, with a few extra commands added.
  6942. \{scribe-mode-map}
  6943.  
  6944. Interesting variables:
  6945.  
  6946. scribe-fancy-paragraphs
  6947.   Non-nil makes Scribe mode use a different style of paragraph separation.
  6948.  
  6949. scribe-electric-quote
  6950.   Non-nil makes insert of double quote use `` or '' depending on context.
  6951.  
  6952. scribe-electric-parenthesis
  6953.   Non-nil makes an open-parenthesis char (one of `([<{')
  6954.   automatically insert its close if typed after an @Command form.
  6955. Vsend-mail-function
  6956. Function to call to send the current buffer as mail.
  6957. The headers are delimited by a string found in mail-header-separator.
  6958. Vmail-self-blind
  6959. *Non-nil means insert BCC to self in messages to be sent.
  6960. This is done when the message is initialized,
  6961. so you can remove or alter the BCC field to override the default.
  6962. Vmail-interactive
  6963. *Non-nil means when sending a message wait for and display errors.
  6964. nil means let mailer mail back a message to report errors.
  6965. Vmail-yank-ignored-headers
  6966. Delete these headers from old message when it's inserted in a reply.
  6967. Vmail-header-separator
  6968. *Line used to separate headers from text in messages being composed.
  6969. Vmail-archive-file-name
  6970. *Name of file to write all outgoing messages in, or nil for none.
  6971. Do not use an rmail file here!  Instead, use its inbox file.
  6972. Vmail-signature-file
  6973. File to be inserted at the end of a message. Usually, this file is called
  6974. "~/.signature".
  6975. Vmail-aliases
  6976. Word-abbrev table of mail address aliases.
  6977. If this is nil, it means the aliases have not yet been initialized and
  6978. should be read from the .mailrc file.  (This is distinct from there being
  6979. no aliases, which is represented by this being a table with no entries.)
  6980. Vmail-abbrev-mailrc-file
  6981. Name of file with mail aliases.   If nil, ~/.mailrc is used.
  6982. Fmail-other-window
  6983. Like `mail' command, but display mail buffer in another window.
  6984. Fmail
  6985. Edit a message to be sent.  Argument means resume editing (don't erase).
  6986. Returns with message buffer selected; value t if message freshly initialized.
  6987. While editing message, type C-c C-c to send the message and exit.
  6988.  
  6989. Various special commands starting with C-c are available in sendmail mode
  6990. to move to message header fields:
  6991. \{mail-mode-map}
  6992.  
  6993. If mail-self-blind is non-nil, a BCC to yourself is inserted
  6994. when the message is initialized.
  6995.  
  6996. If mail-default-reply-to is non-nil, it should be an address (a string);
  6997. a Reply-to: field with that address is inserted.
  6998.  
  6999. If mail-archive-file-name is non-nil, an FCC field with that file name
  7000. is inserted.
  7001.  
  7002. If mail-setup-hook is bound, its value is called with no arguments
  7003. after the message is initialized.  It can add more default fields.
  7004.  
  7005. When calling from a program, the second through fifth arguments
  7006.  TO, SUBJECT, IN-REPLY-TO and CC specify if non-nil
  7007.  the initial contents of those header fields.
  7008.  These arguments should not have final newlines.
  7009. The sixth argument REPLYBUFFER is a buffer whose contents
  7010.  should be yanked if the user types C-c C-y.
  7011. Fmail-mode
  7012. Major mode for editing mail to be sent.
  7013. Like Text Mode but with these additional commands:
  7014. C-c C-s  mail-send (send the message)    C-c C-c  mail-send-and-exit
  7015. C-c C-f  move to a header field (and create it if there isn't):
  7016.      C-c C-f C-t  move to To:    C-c C-f C-s  move to Subj:
  7017.      C-c C-f C-b  move to BCC:    C-c C-f C-c  move to CC:
  7018. C-c C-t  move to message text.
  7019. C-c C-w  mail-signature (insert ~/.signature at end).
  7020. C-c C-y  mail-yank-original (insert current message, in Rmail).
  7021. C-c C-q  mail-fill-yanked-message (fill what was yanked).
  7022. Vmail-use-rfc822
  7023. *If non-nil, use a full, hairy RFC822 parser on mail addresses.
  7024. Otherwise, (the default) use a smaller, somewhat faster and
  7025. often-correct parser.
  7026. Ffeedmail-send-it
  7027. Replacement for sendmail-send-it.  Do this to use it:
  7028. (setq send-mail-function 'feedmail-send-it)
  7029. Fserver-start
  7030. Allow this Emacs process to be a server for client processes.
  7031. This starts a server communications subprocess through which
  7032. client "editors" can send your editing commands to this Emacs job.
  7033. To use the server, set up the program `etc/emacsclient' in the
  7034. Emacs distribution as your standard "editor".
  7035.  
  7036. Prefix arg means just kill any existing server communications subprocess.
  7037. Frun-lisp
  7038. Run an inferior Lisp process, input and output via buffer *lisp*.
  7039. Fshell
  7040. Run an inferior shell, with I/O through buffer *shell*.
  7041. If buffer exists but shell process is not running, make new shell.
  7042. Program used comes from variable explicit-shell-file-name,
  7043.  or (if that is nil) from the ESHELL environment variable,
  7044.  or else from SHELL if there is no ESHELL.
  7045. If a file ~/.emacs_SHELLNAME exists, it is given as initial input
  7046.  (Note that this may lose due to a timing error if the shell
  7047.   discards input when it starts up.)
  7048. The buffer is put in shell-mode, giving commands for sending input
  7049. and controlling the subjobs of the shell.  See shell-mode.
  7050. See also variable shell-prompt-pattern.
  7051.  
  7052. The shell file name (sans directories) is used to make a symbol name
  7053. such as `explicit-csh-arguments'.  If that symbol is a variable,
  7054. its value is used as a list of arguments when invoking the shell.
  7055. Otherwise, one argument `-i' is passed to the shell.
  7056.  
  7057. Note that many people's .cshrc files unconditionally clear the prompt.
  7058. If yours does, you will probably want to change it.
  7059. Fcomint-dynamic-complete
  7060. Dynamically complete the filename at point.
  7061. This function is similar to comint-replace-by-expanded-filename, except
  7062. that it won't change parts of the filename already entered in the buffer; 
  7063. it just adds completion characters to the end of the filename.
  7064. Fcomint-dynamic-list-completions
  7065. List in help buffer all possible completions of the filename at point.
  7066. Fsort-lines
  7067. Sort lines in region alphabetically; argument means descending order.
  7068. Called from a program, there are three arguments:
  7069. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  7070. Fsort-paragraphs
  7071. Sort paragraphs in region alphabetically; argument means descending order.
  7072. Called from a program, there are three arguments:
  7073. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  7074. Fsort-pages
  7075. Sort pages in region alphabetically; argument means descending order.
  7076. Called from a program, there are three arguments:
  7077. REVERSE (non-nil means reverse order), BEG and END (region to sort).
  7078. Fsort-numeric-fields
  7079. Sort lines in region numerically by the ARGth field of each line.
  7080. Fields are separated by whitespace and numbered from 1 up.
  7081. Specified field must contain a number in each line of the region.
  7082. With a negative arg, sorts by the -ARG'th field, in reverse order.
  7083. Called from a program, there are three arguments:
  7084. FIELD, BEG and END.  BEG and END specify region to sort.
  7085. Fsort-fields
  7086. Sort lines in region lexicographically by the ARGth field of each line.
  7087. Fields are separated by whitespace and numbered from 1 up.
  7088. With a negative arg, sorts by the -ARG'th field, in reverse order.
  7089. Called from a program, there are three arguments:
  7090. FIELD, BEG and END.  BEG and END specify region to sort.
  7091. Fsort-columns
  7092. Sort lines in region alphabetically by a certain range of columns.
  7093. For the purpose of this command, the region includes
  7094. the entire line that point is in and the entire line the mark is in.
  7095. The column positions of point and mark bound the range of columns to sort on.
  7096. A prefix argument means sort into reverse order.
  7097.  
  7098. Note that sort-columns uses the sort utility program and therefore
  7099. cannot work on text containing TAB characters.  Use M-x untabify
  7100. to convert tabs to spaces before sorting.
  7101. Fsort-regexp-fields
  7102. Sort the region lexicographically as specifed by RECORD-REGEXP and KEY.
  7103. RECORD-REGEXP specifies the textual units which should be sorted.
  7104.   For example, to sort lines RECORD-REGEXP would be "^.*$"
  7105. KEY specifies the part of each record (ie each match for RECORD-REGEXP)
  7106.   is to be used for sorting.
  7107.   If it is "\digit" then the digit'th "\(...\)" match field from
  7108.   RECORD-REGEXP is used.
  7109.   If it is "\&" then the whole record is used.
  7110.   Otherwise, it is a regular-expression for which to search within the record.
  7111. If a match for KEY is not found within a record then that record is ignored.
  7112.  
  7113. With a negative prefix arg sorts in reverse order.
  7114.  
  7115. For example: to sort lines in the region by the first word on each line
  7116.  starting with the letter "f",
  7117.  RECORD-REGEXP would be "^.*$" and KEY would be "\=\<f\w*\>"
  7118. Fspell-buffer
  7119. Check spelling of every word in the buffer.
  7120. For each incorrect word, you are asked for the correct spelling
  7121. and then put into a query-replace to fix some or all occurrences.
  7122. If you do not want to change a word, just give the same word
  7123. as its "correct" spelling; then the query replace is skipped.
  7124. Fspell-region
  7125. Like spell-buffer but applies only to region.
  7126. From program, applies from START to END.
  7127. Fspell-word
  7128. Check spelling of word at or before point.
  7129. If it is not correct, ask user for the correct spelling
  7130. and query-replace the entire buffer to substitute it.
  7131. Fspell-string
  7132. Check spelling of string supplied as argument.
  7133. Funtabify
  7134. Convert all tabs in region to multiple spaces, preserving columns.
  7135. The variable tab-width controls the action.
  7136. Ftabify
  7137. Convert multiple spaces in region to tabs when possible.
  7138. A group of spaces is partially replaced by tabs
  7139. when this can be done without changing the column they end at.
  7140. The variable tab-width controls the action.
  7141. Ffind-tag
  7142. *Find tag whose name contains TAGNAME.
  7143. Selects the buffer that the tag is contained in and puts
  7144.  point at its definition.
  7145. If TAGNAME is a null string, the expression in the buffer
  7146.  around or before point is used as the tag name.
  7147. If second arg NEXT is non-nil (interactively, with prefix arg),
  7148.  searches for the next tag in the tag table that matches the
  7149.  tagname used in the previous find-tag.
  7150.  
  7151. Multiple active tags tables and completion are supported.
  7152.  
  7153. Variables of note:
  7154.  
  7155.   tag-table-alist        controls which tables apply to which buffers
  7156.   tags-file-name        a default tags table
  7157.   tags-build-completion-table   controls completion behavior
  7158.   buffer-tag-table        another way of specifying a buffer-local table
  7159.   make-tags-files-invisible    whether tags tables should be very hidden
  7160.   tag-mark-stack-max        how many tags-based hops to remember
  7161. Ffind-tag-other-window
  7162. *Find tag whose name contains TAGNAME.
  7163. Selects the buffer that the tag is contained in in another window
  7164.  and puts point at its definition.
  7165. If TAGNAME is a null string, the expression in the buffer
  7166.  around or before point is used as the tag name.
  7167. If second arg NEXT is non-nil (interactively, with prefix arg),
  7168.  searches for the next tag in the tag table that matches the
  7169.  tagname used in the previous find-tag.
  7170.  
  7171. Multiple active tags tables and completion are supported.
  7172.  
  7173. Variables of note:
  7174.  
  7175.   tag-table-alist        controls which tables apply to which buffers
  7176.   tags-file-name        a default tags table
  7177.   tags-build-completion-table   controls completion behavior
  7178.   buffer-tag-table        another way of specifying a buffer-local table
  7179.   make-tags-files-invisible    whether tags tables should be very hidden
  7180.   tag-mark-stack-max        how many tags-based hops to remember
  7181. Flist-tags
  7182. Display list of tags in file FILE.
  7183. FILE should not contain a directory spec
  7184. unless it has one in the tag table.
  7185. Fnext-file
  7186. Select next file among files in current tag table(s).
  7187. Non-nil argument (prefix arg, if interactive)
  7188. initializes to the beginning of the list of files in the (first) tag table.
  7189. Ftags-apropos
  7190. Display list of all tags in tag table REGEXP matches.
  7191. Ftags-loop-continue
  7192. Continue last \[tags-search] or \[tags-query-replace] command.
  7193. Used noninteractively with non-nil argument
  7194. to begin such a command.  See variable tags-loop-form.
  7195. Ftag-table-files
  7196. Returns a list of the files referenced by the named TAGS table.
  7197. Ftags-query-replace
  7198. Query-replace-regexp FROM with TO through all files listed in tag table.
  7199. Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
  7200. If you exit (C-G or ESC), you can resume the query-replace
  7201. with the command \[tags-loop-continue].
  7202.  
  7203. See documentation of variable tag-table-alist.
  7204. Ftags-search
  7205. Search through all files listed in tag table for match for REGEXP.
  7206. Stops when a match is found.
  7207. To continue searching for next match, use command \[tags-loop-continue].
  7208.  
  7209. See documentation of variable tag-table-alist.
  7210. Fvisit-tags-table
  7211. Tell tags commands to use tags table file FILE first.
  7212. FILE should be the name of a file created with the `etags' program.
  7213. A directory name is ok too; it means file TAGS in that directory.
  7214. This function is largely obsoleted by the variable tag-table-alist.
  7215. Ftelnet
  7216. Open a network login connection to host named HOST (a string).
  7217. Communication with HOST is recorded in a buffer *HOST-telnet*.
  7218. Normally input is edited in Emacs and sent a line at a time.
  7219. See also `\[rsh]'.
  7220. Frsh
  7221. Open a network login connection to host named HOST (a string).
  7222. Communication with HOST is recorded in a buffer *HOST-rsh*.
  7223. Normally input is edited in Emacs and sent a line at a time.
  7224. See also `\[telnet]'.
  7225. Fterminal-emulator
  7226. Under a display-terminal emulator in BUFFER, run PROGRAM on arguments ARGS.
  7227. ARGS is a list of argument-strings.  Remaining arguments are WIDTH and HEIGHT.
  7228. BUFFER's contents are made an image of the display generated by that program,
  7229. and any input typed when BUFFER is the current Emacs buffer is sent to that
  7230. program an keyboard input.
  7231.  
  7232. Interactively, BUFFER defaults to "*terminal*" and PROGRAM and ARGS
  7233. are parsed from an input-string using your usual shell.
  7234. WIDTH and HEIGHT are determined from the size of the current window
  7235. -- WIDTH will be one less than the window's width, HEIGHT will be its height.
  7236.  
  7237. To switch buffers and leave the emulator, or to give commands
  7238. to the emulator itself (as opposed to the program running under it),
  7239. type Control-^.  The following character is an emulator command.
  7240. Type Control-^ twice to send it to the subprogram.
  7241. This escape character may be changed using the variable `terminal-escape-char'.
  7242.  
  7243. `Meta' characters may not currently be sent through the terminal emulator.
  7244.  
  7245. Here is a list of some of the variables which control the behaviour
  7246. of the emulator -- see their documentation for more information:
  7247. terminal-escape-char, terminal-scrolling, terminal-more-processing,
  7248. terminal-redisplay-interval.
  7249.  
  7250. This function calls the value of terminal-mode-hook if that exists
  7251. and is non-nil after the terminal buffer has been set up and the
  7252. subprocess started.
  7253.  
  7254. Presently with `termcap' only; if somebody sends us code to make this
  7255. work with `terminfo' we will try to use it.
  7256. Flatex-mode
  7257. Major mode for editing files of input for LaTeX.
  7258. Makes $ and } display the characters they match.
  7259. Makes " insert `` when it seems to be the beginning of a quotation,
  7260. and '' when it appears to be the end; it inserts " only after a \.
  7261.  
  7262. Use \[TeX-region] to run LaTeX on the current region, plus the preamble
  7263. copied from the top of the file (containing \documentstyle, etc.),
  7264. running LaTeX under a special subshell.  \[TeX-buffer] does the whole buffer.
  7265. \[TeX-print] prints the .dvi file made by either of these.
  7266.  
  7267. Use \[validate-TeX-buffer] to check buffer for paragraphs containing
  7268. mismatched $'s or braces.
  7269.  
  7270. Special commands:
  7271. \{TeX-mode-map}
  7272.  
  7273. Mode variables:
  7274. TeX-directory
  7275.     Directory in which to create temporary files for TeX jobs
  7276.     run by \[TeX-region] or \[TeX-buffer].
  7277. TeX-dvi-print-command
  7278.     Command string used by \[TeX-print] to print a .dvi file.
  7279. TeX-show-queue-command
  7280.     Command string used by \[TeX-show-print-queue] to show the print
  7281.     queue that \[TeX-print] put your job on.
  7282.  
  7283. Entering LaTeX mode calls the value of text-mode-hook,
  7284. then the value of TeX-mode-hook, and then the value
  7285. of LaTeX-mode-hook.
  7286. Fplain-tex-mode
  7287. Major mode for editing files of input for plain TeX.
  7288. Makes $ and } display the characters they match.
  7289. Makes " insert `` when it seems to be the beginning of a quotation,
  7290. and '' when it appears to be the end; it inserts " only after a \.
  7291.  
  7292. Use \[TeX-region] to run TeX on the current region, plus a "header"
  7293. copied from the top of the file (containing macro definitions, etc.),
  7294. running TeX under a special subshell.  \[TeX-buffer] does the whole buffer.
  7295. \[TeX-print] prints the .dvi file made by either of these.
  7296.  
  7297. Use \[validate-TeX-buffer] to check buffer for paragraphs containing
  7298. mismatched $'s or braces.
  7299.  
  7300. Special commands:
  7301. \{TeX-mode-map}
  7302.  
  7303. Mode variables:
  7304. TeX-directory
  7305.     Directory in which to create temporary files for TeX jobs
  7306.     run by \[TeX-region] or \[TeX-buffer].
  7307. TeX-dvi-print-command
  7308.     Command string used by \[TeX-print] to print a .dvi file.
  7309. TeX-show-queue-command
  7310.     Command string used by \[TeX-show-print-queue] to show the print
  7311.     queue that \[TeX-print] put your job on.
  7312.  
  7313. Entering plain-TeX mode calls the value of text-mode-hook,
  7314. then the value of TeX-mode-hook, and then the value
  7315. of plain-TeX-mode-hook.
  7316. Ftex-mode
  7317. Major mode for editing files of input for TeX or LaTeX.
  7318. Trys to intuit whether this file is for plain TeX or LaTeX and
  7319. calls plain-tex-mode or latex-mode.  If it cannot be determined
  7320. (e.g., there are no commands in the file), the value of
  7321. TeX-default-mode is used.
  7322. Ftexinfo-mode
  7323. Major mode for editing texinfo files.
  7324. These are files that are input for TEX and also to be turned
  7325. into Info files by \[texinfo-format-buffer].
  7326. These files must be written in a very restricted and
  7327. modified version of TEX input format.
  7328.  
  7329. As for editing commands, like text-mode except for syntax table,
  7330. which is set up so expression commands skip texinfo bracket groups.
  7331. Ftexinfo-format-buffer
  7332. Process the current buffer as texinfo code, into an Info file.
  7333. The Info file output is generated in a buffer
  7334. visiting the Info file names specified in the @setfilename command.
  7335.  
  7336. Non-nil argument (prefix, if interactive) means don't make tag table
  7337. and don't split the file if large.  You can use Info-tagify and
  7338. Info-split to do these manually.
  7339. Ftexinfo-format-region
  7340. Convert the the current region of the Texinfo file to Info format.
  7341. This lets you see what that part of the file will look like in Info.
  7342. The command is bound to \[texinfo-format-region].  The text that is
  7343. converted to Info is stored in a temporary buffer.
  7344. Fbatch-texinfo-format
  7345. Runs  texinfo-format-buffer  on the files remaining on the command line.
  7346. Must be used only with -batch, and kills emacs on completion.
  7347. Each file will be processed even if an error occurred previously.
  7348. For example, invoke
  7349.   "emacs -batch -funcall batch-texinfo-format $docs/ ~/*.texinfo".
  7350. Fdisplay-time
  7351. Display current time and load level in mode line of each buffer.
  7352. Updates automatically every minute.
  7353. If display-time-day-and-date is non-nil, the current day and date
  7354. are displayed as well.
  7355. Funderline-region
  7356. Underline all nonblank characters in the region.
  7357. Works by overstriking underscores.
  7358. Called from program, takes two arguments START and END
  7359. which specify the range to operate on.
  7360. Fununderline-region
  7361. Remove all underlining (overstruck underscores) in the region.
  7362. Called from program, takes two arguments START and END
  7363. which specify the range to operate on.
  7364. Fask-user-about-lock
  7365. Ask user what to do when he wants to edit FILE but it is locked by USER.
  7366. This function has a choice of three things to do:
  7367.   do (signal 'buffer-file-locked (list FILE USER))
  7368.     to refrain from editing the file
  7369.   return t (grab the lock on the file)
  7370.   return nil (edit the file even though it is locked).
  7371. You can rewrite it to use any criterion you like to choose which one to do.
  7372. Fask-user-about-supersession-threat
  7373. Ask a user who is about to modify an obsolete buffer what to do.
  7374. This function has two choices: it can return, in which case the modification
  7375. of the buffer will proceed, or it can (signal 'file-supersession (file)),
  7376. in which case the proposed buffer modification will not be made.
  7377.  
  7378. You can rewrite this to use any criterion you like to choose which one to do.
  7379. The buffer in question is current when this function is called.
  7380. Fvi-mode
  7381. Major mode that acts like the `vi' editor.
  7382. The purpose of this mode is to provide you the combined power of vi (namely,
  7383. the "cross product" effect of commands and repeat last changes) and Emacs.
  7384.  
  7385. This command redefines nearly all keys to look like vi commands.
  7386. It records the previous major mode, and any vi command for input
  7387. (`i', `a', `s', etc.) switches back to that mode.
  7388. Thus, ordinary Emacs (in whatever major mode you had been using)
  7389. is "input" mode as far as vi is concerned.
  7390.  
  7391. To get back into vi from "input" mode, you must issue this command again.
  7392. Therefore, it is recommended that you assign it to a key.
  7393.  
  7394. Major differences between this mode and real vi :
  7395.  
  7396. * Limitations and unsupported features
  7397.   - Search patterns with line offset (e.g. /pat/+3 or /pat/z.) are
  7398.     not supported.
  7399.   - Ex commands are not implemented; try ':' to get some hints.
  7400.   - No line undo (i.e. the 'U' command), but multi-undo is a standard feature.
  7401.  
  7402. * Modifications
  7403.   - The stopping positions for some point motion commands (word boundary,
  7404.     pattern search) are slightly different from standard 'vi'.
  7405.     Also, no automatic wrap around at end of buffer for pattern searching.
  7406.   - Since changes are done in two steps (deletion then insertion), you need
  7407.     to undo twice to completely undo a change command.  But this is not needed
  7408.     for undoing a repeated change command.
  7409.   - No need to set/unset 'magic', to search for a string with regular expr
  7410.     in it just put a prefix arg for the search commands.  Replace cmds too.
  7411.   - ^R is bound to incremental backward search, so use ^L to redraw screen.
  7412.  
  7413. * Extensions
  7414.   - Some standard (or modified) Emacs commands were integrated, such as
  7415.     incremental search, query replace, transpose objects, and keyboard macros.
  7416.   - In command state, ^X links to the 'ctl-x-map', and ESC can be linked to
  7417.     esc-map or set undefined.  These can give you the full power of Emacs.
  7418.   - See vi-com-map for those keys that are extensions to standard vi, e.g.
  7419.     `vi-name-last-change-or-macro', `vi-verify-spelling', `vi-locate-def',
  7420.     `vi-mark-region', and 'vi-quote-words'.  Some of them are quite handy.
  7421.   - Use \[vi-switch-mode] to switch among different modes quickly.
  7422.   
  7423. Syntax table and abbrevs while in vi mode remain as they were in Emacs.
  7424. Fview-file
  7425. Find FILE, enter view mode.  With prefix arg use other window.
  7426. Fview-buffer
  7427. Switch to BUF, enter view mode.  With prefix arg use other window.
  7428. Fview-mode
  7429. Mode for viewing text, with bindings like `less'.
  7430. Fvip-mode
  7431. Begin emulating the vi editor.  This is distinct from `vi-mode'.
  7432. This emulator has different capabilities from the `vi-mode' emulator.
  7433. See the text at the beginning of the source file .../lisp/vip.el
  7434. in the Emacs distribution.
  7435. Fevi
  7436. Start vi emulation in this buffer.  Of all the those available, this
  7437. emulator most closely resembles vi.
  7438. See the text at the beginning of the source file .../lisp/evi.el
  7439. in the Emacs distribution.
  7440. Fyow
  7441. Return or display a Zippy quotation
  7442. Fpsychoanalyze-pinhead
  7443. Zippy goes to the analyst.
  7444. Fquery-replace
  7445. Replace some occurrences of FROM-STRING with TO-STRING.
  7446. As each match is found, the user must type a character saying
  7447. what to do with it.  For directions, type \[help-command] at that time.
  7448.  
  7449. Preserves case in each replacement if  case-replace  and  case-fold-search
  7450. are non-nil and FROM-STRING has no uppercase letters.
  7451. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  7452. only matches surrounded by word boundaries.
  7453. Fquery-replace-regexp
  7454. Replace some things after point matching REGEXP with TO-STRING.
  7455. As each match is found, the user must type a character saying
  7456. what to do with it.  For directions, type \[help-command] at that time.
  7457.  
  7458. Preserves case in each replacement if  case-replace  and  case-fold-search
  7459. are non-nil and REGEXP has no uppercase letters.
  7460. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  7461. only matches surrounded by word boundaries.
  7462. In TO-STRING, \& means insert what matched REGEXP,
  7463. and \=\<n> means insert what matched <n>th \(...\) in REGEXP.
  7464. Fmap-query-replace-regexp
  7465. Replace some matches for REGEXP with various strings, in rotation.
  7466. The second argument TO-STRINGS contains the replacement strings, separated
  7467. by spaces.  This command works like `query-replace-regexp' except
  7468. that each successive replacement uses the next successive replacement string,
  7469. wrapping around from the last such string to the first.
  7470.  
  7471. Non-interactively, TO-STRINGS may be a list of replacement strings.
  7472.  
  7473. A prefix argument N says to use each replacement string N times
  7474. before rotating to the next.
  7475. Freplace-string
  7476. Replace occurrences of FROM-STRING with TO-STRING.
  7477. Preserve case in each match if `case-replace' and `case-fold-search'
  7478. are non-nil and FROM-STRING has no uppercase letters.
  7479. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  7480. only matches surrounded by word boundaries.
  7481.  
  7482. This function is usually the wrong thing to use in a Lisp program.
  7483. What you probably want is a loop like this:
  7484.   (while (search-forward OLD-STRING nil t)
  7485.     (replace-match REPLACEMENT nil t))
  7486. which will run faster and will not set the mark or print anything.
  7487. Freplace-regexp
  7488. Replace things after point matching REGEXP with TO-STRING.
  7489. Preserve case in each match if case-replace and case-fold-search
  7490. are non-nil and REGEXP has no uppercase letters.
  7491. Third arg DELIMITED (prefix arg if interactive) non-nil means replace
  7492. only matches surrounded by word boundaries.
  7493. In TO-STRING, \& means insert what matched REGEXP,
  7494. and \=\<n> means insert what matched <n>th \(...\) in REGEXP.
  7495.  
  7496. This function is usually the wrong thing to use in a Lisp program.
  7497. What you probably want is a loop like this:
  7498.   (while (re-search-forward REGEXP nil t)
  7499.     (replace-match REPLACEMENT nil nil))
  7500. which will run faster and will not set the mark or print anything.
  7501. Fload-sound-file
  7502. Read in an audio-file and add it to the sound-alist.
  7503. Fload-default-sounds
  7504. Load and install some sound files as beep-types.
  7505. This only works if you're on display 0 of a Sun SparcStation.
  7506. Fvm
  7507. View Mail: an alternate mail reader for emacs.
  7508. Optional first arg FOLDER specifies the folder to visit.  It defaults
  7509. to the value of vm-primary-inbox.  The folder buffer is put into VM
  7510. mode, a major mode for reading mail.
  7511.  
  7512. Prefix arg or optional second arg READ-ONLY non-nil indicates
  7513. that the folder should be considered read only.  No attribute
  7514. changes, messages additions or deletions will be allowed in the
  7515. visited folder.
  7516.  
  7517. Visiting the primary inbox causes any contents of the system mailbox to
  7518. be moved and appended to the resulting buffer.
  7519.  
  7520. All the messages can be read by repeatedly pressing SPC.  Use `n'ext and
  7521. `p'revious to move about in the folder.  Messages are marked for
  7522. deletion with `d', and saved to another folder with `s'.  Quitting VM
  7523. with `q' expunges deleted messages and saves the buffered folder to
  7524. disk.
  7525.  
  7526. See the documentation for vm-mode for more information.
  7527. Fvm-mode
  7528. View Mail: an alternate mail reader for emacs.
  7529.  
  7530. Commands:
  7531.    h - summarize folder contents
  7532.    j - discard cached information about the current message
  7533.  
  7534.    n - go to next message
  7535.    p - go to previous message
  7536.    N - like `n' but ignores skip-variable settings
  7537.    P - like `p' but ignores skip-variable settings
  7538.  M-n - go to next unread message
  7539.  M-p - go to previous unread message
  7540.  RET - go to numbered message (uses prefix arg or prompts in minibuffer)
  7541.  TAB - go to last message seen
  7542.  M-s - incremental search through the folder
  7543.  
  7544.    t - display hidden headers
  7545.  SPC - scroll forward a page (if at end of message, then display next message)
  7546.    b - scroll backward a page
  7547.    < - go to beginning of current message
  7548.    > - go to end of current message
  7549.  
  7550.    d - delete message, prefix arg deletes messages forward (flag as deleted)
  7551.  C-d - delete message, prefix arg deletes messages backward (flag as deleted)
  7552.    u - undelete
  7553.    k - flag for deletion all messages with same subject as the current message
  7554.  
  7555.    r - reply (only to the sender of the message)
  7556.    R - reply with included text for current message
  7557.  M-r - extract and resend bounced message
  7558.    f - followup (reply to all recipients of message)
  7559.    F - followup with included text from the current message
  7560.    z - forward the current message
  7561.    m - send a message
  7562.    B - resend the current message to another user.
  7563.    c - continue composing the most recent message you were composing
  7564.  
  7565.    @ - digestify and mail entire folder contents (the folder is not modified)
  7566.    * - burst a digest into individual messages, and append and assimilate these
  7567.        message into the current folder.
  7568.  
  7569.    G - group messages according to some criteria
  7570.  
  7571.    g - get any new mail that has arrived in the system mailbox
  7572.        (new mail is appended to the disk and buffer copies of the
  7573.        primary inbox.)
  7574.    v - visit another mail folder
  7575.    V - visit a virtual folder
  7576.  
  7577.    e - edit the current message
  7578.  
  7579.    s - save current message in a folder (appends if folder already exists)
  7580.    w - write current message to a file without its headers (appends if exists)
  7581.    S - save entire folder to disk, expunging deleted messages
  7582.    A - save unfiled messages to their vm-auto-folder-alist specified folders
  7583.    # - expunge deleted messages (without saving folder)
  7584.    q - quit VM, deleted messages are expunged, folder saved to disk
  7585.    x - exit VM with no change to the folder
  7586.  
  7587.  M N - use marks; the next vm command will affect only marked messages
  7588.        if it makes sense for the command to do so
  7589.  
  7590.        M m - mark the current message
  7591.        M u - unmark the current message
  7592.        M M - mark all messsages
  7593.        M U - unmark all messsages
  7594.  
  7595.  C-_ - undo, special undo that retracts the most recent
  7596.              changes in message attributes.  Expunges and saves
  7597.              cannot be undone.  C-x u is also bound to this
  7598.              command.
  7599.  
  7600.    L - reload your VM init file, ~/.vm
  7601.  
  7602.    ? - help
  7603.  
  7604.    ! - run a shell command
  7605.    | - run a shell command with the current message as input
  7606.  
  7607.  M-C - view conditions under which you may redistribute VM
  7608.  M-W - view the details of VM's lack of a warranty
  7609.  
  7610. Variables:
  7611.    vm-auto-center-summary
  7612.    vm-auto-folder-alist
  7613.    vm-auto-folder-case-fold-search
  7614.    vm-auto-next-message
  7615.    vm-berkeley-mail-compatibility
  7616.    vm-circular-folders
  7617.    vm-confirm-new-folders
  7618.    vm-confirm-quit
  7619.    vm-crash-box
  7620.    vm-delete-after-archiving
  7621.    vm-delete-after-bursting
  7622.    vm-delete-after-saving
  7623.    vm-delete-empty-folders
  7624.    vm-digest-center-preamble
  7625.    vm-digest-preamble-format
  7626.    vm-folder-directory
  7627.    vm-folder-read-only
  7628.    vm-follow-summary-cursor
  7629.    vm-forwarding-subject-format
  7630.    vm-gargle-uucp
  7631.    vm-group-by
  7632.    vm-highlighted-header-regexp
  7633.    vm-honor-page-delimiters
  7634.    vm-in-reply-to-format
  7635.    vm-included-text-attribution-format
  7636.    vm-included-text-prefix
  7637.    vm-inhibit-startup-message
  7638.    vm-invisible-header-regexp
  7639.    vm-keep-sent-messages
  7640.    vm-mail-window-percentage
  7641.    vm-mode-hooks
  7642.    vm-move-after-deleting
  7643.    vm-move-after-undeleting
  7644.    vm-mutable-windows
  7645.    vm-preview-lines
  7646.    vm-preview-read-messages
  7647.    vm-primary-inbox
  7648.    vm-retain-message-order
  7649.    vm-reply-ignored-addresses
  7650.    vm-reply-subject-prefix
  7651.    vm-rfc934-forwarding
  7652.    vm-search-using-regexps
  7653.    vm-skip-deleted-messages
  7654.    vm-skip-read-messages
  7655.    vm-spool-files
  7656.    vm-startup-with-summary
  7657.    vm-strip-reply-headers
  7658.    vm-summary-format
  7659.    vm-virtual-folder-alist
  7660.    vm-virtual-mirror
  7661.    vm-visible-headers
  7662.    vm-visit-when-saving
  7663. Fvm-visit-folder
  7664. Visit a mail file with View Mail, an alternate mail reader for emacs.
  7665. See the description of the `vm' and `vm-mode' functions.
  7666.  
  7667. VM will parse and present its messages to you in the usual way.
  7668.  
  7669. First arg FOLDER specifies the mail file to visit.  When this
  7670. command is called interactively the file name is read from the
  7671. minibuffer.
  7672.  
  7673. Prefix arg or optional second arg READ-ONLY non-nil indicates
  7674. that the folder should be considered read only.  No attribute
  7675. changes, messages additions or deletions will be allowed in the
  7676. visited folder.
  7677. Fvm-mail
  7678. Send a mail message from within View Mail, or from without.
  7679. Fwebster
  7680. Look up a word in Webster's 7th edition
  7681. Fwebster-spell
  7682. Search for an approximately-spelled word in Webster's 7th edition
  7683. Fwebster-endings
  7684. Search for a word in Webster's 7th edition that begins with a certain prefix
  7685. Fpostscript-mode
  7686. Major mode for editing PostScript programs.
  7687. Fgnus
  7688. Read network news.
  7689. Fgnus-post-news
  7690. Post a netnews article.
  7691. Ftar-mode
  7692. Major mode for editing `tar' (tape archive) files in a dired-like manner.
  7693. Fconx
  7694. Generate some random sentences in the *conx* buffer.
  7695. Output will be continuously generated until you type ^G.
  7696. Before running this function, you must snarf some text into the CONX 
  7697. database with the M-x conx-buffer or M-x conx-region commands.
  7698. Fconx-load
  7699. Load a CONX database that has been previously saved with M-x conx-save.
  7700. Fconx-buffer
  7701. Absorb the text in the current buffer into the CONX database;
  7702. use the M-x conx command to generate random sentences based on the
  7703. word frequency in this buffer.  Multiple uses of this function are
  7704. additive; to clear the database and start over, use M-x conx-init.
  7705. Fconx-region
  7706. Absorb the text in the current buffer into the CONX database;
  7707. use the M-x conx command to generate random sentences based on the
  7708. word frequency in this region.  Multiple uses of this function are
  7709. additive; to clear the database and start over, use M-x conx-init.
  7710. Fwith-timeout
  7711. Usage: (with-timeout (seconds &rest timeout-forms) &rest body)
  7712. This is just like progn, but if the given number of seconds expires before
  7713. the body returns, then timeout-forms are evaluated and returned instead.
  7714. The body won't be interrupted in the middle of a computation: the check for 
  7715. the timer expiration only occurs when body does a redisplay, or prompts the
  7716. user for input, or calls accept-process-output.
  7717. Fyes-or-no-p-with-timeout
  7718. Just like yes-or-no-p, but will time out after TIMEOUT seconds
  7719. if the user has not yes answered, returning DEFAULT-VALUE.
  7720. Fy-or-n-p-with-timeout
  7721. Just like y-or-n-p, but will time out after TIMEOUT seconds
  7722. if the user has not yes answered, returning DEFAULT-VALUE.
  7723. Fhighlight-headers
  7724. Highlight message headers between start and end.
  7725. Faces used:
  7726.   message-headers            the part before the colon
  7727.   message-header-contents        the part after the colon
  7728.   message-highlighted-header-contents    contents of "special" headers
  7729.   message-cited-text            quoted text from other messages
  7730.  
  7731. Variables used:
  7732.  
  7733.   highlight-headers-regexp            what makes a "special" header
  7734.   highlight-headers-citation-regexp        matches lines of quoted text
  7735.   highlight-headers-citation-header-regexp    matches headers for quoted text
  7736.  
  7737. If HACK-SIG is true,then we search backward from END for something that
  7738. looks like the beginning of a signature block, and don't consider that a
  7739. part of the message (this is because signatures are often incorrectly
  7740. interpreted as cited text.)
  7741. Frun-ilisp
  7742. Select a new inferior LISP.
  7743. Fclisp
  7744. Run an inferior generic Common LISP.
  7745. Fallegro
  7746. Run an inferior Allegro Common LISP.
  7747. Flucid
  7748. Run an inferior Lucid Common LISP.
  7749. Fcmulisp
  7750. Run an inferior CMU Common LISP.
  7751. Fkcl
  7752. Run an inferior Kyoto Common LISP.
  7753. Fscheme
  7754. Run an inferior generic Scheme.
  7755. Foaklisp
  7756. Run an inferior Oaklisp Scheme.
  7757. Fopen-line
  7758. Insert a newline and leave point before it.  If there is a fill
  7759. prefix, inserts the fill prefix after the newline that it inserts.
  7760. With arg, inserts that many newlines.
  7761. Fsplit-line
  7762. Split current line, moving portion beyond point vertically down.
  7763. Fquoted-insert
  7764. Read next input character and insert it.
  7765. Useful for inserting control characters.
  7766. You may also type up to 3 octal digits, to insert a character with that code
  7767. Fdelete-indentation
  7768. Join this line to previous and fix up whitespace at join.
  7769. With argument, join this line to following line.
  7770. Ffixup-whitespace
  7771. Fixup white space between objects around point.
  7772. Leave one space or none, according to the context.
  7773. Fdelete-horizontal-space
  7774. Delete all spaces and tabs around point.
  7775. Fjust-one-space
  7776. Delete all spaces and tabs around point, leaving one space.
  7777. Fdelete-blank-lines
  7778. On blank line, delete all surrounding blank lines, leaving just one.
  7779. On isolated blank line, delete that one.
  7780. On nonblank line, delete all blank lines that follow it.
  7781. Fback-to-indentation
  7782. Move point to the first non-whitespace character on this line.
  7783. Fnewline-and-indent
  7784. Insert a newline, then indent according to major mode.
  7785. Indentation is done using the current indent-line-function.
  7786. In programming language modes, this is the same as TAB.
  7787. In some text modes, where TAB inserts a tab, this indents to the
  7788. specified left-margin column.
  7789. Freindent-then-newline-and-indent
  7790. Reindent current line, insert newline, then indent the new line.
  7791. Indentation of both lines is done according to the current major mode,
  7792. which means that the current value of indent-line-function is called.
  7793. In programming language modes, this is the same as TAB.
  7794. In some text modes, where TAB inserts a tab, this indents to the
  7795. specified left-margin column.
  7796. Fbackward-delete-char-untabify
  7797. Delete characters backward, changing tabs into spaces.
  7798. Delete ARG chars, and kill (save in kill ring) if KILLP is non-nil.
  7799. Interactively, ARG is the prefix arg (default 1)
  7800. and KILLP is t if prefix arg is was specified.
  7801. Fzap-to-char
  7802. Kill up to and including ARG'th occurrence of CHAR.
  7803. Goes backward if ARG is negative; error if CHAR not found.
  7804. Fbeginning-of-buffer
  7805. Move point to the beginning of the buffer; leave mark at previous position.
  7806. With arg N, put point N/10 of the way from the true beginning.
  7807. Don't use this in Lisp programs!
  7808. (goto-char (point-min)) is faster and avoids clobbering the mark.
  7809. Fend-of-buffer
  7810. Move point to the end of the buffer; leave mark at previous position.
  7811. With arg N, put point N/10 of the way from the true end.
  7812. Don't use this in Lisp programs!
  7813. (goto-char (point-max)) is faster and avoids clobbering the mark.
  7814. Fmark-beginning-of-buffer
  7815. Push a mark at the beginning of the buffer; leave point where it is.
  7816. With arg N, push mark N/10 of the way from the true beginning.
  7817. Fmark-end-of-buffer
  7818. Push a mark at the end of the buffer; leave point where it is.
  7819. With arg N, push mark N/10 of the way from the true end.
  7820. Fmark-whole-buffer
  7821. Put point at beginning and mark at end of buffer.
  7822. Feval-current-buffer
  7823. Evaluate the current buffer as Lisp code.
  7824. Programs can pass argument PRINTFLAG which controls printing of output:
  7825. nil means discard it; anything else is stream for print.
  7826. Fcount-lines-region
  7827. Print number of lines in the region.
  7828. Fwhat-line
  7829. Print the current line number (in the buffer) of point.
  7830. Fcount-lines
  7831. Return number of lines between START and END.
  7832. This is usually the number of newlines between them,
  7833. but will be one more if START is not equal to END
  7834. and the greater of them is not at the start of a line.
  7835. Fwhat-cursor-position
  7836. Print info on cursor position (on screen and within buffer).
  7837. Ffundamental-mode
  7838. Major mode not specialized for anything in particular.
  7839. Other major modes are defined by comparison with this one.
  7840. Feval-expression
  7841. Evaluate EXPRESSION and print value in minibuffer.
  7842. Value is also consed on to front of the variable `values'.
  7843. Fedit-and-eval-command
  7844. Prompting with PROMPT, let user edit COMMAND and eval result.
  7845. COMMAND is a Lisp expression.  Let user edit that expression in
  7846. the minibuffer, then read and evaluate the result.
  7847. Frepeat-complex-command
  7848. Edit and re-evaluate last complex command, or ARGth from last.
  7849. A complex command is one which used the minibuffer.
  7850. The command is placed in the minibuffer as a Lisp form for editing.
  7851. The result is executed, repeating the command as changed.
  7852. If the command has been changed or is not the most recent previous command
  7853. it is added to the front of the command history.
  7854. You can use the minibuffer history commands \<minibuffer-local-map>\[next-history-element] and \[previous-history-element]
  7855. to get different commands to edit and resubmit.
  7856. Fgoto-line
  7857. Goto line ARG, counting from line 1 at beginning of buffer.
  7858. Fundo
  7859. Undo some previous changes.
  7860. Repeat this command to undo more changes.
  7861. A numeric argument serves as a repeat count.
  7862. Fundo-start
  7863. Move undo-pointer to front of undo records.
  7864. The next call to undo-more will undo the most recently made change.
  7865. Fundo-more
  7866. Undo back N undo-boundaries beyond what was already undone recently.
  7867. Call undo-start to get ready to undo recent changes,
  7868. then call undo-more one or more times to undo them.
  7869. Fshell-command
  7870. Execute string COMMAND in inferior shell; display output, if any.
  7871. If COMMAND ends in ampersand, execute it asynchronously.
  7872.  
  7873. Optional second arg non-nil (prefix arg, if interactive)
  7874. means insert output in current buffer after point (leave mark after it).
  7875. This cannot be done asynchronously.
  7876. Fshell-command-on-region
  7877. Execute string COMMAND in inferior shell with region as input.
  7878. Normally display output (if any) in temp buffer `*Shell Command Output*';
  7879. Prefix arg means replace the region with it.
  7880. Noninteractive args are START, END, COMMAND, FLAG.
  7881. Noninteractively FLAG means insert output in place of text from START to END,
  7882. and put point at the end, but don't alter the mark.
  7883.  
  7884. If the output is one line, it is displayed in the echo area,
  7885. but it is nonetheless available in buffer `*Shell Command Output*'
  7886. even though that buffer is not automatically displayed.  If there is no output
  7887. or output is inserted in the current buffer then `*Shell Command Output*' is
  7888. deleted.
  7889. Funiversal-argument
  7890. Begin a numeric argument for the following command.
  7891. Digits or minus sign following this command make up the numeric argument.
  7892. If no digits or minus sign follow, this command by itself provides 4 as argument.
  7893. Used more than once, this command multiplies the argument by 4 each time.
  7894. Fdigit-argument
  7895. Part of the numeric argument for the next command.
  7896. Fnegative-argument
  7897. Begin a negative numeric argument for the next command.
  7898. Fforward-to-indentation
  7899. Move forward ARG lines and position at first nonblank character.
  7900. Fbackward-to-indentation
  7901. Move backward ARG lines and position at first nonblank character.
  7902. Fkill-line
  7903. Kill the rest of the current line; if no nonblanks there, kill thru newline.
  7904. With prefix argument, kill that many lines from point.
  7905. Negative arguments kill lines backward.
  7906.  
  7907. When calling from a program, nil means "no arg",
  7908. a number counts as a prefix arg.
  7909. Vkill-ring
  7910. List of killed text sequences.
  7911. Vkill-ring-max
  7912. *Maximum length of kill ring before oldest elements are thrown away.
  7913. Vkill-ring-yank-pointer
  7914. The tail of the kill ring whose car is the last thing yanked.
  7915. Fkill-region
  7916. Kill between point and mark.
  7917. The text is deleted but saved in the kill ring.
  7918. The command \[yank] can retrieve it from there.
  7919. (If you want to kill and then yank immediately, use \[kill-ring-save].)
  7920.  
  7921. This is the primitive for programs to kill text (as opposed to deleting it).
  7922. Supply two arguments, character numbers indicating the stretch of text
  7923.  to be killed.
  7924. Any command that calls this function is a "kill command".
  7925. If the previous command was also a kill command,
  7926. the text killed this time appends to the text killed last time
  7927. to make one entry in the kill ring.
  7928. Vkill-hooks
  7929. If non-nil, this should be a function or functions of one argument which
  7930. are called with the string most recently added to the kill ring.  You can use
  7931. this to, for example, make the most recent kill become the X Clipboard
  7932. selection.
  7933. Fcopy-region-as-kill
  7934. Save the region as if killed, but don't kill it.
  7935. Fkill-ring-save
  7936. Save the region as if killed, but don't kill it.
  7937. Fappend-next-kill
  7938. Cause following command, if kill, to append to previous kill.
  7939. Frotate-yank-pointer
  7940. Rotate the yanking point in the kill ring.
  7941. Fyank-pop
  7942. Replace just-yanked stretch of killed-text with a different stretch.
  7943. This command is allowed only immediately after a  yank  or a  yank-pop.
  7944. At such a time, the region contains a stretch of reinserted
  7945. previously-killed text.  yank-pop  deletes that text and inserts in its
  7946. place a different stretch of killed text.
  7947.  
  7948. With no argument, the previous kill is inserted.
  7949. With argument n, the n'th previous kill is inserted.
  7950. If n is negative, this is a more recent kill.
  7951.  
  7952. The sequence of kills wraps around, so that after the oldest one
  7953. comes the newest one.
  7954. Fyank
  7955. Reinsert the last stretch of killed text.
  7956. More precisely, reinsert the stretch of killed text most recently
  7957. killed OR yanked.
  7958. With just C-U as argument, same but put point in front (and mark at end).
  7959. With argument n, reinsert the nth most recently killed stretch of killed
  7960. text.
  7961. See also the command \[yank-pop].
  7962. Finsert-buffer
  7963. Insert after point the contents of BUFFER.
  7964. Puts mark after the inserted text.
  7965. BUFFER may be a buffer or a buffer name.
  7966. Fappend-to-buffer
  7967. Append to specified buffer the text of the region.
  7968. It is inserted into that buffer before its point.
  7969.  
  7970. When calling from a program, give three arguments:
  7971. a buffer or the name of one, and two character numbers
  7972. specifying the portion of the current buffer to be copied.
  7973. Fprepend-to-buffer
  7974. Prepend to specified buffer the text of the region.
  7975. It is inserted into that buffer after its point.
  7976.  
  7977. When calling from a program, give three arguments:
  7978. a buffer or the name of one, and two character numbers
  7979. specifying the portion of the current buffer to be copied.
  7980. Fcopy-to-buffer
  7981. Copy to specified buffer the text of the region.
  7982. It is inserted into that buffer, replacing existing text there.
  7983.  
  7984. When calling from a program, give three arguments:
  7985. a buffer or the name of one, and two character numbers
  7986. specifying the portion of the current buffer to be copied.
  7987. Fmark
  7988. Return this buffer's mark value as integer, or nil if no mark.
  7989.  
  7990. If `zmacs-regions' is true, then this returns nil unless the region is
  7991. currently in the active (hilighted) state.  With an argument of t, this
  7992. returns the mark (if there is one) regardless of the active-region state.
  7993. You should *generally* not use the mark unless the region is active, if
  7994. the user has expressed a preference for the active-region model.
  7995.  
  7996. If you are using this in an editing command, you are most likely making
  7997. a mistake; see the documentation of `set-mark'.
  7998. Fset-mark
  7999. Set this buffer's mark to POS.  Don't use this function!
  8000. That is to say, don't use this function unless you want
  8001. the user to see that the mark has moved, and you want the previous
  8002. mark position to be lost.
  8003.  
  8004. Normally, when a new mark is set, the old one should go on the stack.
  8005. This is why most applications should use push-mark, not set-mark.
  8006.  
  8007. Novice emacs-lisp programmers often try to use the mark for the wrong
  8008. purposes.  The mark saves a location for the user's convenience.
  8009. Most editing commands should not alter the mark.
  8010. To remember a location for internal use in the Lisp program,
  8011. store it in a Lisp variable.  Example:
  8012.  
  8013.    (let ((beg (point))) (forward-line 1) (delete-region beg (point))).
  8014. Vmark-ring
  8015. The list of saved former marks of the current buffer,
  8016. most recent first.
  8017. Vmark-ring-max
  8018. *Maximum size of mark ring.  Start discarding off end if gets this big.
  8019. Fset-mark-command
  8020. Set mark at where point is, or jump to mark.
  8021. With no prefix argument, set mark, and push previous mark on mark ring.
  8022. With argument, jump to mark, and pop into mark off the mark ring.
  8023.  
  8024. Novice emacs-lisp programmers often try to use the mark for the wrong
  8025. purposes.  See the documentation of `set-mark' for more information.
  8026. Fpush-mark
  8027. Set mark at LOCATION (point, by default) and push old mark on mark ring.
  8028. Displays "Mark set" unless the optional second arg NOMSG is non-nil.
  8029.  
  8030. Novice emacs-lisp programmers often try to use the mark for the wrong
  8031. purposes.  See the documentation of `set-mark' for more information.
  8032. Fpop-mark
  8033. Pop off mark ring into the buffer's actual mark.
  8034. Does not set point.  Does nothing if mark ring is empty.
  8035. Fexchange-point-and-mark
  8036. Put the mark where point is now, and point where the mark is now.
  8037. Fnext-line
  8038. Move cursor vertically down ARG lines.
  8039. If there is no character in the target line exactly under the current column,
  8040. the cursor is positioned after the character in that line which spans this
  8041. column, or at the end of the line if it is not long enough.
  8042. If there is no line in the buffer after this one,
  8043. a newline character is inserted to create a line
  8044. and the cursor moves to that line.
  8045.  
  8046. The command \[set-goal-column] can be used to create
  8047. a semipermanent goal column to which this command always moves.
  8048. Then it does not try to move vertically.  This goal column is stored
  8049. in `goal-column', which is nil when there is none.
  8050.  
  8051. If you are thinking of using this in a Lisp program, consider
  8052. using `forward-line' instead.  It is usually easier to use
  8053. and more reliable (no dependence on goal column, etc.).
  8054. Fprevious-line
  8055. Move cursor vertically up ARG lines.
  8056. If there is no character in the target line exactly over the current column,
  8057. the cursor is positioned after the character in that line which spans this
  8058. column, or at the end of the line if it is not long enough.
  8059.  
  8060. The command \[set-goal-column] can be used to create
  8061. a semipermanent goal column to which this command always moves.
  8062. Then it does not try to move vertically.
  8063.  
  8064. If you are thinking of using this in a Lisp program, consider using
  8065. `forward-line' with negative argument instead..  It is usually easier
  8066. to use and more reliable (no dependence on goal column, etc.).
  8067. Vtrack-eol
  8068. *Non-nil means vertical motion starting at end of line keeps to ends of lines.
  8069. This means moving to the end of each line moved onto.
  8070. Vtemporary-goal-column
  8071. Current goal column for vertical motion.
  8072. It is the column where point was at the start of current run of vertical motion commands.
  8073. Fset-goal-column
  8074. Set the current horizontal position as a goal for \[next-line] and \[previous-line].
  8075. Those commands will move to this position in the line moved to
  8076. rather than trying to keep the same horizontal position.
  8077. With a non-nil argument, clears out the goal column
  8078. so that \[next-line] and \[previous-line] resume vertical motion.
  8079. Ftranspose-chars
  8080. Interchange characters around point, moving forward one character.
  8081. With prefix arg ARG, effect is to take character before point
  8082. and drag it forward past ARG other characters (backward if ARG negative).
  8083. If no argument and at end of line, the previous two chars are exchanged.
  8084. Ftranspose-words
  8085. Interchange words around point, leaving point at end of them.
  8086. With prefix arg ARG, effect is to take word before or around point
  8087. and drag it forward past ARG other words (backward if ARG negative).
  8088. If ARG is zero, the words around or after point and around or after mark
  8089. are interchanged.
  8090. Ftranspose-sexps
  8091. Like \[transpose-words] but applies to sexps.
  8092. Does not work on a sexp that point is in the middle of
  8093. if it is a list or string.
  8094. Ftranspose-lines
  8095. Exchange current line and previous line, leaving point after both.
  8096. With argument ARG, takes previous line and moves it past ARG lines.
  8097. With argument 0, interchanges line point is in with line mark is in.
  8098. Vcomment-column
  8099. *Column to indent right-margin comments to.
  8100. Setting this variable automatically makes it local to the current buffer.
  8101. Vcomment-start
  8102. *String to insert to start a new comment, or nil if no comment syntax defined.
  8103. Vcomment-start-skip
  8104. *Regexp to match the start of a comment plus everything up to its body.
  8105. If there are any \(...\) pairs, the comment delimiter text is held to begin
  8106. at the place matched by the close of the first pair.
  8107. Vcomment-end
  8108. *String to insert to end a new comment.
  8109. Should be an empty string if comments are terminated by end-of-line.
  8110. Vcomment-indent-hook
  8111. Function to compute desired indentation for a comment.
  8112. This function is called with no args with point at the beginning of
  8113. the comment's starting delimiter.
  8114. Findent-for-comment
  8115. Indent this line's comment to comment column, or insert an empty comment.
  8116. Fset-comment-column
  8117. Set the comment column based on point.
  8118. With no arg, set the comment column to the current column.
  8119. With just minus as arg, kill any comment on this line.
  8120. With any other arg, set comment column to indentation of the previous comment
  8121.  and then align or create a comment on this line at that column.
  8122. Fkill-comment
  8123. Kill the comment on this line, if any.
  8124. With argument, kill comments on that many lines starting with this one.
  8125. Fbackward-word
  8126. Move backward until encountering the end of a word.
  8127. With argument, do this that many times.
  8128. In programs, it is faster to call forward-word with negative arg.
  8129. Fmark-word
  8130. Set mark arg words away from point.
  8131. Fkill-word
  8132. Kill characters forward until encountering the end of a word.
  8133. With argument, do this that many times.
  8134. Fbackward-kill-word
  8135. Kill characters backward until encountering the end of a word.
  8136. With argument, do this that many times.
  8137. Vfill-prefix
  8138. *String for filling to insert at front of new line, or nil for none.
  8139. Setting this variable automatically makes it local to the current buffer.
  8140. Vauto-fill-inhibit-regexp
  8141. *Regexp to match lines which should not be auto-filled.
  8142. Vcomment-multi-line
  8143. *Non-nil means \[indent-new-comment-line] should continue same comment
  8144. on new line, with no new terminator or starter.
  8145. Findent-new-comment-line
  8146. Break line at point and indent, continuing comment if presently within one.
  8147. The body of the continued comment is indented under the previous comment line.
  8148. Fauto-fill-mode
  8149. Toggle auto-fill mode.
  8150. With arg, turn auto-fill mode on if and only if arg is positive.
  8151. In auto-fill mode, inserting a space at a column beyond  fill-column
  8152. automatically breaks the line at a previous space.
  8153. Fturn-on-auto-fill
  8154. Unconditionally turn on Auto Fill mode.
  8155. Fset-fill-column
  8156. Set fill-column to current column, or to argument if given.
  8157. fill-column's value is separate for each buffer.
  8158. Fset-selective-display
  8159. Set selective-display to ARG; clear it if no arg.
  8160. When selective-display is a number > 0,
  8161. lines whose indentation is >= selective-display are not displayed.
  8162. selective-display's value is separate for each buffer.
  8163. Foverwrite-mode
  8164. Toggle overwrite mode.
  8165. With arg, turn overwrite mode on iff arg is positive.
  8166. In overwrite mode, printing characters typed in replace existing text
  8167. on a one-for-one basis, rather than pushing it to the right.
  8168. Vblink-matching-paren
  8169. *Non-nil means show matching open-paren when close-paren is inserted.
  8170. Vblink-matching-paren-distance
  8171. *If non-nil, is maximum distance to search for matching open-paren
  8172. when close-paren is inserted.
  8173. Fblink-matching-open
  8174. Move cursor momentarily to the beginning of the sexp before point.
  8175. Fkeyboard-quit
  8176. Signal a `quit' condition.
  8177. Fset-variable
  8178. Set VARIABLE to VALUE.  VALUE is a Lisp object.
  8179. When using this interactively, supply a Lisp expression for VALUE.
  8180. If you want VALUE to be a string, you must surround it with doublequotes.
  8181. Vhelp-map
  8182. Keymap for characters following the Help key.
  8183. Fhelp-with-tutorial
  8184. Select the Emacs learn-by-doing tutorial.
  8185. Fdescribe-key-briefly
  8186. Print the name of the function KEY invokes.  KEY is a string.
  8187. Fprint-help-return-message
  8188. Display or return message saying how to restore windows after help command.
  8189. Computes a message and applies the argument FUNCTION to it.
  8190. If FUNCTION is nil, applies `message' to it, thus printing it.
  8191. Fdescribe-key
  8192. Display documentation of the function KEY invokes.  
  8193. KEY is a string, or vector of events.  When called interactvely, key may
  8194. also be a menu selection.
  8195. Fwhere-is
  8196. Print message listing key sequences that invoke specified command.
  8197. Argument is a command definition, usually a symbol with a function definition.
  8198. Fdescribe-mode
  8199. Display documentation of current major mode.
  8200. Fdescribe-distribution
  8201. Display info on how to obtain the latest version of GNU Emacs.
  8202. Fdescribe-copying
  8203. Display info on how you may redistribute copies of GNU Emacs.
  8204. Fdescribe-pointer
  8205. Show a list of all defined mouse buttons, and their definitions.
  8206. This is the same as \[universal-argument] \[describe-bindings].
  8207. Fdescribe-no-warranty
  8208. Display info on all the kinds of warranty Emacs does NOT have.
  8209. Fview-emacs-news
  8210. Display info on recent changes to Emacs.
  8211. Fview-lossage
  8212. Display last 100 input keystrokes.
  8213. Fhelp-for-help
  8214. You have typed C-h, the help character.  Type a Help option:
  8215.  
  8216. A  command-apropos.   Give a substring, and see a list of commands
  8217.               (functions interactively callable) that contain
  8218.           that substring.  See also the  apropos  command.
  8219. B  describe-bindings.  Display table of all key bindings.
  8220. C  describe-key-briefly.  Type a command key sequence;
  8221.           it prints the function name that sequence runs.
  8222. F  describe-function.  Type a function name and get documentation of it.
  8223. I  info. The  info  documentation reader.
  8224. K  describe-key.  Type a command key sequence;
  8225.           it displays the full documentation.
  8226. L  view-lossage.  Shows last 100 characters you typed.
  8227. M  describe-mode.  Print documentation of current major mode,
  8228.           which describes the commands peculiar to it.
  8229. N  view-emacs-news.  Shows emacs news file.
  8230. P  describe-pointer.  Display table of all mouse-button bindings.
  8231. S  describe-syntax.  Display contents of syntax table, plus explanations
  8232. T  help-with-tutorial.  Select the Emacs learn-by-doing tutorial.
  8233. V  describe-variable.  Type name of a variable;
  8234.           it displays the variable's documentation and value.
  8235. W  where-is.  Type command name; it prints which keystrokes
  8236.           invoke that command.
  8237. C-c print Emacs copying permission (General Public License).
  8238. C-d print Emacs ordering information.
  8239. C-n print news of recent Emacs changes.
  8240. C-w print information on absence of warranty for GNU Emacs.
  8241. Vdescribe-function-show-arglist
  8242. *If true, then describe-function will show its arglist if the function is
  8243. not an autoload.
  8244. Fdescribe-function
  8245. Display the full documentation of FUNCTION (a symbol).
  8246. Fdescribe-variable
  8247. Display the full documentation of VARIABLE (a symbol).
  8248. Fcommand-apropos
  8249. Like apropos but lists only symbols that are names of commands
  8250. (interactively callable functions).  Argument REGEXP is a regular expression
  8251. that is matched against command symbol names.  Returns list of symbols and
  8252. documentation found.
  8253. Flocate-library
  8254. Show the full path name of Emacs library LIBRARY.
  8255. This command searches the directories in `load-path' like  M-x load-library
  8256. to find the file that  M-x load-library RET LIBRARY RET  would load.
  8257. Optional prefix arg NOSUFFIX non-nil means don't add suffixes `.elc' or `.el'
  8258. to the specified name LIBRARY - a la calling (load LIBRARY nil nil t).
  8259. Vdelete-auto-save-files
  8260. *Non-nil means delete a buffer's auto-save file
  8261. when the buffer is saved for real.
  8262. Vmake-backup-files
  8263. *Create a backup of each file when it is saved for the first time.
  8264. This can be done by renaming the file or by copying.
  8265.  
  8266. Renaming means that Emacs renames the existing file so that it is a
  8267. backup file, then writes the buffer into a new file.  Any other names
  8268. that the old file had will now refer to the backup file.
  8269. The new file is owned by you and its group is defaulted.
  8270.  
  8271. Copying means that Emacs copies the existing file into the backup file,
  8272. then writes the buffer on top of the existing file.  Any other names
  8273. that the old file had will now refer to the new (edited) file.
  8274. The file's owner and group are unchanged.
  8275.  
  8276. The choice of renaming or copying is controlled by the variables
  8277. backup-by-copying, backup-by-copying-when-linked and
  8278. backup-by-copying-when-mismatch.
  8279. Vbackup-by-copying
  8280. *Non-nil means always use copying to create backup files.
  8281. See documentation of variable  make-backup-files.
  8282. Vbackup-by-copying-when-linked
  8283. *Non-nil means use copying to create backups for files with multiple names.
  8284. This causes the alternate names to refer to the latest version as edited.
  8285. This variable is relevant only if  backup-by-copying  is nil.
  8286. Vbackup-by-copying-when-mismatch
  8287. *Non-nil means create backups by copying if this preserves owner or group.
  8288. Renaming may still be used (subject to control of other variables)
  8289. when it would not result in changing the owner or group of the file;
  8290. that is, for files which are owned by you and whose group matches
  8291. the default for a new file created there by you.
  8292. This variable is relevant only if  backup-by-copying  is nil.
  8293. Vbuffer-offer-save
  8294. *Non-nil in a buffer means offer to save the buffer on exit
  8295. even if the buffer is not visiting a file.  Automatically local in
  8296. all buffers.
  8297. Vfile-precious-flag
  8298. *Non-nil means protect against I/O errors while saving files.
  8299. Some modes set this non-nil in particular buffers.
  8300. Vversion-control
  8301. *Control use of version numbers for backup files.
  8302. t means make numeric backup versions unconditionally.
  8303. nil means make them for files that have some already.
  8304. never means do not make them.
  8305. Vdired-kept-versions
  8306. *When cleaning directory, number of versions to keep.
  8307. Vtrim-versions-without-asking
  8308. *If true, deletes excess backup versions silently.
  8309. Otherwise asks confirmation.
  8310. Vkept-old-versions
  8311. *Number of oldest versions to keep when a new numbered backup is made.
  8312. Vkept-new-versions
  8313. *Number of newest versions to keep when a new numbered backup is made.
  8314. Includes the new backup.  Must be > 0
  8315. Vrequire-final-newline
  8316. *Value of t says silently ensure a file ends in a newline when it is saved.
  8317. Non-nil but not t says ask user whether to add a newline when there isn't one.
  8318. nil means don't add newlines.
  8319. Vauto-save-default
  8320. *Non-nil says by default do auto-saving of every file-visiting buffer.
  8321. Vauto-save-visited-file-name
  8322. *Non-nil says auto-save a buffer in the file it is visiting, when practical.
  8323. Normally auto-save files are written under other names.
  8324. Vsave-abbrevs
  8325. *Non-nil means save word abbrevs too when files are saved.
  8326. Loading an abbrev file sets this to t.
  8327. Vfind-file-run-dired
  8328. *Non-nil says run dired if find-file is given the name of a directory.
  8329. Vfind-file-not-found-hooks
  8330. List of functions to be called for find-file on nonexistent file.
  8331. These functions are called as soon as the error is detected.
  8332. buffer-file-name is already set up.
  8333. The functions are called in the order given,
  8334. until one of them returns non-nil.
  8335. Vfind-file-hooks
  8336. List of functions to be called after a buffer is loaded from a file.
  8337. The buffer's local variables (if any) will have been processed before the
  8338. functions are called.
  8339. Vwrite-file-hooks
  8340. List of functions to be called before writing out a buffer to a file.
  8341. If one of them returns non-nil, the file is considered already written
  8342. and the rest are not called.
  8343. These hooks are considered to pertain to the visited file.
  8344. So this list is cleared if you change the visited file name.
  8345. See also `write-contents-hooks'.
  8346. Vwrite-contents-hooks
  8347. List of functions to be called before writing out a buffer to a file.
  8348. If one of them returns non-nil, the file is considered already written
  8349. and the rest are not called.
  8350. These hooks are considered to pertain to the buffer's contents,
  8351. not to the particular visited file; thus, `set-visited-file-name' does
  8352. not clear this variable, but changing the major mode does clear it.
  8353. See also `write-file-hooks'.
  8354. Vafter-write-file-hooks
  8355. List of functions to be called after writing out a buffer to a file.
  8356. These hooks are considered to pertain to the visited file.
  8357. So this list is cleared if you change the visited file name.
  8358. Venable-local-variables
  8359. *Control use of local-variables lists in files you visit.
  8360. The value can be t, nil or something else.
  8361. A value of t means local-variables lists are obeyed;
  8362. nil means they are ignored; anything else means query.
  8363.  
  8364. The command \[normal-mode] always obeys local-variables lists
  8365. and ignores this variable.
  8366. Vignore-local-variable-errors
  8367. *If t, ignore errors occurring during local-variable parsing of a file.
  8368. This is set to t by default, so that files such as xdefault.ini
  8369. under MS-DOS that may contain -*- in their first line don't cause
  8370. spurious errors.
  8371. Fpwd
  8372. Show the current default directory.
  8373. Fcd
  8374. Make DIR become the current buffer's default directory.
  8375. Fload-file
  8376. Load the file FILE of Lisp code.
  8377. Fload-library
  8378. Load the library named LIBRARY.
  8379. This is an interface to the function `load'.
  8380. Fswitch-to-other-buffer
  8381. Switch to the previous buffer.  With a numeric arg, n, switch to the nth
  8382. most recent buffer.  With an arg of 0, buries the current buffer at the
  8383. bottom of the buffer stack.
  8384. Fswitch-to-buffer-other-window
  8385. Select buffer BUFFER in another window.
  8386. Ffind-file
  8387. Edit file FILENAME.
  8388. Switch to a buffer visiting file FILENAME,
  8389. creating one if none already exists.
  8390. Ffind-file-other-window
  8391. Edit file FILENAME, in another window.
  8392. May create a new window, or reuse an existing one;
  8393. see the function display-buffer.
  8394. Ffind-file-read-only
  8395. Edit file FILENAME but don't allow changes.
  8396. Like \[find-file] but marks buffer as read-only.
  8397. Use \[toggle-read-only] to permit editing.
  8398. Ffind-file-read-only-other-window
  8399. Edit file FILENAME in another window but don't allow changes.
  8400. Like \[find-file-other-window] but marks buffer as read-only.
  8401. Use \[toggle-read-only] to permit editing.
  8402. Ffind-alternate-file
  8403. Find file FILENAME, select its buffer, kill previous buffer.
  8404. If the current buffer now contains an empty file that you just visited
  8405. (presumably by mistake), use this command to visit the file you really want.
  8406. Fcreate-file-buffer
  8407. Create a suitably named buffer for visiting FILENAME, and return it.
  8408. FILENAME (sans directory) is used unchanged if that name is free;
  8409. otherwise a string <2> or <3> or ... is appended to get an unused name.
  8410. Fcompute-buffer-file-truename
  8411. Recomputes this buffer's value of `buffer-file-truename'
  8412. based on the current value of `buffer-file-name'.
  8413. Ffind-file-noselect
  8414. Read file FILENAME into a buffer and return the buffer.
  8415. If a buffer exists visiting FILENAME, return that one, but
  8416. verify that the file has not changed since visited or saved.
  8417. The buffer is not selected, just returned to the caller.
  8418. Fafter-find-file
  8419. Called after finding a file and by the default revert function.
  8420. Sets buffer mode, parses local variables.
  8421. Optional args ERROR and WARN: ERROR non-nil means there was an
  8422. error in reading the file.  WARN non-nil means warn if there
  8423. exists an auto-save file more recent than the visited file.
  8424. Finishes by calling the functions in find-file-hooks.
  8425. Fnormal-mode
  8426. Choose the major mode for this buffer automatically.
  8427. Also sets up any specified local variables of the file.
  8428. Uses the visited file name, the -*- line, and the local variables spec.
  8429.  
  8430. This function is called automatically from `find-file'.  In that case,
  8431. we may set up specified local variables depending on the value of
  8432. `enable-local-variables': if it is t, we do; if it is nil, we don't;
  8433. otherwise, we query.  `enable-local-variables' is ignored if you
  8434. run `normal-mode' explicitly.
  8435. Fset-auto-mode
  8436. Select major mode appropriate for current buffer.
  8437. May base decision on visited file name (see variable `auto-mode-alist') or on
  8438. buffer contents (the -*- line), but does not look for the "mode:" local
  8439. variable spec in the last page.  For that, use `hack-local-variables'.
  8440. Fhack-local-variables
  8441. Parse, and bind or evaluate as appropriate, any local variables
  8442. for current buffer.
  8443. Fset-visited-file-name
  8444. Change name of file visited in current buffer to FILENAME.
  8445. The next time the buffer is saved it will go in the newly specified file.
  8446. nil or empty string as argument means make buffer not be visiting any file.
  8447. Remember to delete the initial contents of the minibuffer
  8448. if you wish to pass an empty string as the argument.
  8449. Fwrite-file
  8450. Write current buffer into file FILENAME.
  8451. Makes buffer visit that file, and marks it not modified.
  8452. Fbackup-buffer
  8453. Make a backup of the disk file visited by the current buffer, if appropriate.
  8454. This is normally done before saving the buffer the first time.
  8455. If the value is non-nil, it is the result of `file-modes' on the original file;
  8456. this means that the caller, after saving the buffer, should change the modes
  8457. of the new file to agree with the old modes.
  8458. Ffile-name-sans-versions
  8459. Return FILENAME sans backup versions or strings.
  8460. This is a separate procedure so your site-init or startup file can
  8461. redefine it.
  8462. Fmake-backup-file-name
  8463. Create the non-numeric backup file name for FILE.
  8464. This is a separate function so you can redefine it for customization.
  8465. Fbackup-file-name-p
  8466. Return non-nil if FILE is a backup file name (numeric or not).
  8467. This is a separate function so you can redefine it for customization.
  8468. You may need to redefine file-name-sans-versions as well.
  8469. Ffind-backup-file-name
  8470. Find a file name for a backup file, and suggestions for deletions.
  8471. Value is a list whose car is the name for the backup file
  8472.  and whose cdr is a list of old versions to consider deleting now.
  8473. Ffile-nlinks
  8474. Return number of names file FILENAME has.
  8475. Ffile-relative-name
  8476. Convert FILENAME to be relative to DIRECTORY (default: default-directory).
  8477. Fsave-buffer
  8478. Save current buffer in visited file if modified.  Versions described below.
  8479.  
  8480. By default, makes the previous version into a backup file
  8481.  if previously requested or if this is the first save.
  8482. With 1 or 3 \[universal-argument]'s, marks this version
  8483.  to become a backup when the next save is done.
  8484. With 2 or 3 \[universal-argument]'s,
  8485.  unconditionally makes the previous version into a backup file.
  8486. With argument of 0, never makes the previous version into a backup file.
  8487.  
  8488. If a file's name is FOO, the names of its numbered backup versions are
  8489.  FOO.~i~ for various integers i.  A non-numbered backup file is called FOO~.
  8490. Numeric backups (rather than FOO~) will be made if value of
  8491.  `version-control' is not the atom `never' and either there are already
  8492.  numeric versions of the file being backed up, or `version-control' is
  8493.  non-nil.
  8494. We don't want excessive versions piling up, so there are variables
  8495.  `kept-old-versions', which tells Emacs how many oldest versions to keep,
  8496.  and `kept-new-versions', which tells how many newest versions to keep.
  8497.  Defaults are 2 old versions and 2 new.
  8498. `dired-kept-versions' controls dired's clean-directory (.) command.
  8499. If `trim-versions-without-asking' is nil, system will query user
  8500.  before trimming versions.  Otherwise it does it silently.
  8501. Fdelete-auto-save-file-if-necessary
  8502. Delete the auto-save filename for the current buffer (if it has one)
  8503. if variable `delete-auto-save-files' is non-nil.
  8504. Normally delete only if the file was written by this Emacs
  8505. since the last real save, but optional arg FORCE non-nil means delete anyway.
  8506. Fbasic-save-buffer
  8507. Save the current buffer in its visited file, if it has been modified.
  8508. Fsave-some-buffers
  8509. Save some modified file-visiting buffers.  Asks user about each one.
  8510. Optional argument (the prefix) non-nil means save all with no questions.
  8511. Optional second argument EXITING means ask about certain non-file buffers
  8512.  as well as about file buffers.
  8513. Fnot-modified
  8514. Mark current buffer as unmodified, not needing to be saved.
  8515. With prefix arg, mark buffer as modified, so \[save-buffer] will save.
  8516. Ftoggle-read-only
  8517. Change whether this buffer is visiting its file read-only.
  8518. With arg, set read-only iff arg is positive.
  8519. Finsert-file
  8520. Insert contents of file FILENAME into buffer after point.
  8521. Set mark after the inserted text.
  8522.  
  8523. This function is meant for the user to run interactively.
  8524. Don't call it from programs!  Use `insert-file-contents' instead.
  8525. (Its calling sequence is different; see its documentation).
  8526. Fappend-to-file
  8527. Append the contents of the region to the end of file FILENAME.
  8528. When called from a function, expects three arguments,
  8529. START, END and FILENAME.  START and END are buffer positions
  8530. saying what text to write.
  8531. Ffile-newest-backup
  8532. Return most recent backup file for FILENAME or nil if no backups exist.
  8533. Frename-uniquely
  8534. Rename current buffer to a similar name not already taken.
  8535. This function is useful for creating multiple shell process buffers
  8536. or multiple mail buffers, etc.
  8537. Fmake-directory-path
  8538. Create all the directories along path that don't exist yet.
  8539. Vrevert-buffer-function
  8540. Function to use to revert this buffer, or nil to do the default.
  8541. Vrevert-buffer-insert-file-contents-function
  8542. Function to use to insert contents when reverting this buffer.
  8543. Gets two args, first the nominal file name to use,
  8544. and second, t if reading the auto-save file.
  8545. Frevert-buffer
  8546. Replace the buffer text with the text of the visited file on disk.
  8547. This undoes all changes since the file was visited or saved.
  8548. With a prefix argument, offer to revert from latest auto-save file, if
  8549. that is more recent than the visited file.
  8550. When called from lisp, this is the first argument, CHECK-AUTO; it is optional.
  8551. Optional second argument NOCONFIRM means don't ask for confirmation at all.
  8552.  
  8553. If the value of `revert-buffer-function' is non-nil, it is called to
  8554. do the work.
  8555. Frecover-file
  8556. Visit file FILE, but get contents from its last auto-save file.
  8557. Fkill-some-buffers
  8558. For each buffer, ask whether to kill it.
  8559. Fauto-save-mode
  8560. Toggle auto-saving of contents of current buffer.
  8561. With arg, turn auto-saving on if arg is positive, else off.
  8562. Frename-auto-save-file
  8563. Adjust current buffer's auto save file name for current conditions.
  8564. Also rename any existing auto save file, if it was made in this session.
  8565. Fmake-auto-save-file-name
  8566. Return file name to use for auto-saves of current buffer.
  8567. Does not consider auto-save-visited-file-name; that is checked
  8568. before calling this function.
  8569. You can redefine this for customization.
  8570. See also auto-save-file-name-p.
  8571. Fauto-save-file-name-p
  8572. Return non-nil if FILENAME can be yielded by make-auto-save-file-name.
  8573. FILENAME should lack slashes.
  8574. You can redefine this for customization.
  8575. Vlist-directory-brief-switches
  8576. *Switches for list-directory to pass to `ls' for brief listing,
  8577. Vlist-directory-verbose-switches
  8578. *Switches for list-directory to pass to `ls' for verbose listing,
  8579. Flist-directory
  8580. Display a list of files in or matching DIRNAME, a la `ls'.
  8581. DIRNAME is globbed by the shell if necessary.
  8582. Prefix arg (second arg if noninteractive) means supply -l switch to `ls'.
  8583. Actions controlled by variables list-directory-brief-switches
  8584.  and list-directory-verbose-switches.
  8585. Fsave-buffers-kill-emacs
  8586. Offer to save each buffer, then kill this Emacs process.
  8587. With prefix arg, silently save all file-visiting buffers, then kill.
  8588. Findent-according-to-mode
  8589. Indent line in proper way for current major mode.
  8590. Findent-for-tab-command
  8591. Indent line in proper way for current major mode.
  8592. Findent-rigidly
  8593. Indent all lines starting in the region sideways by ARG columns.
  8594. Called from a program, takes three arguments, START, END and ARG.
  8595. Vindent-region-function
  8596. Function which is short cut to indent each line in region with TAB.
  8597. A value of nil means really perform TAB on each line.
  8598. Findent-region
  8599. Indent each nonblank line in the region.
  8600. With no argument, indent each line with TAB.
  8601. (If there is a fill prefix, make each line start with the fill prefix.)
  8602. With argument COLUMN, indent each line to that column.
  8603. Called from a program, takes three args: START, END and COLUMN.
  8604. Findent-relative-maybe
  8605. Indent a new line like previous nonblank line.
  8606. Findent-relative
  8607. Space out to under next indent point in previous nonblank line.
  8608. An indent point is a non-whitespace character following whitespace.
  8609. If the previous nonblank line has no indent points beyond
  8610. the column point starts at, `tab-to-tab-stop' is done instead.
  8611. Vtab-stop-list
  8612. *List of tab stop positions used by `tab-to-tab-stops'.
  8613. Vedit-tab-stops-map
  8614. Keymap used in `edit-tab-stops'.
  8615. Vedit-tab-stops-buffer
  8616. Buffer whose tab stops are being edited--in case
  8617. the variable `tab-stop-list' is local in that buffer.
  8618. Fedit-tab-stops
  8619. Edit the tab stops used by tab-to-tab-stop.
  8620. Creates a buffer *Tab Stops* containing text describing the tab stops.
  8621. A colon indicates a column where there is a tab stop.
  8622. You can add or remove colons and then do C-c C-c to make changes take effect.
  8623. Fedit-tab-stops-note-changes
  8624. Put edited tab stops into effect.
  8625. Ftab-to-tab-stop
  8626. Insert spaces or tabs to next defined tab-stop column.
  8627. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  8628. Use \[edit-tab-stops] to edit them interactively.
  8629. Fmove-to-tab-stop
  8630. Move point to next defined tab-stop column.
  8631. The variable `tab-stop-list' is a list of columns at which there are tab stops.
  8632. Use \[edit-tab-stops] to edit them interactively.
  8633. Fcount-windows
  8634. Returns the number of visible windows.
  8635. Optional arg NO-MINI non-nil means don't count the minibuffer
  8636. even if it is active.
  8637. Fbalance-windows
  8638. Makes all visible windows the same size (approximately).
  8639. Fsplit-window-vertically
  8640. Split current window into two windows, one above the other.
  8641. The top window gets ARG lines.  No arg means split equally.
  8642.  
  8643. The two windows will be displaying the same text as before: both windows will
  8644. be displaying the current buffer, but the second window will be scrolled such
  8645. that little redisplay will happen - the lines that were on the screen before
  8646. the split will still be on the screen, in the same places.  
  8647.  
  8648. An effort is made to keep the cursor in the same place relative to the text on
  8649. the screen as well.  If the cursor is below the split-point before the split,
  8650. then the bottom window will be selected; otherwise the top window will be
  8651. selected.
  8652. Fsplit-window-horizontally
  8653. Split current window into two windows side by side.
  8654. This window becomes the leftmost of the two, and gets
  8655. ARG columns.  No arg means split equally.
  8656. Fenlarge-window-horizontally
  8657. Make current window ARG columns wider.
  8658. Fshrink-window-horizontally
  8659. Make current window ARG columns narrower.
  8660. Fwindow-config-to-register
  8661. Save the current window configuration in register REG (a letter).
  8662. It can be later retrieved using \[M-x register-to-window-config].
  8663. Fregister-to-window-config
  8664. Restore (make current) the window configuration in register REG (a letter).
  8665. Use with a register previously set with \[window-config-to-register].
  8666. Vdirectory-abbrev-alist
  8667. *Alist of abbreviations for file directories.
  8668. A list of elements of the form (FROM . TO), each meaning to replace
  8669. FROM with TO when it appears in a directory name.
  8670. This replacement is done when setting up the default directory
  8671. of a newly visited file.  *Every* FROM string should start with `^'.
  8672.  
  8673. Use this feature when you have directories which you normally refer to
  8674. via absolute symbolic links.  Make TO the name of the link, and FROM
  8675. the name it is linked to.
  8676. Fabbreviate-file-name
  8677. Return a version of FILENAME shortened using directory-abbrev-alist.
  8678. See \[describe-variable] directory-abbrev-alist RET for more information.
  8679. If optional argument HACK-HOMEDIR is non-nil, then This also substitutes
  8680. "~" for the user's home directory.
  8681. Vcommand-line-processed
  8682. t once command line has been processed
  8683. Vinhibit-startup-message
  8684. *Non-nil inhibits the initial startup messages.
  8685. This is for use in your personal init file, once you are familiar
  8686. with the contents of the startup message.
  8687. Vinhibit-default-init
  8688. *Non-nil inhibits loading the `default' library.
  8689. Vcommand-switch-alist
  8690. Alist of command-line switches.
  8691. Elements look like (SWITCH-STRING . HANDLER-FUNCTION).
  8692. HANDLER-FUNCTION receives switch name as sole arg;
  8693. remaining command-line args are in the variable `command-line-args-left'.
  8694. Vterm-setup-hook
  8695. Function to be called after loading terminal-specific lisp code.
  8696. It is called with no arguments.  This variable exists for users to set,
  8697. so as to override the definitions made by the terminal-specific file.
  8698. Emacs never sets this variable itself.
  8699. Vkeyboard-type
  8700. The brand of keyboard you are using.  This variable is used to define
  8701. the proper function and keypad keys for use under X.  It is used in a
  8702. fashion analogous to the environment value TERM.
  8703. Vwindow-setup-hook
  8704. Function used to initialize window system display, after command line args.
  8705. Users should not set this variable; use term-setup-hook instead.
  8706. Vinitial-major-mode
  8707. Major mode command symbol to use for the initial *scratch* buffer.
  8708. Vinit-file-user
  8709. When the `.emacs' file is read, this says which user's init file it is.
  8710. The value may be the null string or a string containing a user's name.
  8711. If the value is a null string, it means that the init file was taken from
  8712. the user that originally logged in.
  8713.  
  8714. In all cases, `(concat "~" init-file-user "/")' evaluates to the
  8715. directory name of the directory where the `.emacs' file was looked for.
  8716. Vsite-run-file
  8717. File containing site-wide run-time initializations.
  8718. This file is loaded at run-time before ~/.emacs.  It contains inits
  8719. that need to be in place for the entire site, but which, due to their
  8720. higher incidence of change, don't make sense to load into emacs'
  8721. dumped image.  Thus, the run-time load order is: 1. file described in
  8722. this variable, if non-nil; 2. ~/.emacs; 3. default.el.
  8723. Vinit-file-name
  8724. Name of the initialization file.
  8725. Vdefun-prompt-regexp
  8726. Non-nil => regexp to ignore, before the `(' that starts a defun.
  8727. Fforward-sexp
  8728. Move forward across one balanced expression (sexp).
  8729. With argument, do it that many times.
  8730. Negative arg -N means move backward across N balanced expressions.
  8731. Fbackward-sexp
  8732. Move backward across one balanced expression (sexp).
  8733. With argument, do it that many times.
  8734. Negative arg -N means move forward across N balanced expressions.
  8735. Fmark-sexp
  8736. Set mark ARG sexps from point.
  8737. The place mark goes is the same place \[forward-sexp] would move to
  8738. with the same argument.
  8739. Fforward-list
  8740. Move forward across one balanced group of parentheses.
  8741. With argument, do it that many times.
  8742. Negative arg -N means move backward across N groups of parentheses.
  8743. Fbackward-list
  8744. Move backward across one balanced group of parentheses.
  8745. With argument, do it that many times.
  8746. Negative arg -N means move forward across N groups of parentheses.
  8747. Fdown-list
  8748. Move forward down one level of parentheses.
  8749. With argument, do this that many times.
  8750. A negative argument means move backward but still go down a level.
  8751. In Lisp programs, an argument is required.
  8752. Fbackward-up-list
  8753. Move backward out of one level of parentheses.
  8754. With argument, do this that many times.
  8755. A negative argument means move forward but still to a less deep spot.
  8756. In Lisp programs, an argument is required.
  8757. Fup-list
  8758. Move forward out of one level of parentheses.
  8759. With argument, do this that many times.
  8760. A negative argument means move backward but still to a less deep spot.
  8761. In Lisp programs, an argument is required.
  8762. Fkill-sexp
  8763. Kill the sexp (balanced expression) following the cursor.
  8764. With argument, kill that many sexps after the cursor.
  8765. Negative arg -N means kill N sexps before the cursor.
  8766. Fbackward-kill-sexp
  8767. Kill the sexp (balanced expression) preceding the cursor.
  8768. With argument, kill that many sexps before the cursor.
  8769. Negative arg -N means kill N sexps after the cursor.
  8770. Fbeginning-of-defun
  8771. Move backward to the beginning of a defun.
  8772. With argument, do it that many times.  Negative arg -N
  8773. means move forward to Nth following beginning of defun.
  8774. Returns t unless search stops due to beginning or end of buffer.
  8775.  
  8776. Normally a defun starts when there is an char with open-parenthesis
  8777. syntax at the beginning of a line.  If `defun-prompt-regexp' is
  8778. non-nil, then a string which matches that regexp may precede the
  8779. open-parenthesis.
  8780. Fend-of-defun
  8781. Move forward to next end of defun.  With argument, do it that many times.
  8782. Negative argument -N means move back to Nth preceding end of defun.
  8783.  
  8784. An end of a defun occurs right after the close-parenthesis that matches
  8785. the open-parenthesis that starts a defun; see `beginning-of-defun'.
  8786. Fmark-defun
  8787. Put mark at end of this defun, point at beginning.
  8788. The defun marked is the one that contains point or follows point.
  8789. Finsert-parentheses
  8790. Put parentheses around next ARG sexps.  Leave point after open-paren.
  8791. No argument is equivalent to zero: just insert () and leave point between.
  8792. Fmove-past-close-and-reindent
  8793. Move past next `)', delete indentation before it, then indent after it.
  8794. Flisp-complete-symbol
  8795. Perform completion on Lisp symbol preceding point.
  8796. That symbol is compared against the symbols that exist
  8797. and any additional characters determined by what is there
  8798. are inserted.
  8799. If the symbol starts just after an open-parenthesis,
  8800. only symbols with function definitions are considered.
  8801. Otherwise, all symbols with function definitions, values
  8802. or properties are considered.
  8803. Fforward-page
  8804. Move forward to page boundary.  With arg, repeat, or go back if negative.
  8805. A page boundary is any line whose beginning matches the regexp  page-delimiter.
  8806. Fbackward-page
  8807. Move backward to page boundary.  With arg, repeat, or go fwd if negative.
  8808. A page boundary is any line whose beginning matches the regexp  page-delimiter.
  8809. Fmark-page
  8810. Put mark at end of page, point at beginning.
  8811. A numeric arg specifies to move forward or backward by that many pages,
  8812. thus marking a page other than the one point was originally in.
  8813. Fnarrow-to-page
  8814. Make text outside current page invisible.
  8815. A numeric arg specifies to move forward or backward by that many pages,
  8816. thus showing a page other than the one point was originally in.
  8817. Fcount-lines-page
  8818. Report number of lines on current page, and how many are before or after point.
  8819. Fwhat-page
  8820. Print page and line number of point.
  8821. Vregister-alist
  8822. Alist of elements (NAME . CONTENTS), one for each Emacs register.
  8823. NAME is a character (a number).  CONTENTS is a string, number,
  8824. mark or list.  A list represents a rectangle; its elements are strings.
  8825. Fget-register
  8826. Return contents of Emacs register named CHAR, or nil if none.
  8827. Fset-register
  8828. Set contents of Emacs register named CHAR to VALUE.
  8829. Returns VALUE.
  8830. Fpoint-to-register
  8831. Store current location of point in a register.
  8832. Argument is a character, naming the register.
  8833. Fjump-to-register
  8834. Move point to location stored in a register.
  8835. Argument is a character, naming the register.
  8836. Fview-register
  8837. Display what is contained in register named REGISTER.
  8838. REGISTER is a character.
  8839. Finsert-register
  8840. Insert contents of register REG.  REG is a character.
  8841. Normally puts point before and mark after the inserted text.
  8842. If optional second arg is non-nil, puts mark before and point after.
  8843. Interactively, second arg is non-nil if prefix arg is supplied.
  8844. Fcopy-to-register
  8845. Copy region into register REG.
  8846. With prefix arg, delete as well.
  8847. Called from program, takes four args:
  8848. REG, START, END and DELETE-FLAG.
  8849. START and END are buffer positions indicating what to copy.
  8850. Fappend-to-register
  8851. Append region to text in register REG.
  8852. With prefix arg, delete as well.
  8853. Called from program, takes four args:
  8854. REG, START, END and DELETE-FLAG.
  8855. START and END are buffer positions indicating what to append.
  8856. Fprepend-to-register
  8857. Prepend region to text in register REG.
  8858. With prefix arg, delete as well.
  8859. Called from program, takes four args:
  8860. REG, START, END and DELETE-FLAG.
  8861. START and END are buffer positions indicating what to prepend.
  8862. Fcopy-rectangle-to-register
  8863. Copy rectangular region into register REG.
  8864. With prefix arg, delete as well.
  8865. Called from program, takes four args:
  8866. REG, START, END and DELETE-FLAG.
  8867. START and END are buffer positions giving two corners of rectangle.
  8868. Viso8859/1-case-table
  8869. The case table for ISO-8859/1 characters.
  8870. Vparagraph-ignore-fill-prefix
  8871. Non-nil means the paragraph commands are not affected by fill-prefix.
  8872. This is desirable in modes where blank lines are the paragraph delimiters.
  8873. Fforward-paragraph
  8874. Move forward to end of paragraph.
  8875. With arg N, do it N times; negative arg -N means move forward N paragraphs.
  8876.  
  8877. A line which `paragraph-start' matches either separates paragraphs
  8878. (if `paragraph-separate' matches it also) or is the first line of a paragraph.
  8879. A paragraph end is the beginning of a line which is not part of the paragraph
  8880. to which the end of the previous line belongs, or the end of the buffer.
  8881. Fbackward-paragraph
  8882. Move backward to start of paragraph.
  8883. With arg N, do it N times; negative arg -N means move forward N paragraphs.
  8884.  
  8885. A paragraph start is the beginning of a line which is a first-line-of-paragraph
  8886. or which is ordinary text and follows a paragraph-separating line; except:
  8887. if the first real line of a paragraph is preceded by a blank line,
  8888. the paragraph starts at that blank line.
  8889. See forward-paragraph for more information.
  8890. Fmark-paragraph
  8891. Put point at beginning of this paragraph, mark at end.
  8892. The paragraph marked is the one that contains point or follows point.
  8893. Fkill-paragraph
  8894. Kill forward to end of paragraph.
  8895. With arg N, kill forward to Nth end of paragraph;
  8896. negative arg -N means kill backward to Nth start of paragraph.
  8897. Fbackward-kill-paragraph
  8898. Kill back to start of paragraph.
  8899. With arg N, kill back to Nth start of paragraph;
  8900. negative arg -N means kill forward to Nth end of paragraph.
  8901. Ftranspose-paragraphs
  8902. Interchange this (or next) paragraph with previous one.
  8903. Fforward-sentence
  8904. Move forward to next sentence-end.  With argument, repeat.
  8905. With negative argument, move backward repeatedly to sentence-beginning.
  8906.  
  8907. The variable `sentence-end' is a regular expression that matches ends
  8908. of sentences.  Also, every paragraph boundary terminates sentences as
  8909. well.
  8910. Fbackward-sentence
  8911. Move backward to start of sentence.  With arg, do it arg times.
  8912. See forward-sentence for more information.
  8913. Fkill-sentence
  8914. Kill from point to end of sentence.
  8915. With arg, repeat; negative arg -N means kill back to Nth start of sentence.
  8916. Fbackward-kill-sentence
  8917. Kill back from point to start of sentence.
  8918. With arg, repeat, or kill forward to Nth end of sentence if negative arg -N.
  8919. Fmark-end-of-sentence
  8920. Put mark at end of sentence.  Arg works as in forward-sentence.
  8921. Ftranspose-sentences
  8922. Interchange this (next) and previous sentence.
  8923. Fset-fill-prefix
  8924. Set the fill-prefix to the current line up to point.
  8925. Filling expects lines to start with the fill prefix
  8926. and reinserts the fill prefix in each resulting line.
  8927. Ffill-region-as-paragraph
  8928. Fill region as one paragraph: break lines to fit fill-column.
  8929. Prefix arg means justify too.
  8930. From program, pass args FROM, TO and JUSTIFY-FLAG.
  8931. Ffill-paragraph
  8932. Fill paragraph at or after point.
  8933. Prefix arg means justify as well.
  8934. Ffill-region
  8935. Fill each of the paragraphs in the region.
  8936. Prefix arg (non-nil third arg, if called from program)
  8937. means justify as well.
  8938. Fjustify-current-line
  8939. Add spaces to line point is in, so it ends at fill-column.
  8940. Ffill-individual-paragraphs
  8941. Fill each paragraph in region according to its individual fill prefix.
  8942. Calling from a program, pass range to fill as first two arguments.
  8943. Optional third and fourth arguments JUSTIFY-FLAG and MAIL-FLAG:
  8944. JUSTIFY-FLAG to justify paragraphs (prefix arg),
  8945. MAIL-FLAG for a mail message, i. e. don't fill header lines.
  8946. Vsearch-last-string
  8947. Last string search for by a search command.
  8948. This does not include direct calls to the primitive search functions,
  8949. and does not include searches that are aborted.
  8950. Vsearch-last-regexp
  8951. Last string searched for by a regexp search command.
  8952. This does not include direct calls to the primitive search functions,
  8953. and does not include searches that are aborted.
  8954. Vsearch-exit-option
  8955. Non-nil means random control characters terminate incremental search.
  8956. Vsearch-slow-window-lines
  8957. *Number of lines in slow search display windows.
  8958. These are the short windows used during incremental search on slow terminals.
  8959. Negative means put the slow search window at the top (normally it's at bottom)
  8960. and the value is minus the number of lines.
  8961. Vsearch-slow-speed
  8962. *Highest terminal speed at which to use "slow" style incremental search.
  8963. This is the style where a one-line window is created to show the line
  8964. that the search has reached.
  8965. Vsearch-caps-disable-folding
  8966. *If non-nil, upper case chars disable case fold searching.
  8967. This does not apply to "yanked" strings.
  8968. Vsearch-nonincremental-instead
  8969. *If non-nil, do a nonincremental search instead if exiting immediately.
  8970. Vsearch-whitespace-regexp
  8971. *If non-nil, regular expression to match a sequence of whitespace chars.
  8972. Vsearch-ring
  8973. List of search string sequences.
  8974. Vregexp-search-ring
  8975. List of regular expression search string sequences.
  8976. Vsearch-ring-max
  8977. *Maximum length of search ring before oldest elements are thrown away.
  8978. Vregexp-search-ring-max
  8979. *Maximum length of regexp search ring before oldest elements are thrown away.
  8980. Vsearch-ring-yank-pointer
  8981. The tail of the search ring whose car is the last thing searched for.
  8982. Vregexp-search-ring-yank-pointer
  8983. The tail of the regular expression search ring whose car is the last
  8984. thing searched for.
  8985. Visearch-mode-map
  8986. Keymap for isearch-mode.
  8987. Vminibuffer-local-isearch-map
  8988. Keymap for editing isearch strings in the minibuffer.
  8989. Visearch-mode-hook
  8990. Function(s) to call after starting up an incremental search.
  8991. Visearch-mode-end-hook
  8992. Function(s) to call after terminating an incremental search.
  8993. Fisearch-forward
  8994. Do incremental search forward.
  8995. With a prefix argument, do an incremental regular expression search instead.
  8996. \<isearch-mode-map>
  8997. As you type characters, they add to the search string and are found.
  8998. The following non-printing keys are bound in `isearch-mode-map'.  
  8999.  
  9000. Type \[isearch-delete-char] to cancel characters from end of search string.
  9001. Type \[isearch-exit] to exit, leaving point at location found.
  9002. Type LFD (C-j) to match end of line.
  9003. Type \[isearch-repeat-forward] to search again forward, \[isearch-repeat-backward] to search again backward.
  9004. Type \[isearch-yank-word] to yank word from buffer onto end of search string and search for it.
  9005. Type \[isearch-yank-line] to yank rest of line onto end of search string and search for it.
  9006. Type \[isearch-quote-char] to quote control character to search for it.
  9007. Type \[isearch-whitespace-chars] to match all whitespace chars in regexp.
  9008. \[isearch-abort] while searching or when search has failed cancels input back to what has
  9009.  been found successfully.
  9010. \[isearch-abort] when search is successful aborts and moves point to starting point.
  9011.  
  9012. Also supported is a search ring of the previous 16 search strings.
  9013. Type \[isearch-ring-advance] to search for the next item in the search ring.
  9014. Type \[isearch-ring-retreat] to search for the previous item in the search ring.
  9015. Type \[isearch-complete] to complete the search string using the search ring.
  9016.  
  9017. The above keys are bound in the isearch-mode-map.  To change the keys which
  9018.  are special to isearch-mode, simply change the bindings in that map.
  9019.  
  9020. Other control and meta characters terminate the search
  9021.  and are then executed normally (depending on `search-exit-option').
  9022.  
  9023. If this function is called non-interactively, it does not return to
  9024. the calling function until the search is done.
  9025.  
  9026. The bindings, more precisely:
  9027. \{isearch-mode-map}
  9028. Fisearch-forward-regexp
  9029. Do incremental search forward for regular expression.
  9030. Like ordinary incremental search except that your input
  9031. is treated as a regexp.  See \[isearch-forward] for more info.
  9032. Fisearch-backward
  9033. Do incremental search backward.
  9034. With a prefix argument, do an incremental regular expression search instead.
  9035. See \[isearch-forward] for more information.
  9036. Fisearch-backward-regexp
  9037. Do incremental search backward for regular expression.
  9038. Like ordinary incremental search except that your input
  9039. is treated as a regexp.  See \[isearch-forward] for more info.
  9040. Fisearch-mode
  9041. Start isearch minor mode.  Called by isearch-forward, etc.
  9042. Fisearch-exit
  9043. Exit search normally.
  9044. However, if this is the first command after starting incremental
  9045. search and `search-nonincremental-instead' is non-nil, do a
  9046. nonincremental search instead.
  9047. Fisearch-edit-string
  9048. Edit the search string in the minibuffer.
  9049. The following additional command keys are active while editing.
  9050. \<minibuffer-local-isearch-map>
  9051. \[exit-minibuffer] to exit editing and resume incremental searching.
  9052. \[isearch-forward-exit-minibuffer] to resume isearching forward.
  9053. \[isearch-backward-exit-minibuffer] to resume isearching backward.
  9054. \[isearch-ring-advance-edit] to replace the search string with the next item in the search ring.
  9055. \[isearch-ring-retreat-edit] to replace the search string with the next item in the search ring.
  9056. \[isearch-complete-edit] to complete the search string from the search ring.
  9057. Fisearch-abort
  9058. Quit incremental search mode if searching is successful, signalling quit.
  9059. Otherwise, revert to previous successful search and continue searching.
  9060. Use `isearch-exit' to quit without signalling.
  9061. Fisearch-repeat-forward
  9062. Repeat incremental search forwards.
  9063. Fisearch-repeat-backward
  9064. Repeat incremental search backwards.
  9065. Fisearch-toggle-regexp
  9066. Toggle regexp searching on or off.
  9067. Fisearch-delete-char
  9068. Discard last input item and move point back.  
  9069. If no previous match was done, just beep.
  9070. Fisearch-yank-word
  9071. Pull next word from buffer into search string.
  9072. Fisearch-yank-line
  9073. Pull rest of line from buffer into search string.
  9074. Fisearch-*-char
  9075. Handle * and ? specially in regexps.
  9076. Fisearch-|-char
  9077. If in regexp search, jump to the barrier.
  9078. Fisearch-quote-char
  9079. Quote special characters for incremental search.
  9080. Fisearch-return-char
  9081. Convert return into newline for incremental search.
  9082. Obsolete.
  9083. Fisearch-printing-char
  9084. Any other printing character => add it to the search string and search.
  9085. Fisearch-whitespace-chars
  9086. Match all whitespace chars, if in regexp mode.
  9087. Vsearch-ring-update
  9088. *Non-nil if advancing or retreating in the search ring should cause search.
  9089. Default nil means edit the string from the search ring first.
  9090. Fisearch-ring-advance
  9091. Advance to the next search string in the ring.
  9092. Fisearch-ring-retreat
  9093. Retreat to the previous search string in the ring.
  9094. Fisearch-ring-adjust-edit
  9095. Use the next or previous search string in the ring while in minibuffer.
  9096. Fisearch-ring-retreat-edit
  9097. Retreat to the previous search string in the ring while in the minibuffer.
  9098. Fisearch-complete
  9099. Complete the search string from the strings on the search ring.
  9100. The completed string is then editable in the minibuffer.
  9101. If there is no completion possible, say so and continue searching.
  9102. Fisearch-complete-edit
  9103. Same as `isearch-complete' except in the minibuffer.
  9104. Visearch-highlight
  9105. *Whether isearch and query-replace should highlight the text which 
  9106. currently matches the search-string.
  9107. Fisearch-no-upper-case-p
  9108. Return t if there are no upper case chars in string.
  9109. But upper case chars preceeded by \ do not count since they
  9110. have special meaning in a regexp.
  9111. Fkeep-lines
  9112. Delete all lines except those containing matches for REGEXP.
  9113. A match split across lines preserves all the lines it lies in.
  9114. Applies to all lines after point.
  9115. Fflush-lines
  9116. Delete lines containing matches for REGEXP.
  9117. If a match is split across lines, all the lines it lies in are deleted.
  9118. Applies to lines after point.
  9119. Fhow-many
  9120. Print number of matches for REGEXP following point.
  9121. Foccur-mode
  9122. Major mode for output from \[occur].
  9123. Move point to one of the occurrences in this buffer,
  9124. then use \[occur-mode-goto-occurrence] to go to the same occurrence
  9125. in the buffer that the occurrences were found in.
  9126. \{occur-mode-map}
  9127. Foccur-mode-goto-occurrence
  9128. Go to the line this occurrence was found in, in the buffer it was found in.
  9129. Vlist-matching-lines-default-context-lines
  9130. *Default number of context lines to include around a list-matching-lines
  9131. match.  A negative number means to include that many lines before the match.
  9132. A positive number means to include that many lines both before and after.
  9133. Voccur-whole-buffer
  9134. If t, occur operates on whole buffer, otherwise occur starts from point.
  9135. default is nil.
  9136. Foccur
  9137. Show lines containing a match for REGEXP.  If the global variable
  9138. occur-whole-buffer is non-nil, the entire buffer is searched, otherwise
  9139. search begins at point.  Interactively, REGEXP defaults to the last REGEXP
  9140. used interactively.
  9141.  
  9142. Each line is displayed with NLINES lines before and after,
  9143. or -NLINES before if NLINES is negative.
  9144. NLINES defaults to list-matching-lines-default-context-lines.
  9145. Interactively it is the prefix arg.
  9146.  
  9147. The lines are shown in a buffer named *Occur*.
  9148. It serves as a menu to find any of the occurrences in this buffer.
  9149. \[describe-mode] in that buffer will explain how.
  9150. Vquery-replace-help
  9151. Help message while in query-replace
  9152. Fperform-replace
  9153. Subroutine of `query-replace'.  Its complexity handles interactive queries.
  9154. Don't use this in your own program unless you want to query and set the mark
  9155. just as `query-replace' does.  Instead, write a simple loop like this:
  9156.   (while (re-search-forward "foo[     ]+bar" nil t)
  9157.     (replace-match "foobar" nil nil))
  9158. which will run faster and do exactly what you probably want.
  9159. Fmap-query-replace-regexp
  9160. Replace some matches for REGEXP with various strings, in rotation.
  9161. The second argument TO-STRINGS contains the replacement strings, separated
  9162. by spaces.  This command works like `query-replace-regexp' except
  9163. that each successive replacement uses the next successive replacement string,
  9164. wrapping around from the last such string to the first.
  9165.  
  9166. Non-interactively, TO-STRINGS may be a list of replacement strings.
  9167.  
  9168. A prefix argument N says to use each replacement string N times
  9169. before rotating to the next.
  9170. Vpi
  9171. The value of Pi (3.1415926...)
  9172. Ve
  9173. The value of e (2.7182818...)
  9174. Vdegrees-to-radians
  9175. Degrees to radian conversion constant
  9176. Vradians-to-degrees
  9177. Radian to degree conversion constant
  9178. Fdegrees-to-radians
  9179. Convert ARG from degrees to radians.
  9180. Fradians-to-degrees
  9181. Convert ARG from radians to degrees.
  9182. Vselect-screen-hook
  9183. Function or functions to run just after a new screen is selected.
  9184. Vdeselect-screen-hook
  9185. Function or functions to run just before selecting another screen.
  9186. Vscreen-default-alist
  9187. Alist of default values for screen creation, other than the first one.
  9188. These may be set in your init file, like this:
  9189.   (setq screen-default-alist '((width . 80) (height . 55)))
  9190. For values specific to the first emacs screen, you must use X Resources.
  9191. Vminibuffer-alist
  9192. Alist of switches for the appearance of the detached minibuffer screen.
  9193. Vinitial-screen-hooks
  9194. Hook to run after initial screen startup.
  9195. Vscreen-creation-func
  9196. Window-system dependent function for creating new screens.
  9197. Vnew-screen-x-delta
  9198. Horizontal displacement (in pixels) for position of new screen.
  9199. Vnew-screen-y-delta
  9200. Vertical displacement (in pixels) for position of new screen.
  9201. Fother-window-any-screen
  9202. Select the ARG'th different window on any screen.
  9203. All windows on current screen are arranged in a cyclic order.
  9204. This command selects the window ARG steps away in that order.
  9205. A negative ARG moves in the opposite order.  However, unlike
  9206. `other-window', this command will select a window on the next
  9207. (or previous) screen instead of wrapping around to the top
  9208. (or bottom) of this screen, when there are no more windows.
  9209. Fone-screen
  9210. Delete all screens but SCREEN (default is current screen).
  9211. Also delete all windows but the selected one on SCREEN.
  9212. Ffind-file-new-screen
  9213. Just like find-file, but creates a new screen for it first.
  9214. Fswitch-to-buffer-new-screen
  9215. Just like switch-to-buffer, but creates a new screen for it first.
  9216. Vauto-raise-screen
  9217. *If true, screens will be raised to the top when selected.
  9218. Under X, most ICCCM-compliant window managers will have an option to do this 
  9219. for you, but this variable is provided in case you're using a broken WM.
  9220. Vauto-lower-screen
  9221. *If true, screens will be lowered to the bottom when no longer selected.
  9222. Under X, most ICCCM-compliant window managers will have an option to do this 
  9223. for you, but this variable is provided in case you're using a broken WM.
  9224. Fdefault-select-screen-hook
  9225. Implements the `auto-raise-screen' variable.
  9226. For use as the value of `select-screen-hook'.
  9227. Fdefault-deselect-screen-hook
  9228. Implements the `auto-lower-screen' variable.
  9229. For use as the value of `deselect-screen-hook'.
  9230. Vget-screen-for-buffer-default-screen-name
  9231. The default screen to select; see doc of `get-screen-for-buffer'.
  9232. Fget-screen-for-buffer
  9233. Select and return a screen in which to display BUFFER.
  9234. Normally, the buffer will simply be displayed in the current screen.
  9235. But if the symbol naming the major-mode of the buffer has a 'screen-name
  9236. property (which should be a symbol), then the buffer will be displayed in
  9237. a screen of that name.  If there is no screen of that name, then one is
  9238. created.  
  9239.  
  9240. If the major-mode doesn't have a 'screen-name property, then the screen
  9241. named by `get-screen-for-buffer-default-screen-name' will be used.  If
  9242. that is nil (the default) then the currently selected screen will used.
  9243.  
  9244. If the screen-name symbol has an 'instance-limit property (an integer)
  9245. then each time a buffer of the mode in question is displayed, a new screen
  9246. with that name will be created, until there are `instance-limit' of them.
  9247. If instance-limit is 0, then a new screen will be created each time.
  9248.  
  9249. If a buffer is already displayed in a screen, then `instance-limit' is 
  9250. ignored, and that screen is used.
  9251.  
  9252. If the screen-name symbol has a 'screen-defaults property, then that is
  9253. prepended to the `screen-default-alist' when creating a screen for the
  9254. first time.
  9255.  
  9256. This function may be used as the value of `pre-display-buffer-hook', to 
  9257. cause the display-buffer function and its callers to exhibit the above
  9258. behavior.
  9259. Fshow-temp-buffer-in-current-screen
  9260. For use as the value of temp-buffer-show-function:
  9261. always displays the buffer in the current screen, regardless of the behavior
  9262. that would otherwise be introduced by the `pre-display-buffer-function', which
  9263. is normally set to `get-screen-for-buffer' (which see.)
  9264. Fkill-this-buffer
  9265. Kills the current buffer.
  9266. Fx-new-screen
  9267. Creates a new emacs screen (that is, a new X window.)
  9268. Fset-menubar
  9269. Set the default menubar to be menubar.
  9270. Fset-buffer-menubar
  9271. Set the buffer-local menubar to be menubar.
  9272. Fdisable-menu-item
  9273. Make the named menu item be unselectable.
  9274. PATH is a list of strings which identify the position of the menu item in 
  9275. the menu hierarchy.  ("File" "Save") means the menu item called "Save"
  9276. under the toplevel "File" menu.  ("Menu" "Foo" "Item") means the 
  9277. menu item called "Item" under the "Foo" submenu of "Menu".
  9278. Fenable-menu-item
  9279. Make the named menu item be selectable.
  9280. PATH is a list of strings which identify the position of the menu item in 
  9281. the menu hierarchy.  ("File" "Save") means the menu item called "Save"
  9282. under the toplevel "File" menu.  ("Menu" "Foo" "Item") means the 
  9283. menu item called "Item" under the "Foo" submenu of "Menu".
  9284. Fadd-menu-item
  9285. Add a menu item to some menu, creating the menu first if necessary.
  9286. If the named item exists already, it is changed.
  9287. MENU-PATH identifies the menu under which the new menu item should be inserted.
  9288.  It is a list of strings; for example, ("File") names the top-level "File"
  9289.  menu.  ("File" "Foo") names a hypothetical submenu of "File".
  9290. ITEM-NAME is the string naming the menu item to be added.
  9291. FUNCTION is the command to invoke when this menu item is selected.
  9292.  If it is a symbol, then it is invoked with `call-interactively', in the same
  9293.  way that functions bound to keys are invoked.  If it is a list, then the 
  9294.  list is simply evaluated.
  9295. ENABLED-P controls whether the item is selectable or not.
  9296. BEFORE, if provided, is the name of a menu item before which this item should
  9297.  be added, if this item is not on the menu already.  If the item is already
  9298.  present, it will not be moved.
  9299. Fdelete-menu-item
  9300. Remove the named menu item from the menu hierarchy.
  9301. PATH is a list of strings which identify the position of the menu item in 
  9302. the menu hierarchy.  ("File" "Save") means the menu item called "Save"
  9303. under the toplevel "File" menu.  ("Menu" "Foo" "Item") means the 
  9304. menu item called "Item" under the "Foo" submenu of "Menu".
  9305. Frelabel-menu-item
  9306. Change the string of the specified menu item.
  9307. PATH is a list of strings which identify the position of the menu item in 
  9308. the menu hierarchy.  ("File" "Save") means the menu item called "Save"
  9309. under the toplevel "File" menu.  ("Menu" "Foo" "Item") means the 
  9310. menu item called "Item" under the "Foo" submenu of "Menu".
  9311. NEW-NAME is the string that the menu item will be printed as from now on.
  9312. Fadd-menu
  9313. Add a menu to the menubar or one of its submenus.
  9314. If the named menu exists already, it is changed.
  9315. MENU-PATH identifies the menu under which the new menu should be inserted.
  9316.  It is a list of strings; for example, ("File") names the top-level "File"
  9317.  menu.  ("File" "Foo") names a hypothetical submenu of "File".
  9318.  If MENU-PATH is nil, then the menu will be added to the menubar itself.
  9319. MENU-NAME is the string naming the menu to be added.
  9320. MENU-ITEMS is a list of menu item descriptions.
  9321.  Each menu item should be a vector of three elements:
  9322.    - a string, the name of the menu item;
  9323.    - a symbol naming a command, or a form to evaluate;
  9324.    - and t or nil, whether this item is selectable.
  9325. BEFORE, if provided, is the name of a menu before which this menu should
  9326.  be added, if this menu is not on its parent already.  If the menu is already
  9327.  present, it will not be moved.
  9328. Fsensitize-file-and-edit-menus-hook
  9329. For use as a value of activate-menubar-hook.
  9330. This function changes the sensitivity of these File and Edit menu items:
  9331.  
  9332.   Cut    sensitive only when emacs owns the primary X Selection.
  9333.   Copy   sensitive only when emacs owns the primary X Selection.
  9334.   Clear  sensitive only when emacs owns the primary X Selection.
  9335.   Paste  sensitive only when there is an owner for the X Clipboard Selection.
  9336.   Undo   sensitive only when there is undo information.
  9337.          While in the midst of an undo, this is changed to "Undo More".
  9338.  
  9339.   Kill Buffer    has the name of the current buffer appended to it.
  9340.   Print Buffer   has the name of the current buffer appended to it.
  9341.   Save Buffer    has the name of the current buffer appended to it, and is
  9342.                  sensitive only when the current buffer is modified.
  9343.   Revert Buffer  has the name of the current buffer appended to it, and is
  9344.                  sensitive only when the current buffer has a file.
  9345.   Delete Screen  sensitive only when there is more than one visible screen.
  9346. Fformat-buffers-menu-line
  9347. Returns a string to represent the given buffer in the Buffer menu.
  9348. nil means the buffer shouldn't be listed.  You can redefine this.
  9349. Vbuffers-menu-max-size
  9350. *Maximum number of entries which may appear on the "Buffers" menu.
  9351. If this is 10, then only the ten most-recently-selected buffers will be
  9352. shown.  If this is nil, then all buffers will be shown.  Setting this to
  9353. a large number or nil will slow down menu responsiveness.
  9354. Vcomplex-buffers-menu-p
  9355. *If true, the buffers menu will contain several commands, as submenus
  9356. of each buffer line.  If this is false, then there will be only one command:
  9357. select that buffer.
  9358. Vbuffers-menu-switch-to-buffer-function
  9359. *The function to call to select a buffer from the buffers menu.
  9360. `switch-to-buffer' is a good choice, as is `pop-to-buffer'.
  9361. Fbuild-buffers-menu-hook
  9362. For use as a value of activate-menubar-hook.
  9363. This function changes the contents of the "Buffers" menu to correspond
  9364. to the current set of buffers.  Only the most-recently-used few buffers
  9365. will be listed on the menu, for efficiency reasons.  You can control how
  9366. many buffers will be shown by setting `buffers-menu-max-size'.
  9367. You can control the text of the menu items by redefining the function
  9368. `format-buffers-menu-line'.
  9369. Fyes-or-no-p-dialog-box
  9370. Ask user a "y or n" question with a popup dialog box.
  9371. Returns t if answer is "yes".
  9372. Takes one argument, which is the string to display to ask the question.
  9373. Fyes-or-no-p-maybe-dialog-box
  9374. Ask user a yes-or-no question.  Return t if answer is yes.
  9375. The question is asked with a dialog box or the minibuffer, as appropriate.
  9376. Takes one argument, which is the string to display to ask the question.
  9377. It should end in a space; `yes-or-no-p' adds `(yes or no) ' to it.
  9378. The user must confirm the answer with RET,
  9379. and can edit it until it as been confirmed.
  9380. Fy-or-n-p-maybe-dialog-box
  9381. Ask user a "y or n" question.  Return t if answer is "y".
  9382. Takes one argument, which is the string to display to ask the question.
  9383. The question is asked with a dialog box or the minibuffer, as appropriate.
  9384. It should end in a space; `y-or-n-p' adds `(y or n) ' to it.
  9385. No confirmation of the answer is requested; a single character is enough.
  9386. Also accepts Space to mean yes, or Delete to mean no.
  9387. Fmouse-select
  9388. Select Emacs window the mouse is on.
  9389. Fmouse-delete-window
  9390. Delete the Emacs window the mouse is on.
  9391. Fmouse-keep-one-window
  9392. Select Emacs window mouse is on, then kill all other Emacs windows.
  9393. Fmouse-select-and-split
  9394. Select Emacs window mouse is on, then split it vertically in half.
  9395. Fmouse-set-point
  9396. Select Emacs window mouse is on, and move point to mouse position.
  9397. Fmouse-line-length
  9398. Print the length of the line indicated by the pointer.
  9399. Fmouse-set-mark
  9400. Select Emacs window mouse is on, and set mark at mouse position.
  9401. Display cursor at that position for a second.
  9402. Fmouse-scroll
  9403. Scroll point to the mouse position.
  9404. Fmouse-del-char
  9405. Delete the char pointed to by the mouse.
  9406. Fmouse-kill-line
  9407. Kill the line pointed to by the mouse.
  9408. Fnarrow-window-to-region
  9409. Narrow window to region between point and last mark
  9410. Fmouse-window-to-region
  9411. Narrow window to region between cursor and mouse pointer.
  9412. Fmouse-ignore
  9413. Don't do anything.
  9414. Fmouse-track
  9415. Make a selection with the mouse.  This should be bound to a mouse button.
  9416. If you click-and-drag, the selection will be set to the region between the
  9417. point of the initial click and the point at which you release the button.
  9418. These positions need not be ordered.
  9419.  
  9420. If you click-and-release without moving the mouse, then the point is moved,
  9421. and the selection is disowned (there will be no selection owner.)  The mark
  9422. will be set to the previous position of point.
  9423.  
  9424. If you double-click, the selection will extend by symbols instead of by
  9425. characters.  If you triple-click, the selection will extend by lines.
  9426.  
  9427. If you drag the mouse off the top or bottom of the window, you can select
  9428. pieces of text which are larger than the visible part of the buffer; the 
  9429. buffer will scroll as necessary.
  9430.  
  9431. The selected text becomes the current X Selection, and is also copied to the
  9432. top of the kill ring.  The point will be left at the position at which you
  9433. released the button, and the mark will be left at the initial click position.
  9434.  
  9435. See also the `mouse-track-adjust' command, on \[mouse-track-adjust].
  9436. Fmouse-track-adjust
  9437. Extend the existing selection.  This should be bound to a mouse button.
  9438. The selection will be enlarged or shrunk so that the point of the mouse
  9439. click is one of its endpoints.  This is only really meaningful after the
  9440. `mouse-track' command (\[mouse-track]) has been executed.
  9441. Fmouse-track-insert
  9442. Make a selection with the mouse and insert it at point.
  9443. This is exactly the same as the `mouse-track' command on \[mouse-track], 
  9444. except that point is not moved; the selected text is immediately inserted
  9445. after being selected; and the selection is immediately disowned afterwards.
  9446. Fmouse-track-delete-and-insert
  9447. Make a selection with the mouse and insert it at point.
  9448. This is exactly the same as the `mouse-track' command on \[mouse-track], 
  9449. except that point is not moved; the selected text is immediately inserted
  9450. after being selected; and the text of the selection is deleted.
  9451. Vmode-motion-hook
  9452. Function or functions which are called whenever the mouse moves.
  9453. You should normally use this rather than `mouse-motion-handler', which 
  9454. does some additional window-system-dependent things.  This hook is local
  9455. to every buffer, and should normally be set up by major-modes which want
  9456. to use special highlighting.  Every time the mouse moves over a window,
  9457. the mode-motion-hook of the buffer of that window is run.
  9458. Fmode-motion-highlight-line
  9459. For use as the value of `mode-motion-hook' -- highlight line under mouse.
  9460. Fmode-motion-highlight-word
  9461. For use as the value of `mode-motion-hook' -- highlight word under mouse.
  9462. Fmode-motion-highlight-symbol
  9463. For use as the value of `mode-motion-hook' -- highlight symbol under mouse.
  9464. Fmode-motion-highlight-sexp
  9465. For use as the value of `mode-motion-hook' -- highlight form under mouse.
  9466. Fminibuf-select-highlighted-completion
  9467. Select the highlighted text under the mouse as a minibuffer response.
  9468. When the minibuffer is being used to prompt the user for a completion,
  9469. any valid completions which are visible on the screen will highlight
  9470. when the mouse moves over them.  Clicking \<minibuffer-local-map>\[minibuf-select-highlighted-completion] will select the
  9471. highlighted completion under the mouse.
  9472.  
  9473. If the mouse is clicked while while not over a highlighted completion,
  9474. then the global binding of \[minibuf-select-highlighted-completion] will be executed instead.  In this
  9475. way you can get at the normal global behavior of \[minibuf-select-highlighted-completion] as well as
  9476. the special minibuffer behavior.
  9477. Fask-user-about-lock
  9478. Ask user what to do when he wants to edit FILE but it is locked by USER.
  9479. This function has a choice of three things to do:
  9480.   do (signal 'buffer-file-locked (list FILE USER))
  9481.     to refrain from editing the file
  9482.   return t (grab the lock on the file)
  9483.   return nil (edit the file even though it is locked).
  9484. You can rewrite it to use any criterion you like to choose which one to do.
  9485. Fask-user-about-supersession-threat
  9486. Ask a user who is about to modify an obsolete buffer what to do.
  9487. This function has two choices: it can return, in which case the modification
  9488. of the buffer will proceed, or it can (signal 'file-supersession (file)),
  9489. in which case the proposed buffer modification will not be made.
  9490.  
  9491. You can rewrite this to use any criterion you like to choose which one to do.
  9492. The buffer in question is current when this function is called.
  9493. Vlisp-mode-syntax-table
  9494.  
  9495. Vemacs-lisp-mode-syntax-table
  9496.  
  9497. Vlisp-mode-abbrev-table
  9498.  
  9499. Vshared-lisp-mode-map
  9500. Keymap for commands shared by all sorts of Lisp modes.
  9501. Vemacs-lisp-mode-map
  9502. Keymap for Emacs Lisp mode.
  9503. All commands in shared-lisp-mode-map are inherited by this map.
  9504. Femacs-lisp-mode
  9505. Major mode for editing Lisp code to run in Emacs.
  9506. Commands:
  9507. Delete converts tabs to spaces as it moves back.
  9508. Blank lines separate paragraphs.  Semicolons start comments.
  9509. \{emacs-lisp-mode-map}
  9510. Entry to this mode calls the value of emacs-lisp-mode-hook
  9511. if that value is non-nil.
  9512. Vlisp-mode-map
  9513. Keymap for ordinary Lisp mode.
  9514. All commands in shared-lisp-mode-map are inherited by this map.
  9515. Flisp-mode
  9516. Major mode for editing Lisp code for Lisps other than GNU Emacs Lisp.
  9517. Commands:
  9518. Delete converts tabs to spaces as it moves back.
  9519. Blank lines separate paragraphs.  Semicolons start comments.
  9520. \{lisp-mode-map}
  9521. Note that `run-lisp' may be used either to start an inferior Lisp job
  9522. or to switch back to an existing one.
  9523.  
  9524. Entry to this mode calls the value of lisp-mode-hook
  9525. if that value is non-nil.
  9526. Flisp-send-defun
  9527. Send the current defun to the Lisp process made by M-x run-lisp.
  9528. Vlisp-interaction-mode-map
  9529. Keymap for Lisp Interaction moe.
  9530. All commands in shared-lisp-mode-map are inherited by this map.
  9531. Flisp-interaction-mode
  9532. Major mode for typing and evaluating Lisp forms.
  9533. Like Lisp mode except that \[eval-print-last-sexp] evals the Lisp expression
  9534. before point, and prints its value into the buffer, advancing point.
  9535.  
  9536. Commands:
  9537. Delete converts tabs to spaces as it moves back.
  9538. Paragraphs are separated only by blank lines.  Semicolons start comments.
  9539. \{lisp-interaction-mode-map}
  9540. Entry to this mode calls the value of lisp-interaction-mode-hook
  9541. if that value is non-nil.
  9542. Feval-print-last-sexp
  9543. Evaluate sexp before point; print value into current buffer.
  9544. Feval-last-sexp
  9545. Evaluate sexp before point; print value in minibuffer.
  9546. With argument, print output into current buffer.
  9547. Feval-defun
  9548. Evaluate defun that point is in or before.
  9549. Print value in minibuffer.
  9550. With argument, insert value in current buffer after the defun.
  9551. Vlisp-indent-offset
  9552.  
  9553. Vlisp-indent-function
  9554.  
  9555. Flisp-indent-line
  9556. Indent current line as Lisp code.
  9557. With argument, indent any additional lines of the same expression
  9558. rigidly along with this one.
  9559. Fcalculate-lisp-indent
  9560. Return appropriate indentation for current line as Lisp code.
  9561. In usual case returns an integer: the column to indent to.
  9562. Can instead return a list, whose car is the column to indent to.
  9563. This means that following lines at the same level of indentation
  9564. should not necessarily be indented the same way.
  9565. The second element of the list is the buffer position
  9566. of the start of the containing expression.
  9567. Vlisp-body-indent
  9568.  
  9569. Findent-sexp
  9570. Indent each line of the list starting just after point.
  9571. If optional arg ENDPOS is given, indent each line, stopping when
  9572. ENDPOS is encountered.
  9573. Findent-code-rigidly
  9574. Indent all lines of code, starting in the region, sideways by ARG columns.
  9575. Does not affect lines starting inside comments or strings,
  9576. assuming that the start of the region is not inside them.
  9577. Called from a program, takes args START, END, COLUMNS and NOCHANGE-REGEXP.
  9578. The last is a regexp which, if matched at the beginning of a line,
  9579. means don't indent that line.
  9580. Vtext-mode-syntax-table
  9581. Syntax table used while in text mode.
  9582. Vtext-mode-abbrev-table
  9583. Abbrev table used while in text mode.
  9584. Vtext-mode-map
  9585. Keymap for Text mode.
  9586. Many other modes, such as Mail mode, Outline mode and Indented Text mode,
  9587. inherit all the commands defined in this map.
  9588. Ftext-mode
  9589. Major mode for editing text intended for humans to read.  Special commands:\{text-mode-map}
  9590. Turning on text-mode calls the value of the variable `text-mode-hook',
  9591. if that value is non-nil.
  9592. Vindented-text-mode-map
  9593. Keymap for Indented Text mode.
  9594. All the commands defined in Text mode are inherited unless overridden.
  9595. Findented-text-mode
  9596. Major mode for editing indented text intended for humans to read.\{indented-text-mode-map}
  9597. Turning on indented-text-mode calls the value of the variable `text-mode-hook',
  9598. if that value is non-nil.
  9599. Fchange-log-mode
  9600. Major mode for editing ChangeLog files.  See M-x add-change-log-entry.
  9601. Almost the same as Indented Text mode, but prevents numeric backups
  9602. and sets `left-margin' to 8 and `fill-column' to 74.
  9603. Fcenter-paragraph
  9604. Center each nonblank line in the paragraph at or after point.
  9605. See center-line for more info.
  9606. Fcenter-region
  9607. Center each nonblank line starting in the region.
  9608. See center-line for more info.
  9609. Fcenter-line
  9610. Center the line point is on, within the width specified by `fill-column'.
  9611. This means adjusting the indentation so that it equals
  9612. the distance between the end of the text and `fill-column'.
  9613. Vc-mode-abbrev-table
  9614. Abbrev table in use in C-mode buffers.
  9615. Vc-mode-map
  9616. Keymap used in C mode.
  9617. Fc-macro-expand
  9618. Display the result of expanding all C macros occurring in the region.
  9619. The expansion is entirely correct because it uses the C preprocessor.
  9620. Vc-mode-syntax-table
  9621. Syntax table in use in C-mode buffers.
  9622. Vc-indent-level
  9623. *Indentation of C statements with respect to containing block.
  9624. Vc-brace-imaginary-offset
  9625. *Imagined indentation of a C open brace that actually follows a statement.
  9626. Vc-brace-offset
  9627. *Extra indentation for braces, compared with other text in same context.
  9628. Vc-argdecl-indent
  9629. *Indentation level of declarations of C function arguments.
  9630. Vc-label-offset
  9631. *Offset of C label lines and case statements relative to usual indentation.
  9632. Vc-continued-statement-offset
  9633. *Extra indent for lines not starting new statements.
  9634. Vc-continued-brace-offset
  9635. *Extra indent for substatements that start with open-braces.
  9636. This is in addition to c-continued-statement-offset.
  9637. Vc-auto-newline
  9638. *Non-nil means automatically newline before and after braces,
  9639. and after colons and semicolons, inserted in C code.
  9640. If you do not want a leading newline before braces then use:
  9641.   (define-key c-mode-map "{" 'electric-c-semi)
  9642. Vc-tab-always-indent
  9643. *Non-nil means TAB in C mode should always reindent the current line,
  9644. regardless of where in the line point is when the TAB command is used.
  9645. Fc-mode
  9646. Major mode for editing C code.
  9647. Expression and list commands understand all C brackets.
  9648. Tab indents for C code.
  9649. Comments are delimited with /* ... */.
  9650. Paragraphs are separated by blank lines only.
  9651. Delete converts tabs to spaces as it moves back.
  9652. \{c-mode-map}
  9653. Variables controlling indentation style:
  9654.  c-tab-always-indent
  9655.     Non-nil means TAB in C mode should always reindent the current line,
  9656.     regardless of where in the line point is when the TAB command is used.
  9657.  c-auto-newline
  9658.     Non-nil means automatically newline before and after braces,
  9659.     and after colons and semicolons, inserted in C code.
  9660.  c-indent-level
  9661.     Indentation of C statements within surrounding block.
  9662.     The surrounding block's indentation is the indentation
  9663.     of the line on which the open-brace appears.
  9664.  c-continued-statement-offset
  9665.     Extra indentation given to a substatement, such as the
  9666.     then-clause of an if or body of a while.
  9667.  c-continued-brace-offset
  9668.     Extra indentation given to a brace that starts a substatement.
  9669.     This is in addition to c-continued-statement-offset.
  9670.  c-brace-offset
  9671.     Extra indentation for line if it starts with an open brace.
  9672.  c-brace-imaginary-offset
  9673.     An open brace following other text is treated as if it were
  9674.     this far to the right of the start of its line.
  9675.  c-argdecl-indent
  9676.     Indentation level of declarations of C function arguments.
  9677.  c-label-offset
  9678.     Extra indentation for line that is a label, or case or default.
  9679.  
  9680. Settings for K&R and BSD indentation styles are
  9681.   c-indent-level                5    8
  9682.   c-continued-statement-offset  5    8
  9683.   c-brace-offset               -5   -8
  9684.   c-argdecl-indent              0    8
  9685.   c-label-offset               -5   -8
  9686.  
  9687. Turning on C mode calls the value of the variable c-mode-hook with no args,
  9688. if that value is non-nil.
  9689. Fc-fill-paragraph
  9690. Like \[fill-paragraph] but handle C comments.
  9691. If point is inside a comment, the current paragraph of the comment
  9692. is filled, preserving the comment indentation or line-starting decorations.
  9693. Felectric-c-brace
  9694. Insert character and correct line's indentation.
  9695. Felectric-c-sharp-sign
  9696. Insert character and correct line's indentation.
  9697. Felectric-c-semi
  9698. Insert character and correct line's indentation.
  9699. Felectric-c-terminator
  9700. Insert character and correct line's indentation.
  9701. Fc-indent-command
  9702. Indent current line as C code, or in some cases insert a tab character.
  9703. If c-tab-always-indent is non-nil (the default), always indent current line.
  9704. Otherwise, indent the current line only if point is at the left margin
  9705. or in the line's indentation; otherwise insert a tab.
  9706.  
  9707. A numeric argument, regardless of its value,
  9708. means indent rigidly all the lines of the expression starting after point
  9709. so that this line becomes properly indented.
  9710. The relative indentation among the lines of the expression are preserved.
  9711. Fc-indent-line
  9712. Indent current line as C code.
  9713. Return the amount the indentation changed by.
  9714. Fcalculate-c-indent
  9715. Return appropriate indentation for current line as C code.
  9716. In usual case returns an integer: the column to indent to.
  9717. Returns nil if line starts inside a string, t if in a comment.
  9718. Fcalculate-c-indent-within-comment
  9719. Return the indentation amount for line inside a block comment.
  9720. Non-nil arg AFTER-STAR means, if lines in the comment have a leading star,
  9721. return the indentation of the text that would follow this star.
  9722. Fc-backward-to-start-of-if
  9723. Move to the start of the last ``unbalanced'' if.
  9724. Fc-backward-to-start-of-do
  9725. If point follows a `do' statement, move to beginning of it and return `t'.
  9726. Otherwise return `nil' and don't move point.
  9727. Fmark-c-function
  9728. Put mark at end of C function, point at beginning.
  9729. Findent-c-exp
  9730. Indent each line of the C grouping following point.
  9731. If optional arg ENDPOS is given, indent each line, stopping when
  9732. ENDPOS is encountered.
  9733. Fabbrev-mode
  9734. Toggle abbrev mode.
  9735. With arg, turn abbrev mode on iff arg is positive.
  9736. In abbrev mode, inserting an abbreviation causes it to expand
  9737. and be replaced by its expansion.
  9738. Vedit-abbrevs-map
  9739. Keymap used in edit-abbrevs.
  9740. Fkill-all-abbrevs
  9741. Undefine all defined abbrevs.
  9742. Finsert-abbrevs
  9743. Insert after point a description of all defined abbrevs.
  9744. Mark is set after the inserted text.
  9745. Flist-abbrevs
  9746. Display a list of all defined abbrevs.
  9747. Fedit-abbrevs-mode
  9748. Major mode for editing the list of abbrev definitions.
  9749. \{edit-abbrevs-map}
  9750. Fedit-abbrevs
  9751. Alter abbrev definitions by editing a list of them.
  9752. Selects a buffer containing a list of abbrev definitions.
  9753. You can edit them and type C-c C-c to redefine abbrevs
  9754. according to your editing.
  9755. Buffer contains a header line for each abbrev table,
  9756.  which is the abbrev table name in parentheses.
  9757. This is followed by one line per abbrev in that table:
  9758. NAME   USECOUNT   EXPANSION   HOOK
  9759. where NAME and EXPANSION are strings with quotes,
  9760. USECOUNT is an integer, and HOOK is any valid function
  9761. or may be omitted (it is usually omitted).
  9762. Fedit-abbrevs-redefine
  9763. Redefine abbrevs according to current buffer contents.
  9764. Fdefine-abbrevs
  9765. Define abbrevs according to current visible buffer contents.
  9766. See documentation of edit-abbrevs for info on the format of the
  9767. text you must have in the buffer.
  9768. With argument, eliminate all abbrev definitions except
  9769. the ones defined from the buffer now.
  9770. Fread-abbrev-file
  9771. Read abbrev definitions from file written with write-abbrev-file.
  9772. Takes file name as argument.
  9773. Optional second argument non-nil means don't print anything.
  9774. Fquietly-read-abbrev-file
  9775. Read abbrev definitions from file written with write-abbrev-file.
  9776. Takes file name as argument.  Does not print anything.
  9777. Fwrite-abbrev-file
  9778. Write all abbrev definitions to file of Lisp code.
  9779. The file can be loaded to define the same abbrevs.
  9780. Fadd-mode-abbrev
  9781. Define mode-specific abbrev for last word(s) before point.
  9782. Argument is how many words before point form the expansion;
  9783. or zero means the region is the expansion.
  9784. A negative argument means to undefine the specified abbrev.
  9785. Reads the abbreviation in the minibuffer.
  9786.  
  9787. Don't use this function in a Lisp program; use define-abbrev instead.
  9788. Fadd-global-abbrev
  9789. Define global (all modes) abbrev for last word(s) before point.
  9790. Argument is how many words before point form the expansion;
  9791. or zero means the region is the expansion.
  9792. A negative argument means to undefine the specified abbrev.
  9793. Reads the abbreviation in the minibuffer.
  9794.  
  9795. Don't use this function in a Lisp program; use define-abbrev instead.
  9796. Finverse-add-mode-abbrev
  9797. Define last word before point as a mode-specific abbrev.
  9798. With argument N, defines the Nth word before point.
  9799. Reads the expansion in the minibuffer.
  9800. Expands the abbreviation after defining it.
  9801. Finverse-add-global-abbrev
  9802. Define last word before point as a global (mode-independent) abbrev.
  9803. With argument N, defines the Nth word before point.
  9804. Reads the expansion in the minibuffer.
  9805. Expands the abbreviation after defining it.
  9806. Fabbrev-prefix-mark
  9807. Mark current point as the beginning of an abbrev.
  9808. Abbrev to be expanded starts here rather than at
  9809. beginning of word.  This way, you can expand an abbrev
  9810. with a prefix: insert the prefix, use this command,
  9811. then insert the abbrev.
  9812. Fexpand-region-abbrevs
  9813. For abbrev occurrence in the region, offer to expand it.
  9814. The user is asked to type y or n for each occurrence.
  9815. A numeric argument means don't query; expand all abbrevs.
  9816. Calling from a program, arguments are START END &optional NOQUERY.
  9817. VBuffer-menu-mode-map
  9818.  
  9819. FBuffer-menu-mode
  9820. Major mode for editing a list of buffers.
  9821. Each line describes one of the buffers in Emacs.
  9822. Letters do not insert themselves; instead, they are commands.
  9823. m -- mark buffer to be displayed.
  9824. q -- select buffer of line point is on.
  9825.   Also show buffers marked with m in other windows.
  9826. 1 -- select that buffer in full-screen window.
  9827. 2 -- select that buffer in one window,
  9828.   together with buffer selected before this one in another window.
  9829. f -- select that buffer in place of the buffer menu buffer.
  9830. o -- select that buffer in another window,
  9831.   so the buffer menu buffer remains visible in its window.
  9832. t -- visit-tags-table this buffer.
  9833. ~ -- clear modified-flag on that buffer.
  9834. s -- mark that buffer to be saved, and move down.
  9835. d or k -- mark that buffer to be deleted, and move down.
  9836. C-d -- mark that buffer to be deleted, and move up.
  9837. x -- delete or save marked buffers.
  9838. u -- remove all kinds of marks from current line.
  9839. Delete -- back up a line and remove marks.
  9840.  
  9841. Precisely,\{Buffer-menu-mode-map}
  9842. FBuffer-menu-buffer
  9843. Return buffer described by this line of buffer menu.
  9844. Vlist-buffers-identification
  9845. String used to identify this buffer, or a function of one argument
  9846. to generate such a string.  This variable is always buffer-local.
  9847. Flist-buffers
  9848. Display a list of names of existing buffers.
  9849. Inserts it in buffer *Buffer List* and displays that.
  9850. Note that buffers with names starting with spaces are omitted.
  9851. Non-null optional arg FILES-ONLY means mention only file buffers.
  9852.  
  9853. The M column contains a * for buffers that are modified.
  9854. The R column contains a % for buffers that are read-only.
  9855. Fbuffer-menu
  9856. Make a menu of buffers so you can save, delete or select them.
  9857. With argument, show only buffers that are visiting files.
  9858. Type ? after invocation to get help on commands available.
  9859. Type q immediately to make the buffer menu go away.
  9860. FBuffer-menu-mark
  9861. Mark buffer on this line for being displayed by \[Buffer-menu-select] command.
  9862. FBuffer-menu-unmark
  9863. Cancel all requested operations on buffer on this line.
  9864. FBuffer-menu-backup-unmark
  9865. Move up and cancel all requested operations on buffer on line above.
  9866. FBuffer-menu-delete
  9867. Mark buffer on this line to be deleted by \[Buffer-menu-execute] command.
  9868. FBuffer-menu-delete-backwards
  9869. Mark buffer on this line to be deleted by \[Buffer-menu-execute] command
  9870. and then move up one line
  9871. FBuffer-menu-save
  9872. Mark buffer on this line to be saved by \[Buffer-menu-execute] command.
  9873. FBuffer-menu-not-modified
  9874. Mark buffer on this line as unmodified (no changes to save).
  9875. FBuffer-menu-execute
  9876. Save and/or delete buffers marked with \[Buffer-menu-save] or \[Buffer-menu-delete] commands.
  9877. FBuffer-menu-select
  9878. Select this line's buffer; also display buffers marked with ">".
  9879. You can mark buffers with the \[Buffer-menu-mark] command.
  9880. FBuffer-menu-visit-tags-table
  9881. Visit the tags table in the buffer on this line.  See `visit-tags-table'.
  9882. FBuffer-menu-1-window
  9883. Select this line's buffer, alone, in full screen.
  9884. FBuffer-menu-this-window
  9885. Select this line's buffer in this window.
  9886. FBuffer-menu-other-window
  9887. Select this line's buffer in other window, leaving buffer menu visible.
  9888. FBuffer-menu-2-window
  9889. Select this line's buffer, with previous buffer in second window.
  9890. Fproclaim-inline
  9891. Cause the named functions to be open-coded when called from compiled code.
  9892. They will only be compiled open-coded when byte-compile-optimize is true.
  9893. Fproclaim-notinline
  9894. Cause the named functions to no longer be open-coded.
  9895. Fdefsubst
  9896. Same syntax as defun, but the defined function will always be open-coded,
  9897. so long as byte-compile-optimize is true.
  9898. Fmake-obsolete
  9899. Make the byte-compiler warn that FUNCTION is obsolete,
  9900. and NEW should be used instead.  If NEW is a string, then that is the
  9901. `use instead' message.
  9902. Fmake-obsolete-variable
  9903. Make the byte-compiler warn that VARIABLE is obsolete,
  9904. and NEW should be used instead.  If NEW is a string, then that is the
  9905. `use instead' message.
  9906. Fdont-compile
  9907. Like progn, but the body will always run interpreted (not compiled).
  9908. If you think you need this, you're probably making a mistake somewhere.
  9909. Feval-when-compile
  9910. Like progn, but evaluates the body at compile-time.  The result of the
  9911. body appears to the compiler as a quoted constant.
  9912. Feval-and-compile
  9913. Like progn, but evaluates the body at compile-time as well as at load-time.
  9914. Fbyte-compiler-options
  9915. Set some compilation-parameters for this file.  This will affect only the
  9916. file in which it appears; this does nothing when evaluated, and when loaded
  9917. from a .el file.
  9918.  
  9919. Each argument to this macro must be a list of a key and a value.
  9920.  
  9921.   Keys:          Values:        Corresponding variable:
  9922.  
  9923.   verbose      t, nil        byte-compile-verbose
  9924.   optimize      t, nil, source, byte    byte-compile-optimize
  9925.   warnings      list of warnings    byte-compile-warnings
  9926.               Legal elements: (callargs redefine free-vars unresolved)
  9927.   file-format      emacs18, emacs19    byte-compile-emacs18-compatibility
  9928.   new-bytecodes      t, nil        byte-compile-generate-emacs19-bytecodes
  9929.  
  9930. For example, this might appear at the top of a source file:
  9931.  
  9932.     (byte-compiler-options
  9933.       (optimize t)
  9934.       (warnings (- free-vars))        ; Don't warn about free variables
  9935.       (file-format emacs19))
  9936. Fx-make-font-bold
  9937. Given an X font specification, this attempts to make a `bold' version
  9938. of it.  If it fails, it returns nil.
  9939. Fx-make-font-demibold
  9940. Given an X font specification, this attempts to make a `demibold' version
  9941. of it.  If it fails, it returns nil.
  9942. Fx-make-font-unbold
  9943. Given an X font specification, this attempts to make a non-bold version
  9944. of it.  If it fails, it returns nil.
  9945. Fx-make-font-italic
  9946. Given an X font specification, this attempts to make an `italic' version
  9947. of it.  If it fails, it returns nil.
  9948. Fx-make-font-oblique
  9949. Given an X font specification, this attempts to make an `italic' version
  9950. of it.  If it fails, it returns nil.
  9951. Fx-make-font-unitalic
  9952. Given an X font specification, this attempts to make a non-italic version
  9953. of it.  If it fails, it returns nil.
  9954. Fmake-face-bold
  9955. Make the font of the given face be bold, if possible.  
  9956. Returns nil on failure.
  9957. Fmake-face-italic
  9958. Make the font of the given face be italic, if possible.  
  9959. Returns nil on failure.
  9960. Fmake-face-bold-italic
  9961. Make the font of the given face be bold and italic, if possible.  
  9962. Returns nil on failure.
  9963. Fmake-face-unbold
  9964. Make the font of the given face be non-bold, if possible.  
  9965. Returns nil on failure.
  9966. Fmake-face-unitalic
  9967. Make the font of the given face be non-italic, if possible.  
  9968. Returns nil on failure.
  9969. Fx-initialize-other-random-faces
  9970. Initializes the colors and fonts of the bold, italic, bold-italic, 
  9971. primary-selection, secondary-selection, and isearch faces when each
  9972. screen is created.  If you want to add code to do stuff like this, use
  9973. the create-screen-hook.
  9974. Fx-mouse-kill
  9975. Kill the text between the point and mouse and copy it to the clipboard and
  9976. to the cut buffer
  9977. Fx-insert-selection
  9978. Insert the current selection into buffer at point.
  9979. Fx-set-point-and-insert-selection
  9980. Sets point where clicked and insert the primary selection or the cut buffer
  9981. Fmouse-track-and-copy-to-cutbuffer
  9982. Makes a selection like `mouse-track', but also copies it to the cutbuffer.
  9983. Vx-pointer-shape
  9984. *The shape of the mouse-pointer when over text.
  9985.  
  9986. This string may be any of the standard cursor names from appendix B 
  9987. of the Xlib manual (also known as the file <X11/cursorfont.h>) minus 
  9988. the XC_ prefix, or it may be a font name and glyph index of the form 
  9989. "FONT fontname index [[font] index]", or it may be the name of a
  9990. bitmap file acceptable to XmuLocateBitmapFile().  If it is a bitmap
  9991. file, and if a bitmap file whose name is the name of the cursor with
  9992. "msk" exists, then it is used as the mask.  For example, a pair of
  9993. files may be named "cursor.xbm" and "cursor.xbmmsk".
  9994. Vx-nontext-pointer-shape
  9995. *The shape of the mouse-pointer when over a buffer, but not over text.  
  9996. If this is nil, then `x-pointer-shape' is used.
  9997. Vx-mode-pointer-shape
  9998. *The shape of the mouse-pointer when over the modeline.
  9999. If this is nil, then either `x-nontext-pointer-shape' or `x-pointer-shape'
  10000. will be used.
  10001. Vx-pointer-foreground-color
  10002. *The foreground color of the mouse pointer.
  10003. Vx-pointer-background-color
  10004. *The background color of the mouse pointer.
  10005. Fx-initialize-pointer-shape
  10006. Initializes the mouse-pointers of the given screen from the resource
  10007. database.
  10008. Fx-get-selection
  10009. Return text selected from some X window.
  10010. Fx-get-secondary-selection
  10011. Return text selected from some X window.
  10012. Fx-get-clipboard
  10013. Return text pasted to the clipboard.
  10014. Vprimary-selection-extent
  10015. The extent of the primary selection; don't use this.
  10016. Vsecondary-selection-extent
  10017. The extent of the secondary selection; don't use this.
  10018. Fx-own-selection
  10019. Make a primary X Selection of the given argument.  
  10020. The argument may be a string, a cons of two markers or an extent.  In the 
  10021. latter cases the selection is considered to be the text between 
  10022. the markers or the between extents endpoints
  10023. Fx-own-secondary-selection
  10024. Make a secondary X Selection of the given argument.  The argument may be a 
  10025. string or a cons of two markers (in which case the selection is considered to
  10026. be the text between those markers.)
  10027. Fx-own-clipboard
  10028. Paste the given string to the X Clipboard.
  10029. Fx-disown-selection
  10030. Assuming we own the selection, disown it.  With an argument, discard the
  10031. secondary selection instead of the primary selection.
  10032. Fx-dehilight-selection
  10033. for use as a value of x-lost-selection-hooks.
  10034. Fx-notice-selection-requests
  10035. for possible use as the value of x-sent-selection-hooks.
  10036. Fx-notice-selection-failures
  10037. for possible use as the value of x-sent-selection-hooks.
  10038. Fx-get-cutbuffer
  10039. Returns the value of one of the 8 X server cut-buffers.  Optional arg
  10040. WHICH-ONE should be a number from 0 to 7, defaulting to 0.
  10041. Cut buffers are considered obsolete; you should use selections instead.
  10042. Fx-store-cutbuffer
  10043. Store the given string into the X server's primary cut buffer.
  10044. The previous value of the primary cut buffer is rotated to the secondary
  10045. cut buffer, and the second to the third, and so on (there are 8 buffers.)
  10046. Cut buffers are considered obsolete; you should use selections instead.
  10047. Fx-kill-primary-selection
  10048. If there is a selection, delete the text it covers, and copy it to 
  10049. both the kill ring and the Clipboard.
  10050. Fx-delete-primary-selection
  10051. If there is a selection, delete the text it covers *without* copying it to
  10052. the kill ring or the Clipboard.
  10053. Fx-copy-primary-selection
  10054. If there is a selection, copy it to both the kill ring and the Clipboard.
  10055. Fx-yank-clipboard-selection
  10056. If someone owns a Clipboard selection, insert it at point.
  10057. Fxselect-convert-to-class
  10058. XEmacs