emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] Changes to emacs/lispref/frames.texi


From: Richard M. Stallman
Subject: [Emacs-diffs] Changes to emacs/lispref/frames.texi
Date: Tue, 05 Aug 2003 21:32:23 -0400

Index: emacs/lispref/frames.texi
diff -c emacs/lispref/frames.texi:1.65 emacs/lispref/frames.texi:1.66
*** emacs/lispref/frames.texi:1.65      Tue Feb  4 09:47:53 2003
--- emacs/lispref/frames.texi   Tue Aug  5 21:32:23 2003
***************
*** 225,230 ****
--- 225,237 ----
  doesn't change.
  @end defun
  
+ @defun modify-all-frames-parameters alist
+ This function alters the frame parameters of all existing frames
+ according to @var{alist}, then modifies @code{default-frame-alist}
+ to apply the same parameter values to frames that will be created
+ henceforth.
+ @end defun
+ 
  @node Initial Parameters
  @subsection Initial Frame Parameters
  
***************
*** 423,435 ****
  A list of buffers that have been selected in this frame,
  ordered most-recently-selected first.
  
- @item font
- The name of the font for displaying text in the frame.  This is a
- string, either a valid font name for your system or the name of an Emacs
- fontset (@pxref{Fontsets}).  Changing this frame parameter on a frame
- also changes the font-related attributes of the default face on that
- frame.
- 
  @item auto-raise
  Whether selecting the frame raises it (address@hidden means yes).
  
--- 430,435 ----
***************
*** 447,453 ****
  implemented.)
  
  @item scroll-bar-width
! The width of the vertical scroll bar, in pixels.
  
  @item icon-type
  The type of icon to use for this frame when it is iconified.  If the
--- 447,454 ----
  implemented.)
  
  @item scroll-bar-width
! The width of the vertical scroll bar, in pixels,
! or @code{nil} meaning to use the default width.
  
  @item icon-type
  The type of icon to use for this frame when it is iconified.  If the
***************
*** 459,491 ****
  The name to use in the icon for this frame, when and if the icon
  appears.  If this is @code{nil}, the frame's title is used.
  
- @item foreground-color
- The color to use for the image of a character.  This is a string; the
- window system defines the meaningful color names.  Changing this
- parameter is equivalent to changing the foreground color of the face
- @code{default} on the frame in question.
- 
- @item background-color
- The color to use for the background of characters.  Changing this
- parameter is equivalent to changing the foreground color of the face
- @code{default} on the frame in question.
- 
  @item background-mode
  This parameter is either @code{dark} or @code{light}, according
  to whether the background color is a light one or a dark one.
  
- @item mouse-color
- The color for the mouse pointer.  Changing this parameter is equivalent
- to changing the background color of face @code{mouse}.
- 
- @item cursor-color
- The color for the cursor that shows point.  Changing this parameter is
- equivalent to changing the background color of face @code{cursor}.
- 
- @item border-color
- The color for the border of the frame.  Changing this parameter is
- equivalent to changing the background color of face @code{border}.
- 
  @item tty-color-mode
  @cindex standard colors for character terminals
  This parameter overrides the terminal's color support as given by the
--- 460,469 ----
***************
*** 500,515 ****
  @code{tty-color-mode-alist}, and if found, the associated number is
  used as the color support mode.
  
- @item scroll-bar-foreground
- If address@hidden, the color for the foreground of scroll bars.
- Changing this parameter is equivalent to setting the foreground color of
- face @code{scroll-bar}.
- 
- @item scroll-bar-background
- If address@hidden, the color for the background of scroll bars.
- Changing this parameter is equivalent to setting the background color of
- face @code{scroll-bar}.
- 
  @item display-type
  This parameter describes the range of possible colors that can be used
  in this frame.  Its value is @code{color}, @code{grayscale} or
--- 478,483 ----
***************
*** 547,552 ****
--- 515,536 ----
  @item internal-border-width
  The distance in pixels between text and border.
  
+ @item left-fringe
+ @itemx right-fringe
+ The default width of the left and right fringes of windows in this
+ frame (@pxref{Fringes}).  If either of these is zero, that effectively
+ removes the corresponding fringe.  A value of @code{nil} stands for
+ the standard fringe width, which is the width needed to display the
+ fringe bitmaps.
+ 
+ The combined fringe widths must add up to an integral number of
+ columns, so the actual default fringe widths for the frame may be
+ larger than the specified values.  The extra width needed to reach an
+ acceptable total is distributed evenly between the left and right
+ fringe.  However, you can force one frame or the other to a precise
+ width by specifying that width a negative integer.  If both widths are
+ negative, only the left fringe gets the specified width.
+ 
  @item unsplittable
  If address@hidden, this frame's window is never split automatically.
  
***************
*** 611,616 ****
--- 595,641 ----
  is examined only when you specify a cursor type for a frame.
  @end defvar
  
+ These frame parameters are semi-obsolete in that they are automatically
+ equivalent to particular face attributes of particular faces.
+ 
+ @table @code
+ @item font
+ The name of the font for displaying text in the frame.  This is a
+ string, either a valid font name for your system or the name of an Emacs
+ fontset (@pxref{Fontsets}).  It is equivalent to the @code{font}
+ attribute of the @code{default} face.
+ 
+ @item foreground-color
+ The color to use for the image of a character.  It is equivalent to
+ the @code{:foreground} attribute of the @code{default} face.
+ 
+ @item background-color
+ The color to use for the background of characters.  It is equivalent to
+ the @code{:background} attribute of the @code{default} face.
+ 
+ @item mouse-color
+ The color for the mouse pointer.  It is equivalent to the @code{:background}
+ attribute of the @code{mouse} face.
+ 
+ @item cursor-color
+ The color for the cursor that shows point.  It is equivalent to the
+ @code{:background} attribute of the @code{cursor} face.
+ 
+ @item border-color
+ The color for the border of the frame.  It is equivalent to the
+ @code{:background} attribute of the @code{border} face.
+ 
+ @item scroll-bar-foreground
+ If address@hidden, the color for the foreground of scroll bars.  It is
+ equivalent to the @code{:foreground} attribute of the
+ @code{scroll-bar} face.
+ 
+ @item scroll-bar-background
+ If address@hidden, the color for the background of scroll bars.  It is
+ equivalent to the @code{:background} attribute of the
+ @code{scroll-bar} face.
+ @end table
+ 
  @node Size and Position
  @subsection Frame Size And Position
  @cindex size of frame
***************
*** 798,807 ****
  way windows behave.
  
  @deffn Command delete-frame &optional frame force
! @vindex delete-frame-hook
  This function deletes the frame @var{frame} after running the hook
! @code{delete-frame-hook}.  By default, @var{frame} is the selected
! frame.
  
  A frame cannot be deleted if its minibuffer is used by other frames.
  Normally, you cannot delete a frame if all other frames are invisible,
--- 823,832 ----
  way windows behave.
  
  @deffn Command delete-frame &optional frame force
! @vindex delete-frame-functions
  This function deletes the frame @var{frame} after running the hook
! @code{delete-frame-functions} (each function gets one argument,
! @var{frame}).  By default, @var{frame} is the selected frame.
  
  A frame cannot be deleted if its minibuffer is used by other frames.
  Normally, you cannot delete a frame if all other frames are invisible,




reply via email to

[Prev in Thread] Current Thread [Next in Thread]