Fopen-termscript Start writing all terminal output to FILE as well as the terminal. FILE = nil means just close any termscript file currently open. arguments:(file) Fsend-string-to-terminal Send STRING to the terminal without alteration. Control characters in STRING will have terminal-dependent effects. arguments:(str) Fding Beep, or flash the screen. Also, unless an argument is given, terminate any keyboard macro currently executing. When called from lisp, the second argument is what sound to make. arguments:(&optional arg sound) Vbaud-rate The output baud rate of the terminal. On most systems, changing this value will affect the amount of padding and the other strategic decisions made during redisplay.Vinverse-video *Non-nil means invert the entire screen display. This means everything is in inverse video which otherwise would not be.Vvisible-bell *Non-nil means try to flash the screen to represent a bell.Vno-redraw-on-reenter *Non-nil means no need to redraw entire screen after suspending. A non-nil value is useful if the terminal can automatically preserve Emacs's screen display when you reenter Emacs. It is up to you to set this variable if your terminal can do that.Vwindow-system A symbol naming the window-system under which Emacs is running, such as `x', or nil if emacs is running on an ordinary terminal.Vwindow-system-version The version number of the window system in use. For X windows, this is 10 or 11.Vcursor-in-echo-area Non-nil means put cursor in minibuffer, at end of any message there.Vglyph-table Table defining how to output a glyph code to the screen. If not nil, this is a vector indexed by glyph code to define the glyph. Each element can be: integer: a glyph code which this glyph is an alias for. string: output this glyph using that string (not impl. in X windows). nil: this glyph mod 256 is char code to output, and this glyph / 256 is face code for X windows (see `x-set-face').Vstandard-display-table Display table to use for buffers that specify none. See `buffer-display-table' for more information.Fscreenp Return non-nil if OBJECT is a screen. Value is t for a termcap screen (a character-only terminal), `x' for an Emacs screen that is really an X window. arguments:(screen) Fscreen-live-p Return non-nil if OBJECT is a screen which has not been deleted. Value is nil if OBJECT is not a live screen. If object is a live screen, the return value indicates what sort of output device it is displayed on. Value is t for a termcap screen (a character-only terminal), `x' for an Emacs screen being displayed in an X window. arguments:(object) Fselect-screen Select the screen S. S's selected window becomes the selected window. arguments:(screen) Fselected-screen Return the screen that is now selected. arguments:() Fwindow-screen Return the screen that window WINDOW is on. arguments:(window) Fscreen-root-window Returns the root-window of SCREEN. arguments:(&optional screen) Fscreen-selected-window Return the selected window of screen SCREEN. arguments:(&optional screen) Fscreen-list Return a list of all screens. arguments:() Fset-screen-left-margin-width Set the default left margin width of SCREEN to WIDTH. If SCREEN is nil, set the selected screen margin width. If SCREEN is t set the default value for all screens. arguments:(width &optional screen) Fset-screen-right-margin-width Set the default right margin width of SCREEN to WIDTH. If SCREEN is nil, set the selected screen margin width. If SCREEN is t set the default value for all screens. arguments:(width &optional screen) Fscreen-left-margin-width Return the width in characters of the right outside margin of screen SCREEN. If SCREEN is nil, the selected screen is assumed. arguments:(&optional screen) Fscreen-right-margin-width Return the width in characters of the right outside margin of screen SCREEN. If SCREEN is nil, the selected screen is assumed. arguments:(&optional screen) Fnext-screen Return the next screen in the screen list after SCREEN. If MINISCREEN is non-nil, include the global-minibuffer-screen if it has its own screen. If VISIBLE-ONLY-P is non-nil, then cycle through the visible screens, instead of all screens. arguments:(&optional screen miniscreen visible_only_p) Fprevious-screen Return the previous screen in the screen list after SCREEN. If MINISCREEN is non-nil, include the global-minibuffer-screen if it has its own screen. If VISIBLE-ONLY-P is non-nil, then cycle through the visible screens, instead of all screens. arguments:(&optional screen miniscreen visible_only_p) Fdelete-screen Delete SCREEN, permanently eliminating it from use. Default is current screen. A screen may not be deleted if its minibuffer is used by other screens. arguments:(&optional screen) Fread-mouse-position Return a cons (x . y) which represents the position of the mouse. arguments:(screen) Fset-mouse-position Move the mouse pointer to the center of character cell (X,Y) in SCREEN. arguments:(screen x y) Fscreen-configuration Return object describing current screen configuration. The screen configuration is the current mouse position and selected screen. This object can be given to `restore-screen-configuration' to restore this screen configuration. arguments:() Frestore-screen-configuration Restores screen configuration CONFIGURATION. arguments:(config) Fmake-screen-visible Make the screen SCREEN visible (assuming it is an X-window). Also raises the screen so that nothing obscures it. arguments:(screen) Fmake-screen-invisible Unconditionally removes screen from the display (assuming it is an X-window). If what you want to do is iconify the screen (if the window manager uses icons) then you should call `iconify-screen' instead. arguments:(screen) Ficonify-screen Make the screen SCREEN into an icon, if the window manager supports icons. arguments:(screen) Fdeiconify-screen Open (de-iconify) the iconified screen SCREEN. arguments:(screen) Fscreen-visible-p Return t if SCREEN is now "visible" (actually in use for display). A screen that is not visible is not updated, and, if it works through a window system, may not show at all. arguments:(screen) Fscreen-iconified-p Return t if SCREEN is iconified. Not all window managers use icons; some merely unmap the window, so this function is not the inverse of `screen-visible-p'. It is possible for a screen to not be visible and not be iconified either. However, if the screen is iconified, it will not be visible. arguments:(screen) Fvisible-screen-list Return a list of all screens now "visible" (being updated). arguments:() Fscreen-parameters Return the parameters-alist of screen SCREEN. It is a list of elements of the form (PARM . VALUE), where PARM is a symbol. The meaningful PARMs depend on the kind of screen. arguments:(&optional screen) Fmodify-screen-parameters Modify the parameters of screen SCREEN according to ALIST. ALIST is an alist of parameters to change and their new values. Each element of ALIST has the form (PARM . VALUE), where PARM is a symbol. The meaningful PARMs depend on the kind of screen; undefined PARMs are ignored. arguments:(screen alist) Fscreen-height Return number of lines available for display on SCREEN. arguments:(&optional screen) Fscreen-width Return number of columns available for display on SCREEN. arguments:(&optional screen) Fscreen-pixel-height Returns the height in pixels of SCREEN. arguments:(&optional screen) Fscreen-pixel-width Returns the width in pixels of SCREEN. arguments:(&optional screen) Fscreen-name Returns the name of SCREEN (defaulting to the selected screen). This is not the same as the `title' of the screen. arguments:(&optional screen) Fscreen-totally-visible-p Return T if screen is not obscured by any other X windows, NIL otherwise arguments:(&optional screen) Fset-screen-height Specify that the screen SCREEN has LINES lines. Optional third arg non-nil means that redisplay should use LINES lines but that the idea of the actual height of the screen should not be changed. arguments:(screen rows &optional pretend) Fset-screen-width Specify that the screen SCREEN has COLS columns. Optional third arg non-nil means that redisplay should use COLS columns but that the idea of the actual width of the screen should not be changed. arguments:(screen cols &optional pretend) Fset-screen-size Sets size of SCREEN to COLS by ROWS. Optional fourth arg non-nil means that redisplay should use COLS by ROWS but that the idea of the actual size of the screen should not be changed. arguments:(screen cols rows &optional pretend) Fset-screen-position Sets position of SCREEN in pixels to XOFFSET by YOFFSET. If XOFFSET or YOFFSET are negative, they are interpreted relative to the leftmost or bottommost position SCREEN could occupy without going off the screen. arguments:(screen xoffset yoffset) Fraise-screen Make the window of SCREEN be the uppermost one (fully visible). arguments:(screen) Flower-screen Make the window of SCREEN be the bottommost one. arguments:(screen) Fcoordinates-in-window-p Return non-nil if COORDINATES are in WINDOW. COORDINATES is a cons of the form (X Y), X and Y being screen-relative. If COORDINATES are in the text portion of WINDOW, the coordinates relative to the window are returned. If they are in the modeline of WINDOW, t is returned. arguments:(coordinates window) Flocate-window-from-coordinates Return window on SCREEN containing position COORDINATES. COORDINATES is a list (SCREEN-X SCREEN-Y) of coordinates which are relative to 0,0 at the top left corner of the screen. arguments:(screen coordinates) Fset-screen-scrollbar-width Specify that the scrollbars on SCREEN are WIDTH pixels wide. arguments:(screen width) Fscreen-scrollbar-width Return the width in pixels of the scrollbars of SCREEN. arguments:(&optional screen) Vterminal-screen The initial screen-object, which represents Emacs's stdout.Vglobal-minibuffer-screen A screen-object holding the default minibuffer for minibufferless screens. When you create a minibufferless screen, by default it will use the minibuffer of this screen. It is up to you to create a suitable screen and store it in this variable.Vdelete-screen-hook Function or functions of one argument, called with each to-be-deleted screen.Vcreate-screen-hook Function or functions of one argument, called with each newly-created screen.Vmouse-enter-screen-hook Function or functions to call when mouse enters a screen. One arg, the screen. Be careful not to make assumptions about the window manger's focus model. In most cases, the `deselect-screen-hook' is more appropriate.Vmouse-leave-screen-hook Function or functions to call when mouse leaves screen. One arg, the screen. Be careful not to make assumptions about the window manger's focus model. In most cases, the `select-screen-hook' is more appropriate.Vmap-screen-hook Function or functions to call when screen is mapped. One arg, the screen.Vunmap-screen-hook Function or functions to call when screen is unmapped. One arg, the screen.Vmouse-motion-handler Handler for motion events. One arg, the event. For most applications, you should use `mode-motion-hook' instead of this.Vsynchronize-minibuffers Set to t if all minibuffer windows are to be synchronizedFredraw-screen Clear screen SCREEN and output again what is supposed to appear on it. arguments:(screen) Fredraw-display Redraw all screens marked as having their images garbled. arguments:() Fforce-redisplay Force an immediate redisplay of all screens. Will still cause a redisplay when there is input pending (unlike when the display is updated from `next-event'). This function differs from `redraw-display' in that it causes an immediate, visible update of the display's contents. Unlike `redraw-screen' or `recenter', it does not mark any screen's current contents as invalid. arguments:() Fmessage-displayed-p Return a non-nil value if a message is presently displayed in the minibuffer's echo area. If optional argument RETURN-STRING is non-nil, return a string containing the message, otherwise just return t. arguments:(&optional return_string) Vglobal-mode-string String displayed by mode-line-format's "%m" specification.Voverlay-arrow-position Marker for where to display an arrow on top of the buffer text. This must be the beginning of a line in order to work. See also `overlay-arrow-string'.Voverlay-arrow-string String to display as an arrow. See also `overlay-arrow-position'.Vscroll-step *The number of lines to try scrolling a window by when point moves out. If that fails to bring point back on screen, point is centered instead. If this is zero, point is always centered after it moves off screen.Vtruncate-partial-width-windows *Non-nil means truncate lines in all windows less than full screen wide.Vline-number-mode *Whether to display line numbers in the mode line.Vmode-line-inverse-video *Non-nil means use inverse video for the mode line.Vscreen-title-format Controls the title of the X window corresponding to the selected screen. This is the same format as `mode-line-format'.Vscreen-icon-title-format Controls the title of the icon corresponding to the selected screen. See also the variable `screen-title-format'Fwindowp Returns t if OBJ is a window. arguments:(obj) Fselected-window Return the window that the cursor now appears in and commands apply to. arguments:() Fminibuffer-window Return the window used now for minibuffers. If the optional argument SCREEN is specified, return the minibuffer window used by that screen. arguments:(&optional screen) Fwindow-minibuffer-p Returns non-nil if WINDOW is a minibuffer window. arguments:(window) Fpos-visible-in-window-p Return t if position POS is currently on the screen in WINDOW. Returns nil if that position is scrolled vertically out of view. POS defaults to point; WINDOW, to the selected window. arguments:(&optional pos window) Fwindow-buffer Return the buffer that WINDOW is displaying. arguments:(&optional window) Fwindow-height Return the number of lines in WINDOW (including its mode line). arguments:(&optional window) Fwindow-pixheight Return the height of WINDOW in pixels. Defaults to current window. arguments:(&optional window) Fwindow-width Return the number of columns in WINDOW. arguments:(&optional window) Fwindow-pixwidth Return the width of WINDOW in pixels. Defaults to current window. arguments:(&optional window) Fwindow-hscroll Return the number of columns by which WINDOW is scrolled from left margin. arguments:(&optional window) Fset-window-hscroll Set number of columns WINDOW is scrolled from left margin to NCOL. NCOL should be zero or positive. arguments:(window ncol) Fwindow-edges Return a list of the edge coordinates of WINDOW. (LEFT TOP RIGHT BOTTOM), all relative to 0, 0 at top left corner of screen. RIGHT is one more than the rightmost column used by WINDOW, and BOTTOM is one more than the bottommost row used by WINDOW and its mode-line. arguments:(&optional window) Fwindow-point Return current value of point in WINDOW. For a nonselected window, this is the value point would have if that window were selected. Note that, when WINDOW is the selected window and its buffer is also currently selected, the value returned is the same as (point). It would be more strictly correct to return the `top-level' value of point, outside of any save-excursion forms. But that is hard to define. arguments:(&optional window) Fwindow-start Return position at which display currently starts in WINDOW. arguments:(&optional window) Fwindow-end Return position at which display currently ends in WINDOW. arguments:(&optional window) Fset-window-point Make point value in WINDOW be at position POS in WINDOW's buffer. arguments:(window pos) Fset-window-start Make display in WINDOW start at position POS in WINDOW's buffer. Optional third arg NOFORCE non-nil inhibits next redisplay from overriding motion of point in order to display at this exact start. arguments:(window pos &optional noforce) Fwindow-dedicated-p Return WINDOW's dedicated object, usually t or nil. See also `set-window-buffer-dedicated'. arguments:(window) Fset-window-buffer-dedicated Make WINDOW display BUFFER and be dedicated to that buffer. Then Emacs will not automatically change which buffer appears in WINDOW. If BUFFER is nil, make WINDOW not be dedicated (but don't change which buffer appears in it currently). arguments:(window arg) Fwindow-display-table Return the display-table that WINDOW is using. arguments:(&optional window) Fset-window-display-table Set WINDOW's display-table to TABLE. arguments:(window table) Fdelete-window Remove WINDOW from the display. Default is selected window. If window is the only one on the screen, the screen is destroyed. arguments:(&optional window) Fnext-window Return next window after WINDOW in canonical ordering of windows. Optional second arg MINIBUF t means count the minibuffer window even if not active. If MINIBUF is neither t nor nil it means not to count the minibuffer even if it is active. Optional third arg ALL-SCREENS t means include all windows in all visible screens; otherwise cycle within the selected screen, with the exception that if a global minibuffer screen is in use, all screens are used. Optional fourth argument INVISIBLE-TOO t means also visit invisible screens. arguments:(&optional window mini all_screens invisible_too) Fprevious-window Return previous window before WINDOW in canonical ordering of windows. Optional second arg MINIBUF t means count the minibuffer window even if not active. If MINIBUF is neither t nor nil it means not to count the minibuffer even if it is active. Optional third arg ALL-SCREENS t means include all windows in all visible screens; otherwise cycle within the selected screen, with the exception that if a global minibuffer screen is in use, all visible screens are used. If optional fourth argument INVISIBLE-TOO is t also visit invisible screens. arguments:(&optional window mini all_screens invisible_too) Fnext-vertical-window Return the next window which is vertically after WINDOW. arguments:(&optional window) Fother-window Select the ARG'th different window on this screen. All windows on current screen are arranged in a cyclic order. This command selects the window ARG steps away in that order. A negative ARG moves in the opposite order. If the optional second argument ALL-SCREENS is non-nil, cycle through all visible screens. If optional third argument INVISIBLE-TOO is t also search invisible screens. arguments:(n &optional all_screens invisible_too) Fget-lru-window Return the window least recently selected or used for display. If optional argument SCREEN is non-nil, search only that screen. arguments:(&optional screen) Fget-largest-window Return the window largest in area. If optional argument SCREEN is non-nil, search only that screen. arguments:(&optional screen) Fget-buffer-window Return a window currently displaying BUFFER, or nil if none. If optional argument SCREEN is t, search all visible screens. If SCREEN is a screen, search only that screen. If INVISIBLE-TOO is t invisible screens are searched too. arguments:(buffer &optional screen invisible_too) Fbuffer-left-margin-pixwidth Return the width in pixels of the left outside margin of buffer BUFFER. If BUFFER is nil, the current buffer is assumed. arguments:(&optional buffer) Fbuffer-right-margin-pixwidth Return the width in pixels of the right outside margin of buffer BUFFER. If BUFFER is nil, the current buffer is assumed. arguments:(&optional buffer) Fdelete-other-windows Make WINDOW (or the selected window) fill its screen. Only the screen WINDOW is on is affected. arguments:(&optional window) Fdelete-windows-on Delete all windows showing BUFFER. arguments:(buffer) Freplace-buffer-in-windows Replace BUFFER with some other buffer in all windows showing it. arguments:(buffer) Fset-window-buffer Make WINDOW display BUFFER as its contents. BUFFER can be a buffer or buffer name. arguments:(window buffer) Fselect-window Select WINDOW. Most editing will apply to WINDOW's buffer. The main editor command loop selects the buffer of the selected window before each command. arguments:(window) Fdisplay-buffer Make BUFFER appear in some window on the current screen, but don't select it. Arguments are BUFFER &optional NOT-THIS-WINDOW-P, OVERRIDE-SCREEN. BUFFER can be a buffer or a buffer name. If BUFFER is shown already in some window in the current screen, just uses that one, unless the window is the selected window and NOT-THIS-WINDOW-P is non-nil. If BUFFER has a dedicated screen, display on that screen instead of the current screen, unless OVERRIDE-SCREEN is non-nil. If OVERRIDE-SCREEN is non-nil, display on that screen instead of the current screen (or the dedicated screen). If `pop-up-windows' is non-nil, always use the current screen and create a new window regardless of whether the buffer has a dedicated screen, and regardless of whether OVERRIDE-SCREEN was specified. Returns the window displaying BUFFER. arguments:(buffer &optional not_this_window_p override_screen) Fsplit-window Split WINDOW, putting SIZE lines in the first of the pair. WINDOW defaults to selected one and SIZE to half its size. If optional third arg HOR-FLAG is non-nil, split side by side and put SIZE columns in the first of the pair. arguments:(&optional window chsize horflag) Fenlarge-window Make current window ARG lines bigger. From program, optional second arg non-nil means grow sideways ARG columns. arguments:(n &optional side) Fshrink-window Make current window ARG lines smaller. From program, optional second arg non-nil means shrink sideways ARG columns. arguments:(n &optional side) Fscroll-up Scroll text of current window upward ARG lines; or near full screen if no ARG. A near full screen is `next-screen-context-lines' less than a full screen. When calling from a program, supply a number as argument or nil. arguments:(&optional n) Fscroll-down Scroll text of current window downward ARG lines; or near full screen if no ARG. A near full screen is `next-screen-context-lines' less than a full screen. When calling from a program, supply a number as argument or nil. arguments:(&optional n) Fscroll-other-window Scroll next window upward ARG lines; or near full screen if no ARG. The next window is the one below the current one; or the one at the top if the current one is at the bottom. When calling from a program, supply a number as argument or nil. If in the minibuffer, `minibuf-scroll-window' if non-nil specifies the window to scroll. If `other-window-scroll-buffer' is non-nil, scroll the window showing that buffer, popping the buffer up if necessary. arguments:(&optional n) Fscroll-left Scroll selected window display ARG columns left. Default for ARG is window width minus 2. arguments:(arg) Fscroll-right Scroll selected window display ARG columns right. Default for ARG is window width minus 2. arguments:(arg) Frecenter Center point in window and redisplay screen. With ARG, put point on line ARG. The desired position of point is always relative to the current window. Just C-u as prefix means put point in the center of the window. No arg (i.e., it is nil) erases the entire screen and then redraws with point in the center of the current window. arguments:(&optional n) Fmove-to-window-line Position point relative to window. With no argument, position text at center of window. An argument specifies screen line; zero means top of window, negative means relative to bottom of window. arguments:(arg) Fwindow-configuration-p T if OBJECT is a window-configration object. arguments:(obj) Fset-window-configuration Set the configuration of windows and buffers as specified by CONFIGURATION. CONFIGURATION must be a value previously returned by `current-window-configuration' (which see). arguments:(configuration) Fcurrent-window-configuration Return an object representing the current window configuration of SCREEN. If SCREEN is nil or omitted, use the selected screen. This describes the number of windows, their sizes and current buffers, and for each displayed buffer, where display starts, and the positions of point and mark. An exception is made for point in the current buffer: its value is -not- saved. arguments:(&optional screen) Fsave-window-excursion Execute body, preserving window sizes and contents. Restores which buffer appears in which window, where display starts, as well as the current buffer. Does not restore the value of point in current buffer. arguments: (&rest args) Vtemp-buffer-show-function Non-nil means call as function to display a help buffer. Used by `with-output-to-temp-buffer'.Vdisplay-buffer-function If non-nil, function to call to handle `display-buffer'. It will receive three args: the same as those to `display-buffer'.Vpre-display-buffer-function If non-nil, function that will be called from `display-buffer' as the first action. It will receive three args: the same as those to `display-buffer'. This function may be used to select an appropriate screen for the buffer, for example. See also the variable `display-buffer-function', which may be used to completely replace the `display-buffer' function.Vminibuffer-scroll-window Non-nil means it is the window that C-M-v in minibuffer should scroll.Vother-window-scroll-buffer If non-nil, this is a buffer and \[scroll-other-window] should scroll its window.Vpop-up-windows *Non-nil means display-buffer should make new windows.Vnext-screen-context-lines *Number of lines of continuity when scrolling by screenfuls.Vsplit-height-threshold *display-buffer would prefer to split the largest window if this large. If there is only one window, it is split regardless of this value.Vwindow-min-height *Delete any window less than this tall (including its mode line).Vwindow-min-width *Delete any window less than this wide.Fevent-to-character Returns the closest ASCII approximation to the given event object. If the event isn't a keypress, this returns nil. If the ALLOW-EXTRA-MODIFIERS argument is non-nil, then this is lenient in its translation; it will ignore modifier keys other than control and meta, and will ignore the shift modifier on those characters which have no shifted ASCII equivalent (Control-Shift-A for example, will be mapped to the same ASCII code as Control-A.) If the ALLOW-META argument is non-nil, then the Meta modifier will be represented by turning on the high bit of the byte returned; otherwise, nil will be returned for events containing the Meta modifier. If the ALLOW-NON-ASCII argument is non-nil, then characters which are present in the prevailing character set (see the `character-set-property' variable) will be returned as their code in that character set, instead of the return value being restricted to ASCII. Note that specifying both ALLOW-META and ALLOW-NON-ASCII is ambiguous, as both use the high bit; `M-x' and `oslash' will be indistinguishable. arguments:(event &optional allow_extra_modifiers allow_meta allow_non_ascii) Fcharacter-to-event Converts a numeric ASCII value to an event structure, replete with bucky bits. The character is the first argument, and the event to fill in is the second. This function contains knowledge about what the codes ``mean'' -- for example, the number 9 is converted to the character ``Tab'', not the distinct character ``Control-I''. If the optional second argument is an event, it is modified; otherwise, a new event object is created. Beware that character-to-event and event-to-character are not strictly inverse functions, since events contain much more information than the ASCII character set can encode. arguments:(ch &optional event) Feventp True if the argument is an event object. arguments:(obj) Fkey-press-event-p True if the argument is a key-press event object. arguments:(obj) Fbutton-press-event-p True if the argument is a mouse-button-press event object. arguments:(obj) Fbutton-release-event-p True if the argument is a mouse-button-release event object. arguments:(obj) Fbutton-event-p True if the argument is a button-press or button-release event object. arguments:(obj) Fmotion-event-p True if the argument is a mouse-motion event object. arguments:(obj) Fprocess-event-p True if the argument is a process-output event object. arguments:(obj) Ftimeout-event-p True if the argument is a timeout event object. arguments:(obj) Fmenu-event-p True if the argument is a menu event object. arguments:(obj) Feval-event-p True if the argument is an `eval' or `menu' event object. arguments:(obj) Fevent-timestamp Returns the timestamp of the given event object. arguments:(event) Fevent-key Returns the KeySym of the given key-press event. This will be the ASCII code of a printing character, or a symbol. arguments:(event) Fevent-button Returns the button-number of the given mouse-button-press event. arguments:(event) Fevent-modifier-bits Returns a number representing the modifier keys which were down when the given mouse or keyboard event was produced. See also the function event-modifiers. arguments:(event) Fevent-modifiers Returns a list of symbols, the names of the modifier keys which were down when the given mouse or keyboard event was produced. See also the function event-modifier-bits. arguments:(event) Fevent-x-pixel Returns the X position of the given mouse-motion, button-press, or button-release event in pixels. arguments:(event) Fevent-y-pixel Returns the Y position of the given mouse-motion, button-press, or button-release event in pixels. arguments:(event) Fevent-screen Given a mouse motion, button press, or button release event, return the screen on which that event occurred. This will be nil for non-mouse events. arguments:(event) Fevent-window Given a mouse motion, button press, or button release event, compute and return the window on which that event occurred. This may be nil if the event did not occur in an emacs window (in the border or modeline.) arguments:(event) Fevent-point Returns the character position of the given mouse-motion, button-press, or button-release event. If the event did not occur over a window, or did not occur over text, then this returns nil. Otherwise, it returns an index into the buffer visible in the event's window. arguments:(event) Fevent-x Returns the X position of the given mouse-motion, button-press, or button-release event in characters. arguments:(event) Fevent-y Returns the Y position of the given mouse-motion, button-press, or button-release event in characters. arguments:(event) Fevent-glyph If the given mouse-motion, button-press, or button-release event happened on top of a glyph, this returns it; else nil. arguments:(event) Fevent-process Returns the process of the given process-output event. arguments:(event) Fevent-function Returns the callback function of the given timeout, menu, or eval event. arguments:(event) Fevent-object Returns the callback function argument of the given timeout, menu, or eval event. arguments:(event) Vcharacter-set-property A symbol used to look up the 8-bit character of a keysym. To convert a keysym symbol to an 8-bit code, as when that key is bound to self-insert-command, we will look up the property that this variable names on the property list of the keysym-symbol. The window- system-specific code will set up appropriate properties and set this variable.Fallocate-event Returns an empty event structure. WARNING, the event object returned may be a reused one; see the function `deallocate-event'. arguments:() Fdeallocate-event Allow the given event structure to be reused. You MUST NOT use this event object after calling this function with it. You will lose. It is not necessary to call this function, as event objects are garbage- collected like all other objects; however, it may be more efficient to explicitly deallocate events when you are sure that that is safe. arguments:(event) Fcopy-event Make a copy of the given event object. If a second argument is given, the first event is copied into the second and the second is returned. If the second argument is not supplied (or is nil) then a new event will be made as with `allocate-event.' See also the function `deallocate-event'. arguments:(event1 &optional event2) Finput-pending-p T if command input is currently available with no waiting. Actually, the value is nil only if we can be sure that no input is available. arguments:() Fenqueue-eval-event Add an eval event to the back of the queue. The eval-event will be the next event read after all pending events. arguments:(function object) Fnext-event Returns the next available event from the window system or terminal driver. Pass this object to `dispatch-event' to handle it. See also the function `next-command-event', which is often more appropriate. If an event object is supplied, it is filled in and returned, otherwise a new event object will be created. arguments:(&optional event prompt) Fnext-command-event Returns the next available "user" event from the window system or terminal driver. Pass this object to dispatch-event to handle it. If an event object is supplied, it is filled in and returned, otherwise a new event object will be created. The event returned will be a keyboard, mouse press, or mouse release event. If there are non-command events available (mouse motion, sub-process output, etc) then these will be executed (with `dispatch-event') and discarded. This function is provided as a convenience; it is equivalent to the lisp code (while (progn (next-event event) (not (or (key-press-event-p event) (button-press-event-p event) (button-release-event-p event) (menu-event-p event)))) (dispatch-event event)) arguments:(&optional event) Fdiscard-input Discard the contents of the terminal input buffer. Also cancel any kbd macro being defined. arguments:() Faccept-process-output Allow any pending output from subprocesses to be read by Emacs. It is read into the process' buffers or given to their filter functions. Non-nil arg PROCESS means do not return until some output has been received from PROCESS. If the second arg is non-nil, it is the maximum number of seconds to wait: this function will return after that much time even if no input has arrived from PROCESS. This argument may be a float, meaning wait some fractional part of a second. If the third arg is non-nil, it is a number of microseconds that is added to the first arg. (This exists only for compatibility.) Return non-nil ifn we received any output before the timeout expired. arguments:(&optional process timeout_secs timeout_msecs) Fsleep-for Pause, without updating display, for ARG seconds. ARG may be a float, meaning pause for some fractional part of a second. arguments:(seconds) Fsit-for Perform redisplay, then wait for ARG seconds or until user input is available. ARG may be a float, meaning a fractional part of a second. Optional second arg non-nil means don't redisplay, just wait for input. Redisplay is preempted as always if user input arrives, and does not happen if input is available before it starts. Value is t if waited the full time with no input arriving. arguments:(seconds &optional nodisplay) Fadd-timeout SECS is a number of seconds, expressed as an integer or a float. FUNCTION will be called after that many seconds have elapsed, with one argument, the given OBJECT. If the optional RESIGNAL argument is provided, then after this timeout expires, `add-timeout' will automatically be called again with RESIGNAL as the first argument. This function returns an object which is the `id' of this particular timeout. You can pass that object to `disable-timeout' to turn off the timeout before it has been signalled. The number of seconds may be expressed as a floating-point number, in which case some fractional part of a second will be used. Caveat: the usable timeout granularity will vary from system to system. Adding a timeout causes a timeout event to be returned by `next-event', and the function will be invoked by `dispatch-event,' so if emacs is in a tight loop, the function will not be invoked until the next call to sit-for or until the return to top-level (the same is true of process filters.) WARNING: if you are thinking of calling add-timeout from inside of a callback function as a way of resignalling a timeout, think again. There is a race condition. That's why the RESIGNAL argument exists. arguments:(secs function object &optional resignal) Fdisable-timeout Given a timeout id number as returned by `add-timeout', this function will cause that timeout to not be signalled if it hasn't been already. arguments:(id) Frecent-keys Return vector of last 100 or so keyboard or mouse button events read. This copies the event objects into a new vector; it is safe to keep and modify them. arguments:() Fdispatch-event Given an event object returned by next-event, execute it. arguments:(event) Fread-key-sequence Read a sequence of keystrokes or mouse clicks and return a vector of the event objects read. The vector and the event objects it contains are freshly created (and will not be side-effected by subsequent calls to this function.) The sequence read is sufficient to specify a non-prefix command starting from the current local and global keymaps. A C-g typed while in this function is treated like any other character, and `quit-flag' is not set. First arg PROMPT is a prompt string. If nil, do not prompt specially. If the user selects a menu item while we are prompting for a key-sequence, the returned value will be a vector of a single menu-selection event. An error will be signalled if you pass this value to `lookup-key' or a related function. arguments:(prompt) Fthis-command-keys Returns a vector of the keyboard or mouse button events that were used to invoke this command. This copies the vector and the events; it is safe to keep and modify them. arguments:() Vecho-keystrokes *Nonzero means echo unfinished commands after this many seconds of pause.Vauto-save-interval *Number of keyboard input characters between auto-saves. Zero means disable autosaving due to number of characters typed. See also the variable `auto-save-timeout'.Vpre-command-hook Function or functions to run before every command. This may examine the `this-command' variable to find out what command is about to be run, or may change it to cause a different command to run. Function on this hook must be careful to avoid signalling errors!Vpost-command-hook Function or functions to run after every command. This may examine the `this-command' variable to find out what command was just executed.Vepoch-event-handler If this variable is not nil, then it is assumed to have a function in it. When an epoch event is received for a screen, this function is called.Vepoch-event Bound to the value of the current event when epoch-event-handler is called.Fx-create-screen Make a new X window, which is considered a "screen" in Emacs terms. Return an Emacs screen object representing the X window. ALIST is an alist of screen parameters. The value of `x-screen-defaults' is an additional alist of default parameters which apply when not overridden by ALIST. Optional second argument is the numerical ID of the X window to use for this screen (in order to run Emacs on a window created by some other program). Since this ID number is an unsigned long, you must pass it as a string. It may be a string of decimal numbers, or a string of hex numbers beginning with "0x". arguments:(parms &optional lisp_window_id) Fx-display-visual-class Returns the visual class of the display `screen' is on. The returned value will be one of the symbols StaticGray, GrayScale, StaticColor, PseudoColor, TrueColor, or DirectColor. arguments:(&optional screen) Fx-display-pixel-width Returns the width in pixels of the display `screen' is on. arguments:(&optional screen) Fx-display-pixel-height Returns the height in pixels of the display `screen' is on. arguments:(&optional screen) Fx-display-planes Returns the number of bitplanes of the display `screen' is on. arguments:(&optional screen) Fx-display-color-cells Returns the number of color cells of the display `screen' is on. arguments:(&optional screen) Fx-server-vendor Returns the vendor ID string of the X server `screen' is on. arguments:(&optional screen) Fx-server-version Returns the version numbers of the X server `screen' is on. The returned value is a list of three integers: the major and minor version numbers of the X Protocol in use, and the vendor-specific release number. See also `x-server-vendor'. arguments:(&optional screen) Fx-set-screen-icon-pixmap Set the icon of the given screen to the given pixmap, which should be an object returned by `make-pixmap', or nil. If the given pixmap has a mask, that will be used as the icon mask; however, not all window managers support this. The window manager is also not required to support color pixmaps, only bitmaps (one plane deep.) If the second argument is a pixmap without a mask, then the optional third argument may be the pixmap to use as the mask (it must be one plane deep.) arguments:(screen pixmap &optional mask) Fx-grab-pointer Grab the pointer and restrict it to its current window. If optional CURSOR argument is non-nil, change the pointer shape to that until `x-ungrab-pointer' is called (it should be an object returned by the `make-cursor' function.) If the second optional argument MOUSE-ONLY is non-nil, ignore all keyboard events during the grab. Returns t if the grab is successful, nil otherwise. arguments:(&optional cursor ignore_keyboard) Fx-ungrab-pointer Release a pointer grab made with `x-grab-pointer.' arguments:() Fx-grab-keyboard Grab the keyboard on the given screen (defaulting to the selected one). So long as the keyboard is grabbed, all keyboard events will be delivered to emacs - it is not possible for other X clients to evesdrop on them. Ungrab the keyboard with `x-ungrab-keyboard' (use unwind-protect.) Returns t if the grab was successful; nil otherwise. arguments:(&optional screen) Fx-ungrab-keyboard Release a keyboard grab made with `x-grab-keyboard.' arguments:(&optional screen) Fx-EnterNotify-internal hands off arguments:(screen) Fx-LeaveNotify-internal hands off arguments:(screen) Fx-FocusIn-internal hands off arguments:(screen) Fx-FocusOut-internal hands off arguments:(screen) Fx-VisibilityNotify-internal hands off arguments:(screen) Fx-non-VisibilityNotify-internal hands off arguments:(screen) Fx-MapNotify-internal hands off arguments:(screen) Fx-UnmapNotify-internal hands off arguments:(screen) Fx-get-resource Retrieve an X resource from the resource manager. The first arg is the name of the resource to retrieve, such as "font". The second arg is the class of the resource to retrieve, like "Font". The third arg should be one of the symbols string, integer, or boolean, specifying the type of object that the database is searched for. The fourth arg is the screen to search for the resources on, defaulting to the selected screen. The resource names passed to this function are looked up relative to the screen widget, so the call (x-get-resource "font" "Font" 'string) is an interface to a C call something like XrmGetResource (db, "lemacs.shell.pane.this_screen_name.font", "Emacs.EmacsShell.EmacsManager.EmacsScreen.Font", "String"); Therefore if you want to retrieve a deeper resource, for example, "Emacs.foo.foreground", you need to specify the same number of links in the class path: (x-get-resource "foo.foreground" "Thing.Foreground" 'string) which is equivalent to something like XrmGetResource (db, "lemacs.shell.pane.this_screen_name.foo.foreground", "Emacs.EmacsShell.EmacsManager.EmacsScreen.Thing.Foreground", "String"); The returned value of this function is nil if the queried resource is not found. If the third arg is `string', a string is returned, and if it is `integer', an integer is returned. If the third arg is `boolean', then the returned value is the list (t) for true, (nil) for false, and is nil to mean ``unspecified.'' arguments:(name class type &optional screen) Fx-valid-color-name-p Returns true if COLOR names a color that X knows about. Valid color names are listed in the file /usr/lib/X11/rgb.txt, or whatever the equivalent is on your system. arguments:(color &optional screen) Fx-valid-keysym-name-p Returns true if KEYSYM names a keysym that the X library knows about. Valid keysyms are listed in the files /usr/include/X11/keysymdef.h and in /usr/lib/X11/XKeysymDB, or whatever the equivalents are on your system. arguments:(keysym) Fx-set-screen-pointer Set the mouse cursor of SCREEN to the given cursor, which should be an object returned by `make-cursor'. arguments:(screen cursor) Fx-set-scrollbar-pointer Set the mouse cursor of the scrollbars on SCREEN to the given cursor, which should be an object returned by `make-cursor'. arguments:(screen cursor) Fx-open-connection Open a connection to an X server. Argument ARGV is a list of strings describing the command line options. Returns a copy of ARGV from which the arguments used by the Xt code to open the connection have been removed. arguments:(argv_list) Fx-window-id Get the ID of the X11 window. This gives us a chance to manipulate the Emacs window from within a different program. Since the id is an unsigned long, we return it as a string. arguments:(screen) Fx-close-current-connection Close the connection to the current X server. arguments:() Fx-debug-mode With a true arg, make the connection to the X server synchronous. With false, make it asynchronous. Synchronous connections are much slower, but are useful for debugging (if you get X errors, make the connection synchronous, and use a debugger to set a breakpoint on `x_error_handler'. Your backtrace of the C stack will now be useful. In asynchronous mode, the stack above `x_error_handler' isn't helpful because of buffering.) Calling this function is the same as calling the C function `XSynchronize', or starting the program with the `-sync' command line argument. arguments:(arg) Vx-gc-pointer-shape The shape of the mouse-pointer during garbage collection. If this is nil, then the cursor will not be changed, and echo-area messages will be used instead.Vx-scrollbar-pointer-shape The shape of the mouse pointer when over a scrollbar.Vbar-cursor Use vertical bar cursor if non-nil. If t width is 1 pixel, otherwise 2.Vx-screen-defaults Alist of default screen-creation parameters for X screens. These override what is specified in the resource database, but are overridden by the arguments to the particular call to `x-create-screen'. See also `default-screen-alist', which specifies parameters which apply to all screens, not just X screens.Vdefault-screen-name The default name to assign to newly-created screens. This can be overridden by arguments to `x-create-screen'. This must be a string.Vx-emacs-application-class The X application class of the Emacs process. This controls, among other things, the name of the `app-defaults' file that emacs will use. For changes to this variable to take effect, they must be made before the connection to the X server is initialized, that is, this variable may only be changed before emacs is dumped, or by setting it in the file lisp/term/x-win.el.Vx-allow-sendevents *Non-nil means to allow synthetic events. Nil means they are ignored. Beware: allowing emacs to process SendEvents opens a big security hole.Fx-selection-reply-timeout-internal arguments:(arg) Fx-own-selection-internal Assert an X selection of the given TYPE with the given VALUE. TYPE is a symbol, typically PRIMARY, SECONDARY, or CLIPBOARD. VALUE is typically a string, or a cons of two markers, but may be anything that the functions on selection-converter-alist know about. arguments:(selection_name selection_value) Fx-get-selection-internal Return text selected from some X window. SELECTION is a symbol, typically PRIMARY, SECONDARY, or CLIPBOARD. TYPE is the type of data desired, typically STRING. arguments:(selection_symbol target_type) Fx-disown-selection-internal If we own the named selection, then disown it (make there be no selection). arguments:(selection &optional time) Fx-selection-owner-p Whether the current emacs process owns the given X Selection. The arg should be the name of the selection in question, typically one of the symbols PRIMARY, SECONDARY, or CLIPBOARD. (For convenience, the symbol nil is the same as PRIMARY, and t is the same as SECONDARY.) arguments:(&optional selection) Fx-selection-exists-p Whether there is an owner for the given X Selection. The arg should be the name of the selection in question, typically one of the symbols PRIMARY, SECONDARY, or CLIPBOARD. (For convenience, the symbol nil is the same as PRIMARY, and t is the same as SECONDARY.) arguments:(&optional selection) Fx-get-cutbuffer-internal Returns the value of the named cutbuffer (typically CUT_BUFFER0). arguments:(buffer) Fx-store-cutbuffer-internal Sets the value of the named cutbuffer (typically CUT_BUFFER0). arguments:(buffer string) Fx-rotate-cutbuffers-internal Rotate the values of the cutbuffers by the given number of steps; positive means move values forward, negative means backward. arguments:(n) Vselection-converter-alist An alist associating selection-types (such as STRING and TIMESTAMP) with functions. These functions will be called with three args: the name of the selection (typically PRIMARY, SECONDARY, or CLIPBOARD); a desired type to which the selection should be converted; and the local selection value (whatever had been passed to `x-own-selection'). These functions should return the value to send to the X server (typically a string). A return value of nil means that the conversion could not be done. A return value which is the symbol NULL means that a side-effect was executed, and there is no meaningful return value.Vx-lost-selection-hooks A function or functions to be called after the X server has notified us that we have lost the selection. The function(s) will be called with one argument, a symbol naming the selection (typically PRIMARY, SECONDARY, or CLIPBOARD.)Vx-sent-selection-hooks A function or functions to be called after we have responded to some other client's request for the value of a selection that we own. The function(s) will be called with four arguments: - the name of the selection (typically PRIMARY, SECONDARY, or CLIPBOARD); - the name of the selection-type which we were requested to convert the selection into before sending (for example, STRING or LENGTH); - and whether we successfully transmitted the selection. We might have failed (and declined the request) for any number of reasons, including being asked for a selection that we no longer own, or being asked to convert into a type that we don't know about or that is inappropriate. This hook doesn't let you change the behavior of emacs's selection replies, it merely informs you that they have happened.Vx-selection-timeout If the selection owner doesn't reply in this many seconds, we give up. A value of 0 means wait as long as necessary. This is initialized from the "*selectionTimeout" resource (which is expressed in milliseconds).Fset-menubar-dirty-flag Tells emacs that the menubar widget has to be updated arguments:() Fpopup-menu Pop up the given menu. A menu description is a list of menu items, strings, and submenus. The first element of a menu must be a string, which is the name of the menu. This is the string that will be displayed in the parent menu, if any. For toplevel menus, it is ignored. This string is not displayed in the menu itself. If an element of a menu is a string, then that string will be presented in the menu as unselectable text. If an element of a menu is a string consisting solely of hyphens, then that item will be presented as a solid horizontal line. If an element of a menu is a list, it is treated as a submenu. The name of that submenu (the first element in the list) will be used as the name of the item representing this menu on the parent. Otherwise, the element must be a vector, which describes a menu item. A menu item can have any of the following forms: [ "name" callback ] [ "name" callback "suffix" ] [ "name" callback : : ... ] The name is the string to display on the menu; it is filtered through the resource database, so it is possible for resources to override what string is actually displayed. If the `callback' of a menu item is a symbol, then it must name a command. It will be invoked with `call-interactively'. If it is a list, then it is evaluated with `eval'. The possible keywords are this: :active
Same as in the first two forms: the expression is evaluated just before the menu is displayed, and the menu will be selectable only if the result is non-nil. :suffix "string" Same as "suffix" in the second form: the suffix is appended to the displayed name, providing a convenient way of adding the name of a command's ``argument'' to the menu, like ``Kill Buffer NAME''. :keys "string" Normally, the keyboard equivalents of commands in menus are displayed when the `callback' is a symbol. This can be used to specify keys for more complex menu items. It is passed through `substitute-command-keys' first. :style