comparison src/editfns.c @ 4693:80cd90837ac5

Add argument information to remaining MANY or UNEVALLED C subrs. src/ChangeLog addition: 2009-09-20 Aidan Kehoe <kehoea@parhasard.net> * alloc.c (Flist): (Fvector): (Fbit_vector): (Fmake_byte_code): (Fstring): * data.c (Feqlsign): (Flss): (Fgtr): (Fleq): (Fgeq): (Fneq): (Fgtr): (Fplus): (Fminus): (Ftimes): (Fdiv): (Fquo): (Fmax): (Fmin): (Flogand): (Flogior): (Flogxor): * editfns.c (Fsave_excursion): (Fsave_current_buffer): (Fencode_time): (Finsert): (Finsert_before_markers): (Fsave_restriction): (Fformat): * elhash.c (Fmake_hash_table): * eval.c (Fdefun): (Fdefmacro): (Fcatch): (Funwind_protect): (Fcall_with_condition_handler): (Ffuncall): (Fapply): (Frun_hooks): * fns.c (Fappend): (Fconcat): (Fvconcat): (Fbvconcat): (Fnconc): * print.c (Fwith_output_to_temp_buffer): * process.c (Fstart_process_internal): * window.c (Fsave_window_excursion): * widget.c (Fwidget_apply): Add argument information, in a form understood by #'function-arglist, to all these MANY or UNEVALLED (that is to say, special-operator) built-in functions.
author Aidan Kehoe <kehoea@parhasard.net>
date Sun, 20 Sep 2009 21:29:00 +0100
parents c76b1bc6bd28
children a5210e70ffbe
comparison
equal deleted inserted replaced
4692:dc3c2f298857 4693:80cd90837ac5
368 DEFUN ("save-excursion", Fsave_excursion, 0, UNEVALLED, 0, /* 368 DEFUN ("save-excursion", Fsave_excursion, 0, UNEVALLED, 0, /*
369 Save point, mark, and current buffer; execute BODY; restore those things. 369 Save point, mark, and current buffer; execute BODY; restore those things.
370 Executes BODY just like `progn'. 370 Executes BODY just like `progn'.
371 The values of point, mark and the current buffer are restored 371 The values of point, mark and the current buffer are restored
372 even in case of abnormal exit (throw or error). 372 even in case of abnormal exit (throw or error).
373
374 arguments: (&rest BODY)
373 */ 375 */
374 (args)) 376 (args))
375 { 377 {
376 /* This function can GC */ 378 /* This function can GC */
377 int speccount = specpdl_depth (); 379 int speccount = specpdl_depth ();
393 } 395 }
394 396
395 DEFUN ("save-current-buffer", Fsave_current_buffer, 0, UNEVALLED, 0, /* 397 DEFUN ("save-current-buffer", Fsave_current_buffer, 0, UNEVALLED, 0, /*
396 Save the current buffer; execute BODY; restore the current buffer. 398 Save the current buffer; execute BODY; restore the current buffer.
397 Executes BODY just like `progn'. 399 Executes BODY just like `progn'.
400
401 arguments: (&rest BODY)
398 */ 402 */
399 (args)) 403 (args))
400 { 404 {
401 /* This function can GC */ 405 /* This function can GC */
402 int speccount = specpdl_depth (); 406 int speccount = specpdl_depth ();
1137 return list2 (make_int (tiempo < 0 ? tiempo / 0x10000 : tiempo >> 16), 1141 return list2 (make_int (tiempo < 0 ? tiempo / 0x10000 : tiempo >> 16),
1138 make_int (tiempo & 0xFFFF)); 1142 make_int (tiempo & 0xFFFF));
1139 } 1143 }
1140 1144
1141 DEFUN ("encode-time", Fencode_time, 6, MANY, 0, /* 1145 DEFUN ("encode-time", Fencode_time, 6, MANY, 0, /*
1142 Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time. 1146 Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.
1143 This is the reverse operation of `decode-time', which see. 1147 This is the reverse operation of `decode-time', which see.
1144 ZONE defaults to the current time zone rule. This can 1148 ZONE defaults to the current time zone rule. This can
1145 be a string (as from `set-time-zone-rule'), or it can be a list 1149 be a string (as from `set-time-zone-rule'), or it can be a list
1146 \(as from `current-time-zone') or an integer (as from `decode-time') 1150 \(as from `current-time-zone') or an integer (as from `decode-time')
1147 applied without consideration for daylight savings time. 1151 applied without consideration for daylight savings time.
1153 1157
1154 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed; 1158 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;
1155 for example, a DAY of 0 means the day preceding the given month. 1159 for example, a DAY of 0 means the day preceding the given month.
1156 Year numbers less than 100 are treated just like other year numbers. 1160 Year numbers less than 100 are treated just like other year numbers.
1157 If you want them to stand for years in this century, you must do that yourself. 1161 If you want them to stand for years in this century, you must do that yourself.
1162
1163 arguments: (SECOND MINUTE HOUR DAY MONTH YEAR &optional ZONE &rest REST)
1158 */ 1164 */
1159 (int nargs, Lisp_Object *args)) 1165 (int nargs, Lisp_Object *args))
1160 { 1166 {
1161 time_t the_time; 1167 time_t the_time;
1162 struct tm tm; 1168 struct tm tm;
1471 argument "array", since the only element of the array will 1477 argument "array", since the only element of the array will
1472 not be used after calling insert_emacs_char or insert_lisp_string, 1478 not be used after calling insert_emacs_char or insert_lisp_string,
1473 so we don't care if it gets trashed. */ 1479 so we don't care if it gets trashed. */
1474 1480
1475 DEFUN ("insert", Finsert, 0, MANY, 0, /* 1481 DEFUN ("insert", Finsert, 0, MANY, 0, /*
1476 Insert the arguments, either strings or characters, at point. 1482 Insert ARGS, either strings or characters, at point.
1477 Point moves forward so that it ends up after the inserted text. 1483 Point moves forward so that it ends up after the inserted text.
1478 Any other markers at the point of insertion remain before the text. 1484 Any other markers at the point of insertion remain before the text.
1479 If a string has non-null string-extent-data, new extents will be created. 1485 If a string has non-null string-extent-data, new extents will be created.
1486
1487 arguments: (&rest ARGS)
1480 */ 1488 */
1481 (int nargs, Lisp_Object *args)) 1489 (int nargs, Lisp_Object *args))
1482 { 1490 {
1483 /* This function can GC */ 1491 /* This function can GC */
1484 REGISTER int argnum; 1492 REGISTER int argnum;
1493 1501
1494 DEFUN ("insert-before-markers", Finsert_before_markers, 0, MANY, 0, /* 1502 DEFUN ("insert-before-markers", Finsert_before_markers, 0, MANY, 0, /*
1495 Insert strings or characters at point, relocating markers after the text. 1503 Insert strings or characters at point, relocating markers after the text.
1496 Point moves forward so that it ends up after the inserted text. 1504 Point moves forward so that it ends up after the inserted text.
1497 Any other markers at the point of insertion also end up after the text. 1505 Any other markers at the point of insertion also end up after the text.
1506
1507 arguments: (&rest ARGS)
1498 */ 1508 */
1499 (int nargs, Lisp_Object *args)) 1509 (int nargs, Lisp_Object *args))
1500 { 1510 {
1501 /* This function can GC */ 1511 /* This function can GC */
1502 REGISTER int argnum; 1512 REGISTER int argnum;
2137 widened and then made changes outside the old restricted area.) 2147 widened and then made changes outside the old restricted area.)
2138 2148
2139 Note: if you are using both `save-excursion' and `save-restriction', 2149 Note: if you are using both `save-excursion' and `save-restriction',
2140 use `save-excursion' outermost: 2150 use `save-excursion' outermost:
2141 (save-excursion (save-restriction ...)) 2151 (save-excursion (save-restriction ...))
2152
2153 arguments: (&rest BODY)
2142 */ 2154 */
2143 (body)) 2155 (body))
2144 { 2156 {
2145 /* This function can GC */ 2157 /* This function can GC */
2146 int speccount = 2158 int speccount =
2217 a decimal point is printed in %f, %e, and %E conversions even if no 2229 a decimal point is printed in %f, %e, and %E conversions even if no
2218 numbers are printed after it; and trailing zeroes are not omitted in 2230 numbers are printed after it; and trailing zeroes are not omitted in
2219 %g and %G conversions. 2231 %g and %G conversions.
2220 2232
2221 Use %% to put a single % into the output. 2233 Use %% to put a single % into the output.
2234
2235 arguments: (CONTROL-STRING &rest ARGS)
2222 */ 2236 */
2223 (int nargs, Lisp_Object *args)) 2237 (int nargs, Lisp_Object *args))
2224 { 2238 {
2225 /* It should not be necessary to GCPRO ARGS, because 2239 /* It should not be necessary to GCPRO ARGS, because
2226 the caller in the interpreter should take care of that. */ 2240 the caller in the interpreter should take care of that. */