diff options
Diffstat (limited to 'src/editfns.c')
| -rw-r--r-- | src/editfns.c | 41 |
1 files changed, 21 insertions, 20 deletions
diff --git a/src/editfns.c b/src/editfns.c index e7a01b24b76..130dffa77de 100644 --- a/src/editfns.c +++ b/src/editfns.c @@ -73,7 +73,7 @@ static int tm_diff P_ ((struct tm *, struct tm *)); static void find_field P_ ((Lisp_Object, Lisp_Object, Lisp_Object, int *, Lisp_Object, int *)); static void update_buffer_properties P_ ((int, int)); static Lisp_Object region_limit P_ ((int)); -static int lisp_time_argument P_ ((Lisp_Object, time_t *, int *)); +int lisp_time_argument P_ ((Lisp_Object, time_t *, int *)); static size_t emacs_memftimeu P_ ((char *, size_t, const char *, size_t, const struct tm *, int)); static void general_insert_function P_ ((void (*) (const unsigned char *, int), @@ -1213,7 +1213,7 @@ If POS is out of range, the value is nil. */) DEFUN ("user-login-name", Fuser_login_name, Suser_login_name, 0, 1, 0, doc: /* Return the name under which the user logged in, as a string. This is based on the effective uid, not the real uid. -Also, if the environment variable LOGNAME or USER is set, +Also, if the environment variables LOGNAME or USER are set, that determines the value of this function. If optional argument UID is an integer, return the login name of the user @@ -1372,7 +1372,7 @@ resolution finer than a second. */) } -static int +int lisp_time_argument (specified_time, result, usec) Lisp_Object specified_time; time_t *result; @@ -1425,7 +1425,7 @@ lisp_time_argument (specified_time, result, usec) DEFUN ("float-time", Ffloat_time, Sfloat_time, 0, 1, 0, doc: /* Return the current time, as a float number of seconds since the epoch. -If an argument is given, it specifies a time to convert to float +If SPECIFIED-TIME is given, it is the time to convert to float instead of the current time. The argument should have the forms: (HIGH . LOW) or (HIGH LOW USEC) or (HIGH LOW . USEC). Thus, you can use times obtained from `current-time' @@ -1655,7 +1655,7 @@ are used as SECOND through YEAR, and the *last* argument is used as ZONE. The intervening arguments are ignored. This feature lets (apply 'encode-time (decode-time ...)) work. -Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed; +Out-of-range values for SECOND, MINUTE, HOUR, DAY, or MONTH are allowed; for example, a DAY of 0 means the day preceding the given month. Year numbers less than 100 are treated just like other year numbers. If you want them to stand for years in this century, you must do that yourself. @@ -1740,8 +1740,8 @@ The format is `Sun Sep 16 01:03:52 1973'. However, see also the functions `decode-time' and `format-time-string' which provide a much more powerful and general facility. -If an argument is given, it specifies a time to format -instead of the current time. The argument should have the form: +If SPECIFIED-TIME is given, it is a time to format instead +of the current time. The argument should have the form: (HIGH . LOW) or the form: (HIGH LOW . IGNORED). @@ -1796,7 +1796,7 @@ This returns a list of the form (OFFSET NAME). OFFSET is an integer number of seconds ahead of UTC (east of Greenwich). A negative value means west of Greenwich. NAME is a string giving the name of the time zone. -If an argument is given, it specifies when the time zone offset is determined +If SPECIFIED-TIME is given, the time zone offset is determined from it instead of using the current time. The argument should have the form: (HIGH . LOW) or the form: @@ -2365,21 +2365,21 @@ of the buffer. */) DEFUN ("insert-buffer-substring", Finsert_buffer_substring, Sinsert_buffer_substring, 1, 3, 0, - doc: /* Insert before point a substring of the contents of buffer BUFFER. + doc: /* Insert before point a substring of the contents of BUFFER. BUFFER may be a buffer or a buffer name. -Arguments START and END are character numbers specifying the substring. -They default to the beginning and the end of BUFFER. */) - (buf, start, end) - Lisp_Object buf, start, end; +Arguments START and END are character positions specifying the substring. +They default to the values of (point-min) and (point-max) in BUFFER. */) + (buffer, start, end) + Lisp_Object buffer, start, end; { register int b, e, temp; register struct buffer *bp, *obuf; - Lisp_Object buffer; + Lisp_Object buf; - buffer = Fget_buffer (buf); - if (NILP (buffer)) - nsberror (buf); - bp = XBUFFER (buffer); + buf = Fget_buffer (buffer); + if (NILP (buf)) + nsberror (buffer); + bp = XBUFFER (buf); if (NILP (bp->name)) error ("Selecting deleted buffer"); @@ -2983,6 +2983,7 @@ It returns the number of characters changed. */) DEFUN ("delete-region", Fdelete_region, Sdelete_region, 2, 2, "r", doc: /* Delete the text between point and mark. + When called from a program, expects two arguments, positions (integers or markers) specifying the stretch to be deleted. */) (start, end) @@ -4043,11 +4044,11 @@ transpose_markers (start1, end1, start2, end2, } DEFUN ("transpose-regions", Ftranspose_regions, Stranspose_regions, 4, 5, 0, - doc: /* Transpose region START1 to END1 with START2 to END2. + doc: /* Transpose region STARTR1 to ENDR1 with STARTR2 to ENDR2. The regions may not be overlapping, because the size of the buffer is never changed in a transposition. -Optional fifth arg LEAVE_MARKERS, if non-nil, means don't update +Optional fifth arg LEAVE-MARKERS, if non-nil, means don't update any markers that happen to be located in the regions. Transposing beyond buffer boundaries is an error. */) |