comparison lispref/internals.texi @ 48261:f31837228578

Added two references from Buffer Internals to Buffer Gap.

48260:06d37ae4038f

@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999
@c   Free Software Foundation, Inc. 
@c See the file elisp.texi for copying conditions.
@setfilename ../info/internals
@node GNU Emacs Internals, Standard Errors, Tips, Top
@comment  node-name,  next,  previous,  up
@appendix GNU Emacs Internals

@smallexample
@group
DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
  Scoordinates_in_window_p, 2, 2,
  "xSpecify coordinate pair: \nXExpression which evals to window: ",
  "Return non-nil if COORDINATES is in WINDOW.\n\  
COORDINATES is a cons of the form (X . Y), X and Y being distances\n\
...
@end group
@group
If they are on the border between WINDOW and its right sibling,\n\

@item beg
This field contains the actual address of the buffer contents.

@item gpt
This holds the character position of the gap in the buffer.

@item z
This field contains the character position of the end of the buffer
text.

@item z_byte
Holds the byte position of the end of the buffer text.

@item gap_size
Contains the size of buffer's gap.

@item modiff
This field counts buffer-modification events for this buffer.  It is
incremented for each such event, and never otherwise changed.

@item save_modiff
Contains the previous value of @code{modiff}, as of the last time a
buffer was visited or saved in a file.
    
@item overlay_modiff
Counts modifications to overlays analogous to @code{modiff}.
       
@item beg_unchanged
Holds the number of characters at the start of the text that are known
to be unchanged since the last redisplay that finished.
    
@item end_unchanged
Holds the number of characters at the end of the text that are known to
be unchanged since the last redisplay that finished.
    
@item unchanged_modified
Contains the value of @code{modiff} at the time of the last redisplay
that finished.  If this value matches @code{modiff},
@code{beg_unchanged} and @code{end_unchanged} contain no useful
information.
    
@item overlay_unchanged_modified
Contains the value of @code{overlay_modiff} at the time of the last
redisplay that finished.  If this value matches @code{overlay_modiff},
@code{beg_unchanged} and @code{end_unchanged} contain no useful
information.
       
@item markers
The markers that refer to this buffer.  This is actually a single
marker, and successive elements in its marker @code{chain} are the other
markers referring to this buffer text.

@item pt_byte
Contains the byte position of point in a buffer.

@item begv
This field contains the character position of the beginning of the 
accessible range of text in the buffer.

@item begv_byte
This field contains the byte position of the beginning of the 
accessible range of text in the buffer.

@item zv
This field contains the character position of the end of the 
accessible range of text in the buffer.

@item zv_byte
This field contains the byte position of the end of the 
accessible range of text in the buffer.

@item base_buffer
In an indirect buffer, this points to the base buffer.  In an ordinary
buffer, it is null.

@item clip_changed
This flag is set when narrowing changes in a buffer.

@item prevent_redisplay_optimizations_p
this flag indicates that redisplay optimizations should not be used 
to display this buffer.

@item undo_list
This field points to the buffer's undo list.  @xref{Undo}.

The buffer name is a string that names the buffer.  It is guaranteed to
be unique.  @xref{Buffer Names}.

@item filename
The name of the file visited in this buffer, or @code{nil}.
 
@item directory
The directory for expanding relative file names.

@item save_length
Length of the file this buffer is visiting, when last read or saved.
This and other fields concerned with saving are not kept in the
@code{buffer_text} structure because indirect buffers are never saved.

@item auto_save_file_name
File name used for auto-saving this buffer.  This is not in the 
@code{buffer_text} because it's not used in indirect buffers at all.

@item read_only
Non-@code{nil} means this buffer is read-only.

@item mode_line_format
Mode line element that controls the format of the mode line.  If this
is @code{nil}, no mode line will be displayed.

@item header_line_format
This field is analoguous to @code{mode_line_format} for the mode 
line displayed at the top of windows.

@item keymap
This field holds the buffer's local keymap.  @xref{Keymaps}.

@item begv_marker
In an indirect buffer, or a buffer that is the base of an indirect
buffer, this holds a marker that records @code{begv} for this buffer
when the buffer is not current.
 
@item zv_marker
In an indirect buffer, or a buffer that is the base of an indirect
buffer, this holds a marker that records @code{zv} for this buffer when
the buffer is not current.

This holds a time stamp that is updated each time this buffer is
displayed in a window.

@item scroll_up_aggressively
The value of @code{scroll-up-aggressively} in this buffer.
 
@item scroll_down_aggressively
The value of @code{scroll-down-aggressively} in this buffer.
@end table

@node Window Internals

redisplay does if point is off the screen: instead of scrolling the
window to show the text around point, it moves point to a location that
is on the screen.

@item frozen_window_start_p
This field is set temporarily to 1 to indicate to redisplay that 
@code{start} of this window should not be changed, even if point
gets invisible.

@item start_at_line_beg
Non-@code{nil} means current value of @code{start} was the beginning of a line

48261:f31837228578

