aboutsummaryrefslogtreecommitdiffstats
path: root/src/buffer.c
diff options
context:
space:
mode:
authorPaul Eggert2015-09-16 16:23:55 -0700
committerPaul Eggert2015-09-16 16:26:07 -0700
commit032ce1c7d1afb23e6b1265d91c5a97e45de071ce (patch)
treedab9ca1e540c23aeb15ee9ef8fdc6b78e1929b6d /src/buffer.c
parent309d39b832ccd72f99cc726090ff03f7e146948d (diff)
downloademacs-032ce1c7d1afb23e6b1265d91c5a97e45de071ce.tar.gz
emacs-032ce1c7d1afb23e6b1265d91c5a97e45de071ce.zip
Omit unnecessary \ before paren in C docstrings
Although \( is needed in docstrings in Elisp code, it is not needed in docstrings in C code, since C function definitiions do not start with a parenthesis. The backslashes made the docstrings a bit harder to read and to format in columns. Also, some C docstrings had ( in column 1 and this did not appear to be causing any problems. So, simplify C docstrings by replacing \( with ( and \) with ).
Diffstat (limited to 'src/buffer.c')
-rw-r--r--src/buffer.c16
1 files changed, 8 insertions, 8 deletions
diff --git a/src/buffer.c b/src/buffer.c
index 33f7996a8c1..530fe114cc8 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -1042,7 +1042,7 @@ DEFUN ("generate-new-buffer-name", Fgenerate_new_buffer_name,
1042 doc: /* Return a string that is the name of no existing buffer based on NAME. 1042 doc: /* Return a string that is the name of no existing buffer based on NAME.
1043If there is no live buffer named NAME, then return NAME. 1043If there is no live buffer named NAME, then return NAME.
1044Otherwise modify name by appending `<NUMBER>', incrementing NUMBER 1044Otherwise modify name by appending `<NUMBER>', incrementing NUMBER
1045\(starting at 2) until an unused name is found, and then return that name. 1045(starting at 2) until an unused name is found, and then return that name.
1046Optional second argument IGNORE specifies a name that is okay to use (if 1046Optional second argument IGNORE specifies a name that is okay to use (if
1047it is in the sequence to be tried) even if a buffer with that name exists. 1047it is in the sequence to be tried) even if a buffer with that name exists.
1048 1048
@@ -1385,7 +1385,7 @@ DEFUN ("buffer-chars-modified-tick", Fbuffer_chars_modified_tick,
1385 Sbuffer_chars_modified_tick, 0, 1, 0, 1385 Sbuffer_chars_modified_tick, 0, 1, 0,
1386 doc: /* Return BUFFER's character-change tick counter. 1386 doc: /* Return BUFFER's character-change tick counter.
1387Each buffer has a character-change tick counter, which is set to the 1387Each buffer has a character-change tick counter, which is set to the
1388value of the buffer's tick counter \(see `buffer-modified-tick'), each 1388value of the buffer's tick counter (see `buffer-modified-tick'), each
1389time text in that buffer is inserted or deleted. By comparing the 1389time text in that buffer is inserted or deleted. By comparing the
1390values returned by two individual calls of `buffer-chars-modified-tick', 1390values returned by two individual calls of `buffer-chars-modified-tick',
1391you can tell whether a character change occurred in that buffer in 1391you can tell whether a character change occurred in that buffer in
@@ -3791,10 +3791,10 @@ If omitted, BUFFER defaults to the current buffer.
3791BEG and END may be integers or markers. 3791BEG and END may be integers or markers.
3792The fourth arg FRONT-ADVANCE, if non-nil, makes the marker 3792The fourth arg FRONT-ADVANCE, if non-nil, makes the marker
3793for the front of the overlay advance when text is inserted there 3793for the front of the overlay advance when text is inserted there
3794\(which means the text *is not* included in the overlay). 3794(which means the text *is not* included in the overlay).
3795The fifth arg REAR-ADVANCE, if non-nil, makes the marker 3795The fifth arg REAR-ADVANCE, if non-nil, makes the marker
3796for the rear of the overlay advance when text is inserted there 3796for the rear of the overlay advance when text is inserted there
3797\(which means the text *is* included in the overlay). */) 3797(which means the text *is* included in the overlay). */)
3798 (Lisp_Object beg, Lisp_Object end, Lisp_Object buffer, 3798 (Lisp_Object beg, Lisp_Object end, Lisp_Object buffer,
3799 Lisp_Object front_advance, Lisp_Object rear_advance) 3799 Lisp_Object front_advance, Lisp_Object rear_advance)
3800{ 3800{
@@ -6014,7 +6014,7 @@ between 0.0 and 1.0, inclusive. */);
6014 doc: /* List of functions to call before each text change. 6014 doc: /* List of functions to call before each text change.
6015Two arguments are passed to each function: the positions of 6015Two arguments are passed to each function: the positions of
6016the beginning and end of the range of old text to be changed. 6016the beginning and end of the range of old text to be changed.
6017\(For an insertion, the beginning and end are at the same place.) 6017(For an insertion, the beginning and end are at the same place.)
6018No information is given about the length of the text after the change. 6018No information is given about the length of the text after the change.
6019 6019
6020Buffer changes made while executing the `before-change-functions' 6020Buffer changes made while executing the `before-change-functions'
@@ -6031,7 +6031,7 @@ from happening repeatedly and making Emacs nonfunctional. */);
6031Three arguments are passed to each function: the positions of 6031Three arguments are passed to each function: the positions of
6032the beginning and end of the range of changed text, 6032the beginning and end of the range of changed text,
6033and the length in chars of the pre-change text replaced by that range. 6033and the length in chars of the pre-change text replaced by that range.
6034\(For an insertion, the pre-change length is zero; 6034(For an insertion, the pre-change length is zero;
6035for a deletion, that length is the number of chars deleted, 6035for a deletion, that length is the number of chars deleted,
6036and the post-change beginning and end are at the same place.) 6036and the post-change beginning and end are at the same place.)
6037 6037
@@ -6076,7 +6076,7 @@ was modified between BEG and END. PROPERTY is the property name,
6076and VALUE is the old value. 6076and VALUE is the old value.
6077 6077
6078An entry (apply FUN-NAME . ARGS) means undo the change with 6078An entry (apply FUN-NAME . ARGS) means undo the change with
6079\(apply FUN-NAME ARGS). 6079(apply FUN-NAME ARGS).
6080 6080
6081An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo 6081An entry (apply DELTA BEG END FUN-NAME . ARGS) supports selective undo
6082in the active region. BEG and END is the range affected by this entry 6082in the active region. BEG and END is the range affected by this entry
@@ -6236,7 +6236,7 @@ to the default frame line height. A value of nil means add no extra space. */)
6236 doc: /* Non-nil means show a cursor in non-selected windows. 6236 doc: /* Non-nil means show a cursor in non-selected windows.
6237If nil, only shows a cursor in the selected window. 6237If nil, only shows a cursor in the selected window.
6238If t, displays a cursor related to the usual cursor type 6238If t, displays a cursor related to the usual cursor type
6239\(a solid box becomes hollow, a bar becomes a narrower bar). 6239(a solid box becomes hollow, a bar becomes a narrower bar).
6240You can also specify the cursor type as in the `cursor-type' variable. 6240You can also specify the cursor type as in the `cursor-type' variable.
6241Use Custom to set this variable and update the display." */); 6241Use Custom to set this variable and update the display." */);
6242 6242