X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/97d44922da3c22b3973f95892bfa2ee4afc0ceac..7c1f66a94bf236a427606ef537b4629a48a1665b:/src/buffer.c diff --git a/src/buffer.c b/src/buffer.c index 332d6d51a8..a2981c90f6 100644 --- a/src/buffer.c +++ b/src/buffer.c @@ -1,6 +1,6 @@ /* Buffer manipulation primitives for GNU Emacs. -Copyright (C) 1985-1989, 1993-1995, 1997-2015 Free Software Foundation, +Copyright (C) 1985-1989, 1993-1995, 1997-2016 Free Software Foundation, Inc. This file is part of GNU Emacs. @@ -30,7 +30,9 @@ along with GNU Emacs. If not, see . */ #include #include "lisp.h" +#include "coding.h" #include "intervals.h" +#include "systime.h" #include "window.h" #include "commands.h" #include "character.h" @@ -38,10 +40,12 @@ along with GNU Emacs. If not, see . */ #include "region-cache.h" #include "indent.h" #include "blockinput.h" -#include "keyboard.h" #include "keymap.h" #include "frame.h" +#ifdef HAVE_XWIDGETS +# include "xwidget.h" +#endif #ifdef WINDOWSNT #include "w32heap.h" /* for mmap_* */ #endif @@ -134,227 +138,227 @@ CHECK_OVERLAY (Lisp_Object x) static void bset_abbrev_mode (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (abbrev_mode) = val; + b->abbrev_mode_ = val; } static void bset_abbrev_table (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (abbrev_table) = val; + b->abbrev_table_ = val; } static void bset_auto_fill_function (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (auto_fill_function) = val; + b->auto_fill_function_ = val; } static void bset_auto_save_file_format (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (auto_save_file_format) = val; + b->auto_save_file_format_ = val; } static void bset_auto_save_file_name (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (auto_save_file_name) = val; + b->auto_save_file_name_ = val; } static void bset_backed_up (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (backed_up) = val; + b->backed_up_ = val; } static void bset_begv_marker (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (begv_marker) = val; + b->begv_marker_ = val; } static void bset_bidi_display_reordering (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (bidi_display_reordering) = val; + b->bidi_display_reordering_ = val; } static void bset_buffer_file_coding_system (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (buffer_file_coding_system) = val; + b->buffer_file_coding_system_ = val; } static void bset_case_fold_search (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (case_fold_search) = val; + b->case_fold_search_ = val; } static void bset_ctl_arrow (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (ctl_arrow) = val; + b->ctl_arrow_ = val; } static void bset_cursor_in_non_selected_windows (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (cursor_in_non_selected_windows) = val; + b->cursor_in_non_selected_windows_ = val; } static void bset_cursor_type (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (cursor_type) = val; + b->cursor_type_ = val; } static void bset_display_table (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (display_table) = val; + b->display_table_ = val; } static void bset_extra_line_spacing (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (extra_line_spacing) = val; + b->extra_line_spacing_ = val; } static void bset_file_format (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (file_format) = val; + b->file_format_ = val; } static void bset_file_truename (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (file_truename) = val; + b->file_truename_ = val; } static void bset_fringe_cursor_alist (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (fringe_cursor_alist) = val; + b->fringe_cursor_alist_ = val; } static void bset_fringe_indicator_alist (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (fringe_indicator_alist) = val; + b->fringe_indicator_alist_ = val; } static void bset_fringes_outside_margins (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (fringes_outside_margins) = val; + b->fringes_outside_margins_ = val; } static void bset_header_line_format (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (header_line_format) = val; + b->header_line_format_ = val; } static void bset_indicate_buffer_boundaries (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (indicate_buffer_boundaries) = val; + b->indicate_buffer_boundaries_ = val; } static void bset_indicate_empty_lines (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (indicate_empty_lines) = val; + b->indicate_empty_lines_ = val; } static void bset_invisibility_spec (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (invisibility_spec) = val; + b->invisibility_spec_ = val; } static void bset_left_fringe_width (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (left_fringe_width) = val; + b->left_fringe_width_ = val; } static void bset_major_mode (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (major_mode) = val; + b->major_mode_ = val; } static void bset_mark (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (mark) = val; + b->mark_ = val; } static void bset_minor_modes (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (minor_modes) = val; + b->minor_modes_ = val; } static void bset_mode_line_format (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (mode_line_format) = val; + b->mode_line_format_ = val; } static void bset_mode_name (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (mode_name) = val; + b->mode_name_ = val; } static void bset_name (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (name) = val; + b->name_ = val; } static void bset_overwrite_mode (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (overwrite_mode) = val; + b->overwrite_mode_ = val; } static void bset_pt_marker (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (pt_marker) = val; + b->pt_marker_ = val; } static void bset_right_fringe_width (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (right_fringe_width) = val; + b->right_fringe_width_ = val; } static void bset_save_length (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (save_length) = val; + b->save_length_ = val; } static void bset_scroll_bar_width (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (scroll_bar_width) = val; + b->scroll_bar_width_ = val; } static void bset_scroll_bar_height (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (scroll_bar_height) = val; + b->scroll_bar_height_ = val; } static void bset_scroll_down_aggressively (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (scroll_down_aggressively) = val; + b->scroll_down_aggressively_ = val; } static void bset_scroll_up_aggressively (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (scroll_up_aggressively) = val; + b->scroll_up_aggressively_ = val; } static void bset_selective_display (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (selective_display) = val; + b->selective_display_ = val; } static void bset_selective_display_ellipses (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (selective_display_ellipses) = val; + b->selective_display_ellipses_ = val; } static void bset_vertical_scroll_bar_type (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (vertical_scroll_bar_type) = val; + b->vertical_scroll_bar_type_ = val; } static void bset_horizontal_scroll_bar_type (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (horizontal_scroll_bar_type) = val; + b->horizontal_scroll_bar_type_ = val; } static void bset_word_wrap (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (word_wrap) = val; + b->word_wrap_ = val; } static void bset_zv_marker (struct buffer *b, Lisp_Object val) { - b->INTERNAL_FIELD (zv_marker) = val; + b->zv_marker_ = val; } void @@ -1042,7 +1046,7 @@ DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name, doc: /* Return a string that is the name of no existing buffer based on NAME. If there is no live buffer named NAME, then return NAME. Otherwise modify name by appending `', incrementing NUMBER -\(starting at 2) until an unused name is found, and then return that name. +(starting at 2) until an unused name is found, and then return that name. Optional second argument IGNORE specifies a name that is okay to use (if it is in the sequence to be tried) even if a buffer with that name exists. @@ -1385,7 +1389,7 @@ DEFUN ("buffer-chars-modified-tick", Fbuffer_chars_modified_tick, Sbuffer_chars_modified_tick, 0, 1, 0, doc: /* Return BUFFER's character-change tick counter. Each buffer has a character-change tick counter, which is set to the -value of the buffer's tick counter \(see `buffer-modified-tick'), each +value of the buffer's tick counter (see `buffer-modified-tick'), each time text in that buffer is inserted or deleted. By comparing the values returned by two individual calls of `buffer-chars-modified-tick', you can tell whether a character change occurred in that buffer in @@ -1467,15 +1471,15 @@ DEFUN ("other-buffer", Fother_buffer, Sother_buffer, 0, 3, 0, Buffers not visible in windows are preferred to visible buffers, unless optional second argument VISIBLE-OK is non-nil. Ignore the argument BUFFER unless it denotes a live buffer. If the optional third argument -FRAME is non-nil, use that frame's buffer list instead of the selected -frame's buffer list. +FRAME specifies a live frame, then use that frame's buffer list instead +of the selected frame's buffer list. The buffer is found by scanning the selected or specified frame's buffer list first, followed by the list of all buffers. If no other buffer exists, return the buffer `*scratch*' (creating it if necessary). */) (Lisp_Object buffer, Lisp_Object visible_ok, Lisp_Object frame) { - struct frame *f = decode_any_frame (frame); + struct frame *f = decode_live_frame (frame); Lisp_Object tail = f->buffer_list, pred = f->buffer_predicate; Lisp_Object buf, notsogood = Qnil; @@ -1591,7 +1595,7 @@ compact_buffer (struct buffer *buffer) turned off in that buffer. Calling truncate_undo_list on Qt tends to return NULL, which effectively turns undo back on. So don't call truncate_undo_list if undo_list is Qt. */ - if (!EQ (buffer->INTERNAL_FIELD (undo_list), Qt)) + if (!EQ (BVAR(buffer, undo_list), Qt)) truncate_undo_list (buffer); /* Shrink buffer gaps. */ @@ -1629,10 +1633,9 @@ cleaning up all windows currently displaying the buffer to be killed. */) (Lisp_Object buffer_or_name) { Lisp_Object buffer; - register struct buffer *b; - register Lisp_Object tem; - register struct Lisp_Marker *m; - struct gcpro gcpro1; + struct buffer *b; + Lisp_Object tem; + struct Lisp_Marker *m; if (NILP (buffer_or_name)) buffer = Fcurrent_buffer (); @@ -1665,10 +1668,8 @@ cleaning up all windows currently displaying the buffer to be killed. */) if (INTERACTIVE && !NILP (BVAR (b, filename)) && BUF_MODIFF (b) > BUF_SAVE_MODIFF (b)) { - GCPRO1 (buffer); - tem = do_yes_or_no_p (format2 ("Buffer %s modified; kill anyway? ", - BVAR (b, name), make_number (0))); - UNGCPRO; + AUTO_STRING (format, "Buffer %s modified; kill anyway? "); + tem = do_yes_or_no_p (CALLN (Fformat, format, BVAR (b, name))); if (NILP (tem)) return unbind_to (count, Qnil); } @@ -1702,8 +1703,6 @@ cleaning up all windows currently displaying the buffer to be killed. */) { struct buffer *other; - GCPRO1 (buffer); - FOR_EACH_BUFFER (other) if (other->base_buffer == b) { @@ -1712,8 +1711,6 @@ cleaning up all windows currently displaying the buffer to be killed. */) Fkill_buffer (buf); } - UNGCPRO; - /* Exit if we now have killed the base buffer (Bug#11665). */ if (!BUFFER_LIVE_P (b)) return Qt; @@ -1751,10 +1748,11 @@ cleaning up all windows currently displaying the buffer to be killed. */) /* Unlock this buffer's file, if it is locked. */ unlock_buffer (b); - GCPRO1 (buffer); kill_buffer_processes (buffer); - UNGCPRO; +#ifdef HAVE_XWIDGETS + kill_buffer_xwidgets (buffer); +#endif /* Killing buffer processes may run sentinels which may have killed our buffer. */ if (!BUFFER_LIVE_P (b)) @@ -2409,7 +2407,6 @@ current buffer is cleared. */) bool narrowed = (BEG != BEGV || Z != ZV); bool modified_p = !NILP (Fbuffer_modified_p (Qnil)); Lisp_Object old_undo = BVAR (current_buffer, undo_list); - struct gcpro gcpro1; if (current_buffer->base_buffer) error ("Cannot do `set-buffer-multibyte' on an indirect buffer"); @@ -2418,8 +2415,6 @@ current buffer is cleared. */) if (NILP (flag) == NILP (BVAR (current_buffer, enable_multibyte_characters))) return flag; - GCPRO1 (old_undo); - /* Don't record these buffer changes. We will put a special undo entry instead. */ bset_undo_list (current_buffer, Qt); @@ -2649,8 +2644,6 @@ current buffer is cleared. */) old_undo)); } - UNGCPRO; - current_buffer->prevent_redisplay_optimizations_p = 1; /* If buffer is shown in a window, let redisplay consider other windows. */ @@ -3258,9 +3251,9 @@ record_overlay_string (struct sortstrlist *ssl, Lisp_Object str, else nbytes = SBYTES (str); - if (INT_ADD_OVERFLOW (ssl->bytes, nbytes)) + if (INT_ADD_WRAPV (ssl->bytes, nbytes, &nbytes)) memory_full (SIZE_MAX); - ssl->bytes += nbytes; + ssl->bytes = nbytes; if (STRINGP (str2)) { @@ -3272,9 +3265,9 @@ record_overlay_string (struct sortstrlist *ssl, Lisp_Object str, else nbytes = SBYTES (str2); - if (INT_ADD_OVERFLOW (ssl->bytes, nbytes)) + if (INT_ADD_WRAPV (ssl->bytes, nbytes, &nbytes)) memory_full (SIZE_MAX); - ssl->bytes += nbytes; + ssl->bytes = nbytes; } } @@ -3370,9 +3363,8 @@ overlay_strings (ptrdiff_t pos, struct window *w, unsigned char **pstr) unsigned char *p; ptrdiff_t total; - if (INT_ADD_OVERFLOW (overlay_heads.bytes, overlay_tails.bytes)) + if (INT_ADD_WRAPV (overlay_heads.bytes, overlay_tails.bytes, &total)) memory_full (SIZE_MAX); - total = overlay_heads.bytes + overlay_tails.bytes; if (total > overlay_str_len) overlay_str_buf = xpalloc (overlay_str_buf, &overlay_str_len, total - overlay_str_len, -1, 1); @@ -3805,10 +3797,10 @@ If omitted, BUFFER defaults to the current buffer. BEG and END may be integers or markers. The fourth arg FRONT-ADVANCE, if non-nil, makes the marker for the front of the overlay advance when text is inserted there -\(which means the text *is not* included in the overlay). +(which means the text *is not* included in the overlay). The fifth arg REAR-ADVANCE, if non-nil, makes the marker for the rear of the overlay advance when text is inserted there -\(which means the text *is* included in the overlay). */) +(which means the text *is* included in the overlay). */) (Lisp_Object beg, Lisp_Object end, Lisp_Object buffer, Lisp_Object front_advance, Lisp_Object rear_advance) { @@ -4394,7 +4386,6 @@ report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after, struct Lisp_Overlay *tail; /* True if this change is an insertion. */ bool insertion = (after ? XFASTINT (arg3) == 0 : EQ (start, end)); - struct gcpro gcpro1, gcpro2, gcpro3, gcpro4; overlay = Qnil; tail = NULL; @@ -4487,7 +4478,6 @@ report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after, } } - GCPRO4 (overlay, arg1, arg2, arg3); { /* Call the functions recorded in last_overlay_modification_hooks. First copy the vector contents, in case some of these hooks @@ -4496,6 +4486,23 @@ report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after, Lisp_Object *copy; ptrdiff_t i; + if (size) + { + Lisp_Object ovl + = XVECTOR (last_overlay_modification_hooks)->contents[1]; + + /* If the buffer of the first overlay in the array doesn't + match the current buffer, then these modification hooks + should not be run in this buffer. This could happen when + some code calls some insdel functions, such as del_range_1, + with the PREPARE argument false -- in that case this + function is never called to record the overlay modification + hook functions in the last_overlay_modification_hooks + array, so anything we find there is not ours. */ + if (XMARKER (OVERLAY_START (ovl))->buffer != current_buffer) + return; + } + USE_SAFE_ALLOCA; SAFE_ALLOCA_LISP (copy, size); memcpy (copy, XVECTOR (last_overlay_modification_hooks)->contents, @@ -4511,17 +4518,12 @@ report_overlay_modification (Lisp_Object start, Lisp_Object end, bool after, SAFE_FREE (); } - UNGCPRO; } static void call_overlay_mod_hooks (Lisp_Object list, Lisp_Object overlay, bool after, Lisp_Object arg1, Lisp_Object arg2, Lisp_Object arg3) { - struct gcpro gcpro1, gcpro2, gcpro3, gcpro4; - - GCPRO4 (list, arg1, arg2, arg3); - while (CONSP (list)) { if (NILP (arg3)) @@ -4530,7 +4532,6 @@ call_overlay_mod_hooks (Lisp_Object list, Lisp_Object overlay, bool after, call5 (XCAR (list), overlay, after ? Qt : Qnil, arg1, arg2, arg3); list = XCDR (list); } - UNGCPRO; } /* Delete any zero-sized overlays at position POS, if the `evaporate' @@ -4595,8 +4596,6 @@ evaporate_overlays (ptrdiff_t pos) #include #endif -#include "coding.h" - /* Memory is allocated in regions which are mapped using mmap(2). The current implementation lets the system select mapped @@ -5285,41 +5284,47 @@ init_buffer (int initialized) pwd = get_current_dir_name (); if (!pwd) - fatal ("`get_current_dir_name' failed: %s\n", strerror (errno)); - - /* Maybe this should really use some standard subroutine - whose definition is filename syntax dependent. */ - len = strlen (pwd); - if (!(IS_DIRECTORY_SEP (pwd[len - 1]))) { - /* Grow buffer to add directory separator and '\0'. */ - pwd = realloc (pwd, len + 2); - if (!pwd) - fatal ("`get_current_dir_name' failed: %s\n", strerror (errno)); - pwd[len] = DIRECTORY_SEP; - pwd[len + 1] = '\0'; - len++; + fprintf (stderr, "Error getting directory: %s\n", + emacs_strerror (errno)); + bset_directory (current_buffer, Qnil); } - - /* At this moment, we still don't know how to decode the directory - name. So, we keep the bytes in unibyte form so that file I/O - routines correctly get the original bytes. */ - bset_directory (current_buffer, make_unibyte_string (pwd, len)); - - /* Add /: to the front of the name - if it would otherwise be treated as magic. */ - temp = Ffind_file_name_handler (BVAR (current_buffer, directory), Qt); - if (! NILP (temp) - /* If the default dir is just /, TEMP is non-nil - because of the ange-ftp completion handler. - However, it is not necessary to turn / into /:/. - So avoid doing that. */ - && strcmp ("/", SSDATA (BVAR (current_buffer, directory)))) + else { - AUTO_STRING (slash_colon, "/:"); - bset_directory (current_buffer, - concat2 (slash_colon, - BVAR (current_buffer, directory))); + /* Maybe this should really use some standard subroutine + whose definition is filename syntax dependent. */ + len = strlen (pwd); + if (!(IS_DIRECTORY_SEP (pwd[len - 1]))) + { + /* Grow buffer to add directory separator and '\0'. */ + pwd = realloc (pwd, len + 2); + if (!pwd) + fatal ("get_current_dir_name: %s\n", strerror (errno)); + pwd[len] = DIRECTORY_SEP; + pwd[len + 1] = '\0'; + len++; + } + + /* At this moment, we still don't know how to decode the directory + name. So, we keep the bytes in unibyte form so that file I/O + routines correctly get the original bytes. */ + bset_directory (current_buffer, make_unibyte_string (pwd, len)); + + /* Add /: to the front of the name + if it would otherwise be treated as magic. */ + temp = Ffind_file_name_handler (BVAR (current_buffer, directory), Qt); + if (! NILP (temp) + /* If the default dir is just /, TEMP is non-nil + because of the ange-ftp completion handler. + However, it is not necessary to turn / into /:/. + So avoid doing that. */ + && strcmp ("/", SSDATA (BVAR (current_buffer, directory)))) + { + AUTO_STRING (slash_colon, "/:"); + bset_directory (current_buffer, + concat2 (slash_colon, + BVAR (current_buffer, directory))); + } } temp = get_minibuffer (0); @@ -5418,140 +5423,140 @@ syms_of_buffer (void) DEFVAR_BUFFER_DEFAULTS ("default-mode-line-format", mode_line_format, doc: /* Default value of `mode-line-format' for buffers that don't override it. -This is the same as (default-value 'mode-line-format). */); +This is the same as (default-value \\='mode-line-format). */); DEFVAR_BUFFER_DEFAULTS ("default-header-line-format", header_line_format, doc: /* Default value of `header-line-format' for buffers that don't override it. -This is the same as (default-value 'header-line-format). */); +This is the same as (default-value \\='header-line-format). */); DEFVAR_BUFFER_DEFAULTS ("default-cursor-type", cursor_type, doc: /* Default value of `cursor-type' for buffers that don't override it. -This is the same as (default-value 'cursor-type). */); +This is the same as (default-value \\='cursor-type). */); DEFVAR_BUFFER_DEFAULTS ("default-line-spacing", extra_line_spacing, doc: /* Default value of `line-spacing' for buffers that don't override it. -This is the same as (default-value 'line-spacing). */); +This is the same as (default-value \\='line-spacing). */); DEFVAR_BUFFER_DEFAULTS ("default-cursor-in-non-selected-windows", cursor_in_non_selected_windows, doc: /* Default value of `cursor-in-non-selected-windows'. -This is the same as (default-value 'cursor-in-non-selected-windows). */); +This is the same as (default-value \\='cursor-in-non-selected-windows). */); DEFVAR_BUFFER_DEFAULTS ("default-abbrev-mode", abbrev_mode, doc: /* Default value of `abbrev-mode' for buffers that do not override it. -This is the same as (default-value 'abbrev-mode). */); +This is the same as (default-value \\='abbrev-mode). */); DEFVAR_BUFFER_DEFAULTS ("default-ctl-arrow", ctl_arrow, doc: /* Default value of `ctl-arrow' for buffers that do not override it. -This is the same as (default-value 'ctl-arrow). */); +This is the same as (default-value \\='ctl-arrow). */); DEFVAR_BUFFER_DEFAULTS ("default-enable-multibyte-characters", enable_multibyte_characters, doc: /* Default value of `enable-multibyte-characters' for buffers not overriding it. -This is the same as (default-value 'enable-multibyte-characters). */); +This is the same as (default-value \\='enable-multibyte-characters). */); DEFVAR_BUFFER_DEFAULTS ("default-buffer-file-coding-system", buffer_file_coding_system, doc: /* Default value of `buffer-file-coding-system' for buffers not overriding it. -This is the same as (default-value 'buffer-file-coding-system). */); +This is the same as (default-value \\='buffer-file-coding-system). */); DEFVAR_BUFFER_DEFAULTS ("default-truncate-lines", truncate_lines, doc: /* Default value of `truncate-lines' for buffers that do not override it. -This is the same as (default-value 'truncate-lines). */); +This is the same as (default-value \\='truncate-lines). */); DEFVAR_BUFFER_DEFAULTS ("default-fill-column", fill_column, doc: /* Default value of `fill-column' for buffers that do not override it. -This is the same as (default-value 'fill-column). */); +This is the same as (default-value \\='fill-column). */); DEFVAR_BUFFER_DEFAULTS ("default-left-margin", left_margin, doc: /* Default value of `left-margin' for buffers that do not override it. -This is the same as (default-value 'left-margin). */); +This is the same as (default-value \\='left-margin). */); DEFVAR_BUFFER_DEFAULTS ("default-tab-width", tab_width, doc: /* Default value of `tab-width' for buffers that do not override it. NOTE: This controls the display width of a TAB character, and not the size of an indentation step. -This is the same as (default-value 'tab-width). */); +This is the same as (default-value \\='tab-width). */); DEFVAR_BUFFER_DEFAULTS ("default-case-fold-search", case_fold_search, doc: /* Default value of `case-fold-search' for buffers that don't override it. -This is the same as (default-value 'case-fold-search). */); +This is the same as (default-value \\='case-fold-search). */); DEFVAR_BUFFER_DEFAULTS ("default-left-margin-width", left_margin_cols, doc: /* Default value of `left-margin-width' for buffers that don't override it. -This is the same as (default-value 'left-margin-width). */); +This is the same as (default-value \\='left-margin-width). */); DEFVAR_BUFFER_DEFAULTS ("default-right-margin-width", right_margin_cols, doc: /* Default value of `right-margin-width' for buffers that don't override it. -This is the same as (default-value 'right-margin-width). */); +This is the same as (default-value \\='right-margin-width). */); DEFVAR_BUFFER_DEFAULTS ("default-left-fringe-width", left_fringe_width, doc: /* Default value of `left-fringe-width' for buffers that don't override it. -This is the same as (default-value 'left-fringe-width). */); +This is the same as (default-value \\='left-fringe-width). */); DEFVAR_BUFFER_DEFAULTS ("default-right-fringe-width", right_fringe_width, doc: /* Default value of `right-fringe-width' for buffers that don't override it. -This is the same as (default-value 'right-fringe-width). */); +This is the same as (default-value \\='right-fringe-width). */); DEFVAR_BUFFER_DEFAULTS ("default-fringes-outside-margins", fringes_outside_margins, doc: /* Default value of `fringes-outside-margins' for buffers that don't override it. -This is the same as (default-value 'fringes-outside-margins). */); +This is the same as (default-value \\='fringes-outside-margins). */); DEFVAR_BUFFER_DEFAULTS ("default-scroll-bar-width", scroll_bar_width, doc: /* Default value of `scroll-bar-width' for buffers that don't override it. -This is the same as (default-value 'scroll-bar-width). */); +This is the same as (default-value \\='scroll-bar-width). */); DEFVAR_BUFFER_DEFAULTS ("default-vertical-scroll-bar", vertical_scroll_bar_type, doc: /* Default value of `vertical-scroll-bar' for buffers that don't override it. -This is the same as (default-value 'vertical-scroll-bar). */); +This is the same as (default-value \\='vertical-scroll-bar). */); DEFVAR_BUFFER_DEFAULTS ("default-indicate-empty-lines", indicate_empty_lines, doc: /* Default value of `indicate-empty-lines' for buffers that don't override it. -This is the same as (default-value 'indicate-empty-lines). */); +This is the same as (default-value \\='indicate-empty-lines). */); DEFVAR_BUFFER_DEFAULTS ("default-indicate-buffer-boundaries", indicate_buffer_boundaries, doc: /* Default value of `indicate-buffer-boundaries' for buffers that don't override it. -This is the same as (default-value 'indicate-buffer-boundaries). */); +This is the same as (default-value \\='indicate-buffer-boundaries). */); DEFVAR_BUFFER_DEFAULTS ("default-fringe-indicator-alist", fringe_indicator_alist, doc: /* Default value of `fringe-indicator-alist' for buffers that don't override it. -This is the same as (default-value 'fringe-indicator-alist'). */); +This is the same as (default-value \\='fringe-indicator-alist). */); DEFVAR_BUFFER_DEFAULTS ("default-fringe-cursor-alist", fringe_cursor_alist, doc: /* Default value of `fringe-cursor-alist' for buffers that don't override it. -This is the same as (default-value 'fringe-cursor-alist'). */); +This is the same as (default-value \\='fringe-cursor-alist). */); DEFVAR_BUFFER_DEFAULTS ("default-scroll-up-aggressively", scroll_up_aggressively, doc: /* Default value of `scroll-up-aggressively'. This value applies in buffers that don't have their own local values. -This is the same as (default-value 'scroll-up-aggressively). */); +This is the same as (default-value \\='scroll-up-aggressively). */); DEFVAR_BUFFER_DEFAULTS ("default-scroll-down-aggressively", scroll_down_aggressively, doc: /* Default value of `scroll-down-aggressively'. This value applies in buffers that don't have their own local values. -This is the same as (default-value 'scroll-down-aggressively). */); +This is the same as (default-value \\='scroll-down-aggressively). */); DEFVAR_PER_BUFFER ("header-line-format", &BVAR (current_buffer, header_line_format), @@ -5631,13 +5636,7 @@ Decimal digits after the % specify field width to which to pad. */); doc: /* Symbol for current buffer's major mode. The default value (normally `fundamental-mode') affects new buffers. A value of nil means to use the current buffer's major mode, provided -it is not marked as "special". - -When a mode is used by default, `find-file' switches to it before it -reads the contents into the buffer and before it finishes setting up -the buffer. Thus, the mode and its hooks should not expect certain -variables such as `buffer-read-only' and `buffer-file-coding-system' -to be set up. */); +it is not marked as "special". */); DEFVAR_PER_BUFFER ("mode-name", &BVAR (current_buffer, mode_name), Qnil, @@ -5724,7 +5723,7 @@ The values of `right-to-left' and `left-to-right' override that. Any other value is treated as nil. This variable has no effect unless the buffer's value of -\`bidi-display-reordering' is non-nil. */); +`bidi-display-reordering' is non-nil. */); DEFVAR_PER_BUFFER ("truncate-lines", &BVAR (current_buffer, truncate_lines), Qnil, doc: /* Non-nil means do not display continuation lines. @@ -5756,7 +5755,7 @@ visual lines rather than logical lines. See the documentation of DEFVAR_PER_BUFFER ("default-directory", &BVAR (current_buffer, directory), Qstringp, - doc: /* Name of default directory of current buffer. Should end with slash. + doc: /* Name of default directory of current buffer. To interactively change the default directory, use command `cd'. */); DEFVAR_PER_BUFFER ("auto-fill-function", &BVAR (current_buffer, auto_fill_function), @@ -5804,11 +5803,14 @@ you probably should set this to -2 in that buffer. */); DEFVAR_PER_BUFFER ("selective-display", &BVAR (current_buffer, selective_display), Qnil, doc: /* Non-nil enables selective display. + An integer N as value means display only lines that start with less than N columns of space. + A value of t means that the character ^M makes itself and all the rest of the line invisible; also, when saving the buffer -in a file, save the ^M as a newline. */); +in a file, save the ^M as a newline. This usage is obsolete; use +overlays or text properties instead. */); DEFVAR_PER_BUFFER ("selective-display-ellipses", &BVAR (current_buffer, selective_display_ellipses), @@ -6030,7 +6032,7 @@ between 0.0 and 1.0, inclusive. */); doc: /* List of functions to call before each text change. Two arguments are passed to each function: the positions of the beginning and end of the range of old text to be changed. -\(For an insertion, the beginning and end are at the same place.) +(For an insertion, the beginning and end are at the same place.) No information is given about the length of the text after the change. Buffer changes made while executing the `before-change-functions' @@ -6047,7 +6049,7 @@ from happening repeatedly and making Emacs nonfunctional. */); Three arguments are passed to each function: the positions of the beginning and end of the range of changed text, and the length in chars of the pre-change text replaced by that range. -\(For an insertion, the pre-change length is zero; +(For an insertion, the pre-change length is zero; for a deletion, that length is the number of chars deleted, and the post-change beginning and end are at the same place.) @@ -6092,7 +6094,7 @@ was modified between BEG and END. PROPERTY is the property name, and VALUE is the old value. An entry (apply FUN-NAME . ARGS) means undo the change with -\(apply FUN-NAME ARGS). +(apply FUN-NAME ARGS). An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo in the active region. BEG and END is the range affected by this entry @@ -6106,7 +6108,7 @@ An entry of the form POSITION indicates that point was at the buffer location given by the integer. Undoing an entry of this form places point at POSITION. -Entries with value `nil' mark undo boundaries. The undo command treats +Entries with value nil mark undo boundaries. The undo command treats the changes between two undo boundaries as a single step to be undone. If the value of the variable is t, undo information is not recorded. */); @@ -6202,11 +6204,11 @@ all windows or just the selected window. Lisp programs may give this variable certain special values: -- A value of `lambda' enables Transient Mark mode temporarily. - It is disabled again after any subsequent action that would +- The symbol `lambda' enables Transient Mark mode temporarily. + The mode is disabled again after any subsequent action that would normally deactivate the mark (e.g. buffer modification). -- A value of (only . OLDVAL) enables Transient Mark mode +- The pair (only . OLDVAL) enables Transient Mark mode temporarily. After any subsequent point motion command that is not shift-translated, or any other action that would normally deactivate the mark (e.g. buffer modification), the value of @@ -6252,9 +6254,9 @@ to the default frame line height. A value of nil means add no extra space. */) doc: /* Non-nil means show a cursor in non-selected windows. If nil, only shows a cursor in the selected window. If t, displays a cursor related to the usual cursor type -\(a solid box becomes hollow, a bar becomes a narrower bar). +(a solid box becomes hollow, a bar becomes a narrower bar). You can also specify the cursor type as in the `cursor-type' variable. -Use Custom to set this variable and update the display." */); +Use Custom to set this variable and update the display. */); DEFVAR_LISP ("kill-buffer-query-functions", Vkill_buffer_query_functions, doc: /* List of functions called with no args to query before killing a buffer.