@c -*-texinfo-*-
@c This is part of the GNU Emacs Lisp Reference Manual.
@c Copyright (C) 1990, 1991, 1992, 1993, 1998, 1999
@c   Free Software Foundation, Inc.
@c See the file elisp.texi for copying conditions.
@setfilename ../info/internals
@node GNU Emacs Internals, Standard Errors, Tips, Top
@comment  node-name,  next,  previous,  up
@appendix GNU Emacs Internals

@smallexample
@group
DEFUN ("coordinates-in-window-p", Fcoordinates_in_window_p,
  Scoordinates_in_window_p, 2, 2,
  "xSpecify coordinate pair: \nXExpression which evals to window: ",
  "Return non-nil if COORDINATES is in WINDOW.\n\
COORDINATES is a cons of the form (X . Y), X and Y being distances\n\
...
@end group
@group
If they are on the border between WINDOW and its right sibling,\n\

@item beg
This field contains the actual address of the buffer contents.

@item gpt
This holds the character position of the gap in the buffer.
@xref{Buffer Gap}.

@item z
This field contains the character position of the end of the buffer
text.

@item z_byte
Holds the byte position of the end of the buffer text.

@item gap_size
Contains the size of buffer's gap.  @xref{Buffer Gap}.

@item modiff
This field counts buffer-modification events for this buffer.  It is
incremented for each such event, and never otherwise changed.

@item save_modiff
Contains the previous value of @code{modiff}, as of the last time a
buffer was visited or saved in a file.

@item overlay_modiff
Counts modifications to overlays analogous to @code{modiff}.

@item beg_unchanged
Holds the number of characters at the start of the text that are known
to be unchanged since the last redisplay that finished.

@item end_unchanged
Holds the number of characters at the end of the text that are known to
be unchanged since the last redisplay that finished.

@item unchanged_modified
Contains the value of @code{modiff} at the time of the last redisplay
that finished.  If this value matches @code{modiff},
@code{beg_unchanged} and @code{end_unchanged} contain no useful
information.

@item overlay_unchanged_modified
Contains the value of @code{overlay_modiff} at the time of the last
redisplay that finished.  If this value matches @code{overlay_modiff},
@code{beg_unchanged} and @code{end_unchanged} contain no useful
information.

@item markers
The markers that refer to this buffer.  This is actually a single
marker, and successive elements in its marker @code{chain} are the other
markers referring to this buffer text.

@item pt_byte
Contains the byte position of point in a buffer.

@item begv
This field contains the character position of the beginning of the
accessible range of text in the buffer.

@item begv_byte
This field contains the byte position of the beginning of the
accessible range of text in the buffer.

@item zv
This field contains the character position of the end of the
accessible range of text in the buffer.

@item zv_byte
This field contains the byte position of the end of the
accessible range of text in the buffer.

@item base_buffer
In an indirect buffer, this points to the base buffer.  In an ordinary
buffer, it is null.

@item clip_changed
This flag is set when narrowing changes in a buffer.

@item prevent_redisplay_optimizations_p
this flag indicates that redisplay optimizations should not be used
to display this buffer.

@item undo_list
This field points to the buffer's undo list.  @xref{Undo}.

The buffer name is a string that names the buffer.  It is guaranteed to
be unique.  @xref{Buffer Names}.

@item filename
The name of the file visited in this buffer, or @code{nil}.

@item directory
The directory for expanding relative file names.

@item save_length
Length of the file this buffer is visiting, when last read or saved.
This and other fields concerned with saving are not kept in the
@code{buffer_text} structure because indirect buffers are never saved.

@item auto_save_file_name
File name used for auto-saving this buffer.  This is not in the
@code{buffer_text} because it's not used in indirect buffers at all.

@item read_only
Non-@code{nil} means this buffer is read-only.

@item mode_line_format
Mode line element that controls the format of the mode line.  If this
is @code{nil}, no mode line will be displayed.

@item header_line_format
This field is analoguous to @code{mode_line_format} for the mode
line displayed at the top of windows.

@item keymap
This field holds the buffer's local keymap.  @xref{Keymaps}.

@item begv_marker
In an indirect buffer, or a buffer that is the base of an indirect
buffer, this holds a marker that records @code{begv} for this buffer
when the buffer is not current.

@item zv_marker
In an indirect buffer, or a buffer that is the base of an indirect
buffer, this holds a marker that records @code{zv} for this buffer when
the buffer is not current.

This holds a time stamp that is updated each time this buffer is
displayed in a window.

@item scroll_up_aggressively
The value of @code{scroll-up-aggressively} in this buffer.

@item scroll_down_aggressively
The value of @code{scroll-down-aggressively} in this buffer.
@end table

@node Window Internals

redisplay does if point is off the screen: instead of scrolling the
window to show the text around point, it moves point to a location that
is on the screen.

@item frozen_window_start_p
This field is set temporarily to 1 to indicate to redisplay that
@code{start} of this window should not be changed, even if point
gets invisible.

@item start_at_line_beg
Non-@code{nil} means current value of @code{start} was the beginning of a line