Mercurial > hg > xemacs-beta
annotate src/editfns.c @ 4505:a5f1da0eb001
Document XFT support in the FAQ, better describe XEmacs pronunciation.
2008-08-31 Aidan Kehoe <kehoea@parhasard.net>
* xemacs-faq.texi (Q5.0.7): Add a section on how one can use
antialiased fonts under X11; thank you Giacomo Boffi.
(Q1.0.3): Clarify pronunciation using a serious phonetic
alphabet.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Sun, 31 Aug 2008 13:53:36 +0200 |
| parents | c76b1bc6bd28 |
| children | 80cd90837ac5 |
| rev | line source |
|---|---|
| 428 | 1 /* Lisp functions pertaining to editing. |
| 2 Copyright (C) 1985-1987, 1989, 1992-1995 Free Software Foundation, Inc. | |
| 3 Copyright (C) 1995 Tinker Systems and INS Engineering Corp. | |
| 2367 | 4 Copyright (C) 1996, 2001, 2002, 2004 Ben Wing. |
| 428 | 5 |
| 6 This file is part of XEmacs. | |
| 7 | |
| 8 XEmacs is free software; you can redistribute it and/or modify it | |
| 9 under the terms of the GNU General Public License as published by the | |
| 10 Free Software Foundation; either version 2, or (at your option) any | |
| 11 later version. | |
| 12 | |
| 13 XEmacs is distributed in the hope that it will be useful, but WITHOUT | |
| 14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 16 for more details. | |
| 17 | |
| 18 You should have received a copy of the GNU General Public License | |
| 19 along with XEmacs; see the file COPYING. If not, write to | |
| 20 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
| 21 Boston, MA 02111-1307, USA. */ | |
| 22 | |
| 23 /* Synched up with: Mule 2.0, FSF 19.30. */ | |
| 24 | |
| 771 | 25 /* This file has been Mule-ized, June 2001. */ |
| 428 | 26 |
| 27 /* Hacked on for Mule by Ben Wing, December 1994. */ | |
| 28 | |
| 29 #include <config.h> | |
| 30 #include "lisp.h" | |
| 31 | |
| 32 #include "buffer.h" | |
| 800 | 33 #include "casetab.h" |
| 34 #include "chartab.h" | |
| 877 | 35 #include "commands.h" /* for zmacs_region functions */ |
| 800 | 36 #include "device.h" |
| 428 | 37 #include "events.h" /* for EVENTP */ |
| 38 #include "frame.h" | |
| 39 #include "insdel.h" | |
| 800 | 40 #include "line-number.h" |
| 872 | 41 #include "process.h" |
| 428 | 42 #include "window.h" |
| 43 | |
| 800 | 44 #include "sysdep.h" |
| 45 #include "sysdir.h" | |
| 46 #include "sysfile.h" | |
| 47 #include "sysproc.h" /* for qxe_getpid() */ | |
| 48 #include "syspwd.h" | |
| 428 | 49 #include "systime.h" |
| 50 | |
| 51 /* Some static data, and a function to initialize it for each run */ | |
| 52 | |
| 53 Lisp_Object Vsystem_name; /* #### - I don't see why this should be */ | |
| 54 /* static, either... --Stig */ | |
| 55 #if 0 /* XEmacs - this is now dynamic */ | |
| 56 /* if at some point it's deemed desirable to | |
| 57 use lisp variables here, then they can be | |
| 58 initialized to nil and then set to their | |
| 59 real values upon the first call to the | |
| 60 functions that generate them. --stig */ | |
| 61 Lisp_Object Vuser_real_login_name; /* login name of current user ID */ | |
| 62 Lisp_Object Vuser_login_name; /* user name from LOGNAME or USER. */ | |
| 63 #endif | |
| 64 | |
| 65 /* It's useful to be able to set this as user customization, so we'll | |
| 66 keep it. */ | |
| 67 Lisp_Object Vuser_full_name; | |
| 68 EXFUN (Fuser_full_name, 1); | |
| 69 | |
| 70 Lisp_Object Qformat; | |
| 71 | |
| 72 Lisp_Object Qpoint, Qmark, Qregion_beginning, Qregion_end; | |
| 73 | |
| 74 Lisp_Object Quser_files_and_directories; | |
| 75 | |
| 76 /* This holds the value of `environ' produced by the previous | |
| 77 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule | |
| 78 has never been called. */ | |
| 771 | 79 static Extbyte **environbuf; |
| 428 | 80 |
| 81 void | |
| 82 init_editfns (void) | |
| 83 { | |
| 84 /* Only used in removed code below. */ | |
| 867 | 85 Ibyte *p; |
| 428 | 86 |
| 87 environbuf = 0; | |
| 88 | |
| 89 /* Set up system_name even when dumping. */ | |
| 90 init_system_name (); | |
| 91 | |
| 92 if (!initialized) | |
| 93 return; | |
| 94 | |
| 771 | 95 if ((p = egetenv ("NAME"))) |
| 428 | 96 /* I don't think it's the right thing to do the ampersand |
| 97 modification on NAME. Not that it matters anymore... -hniksic */ | |
| 771 | 98 Vuser_full_name = build_intstring (p); |
| 428 | 99 else |
| 100 Vuser_full_name = Fuser_full_name (Qnil); | |
| 101 } | |
| 102 | |
| 103 DEFUN ("char-to-string", Fchar_to_string, 1, 1, 0, /* | |
| 444 | 104 Convert CHARACTER to a one-character string containing that character. |
| 428 | 105 */ |
| 444 | 106 (character)) |
| 428 | 107 { |
| 108 Bytecount len; | |
| 867 | 109 Ibyte str[MAX_ICHAR_LEN]; |
| 428 | 110 |
| 444 | 111 if (EVENTP (character)) |
| 428 | 112 { |
| 2862 | 113 Lisp_Object ch2 = Fevent_to_character (character, Qt, Qnil, Qnil); |
| 428 | 114 if (NILP (ch2)) |
| 563 | 115 invalid_argument |
| 2828 | 116 ("key has no character equivalent:", Fcopy_event (character, Qnil)); |
| 444 | 117 character = ch2; |
| 428 | 118 } |
| 119 | |
| 444 | 120 CHECK_CHAR_COERCE_INT (character); |
| 428 | 121 |
| 867 | 122 len = set_itext_ichar (str, XCHAR (character)); |
| 428 | 123 return make_string (str, len); |
| 124 } | |
| 125 | |
| 126 DEFUN ("string-to-char", Fstring_to_char, 1, 1, 0, /* | |
| 127 Convert arg STRING to a character, the first character of that string. | |
| 128 An empty string will return the constant `nil'. | |
| 129 */ | |
| 444 | 130 (string)) |
| 428 | 131 { |
| 444 | 132 CHECK_STRING (string); |
| 428 | 133 |
| 793 | 134 if (XSTRING_LENGTH (string) != 0) |
| 867 | 135 return make_char (string_ichar (string, 0)); |
| 428 | 136 else |
| 137 /* This used to return Qzero. That is broken, broken, broken. */ | |
| 138 /* It might be kinder to signal an error directly. -slb */ | |
| 139 return Qnil; | |
| 140 } | |
| 141 | |
| 142 | |
| 143 static Lisp_Object | |
| 665 | 144 buildmark (Charbpos val, Lisp_Object buffer) |
| 428 | 145 { |
| 146 Lisp_Object mark = Fmake_marker (); | |
| 147 Fset_marker (mark, make_int (val), buffer); | |
| 148 return mark; | |
| 149 } | |
| 150 | |
| 151 DEFUN ("point", Fpoint, 0, 1, 0, /* | |
| 152 Return value of point, as an integer. | |
| 153 Beginning of buffer is position (point-min). | |
| 154 If BUFFER is nil, the current buffer is assumed. | |
| 155 */ | |
| 156 (buffer)) | |
| 157 { | |
| 158 struct buffer *b = decode_buffer (buffer, 1); | |
| 159 return make_int (BUF_PT (b)); | |
| 160 } | |
| 161 | |
| 162 DEFUN ("point-marker", Fpoint_marker, 0, 2, 0, /* | |
| 163 Return value of point, as a marker object. | |
| 164 This marker is a copy; you may modify it with reckless abandon. | |
| 165 If optional argument DONT-COPY-P is non-nil, then it returns the real | |
| 166 point-marker; modifying the position of this marker will move point. | |
| 167 It is illegal to change the buffer of it, or make it point nowhere. | |
| 168 If BUFFER is nil, the current buffer is assumed. | |
| 169 */ | |
| 170 (dont_copy_p, buffer)) | |
| 171 { | |
| 172 struct buffer *b = decode_buffer (buffer, 1); | |
| 173 if (NILP (dont_copy_p)) | |
| 174 return Fcopy_marker (b->point_marker, Qnil); | |
| 175 else | |
| 176 return b->point_marker; | |
| 177 } | |
| 178 | |
| 179 /* | |
| 180 * Chuck says: | |
| 181 * There is no absolute way to determine if goto-char is the function | |
| 182 * being run. this-command doesn't work because it is often eval'd | |
| 183 * and this-command ends up set to eval-expression. So this flag gets | |
| 184 * added for now. | |
| 185 * | |
| 186 * Jamie thinks he's wrong, but we'll leave this in for now. | |
| 187 */ | |
| 188 int atomic_extent_goto_char_p; | |
| 189 | |
| 190 DEFUN ("goto-char", Fgoto_char, 1, 2, "NGoto char: ", /* | |
| 191 Set point to POSITION, a number or marker. | |
| 192 Beginning of buffer is position (point-min), end is (point-max). | |
| 193 If BUFFER is nil, the current buffer is assumed. | |
| 194 Return value of POSITION, as an integer. | |
| 195 */ | |
| 196 (position, buffer)) | |
| 197 { | |
| 198 struct buffer *b = decode_buffer (buffer, 1); | |
| 665 | 199 Charbpos n = get_buffer_pos_char (b, position, GB_COERCE_RANGE); |
| 428 | 200 BUF_SET_PT (b, n); |
| 201 atomic_extent_goto_char_p = 1; | |
| 202 return make_int (n); | |
| 203 } | |
| 204 | |
| 205 static Lisp_Object | |
| 206 region_limit (int beginningp, struct buffer *b) | |
| 207 { | |
| 208 Lisp_Object m; | |
| 209 | |
| 210 #if 0 /* FSFmacs */ | |
| 211 if (!NILP (Vtransient_mark_mode) && NILP (Vmark_even_if_inactive) | |
| 212 && NILP (b->mark_active)) | |
| 213 Fsignal (Qmark_inactive, Qnil); | |
| 214 #endif | |
| 215 m = Fmarker_position (b->mark); | |
| 563 | 216 if (NILP (m)) invalid_operation ("There is no region now", Qunbound); |
| 428 | 217 if (!!(BUF_PT (b) < XINT (m)) == !!beginningp) |
| 218 return make_int (BUF_PT (b)); | |
| 219 else | |
| 220 return m; | |
| 221 } | |
| 222 | |
| 223 DEFUN ("region-beginning", Fregion_beginning, 0, 1, 0, /* | |
| 224 Return position of beginning of region in BUFFER, as an integer. | |
| 225 If BUFFER is nil, the current buffer is assumed. | |
| 226 */ | |
| 227 (buffer)) | |
| 228 { | |
| 229 return region_limit (1, decode_buffer (buffer, 1)); | |
| 230 } | |
| 231 | |
| 232 DEFUN ("region-end", Fregion_end, 0, 1, 0, /* | |
| 233 Return position of end of region in BUFFER, as an integer. | |
| 234 If BUFFER is nil, the current buffer is assumed. | |
| 235 */ | |
| 236 (buffer)) | |
| 237 { | |
| 238 return region_limit (0, decode_buffer (buffer, 1)); | |
| 239 } | |
| 240 | |
| 241 /* Whether to use lispm-style active-regions */ | |
| 242 int zmacs_regions; | |
| 243 | |
| 244 /* Whether the zmacs region is active. This is not per-buffer because | |
| 245 there can be only one active region at a time. #### Now that the | |
| 246 zmacs region are not directly tied to the X selections this may not | |
| 247 necessarily have to be true. */ | |
| 248 int zmacs_region_active_p; | |
| 249 | |
| 250 int zmacs_region_stays; | |
| 251 | |
| 252 Lisp_Object Qzmacs_update_region, Qzmacs_deactivate_region; | |
| 253 Lisp_Object Qzmacs_region_buffer; | |
| 254 | |
| 255 void | |
| 256 zmacs_update_region (void) | |
| 257 { | |
| 258 /* This function can GC */ | |
| 259 if (zmacs_region_active_p) | |
| 260 call0 (Qzmacs_update_region); | |
| 261 } | |
| 262 | |
| 263 void | |
| 264 zmacs_deactivate_region (void) | |
| 265 { | |
| 266 /* This function can GC */ | |
| 267 if (zmacs_region_active_p) | |
| 268 call0 (Qzmacs_deactivate_region); | |
| 269 } | |
| 270 | |
| 271 Lisp_Object | |
| 272 zmacs_region_buffer (void) | |
| 273 { | |
| 274 if (zmacs_region_active_p) | |
| 275 return call0 (Qzmacs_region_buffer); | |
| 276 else | |
| 277 return Qnil; | |
| 278 } | |
| 279 | |
| 280 DEFUN ("mark-marker", Fmark_marker, 0, 2, 0, /* | |
| 281 Return this buffer's mark, as a marker object. | |
| 282 If `zmacs-regions' is true, then this returns nil unless the region is | |
| 283 currently in the active (highlighted) state. If optional argument FORCE | |
| 284 is t, this returns the mark (if there is one) regardless of the zmacs-region | |
| 285 state. You should *generally* not use the mark unless the region is active, | |
| 286 if the user has expressed a preference for the zmacs-region model. | |
| 287 Watch out! Moving this marker changes the mark position. | |
| 288 If you set the marker not to point anywhere, the buffer will have no mark. | |
| 289 If BUFFER is nil, the current buffer is assumed. | |
| 290 */ | |
| 291 (force, buffer)) | |
| 292 { | |
| 293 struct buffer *b = decode_buffer (buffer, 1); | |
| 294 if (! zmacs_regions || zmacs_region_active_p || !NILP (force)) | |
| 295 return b->mark; | |
| 296 return Qnil; | |
| 297 } | |
| 298 | |
| 299 | |
| 300 /* The saved object is a cons: | |
| 301 | |
| 302 (COPY-OF-POINT-MARKER . COPY-OF-MARK) | |
| 303 | |
| 304 We used to have another cons for a VISIBLE-P element, which was t | |
| 305 if `(eq (current-buffer) (window-buffer (selected-window)))' but it | |
| 306 was unused for a long time, so I removed it. --hniksic */ | |
| 307 Lisp_Object | |
| 308 save_excursion_save (void) | |
| 309 { | |
| 310 struct buffer *b; | |
| 311 | |
| 853 | 312 /* There was once a check for preparing_for_armageddon here, which |
| 313 did nothing; perhaps a left-over from FSF Emacs. Obviously | |
| 314 incorrect. --ben */ | |
| 428 | 315 |
| 800 | 316 #ifdef ERROR_CHECK_TEXT |
| 428 | 317 assert (XINT (Fpoint (Qnil)) == |
| 318 XINT (Fmarker_position (Fpoint_marker (Qt, Qnil)))); | |
| 319 #endif | |
| 320 | |
| 321 b = current_buffer; | |
| 322 | |
| 323 return noseeum_cons (noseeum_copy_marker (b->point_marker, Qnil), | |
| 324 noseeum_copy_marker (b->mark, Qnil)); | |
| 325 } | |
| 326 | |
| 327 Lisp_Object | |
| 328 save_excursion_restore (Lisp_Object info) | |
| 329 { | |
| 330 Lisp_Object buffer = Fmarker_buffer (XCAR (info)); | |
| 331 | |
| 332 /* If buffer being returned to is now deleted, avoid error -- | |
| 333 otherwise could get error here while unwinding to top level and | |
| 334 crash. In that case, Fmarker_buffer returns nil now. */ | |
| 335 if (!NILP (buffer)) | |
| 336 { | |
| 337 struct buffer *buf = XBUFFER (buffer); | |
| 338 struct gcpro gcpro1; | |
| 339 GCPRO1 (info); | |
| 340 set_buffer_internal (buf); | |
| 341 Fgoto_char (XCAR (info), buffer); | |
| 342 Fset_marker (buf->mark, XCDR (info), buffer); | |
| 343 | |
| 344 #if 0 /* We used to make the current buffer visible in the selected window | |
| 345 if that was true previously. That avoids some anomalies. | |
| 346 But it creates others, and it wasn't documented, and it is simpler | |
| 347 and cleaner never to alter the window/buffer connections. */ | |
| 348 /* I'm certain some code somewhere depends on this behavior. --jwz */ | |
| 349 /* Even if it did, it certainly doesn't matter anymore, because | |
| 350 this has been the behavior for countless XEmacs releases | |
| 351 now. --hniksic */ | |
| 352 if (visible | |
| 353 && (current_buffer != XBUFFER (XWINDOW (selected_window)->buffer))) | |
| 354 switch_to_buffer (Fcurrent_buffer (), Qnil); | |
| 355 #endif | |
| 356 | |
| 357 UNGCPRO; | |
| 358 } | |
| 359 | |
| 360 /* Free all the junk we allocated, so that a `save-excursion' comes | |
| 361 for free in terms of GC junk. */ | |
| 1204 | 362 free_marker (XCAR (info)); |
| 363 free_marker (XCDR (info)); | |
| 853 | 364 free_cons (info); |
| 428 | 365 return Qnil; |
| 366 } | |
| 367 | |
| 368 DEFUN ("save-excursion", Fsave_excursion, 0, UNEVALLED, 0, /* | |
| 369 Save point, mark, and current buffer; execute BODY; restore those things. | |
| 370 Executes BODY just like `progn'. | |
| 371 The values of point, mark and the current buffer are restored | |
| 372 even in case of abnormal exit (throw or error). | |
| 373 */ | |
| 374 (args)) | |
| 375 { | |
| 376 /* This function can GC */ | |
| 377 int speccount = specpdl_depth (); | |
| 378 | |
| 379 record_unwind_protect (save_excursion_restore, save_excursion_save ()); | |
| 380 | |
| 771 | 381 return unbind_to_1 (speccount, Fprogn (args)); |
| 428 | 382 } |
| 383 | |
| 384 Lisp_Object | |
| 385 save_current_buffer_restore (Lisp_Object buffer) | |
| 386 { | |
| 387 struct buffer *buf = XBUFFER (buffer); | |
| 388 /* Avoid signaling an error if the buffer is no longer alive. This | |
| 389 is for consistency with save-excursion. */ | |
| 390 if (BUFFER_LIVE_P (buf)) | |
| 391 set_buffer_internal (buf); | |
| 392 return Qnil; | |
| 393 } | |
| 394 | |
| 395 DEFUN ("save-current-buffer", Fsave_current_buffer, 0, UNEVALLED, 0, /* | |
| 396 Save the current buffer; execute BODY; restore the current buffer. | |
| 397 Executes BODY just like `progn'. | |
| 398 */ | |
| 399 (args)) | |
| 400 { | |
| 401 /* This function can GC */ | |
| 402 int speccount = specpdl_depth (); | |
| 403 | |
| 404 record_unwind_protect (save_current_buffer_restore, Fcurrent_buffer ()); | |
| 405 | |
| 771 | 406 return unbind_to_1 (speccount, Fprogn (args)); |
| 428 | 407 } |
| 408 | |
| 409 DEFUN ("buffer-size", Fbuffer_size, 0, 1, 0, /* | |
| 410 Return the number of characters in BUFFER. | |
| 411 If BUFFER is nil, the current buffer is assumed. | |
| 412 */ | |
| 413 (buffer)) | |
| 414 { | |
| 415 struct buffer *b = decode_buffer (buffer, 1); | |
| 416 return make_int (BUF_SIZE (b)); | |
| 417 } | |
| 418 | |
| 419 DEFUN ("point-min", Fpoint_min, 0, 1, 0, /* | |
| 420 Return the minimum permissible value of point in BUFFER. | |
| 434 | 421 This is 1, unless narrowing (a buffer restriction) |
| 422 is in effect, in which case it may be greater. | |
| 428 | 423 If BUFFER is nil, the current buffer is assumed. |
| 424 */ | |
| 425 (buffer)) | |
| 426 { | |
| 427 struct buffer *b = decode_buffer (buffer, 1); | |
| 428 return make_int (BUF_BEGV (b)); | |
| 429 } | |
| 430 | |
| 431 DEFUN ("point-min-marker", Fpoint_min_marker, 0, 1, 0, /* | |
| 432 Return a marker to the minimum permissible value of point in BUFFER. | |
| 434 | 433 This is the beginning, unless narrowing (a buffer restriction) |
| 434 is in effect, in which case it may be greater. | |
| 428 | 435 If BUFFER is nil, the current buffer is assumed. |
| 436 */ | |
| 437 (buffer)) | |
| 438 { | |
| 439 struct buffer *b = decode_buffer (buffer, 1); | |
| 771 | 440 return buildmark (BUF_BEGV (b), wrap_buffer (b)); |
| 428 | 441 } |
| 442 | |
| 443 DEFUN ("point-max", Fpoint_max, 0, 1, 0, /* | |
| 444 Return the maximum permissible value of point in BUFFER. | |
| 445 This is (1+ (buffer-size)), unless narrowing (a buffer restriction) | |
| 434 | 446 is in effect, in which case it may be less. |
| 428 | 447 If BUFFER is nil, the current buffer is assumed. |
| 448 */ | |
| 449 (buffer)) | |
| 450 { | |
| 451 struct buffer *b = decode_buffer (buffer, 1); | |
| 452 return make_int (BUF_ZV (b)); | |
| 453 } | |
| 454 | |
| 455 DEFUN ("point-max-marker", Fpoint_max_marker, 0, 1, 0, /* | |
| 434 | 456 Return a marker to the maximum permissible value of point in BUFFER. |
| 428 | 457 This is (1+ (buffer-size)), unless narrowing (a buffer restriction) |
| 434 | 458 is in effect, in which case it may be less. |
| 428 | 459 If BUFFER is nil, the current buffer is assumed. |
| 460 */ | |
| 461 (buffer)) | |
| 462 { | |
| 463 struct buffer *b = decode_buffer (buffer, 1); | |
| 771 | 464 return buildmark (BUF_ZV (b), wrap_buffer (b)); |
| 428 | 465 } |
| 466 | |
| 467 DEFUN ("following-char", Ffollowing_char, 0, 1, 0, /* | |
| 468 Return the character following point. | |
| 469 At the end of the buffer or accessible region, return 0. | |
| 470 If BUFFER is nil, the current buffer is assumed. | |
| 471 */ | |
| 472 (buffer)) | |
| 473 { | |
| 474 struct buffer *b = decode_buffer (buffer, 1); | |
| 475 if (BUF_PT (b) >= BUF_ZV (b)) | |
| 476 return Qzero; /* #### Gag me! */ | |
| 477 else | |
| 478 return make_char (BUF_FETCH_CHAR (b, BUF_PT (b))); | |
| 479 } | |
| 480 | |
| 481 DEFUN ("preceding-char", Fpreceding_char, 0, 1, 0, /* | |
| 482 Return the character preceding point. | |
| 483 At the beginning of the buffer or accessible region, return 0. | |
| 484 If BUFFER is nil, the current buffer is assumed. | |
| 485 */ | |
| 486 (buffer)) | |
| 487 { | |
| 488 struct buffer *b = decode_buffer (buffer, 1); | |
| 489 if (BUF_PT (b) <= BUF_BEGV (b)) | |
| 490 return Qzero; /* #### Gag me! */ | |
| 491 else | |
| 492 return make_char (BUF_FETCH_CHAR (b, BUF_PT (b) - 1)); | |
| 493 } | |
| 494 | |
| 495 DEFUN ("bobp", Fbobp, 0, 1, 0, /* | |
| 496 Return t if point is at the beginning of the buffer. | |
| 497 If the buffer is narrowed, this means the beginning of the narrowed part. | |
| 498 If BUFFER is nil, the current buffer is assumed. | |
| 499 */ | |
| 500 (buffer)) | |
| 501 { | |
| 502 struct buffer *b = decode_buffer (buffer, 1); | |
| 503 return BUF_PT (b) == BUF_BEGV (b) ? Qt : Qnil; | |
| 504 } | |
| 505 | |
| 506 DEFUN ("eobp", Feobp, 0, 1, 0, /* | |
| 507 Return t if point is at the end of the buffer. | |
| 508 If the buffer is narrowed, this means the end of the narrowed part. | |
| 509 If BUFFER is nil, the current buffer is assumed. | |
| 510 */ | |
| 511 (buffer)) | |
| 512 { | |
| 513 struct buffer *b = decode_buffer (buffer, 1); | |
| 514 return BUF_PT (b) == BUF_ZV (b) ? Qt : Qnil; | |
| 515 } | |
| 516 | |
| 517 int | |
| 665 | 518 beginning_of_line_p (struct buffer *b, Charbpos pt) |
| 428 | 519 { |
| 520 return pt <= BUF_BEGV (b) || BUF_FETCH_CHAR (b, pt - 1) == '\n'; | |
| 521 } | |
| 522 | |
| 523 | |
| 524 DEFUN ("bolp", Fbolp, 0, 1, 0, /* | |
| 525 Return t if point is at the beginning of a line. | |
| 526 If BUFFER is nil, the current buffer is assumed. | |
| 527 */ | |
| 528 (buffer)) | |
| 529 { | |
| 530 struct buffer *b = decode_buffer (buffer, 1); | |
| 531 return beginning_of_line_p (b, BUF_PT (b)) ? Qt : Qnil; | |
| 532 } | |
| 533 | |
| 534 DEFUN ("eolp", Feolp, 0, 1, 0, /* | |
| 535 Return t if point is at the end of a line. | |
| 536 `End of a line' includes point being at the end of the buffer. | |
| 537 If BUFFER is nil, the current buffer is assumed. | |
| 538 */ | |
| 539 (buffer)) | |
| 540 { | |
| 541 struct buffer *b = decode_buffer (buffer, 1); | |
| 542 return (BUF_PT (b) == BUF_ZV (b) || BUF_FETCH_CHAR (b, BUF_PT (b)) == '\n') | |
| 543 ? Qt : Qnil; | |
| 544 } | |
| 545 | |
| 546 DEFUN ("char-after", Fchar_after, 0, 2, 0, /* | |
| 434 | 547 Return the character at position POS in BUFFER. |
| 548 POS is an integer or a marker. | |
| 428 | 549 If POS is out of range, the value is nil. |
| 434 | 550 if POS is nil, the value of point is assumed. |
| 428 | 551 If BUFFER is nil, the current buffer is assumed. |
| 552 */ | |
| 553 (pos, buffer)) | |
| 554 { | |
| 555 struct buffer *b = decode_buffer (buffer, 1); | |
| 665 | 556 Charbpos n = (NILP (pos) ? BUF_PT (b) : |
| 428 | 557 get_buffer_pos_char (b, pos, GB_NO_ERROR_IF_BAD)); |
| 558 | |
| 559 if (n < 0 || n == BUF_ZV (b)) | |
| 560 return Qnil; | |
| 561 return make_char (BUF_FETCH_CHAR (b, n)); | |
| 562 } | |
| 563 | |
| 564 DEFUN ("char-before", Fchar_before, 0, 2, 0, /* | |
| 434 | 565 Return the character preceding position POS in BUFFER. |
| 566 POS is an integer or a marker. | |
| 428 | 567 If POS is out of range, the value is nil. |
| 434 | 568 if POS is nil, the value of point is assumed. |
| 428 | 569 If BUFFER is nil, the current buffer is assumed. |
| 570 */ | |
| 571 (pos, buffer)) | |
| 572 { | |
| 573 struct buffer *b = decode_buffer (buffer, 1); | |
| 665 | 574 Charbpos n = (NILP (pos) ? BUF_PT (b) : |
| 434 | 575 get_buffer_pos_char (b, pos, GB_NO_ERROR_IF_BAD)); |
| 428 | 576 |
| 577 n--; | |
| 578 | |
| 579 if (n < BUF_BEGV (b)) | |
| 580 return Qnil; | |
| 581 return make_char (BUF_FETCH_CHAR (b, n)); | |
| 582 } | |
| 583 | |
| 584 | |
| 585 DEFUN ("temp-directory", Ftemp_directory, 0, 0, 0, /* | |
| 586 Return the pathname to the directory to use for temporary files. | |
| 442 | 587 On MS Windows, this is obtained from the TEMP or TMP environment variables, |
| 771 | 588 defaulting to c:\\ if they are both undefined. |
| 444 | 589 On Unix it is obtained from TMPDIR, with /tmp as the default. |
| 428 | 590 */ |
| 591 ()) | |
| 592 { | |
| 867 | 593 Ibyte *tmpdir; |
| 442 | 594 #if defined(WIN32_NATIVE) |
| 771 | 595 tmpdir = egetenv ("TEMP"); |
| 428 | 596 if (!tmpdir) |
| 771 | 597 tmpdir = egetenv ("TMP"); |
| 428 | 598 if (!tmpdir) |
| 867 | 599 tmpdir = (Ibyte *) "c:\\"; |
| 442 | 600 #else /* WIN32_NATIVE */ |
| 771 | 601 tmpdir = egetenv ("TMPDIR"); |
| 428 | 602 if (!tmpdir) |
| 442 | 603 { |
| 604 struct stat st; | |
| 771 | 605 int myuid = getuid (); |
| 867 | 606 Ibyte *login_name = user_login_name (NULL); |
| 771 | 607 DECLARE_EISTRING (eipath); |
| 867 | 608 Ibyte *path; |
| 442 | 609 |
| 2421 | 610 eicpy_ascii (eipath, "/tmp/"); |
| 771 | 611 eicat_rawz (eipath, login_name); |
| 612 path = eidata (eipath); | |
| 613 if (qxe_lstat (path, &st) < 0 && errno == ENOENT) | |
| 614 qxe_mkdir (path, 0700); /* ignore retval -- checked next anyway. */ | |
| 615 if (qxe_lstat (path, &st) == 0 && (int) st.st_uid == myuid | |
| 616 && S_ISDIR (st.st_mode)) | |
| 617 tmpdir = path; | |
| 442 | 618 else |
| 619 { | |
| 771 | 620 eicpy_rawz (eipath, egetenv ("HOME")); |
| 2421 | 621 eicat_ascii (eipath, "/tmp/"); |
| 771 | 622 path = eidata (eipath); |
| 623 if (qxe_stat (path, &st) < 0 && errno == ENOENT) | |
| 442 | 624 { |
| 625 int fd; | |
| 771 | 626 DECLARE_EISTRING (eiwarnpath); |
| 627 | |
| 628 qxe_mkdir (path, 0700); /* ignore retvals */ | |
| 629 eicpy_ei (eiwarnpath, eipath); | |
| 2421 | 630 eicat_ascii (eiwarnpath, ".created_by_xemacs"); |
| 771 | 631 if ((fd = qxe_open (eidata (eiwarnpath), |
| 632 O_WRONLY | O_CREAT, 0644)) > 0) | |
| 442 | 633 { |
| 771 | 634 retry_write (fd, "XEmacs created this directory because " |
| 635 "/tmp/<yourname> was unavailable -- \n" | |
| 636 "Please check !\n", 89); | |
| 637 retry_close (fd); | |
| 442 | 638 } |
| 639 } | |
| 771 | 640 if (qxe_stat (path, &st) == 0 && S_ISDIR (st.st_mode)) |
| 641 tmpdir = path; | |
| 442 | 642 else |
| 867 | 643 tmpdir = (Ibyte *) "/tmp"; |
| 442 | 644 } |
| 645 } | |
| 428 | 646 #endif |
| 647 | |
| 771 | 648 return build_intstring (tmpdir); |
| 428 | 649 } |
| 650 | |
| 651 DEFUN ("user-login-name", Fuser_login_name, 0, 1, 0, /* | |
| 652 Return the name under which the user logged in, as a string. | |
| 653 This is based on the effective uid, not the real uid. | |
| 654 Also, if the environment variable LOGNAME or USER is set, | |
| 655 that determines the value of this function. | |
| 656 If the optional argument UID is present, then environment variables are | |
| 657 ignored and this function returns the login name for that UID, or nil. | |
| 658 */ | |
| 659 (uid)) | |
| 660 { | |
| 867 | 661 Ibyte *returned_name; |
| 428 | 662 uid_t local_uid; |
| 663 | |
| 664 if (!NILP (uid)) | |
| 665 { | |
| 666 CHECK_INT (uid); | |
| 667 local_uid = XINT (uid); | |
| 668 returned_name = user_login_name (&local_uid); | |
| 669 } | |
| 670 else | |
| 671 { | |
| 672 returned_name = user_login_name (NULL); | |
| 673 } | |
| 674 /* #### - I believe this should return nil instead of "unknown" when pw==0 | |
| 675 pw=0 is indicated by a null return from user_login_name | |
| 676 */ | |
| 771 | 677 return returned_name ? build_intstring (returned_name) : Qnil; |
| 428 | 678 } |
| 679 | |
| 680 /* This function may be called from other C routines when a | |
| 681 character string representation of the user_login_name is | |
| 682 needed but a Lisp Object is not. The UID is passed by | |
| 683 reference. If UID == NULL, then the USER name | |
| 684 for the user running XEmacs will be returned. This | |
| 685 corresponds to a nil argument to Fuser_login_name. | |
| 771 | 686 |
| 793 | 687 WARNING: The string returned comes from the data of a Lisp string and |
| 771 | 688 therefore will become garbage after the next GC. |
| 428 | 689 */ |
| 867 | 690 Ibyte * |
| 428 | 691 user_login_name (uid_t *uid) |
| 692 { | |
| 693 /* uid == NULL to return name of this user */ | |
| 694 if (uid != NULL) | |
| 695 { | |
| 771 | 696 struct passwd *pw = qxe_getpwuid (*uid); |
| 867 | 697 return pw ? (Ibyte *) pw->pw_name : NULL; |
| 428 | 698 } |
| 699 else | |
| 700 { | |
| 701 /* #### - when euid != uid, then LOGNAME and USER are leftovers from the | |
| 702 old environment (I site observed behavior on sunos and linux), so the | |
| 703 environment variables should be disregarded in that case. --Stig */ | |
| 867 | 704 Ibyte *user_name = egetenv ("LOGNAME"); |
| 428 | 705 if (!user_name) |
| 771 | 706 user_name = egetenv ( |
| 442 | 707 #ifdef WIN32_NATIVE |
| 428 | 708 "USERNAME" /* it's USERNAME on NT */ |
| 709 #else | |
| 710 "USER" | |
| 711 #endif | |
| 712 ); | |
| 713 if (user_name) | |
| 771 | 714 return user_name; |
| 428 | 715 else |
| 716 { | |
| 771 | 717 struct passwd *pw = qxe_getpwuid (geteuid ()); |
| 442 | 718 #ifdef CYGWIN |
| 428 | 719 /* Since the Cygwin environment may not have an /etc/passwd, |
| 720 return "unknown" instead of the null if the username | |
| 721 cannot be determined. | |
| 722 */ | |
| 593 | 723 /* !!#### fix up in my mule ws */ |
| 867 | 724 return (Ibyte *) (pw ? pw->pw_name : "unknown"); |
| 428 | 725 #else |
| 726 /* For all but Cygwin return NULL (nil) */ | |
| 1204 | 727 return pw ? (Ibyte *) pw->pw_name : NULL; |
| 428 | 728 #endif |
| 729 } | |
| 730 } | |
| 731 } | |
| 732 | |
| 733 DEFUN ("user-real-login-name", Fuser_real_login_name, 0, 0, 0, /* | |
| 734 Return the name of the user's real uid, as a string. | |
| 735 This ignores the environment variables LOGNAME and USER, so it differs from | |
| 736 `user-login-name' when running under `su'. | |
| 737 */ | |
| 738 ()) | |
| 739 { | |
| 771 | 740 struct passwd *pw = qxe_getpwuid (getuid ()); |
| 428 | 741 /* #### - I believe this should return nil instead of "unknown" when pw==0 */ |
| 742 | |
| 793 | 743 return build_string (pw ? pw->pw_name : "unknown"); |
| 428 | 744 } |
| 745 | |
| 746 DEFUN ("user-uid", Fuser_uid, 0, 0, 0, /* | |
| 747 Return the effective uid of Emacs, as an integer. | |
| 748 */ | |
| 749 ()) | |
| 750 { | |
| 751 return make_int (geteuid ()); | |
| 752 } | |
| 753 | |
| 754 DEFUN ("user-real-uid", Fuser_real_uid, 0, 0, 0, /* | |
| 755 Return the real uid of Emacs, as an integer. | |
| 756 */ | |
| 757 ()) | |
| 758 { | |
| 759 return make_int (getuid ()); | |
| 760 } | |
| 761 | |
| 762 DEFUN ("user-full-name", Fuser_full_name, 0, 1, 0, /* | |
| 763 Return the full name of the user logged in, as a string. | |
| 764 If the optional argument USER is given, then the full name for that | |
| 765 user is returned, or nil. USER may be either a login name or a uid. | |
| 766 | |
| 767 If USER is nil, and `user-full-name' contains a string, the | |
| 768 value of `user-full-name' is returned. | |
| 769 */ | |
| 770 (user)) | |
| 771 { | |
| 772 Lisp_Object user_name; | |
| 773 struct passwd *pw = NULL; | |
| 774 Lisp_Object tem; | |
| 867 | 775 const Ibyte *p, *q; |
| 428 | 776 |
| 777 if (NILP (user) && STRINGP (Vuser_full_name)) | |
| 778 return Vuser_full_name; | |
| 779 | |
| 780 user_name = (STRINGP (user) ? user : Fuser_login_name (user)); | |
| 781 if (!NILP (user_name)) /* nil when nonexistent UID passed as arg */ | |
| 782 { | |
| 783 /* Fuck me. getpwnam() can call select() and (under IRIX at least) | |
| 784 things get wedged if a SIGIO arrives during this time. */ | |
| 785 slow_down_interrupts (); | |
| 771 | 786 pw = qxe_getpwnam (XSTRING_DATA (user_name)); |
| 428 | 787 speed_up_interrupts (); |
| 788 } | |
| 789 | |
| 790 /* #### - Stig sez: this should return nil instead of "unknown" when pw==0 */ | |
| 791 /* Ben sez: bad idea because it's likely to break something */ | |
| 792 #ifndef AMPERSAND_FULL_NAME | |
| 867 | 793 p = (Ibyte *) (pw ? USER_FULL_NAME : "unknown"); /* don't gettext */ |
| 771 | 794 q = qxestrchr (p, ','); |
| 428 | 795 #else |
| 867 | 796 p = (Ibyte *) (pw ? USER_FULL_NAME : "unknown"); /* don't gettext */ |
| 771 | 797 q = qxestrchr (p, ','); |
| 428 | 798 #endif |
| 799 tem = ((!NILP (user) && !pw) | |
| 800 ? Qnil | |
| 814 | 801 : make_string (p, (q ? (Bytecount) (q - p) : qxestrlen (p)))); |
| 428 | 802 |
| 803 #ifdef AMPERSAND_FULL_NAME | |
| 804 if (!NILP (tem)) | |
| 805 { | |
| 771 | 806 p = XSTRING_DATA (tem); |
| 807 q = qxestrchr (p, '&'); | |
| 428 | 808 /* Substitute the login name for the &, upcasing the first character. */ |
| 809 if (q) | |
| 810 { | |
| 771 | 811 DECLARE_EISTRING (r); |
| 812 eicpy_raw (r, p, q - p); | |
| 813 eicat_lstr (r, user_name); | |
| 814 eisetch (r, q - p, UPCASE (0, eigetch (r, q - p))); | |
| 815 eicat_rawz (r, q + 1); | |
| 816 tem = eimake_string (r); | |
| 428 | 817 } |
| 818 } | |
| 819 #endif /* AMPERSAND_FULL_NAME */ | |
| 820 | |
| 821 return tem; | |
| 822 } | |
| 823 | |
| 867 | 824 static Ibyte *cached_home_directory; |
| 428 | 825 |
| 826 void | |
| 827 uncache_home_directory (void) | |
| 828 { | |
| 771 | 829 if (cached_home_directory) |
| 1726 | 830 xfree (cached_home_directory, Ibyte *); |
| 771 | 831 cached_home_directory = NULL; |
| 428 | 832 } |
| 833 | |
| 771 | 834 /* Returns the home directory */ |
| 867 | 835 Ibyte * |
| 428 | 836 get_home_directory (void) |
| 837 { | |
| 838 int output_home_warning = 0; | |
| 839 | |
| 840 if (cached_home_directory == NULL) | |
| 841 { | |
| 771 | 842 cached_home_directory = egetenv ("HOME"); |
| 843 if (cached_home_directory) | |
| 844 cached_home_directory = qxestrdup (cached_home_directory); | |
| 845 else | |
| 428 | 846 { |
| 771 | 847 #if defined (WIN32_NATIVE) |
| 867 | 848 Ibyte *homedrive, *homepath; |
| 428 | 849 |
| 771 | 850 if ((homedrive = egetenv ("HOMEDRIVE")) != NULL && |
| 851 (homepath = egetenv ("HOMEPATH")) != NULL) | |
| 428 | 852 { |
| 853 cached_home_directory = | |
| 2367 | 854 xnew_ibytes (qxestrlen (homedrive) + qxestrlen (homepath) + |
| 855 ITEXT_ZTERM_SIZE); | |
| 771 | 856 qxesprintf (cached_home_directory, "%s%s", |
| 857 homedrive, | |
| 858 homepath); | |
| 428 | 859 } |
| 860 else | |
| 861 { | |
| 867 | 862 cached_home_directory = qxestrdup ((Ibyte *) "C:\\"); |
| 428 | 863 output_home_warning = 1; |
| 864 } | |
| 442 | 865 #else /* !WIN32_NATIVE */ |
| 428 | 866 /* |
| 867 * Unix, typically. | |
| 868 * Using "/" isn't quite right, but what should we do? | |
| 869 * We probably should try to extract pw_dir from /etc/passwd, | |
| 870 * before falling back to this. | |
| 871 */ | |
| 867 | 872 cached_home_directory = qxestrdup ((Ibyte *) "/"); |
| 428 | 873 output_home_warning = 1; |
| 442 | 874 #endif /* !WIN32_NATIVE */ |
| 428 | 875 } |
| 876 if (initialized && output_home_warning) | |
| 877 { | |
| 878 warn_when_safe (Quser_files_and_directories, Qwarning, "\n" | |
| 879 " XEmacs was unable to determine a good value for the user's $HOME\n" | |
| 880 " directory, and will be using the value:\n" | |
| 881 " %s\n" | |
| 882 " This is probably incorrect.", | |
| 883 cached_home_directory | |
| 884 ); | |
| 885 } | |
| 886 } | |
| 887 return cached_home_directory; | |
| 888 } | |
| 889 | |
| 890 DEFUN ("user-home-directory", Fuser_home_directory, 0, 0, 0, /* | |
| 891 Return the user's home directory, as a string. | |
| 892 */ | |
| 893 ()) | |
| 894 { | |
| 867 | 895 Ibyte *path = get_home_directory (); |
| 428 | 896 |
| 771 | 897 return !path ? Qnil : |
| 898 Fexpand_file_name (Fsubstitute_in_file_name (build_intstring (path)), | |
| 428 | 899 Qnil); |
| 900 } | |
| 901 | |
| 902 DEFUN ("system-name", Fsystem_name, 0, 0, 0, /* | |
| 903 Return the name of the machine you are running on, as a string. | |
| 904 */ | |
| 905 ()) | |
| 906 { | |
| 771 | 907 return Fcopy_sequence (Vsystem_name); |
| 428 | 908 } |
| 909 | |
| 910 DEFUN ("emacs-pid", Femacs_pid, 0, 0, 0, /* | |
| 911 Return the process ID of Emacs, as an integer. | |
| 912 */ | |
| 913 ()) | |
| 914 { | |
| 771 | 915 return make_int (qxe_getpid ()); |
| 428 | 916 } |
| 917 | |
| 918 DEFUN ("current-time", Fcurrent_time, 0, 0, 0, /* | |
| 919 Return the current time, as the number of seconds since 1970-01-01 00:00:00. | |
| 920 The time is returned as a list of three integers. The first has the | |
| 921 most significant 16 bits of the seconds, while the second has the | |
| 922 least significant 16 bits. The third integer gives the microsecond | |
| 923 count. | |
| 924 | |
| 925 The microsecond count is zero on systems that do not provide | |
| 926 resolution finer than a second. | |
| 927 */ | |
| 928 ()) | |
| 929 { | |
| 930 EMACS_TIME t; | |
| 931 | |
| 932 EMACS_GET_TIME (t); | |
| 933 return list3 (make_int ((EMACS_SECS (t) >> 16) & 0xffff), | |
| 934 make_int ((EMACS_SECS (t) >> 0) & 0xffff), | |
| 935 make_int (EMACS_USECS (t))); | |
| 936 } | |
| 937 | |
| 938 DEFUN ("current-process-time", Fcurrent_process_time, 0, 0, 0, /* | |
| 939 Return the amount of time used by this XEmacs process so far. | |
| 940 The return value is a list of three floating-point numbers, expressing | |
| 941 the user, system, and real times used by the process. The user time | |
| 942 measures the time actually spent by the CPU executing the code in this | |
| 943 process. The system time measures time spent by the CPU executing kernel | |
| 944 code on behalf of this process (e.g. I/O requests made by the process). | |
| 945 | |
| 946 Note that the user and system times measure processor time, as opposed | |
| 947 to real time, and only accrue when the processor is actually doing | |
| 948 something: Time spent in an idle wait (waiting for user events to come | |
| 949 in or for I/O on a disk drive or other device to complete) does not | |
| 950 count. Thus, the user and system times will often be considerably | |
| 951 less than the real time. | |
| 952 | |
| 953 Some systems do not allow the user and system times to be distinguished. | |
| 954 In this case, the user time will be the total processor time used by | |
| 955 the process, and the system time will be 0. | |
| 956 | |
| 957 Some systems do not allow the real and processor times to be distinguished. | |
| 958 In this case, the user and real times will be the same and the system | |
| 959 time will be 0. | |
| 960 */ | |
| 961 ()) | |
| 962 { | |
| 963 double user, sys, real; | |
| 964 | |
| 965 get_process_times (&user, &sys, &real); | |
| 966 return list3 (make_float (user), make_float (sys), make_float (real)); | |
| 967 } | |
| 968 | |
| 969 | |
| 970 int lisp_to_time (Lisp_Object specified_time, time_t *result); | |
| 971 int | |
| 972 lisp_to_time (Lisp_Object specified_time, time_t *result) | |
| 973 { | |
| 974 Lisp_Object high, low; | |
| 975 | |
| 976 if (NILP (specified_time)) | |
| 977 return time (result) != -1; | |
| 978 | |
| 979 CHECK_CONS (specified_time); | |
| 980 high = XCAR (specified_time); | |
| 981 low = XCDR (specified_time); | |
| 982 if (CONSP (low)) | |
| 983 low = XCAR (low); | |
| 984 CHECK_INT (high); | |
| 985 CHECK_INT (low); | |
| 986 *result = (XINT (high) << 16) + (XINT (low) & 0xffff); | |
| 987 return *result >> 16 == XINT (high); | |
| 988 } | |
| 989 | |
| 990 Lisp_Object time_to_lisp (time_t the_time); | |
| 991 Lisp_Object | |
| 992 time_to_lisp (time_t the_time) | |
| 993 { | |
| 994 unsigned int item = (unsigned int) the_time; | |
| 995 return Fcons (make_int (item >> 16), make_int (item & 0xffff)); | |
| 996 } | |
| 997 | |
| 771 | 998 size_t emacs_strftime (Extbyte *string, size_t max, const Extbyte *format, |
| 442 | 999 const struct tm *tm); |
| 1000 static long difftm (const struct tm *a, const struct tm *b); | |
| 428 | 1001 |
| 1002 | |
| 1003 DEFUN ("format-time-string", Fformat_time_string, 1, 2, 0, /* | |
| 1004 Use FORMAT-STRING to format the time TIME. | |
| 1005 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as from | |
| 1006 `current-time' and `file-attributes'. If TIME is not specified it | |
| 1007 defaults to the current time. | |
| 1008 FORMAT-STRING may contain %-sequences to substitute parts of the time. | |
| 1009 %a is replaced by the abbreviated name of the day of week. | |
| 1010 %A is replaced by the full name of the day of week. | |
| 1011 %b is replaced by the abbreviated name of the month. | |
| 1012 %B is replaced by the full name of the month. | |
| 1013 %c is a synonym for "%x %X". | |
| 1014 %C is a locale-specific synonym, which defaults to "%A, %B %e, %Y" in the C locale. | |
| 1015 %d is replaced by the day of month, zero-padded. | |
| 1016 %D is a synonym for "%m/%d/%y". | |
| 1017 %e is replaced by the day of month, blank-padded. | |
| 4203 | 1018 %G is replaced by the year containing the ISO 8601 week |
| 1019 %g is replaced by the year of the ISO 8601 week within the century (00-99) | |
| 428 | 1020 %h is a synonym for "%b". |
| 1021 %H is replaced by the hour (00-23). | |
| 1022 %I is replaced by the hour (00-12). | |
| 1023 %j is replaced by the day of the year (001-366). | |
| 1024 %k is replaced by the hour (0-23), blank padded. | |
| 1025 %l is replaced by the hour (1-12), blank padded. | |
| 1026 %m is replaced by the month (01-12). | |
| 1027 %M is replaced by the minute (00-59). | |
| 1028 %n is a synonym for "\\n". | |
| 1029 %p is replaced by AM or PM, as appropriate. | |
| 1030 %r is a synonym for "%I:%M:%S %p". | |
| 1031 %R is a synonym for "%H:%M". | |
| 1032 %s is replaced by the time in seconds since 00:00:00, Jan 1, 1970 (a | |
| 1033 nonstandard extension) | |
| 1034 %S is replaced by the second (00-60). | |
| 1035 %t is a synonym for "\\t". | |
| 1036 %T is a synonym for "%H:%M:%S". | |
| 1037 %U is replaced by the week of the year (00-53), first day of week is Sunday. | |
| 4203 | 1038 %V is replaced by the ISO 8601 week number |
| 428 | 1039 %w is replaced by the day of week (0-6), Sunday is day 0. |
| 1040 %W is replaced by the week of the year (00-53), first day of week is Monday. | |
| 1041 %x is a locale-specific synonym, which defaults to "%D" in the C locale. | |
| 1042 %X is a locale-specific synonym, which defaults to "%T" in the C locale. | |
| 1043 %y is replaced by the year without century (00-99). | |
| 1044 %Y is replaced by the year with century. | |
| 4203 | 1045 %z is replaced by the time zone as a numeric offset (e.g +0530, -0800 etc.) |
| 428 | 1046 %Z is replaced by the time zone abbreviation. |
| 1047 | |
| 1048 The number of options reflects the `strftime' function. | |
| 1049 | |
| 1050 BUG: If the charset used by the current locale is not ISO 8859-1, the | |
| 1051 characters appearing in the day and month names may be incorrect. | |
| 1052 */ | |
| 1053 (format_string, time_)) | |
| 1054 { | |
| 1055 time_t value; | |
| 665 | 1056 Bytecount size; |
| 428 | 1057 |
| 1058 CHECK_STRING (format_string); | |
| 1059 | |
| 1060 if (! lisp_to_time (time_, &value)) | |
| 563 | 1061 invalid_argument ("Invalid time specification", Qunbound); |
| 428 | 1062 |
| 1063 /* This is probably enough. */ | |
| 1064 size = XSTRING_LENGTH (format_string) * 6 + 50; | |
| 1065 | |
| 1066 while (1) | |
| 1067 { | |
| 2367 | 1068 Extbyte *buf = alloca_extbytes (size); |
| 771 | 1069 Extbyte *formext; |
| 4203 | 1070 /* make a copy of the static buffer returned by localtime() */ |
| 1071 struct tm tm = * localtime(&value); | |
| 1072 | |
| 428 | 1073 *buf = 1; |
| 771 | 1074 |
| 1075 /* !!#### this use of external here is not totally safe, and | |
| 1076 potentially data lossy. */ | |
| 1077 LISP_STRING_TO_EXTERNAL (format_string, formext, Qnative); | |
| 4203 | 1078 if (emacs_strftime (buf, size, formext, &tm) |
| 428 | 1079 || !*buf) |
| 771 | 1080 return build_ext_string (buf, Qnative); |
| 428 | 1081 /* If buffer was too small, make it bigger. */ |
| 1082 size *= 2; | |
| 1083 } | |
| 1084 } | |
| 1085 | |
| 1086 DEFUN ("decode-time", Fdecode_time, 0, 1, 0, /* | |
| 1087 Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE). | |
| 1088 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED) | |
| 1089 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil' | |
| 1090 to use the current time. The list has the following nine members: | |
| 1091 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which | |
| 1092 only some operating systems support. MINUTE is an integer between 0 and 59. | |
| 1093 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31. | |
| 1094 MONTH is an integer between 1 and 12. YEAR is an integer indicating the | |
| 1095 four-digit year. DOW is the day of week, an integer between 0 and 6, where | |
| 1096 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil. | |
| 1097 ZONE is an integer indicating the number of seconds east of Greenwich. | |
| 1098 \(Note that Common Lisp has different meanings for DOW and ZONE.) | |
| 1099 */ | |
| 1100 (specified_time)) | |
| 1101 { | |
| 1102 time_t time_spec; | |
| 1103 struct tm save_tm; | |
| 1104 struct tm *decoded_time; | |
| 1105 Lisp_Object list_args[9]; | |
| 1106 | |
| 1107 if (! lisp_to_time (specified_time, &time_spec)) | |
| 563 | 1108 invalid_argument ("Invalid time specification", Qunbound); |
| 428 | 1109 |
| 1110 decoded_time = localtime (&time_spec); | |
| 1111 list_args[0] = make_int (decoded_time->tm_sec); | |
| 1112 list_args[1] = make_int (decoded_time->tm_min); | |
| 1113 list_args[2] = make_int (decoded_time->tm_hour); | |
| 1114 list_args[3] = make_int (decoded_time->tm_mday); | |
| 1115 list_args[4] = make_int (decoded_time->tm_mon + 1); | |
| 1116 list_args[5] = make_int (decoded_time->tm_year + 1900); | |
| 1117 list_args[6] = make_int (decoded_time->tm_wday); | |
| 1118 list_args[7] = (decoded_time->tm_isdst)? Qt : Qnil; | |
| 1119 | |
| 1120 /* Make a copy, in case gmtime modifies the struct. */ | |
| 1121 save_tm = *decoded_time; | |
| 1122 decoded_time = gmtime (&time_spec); | |
| 1123 if (decoded_time == 0) | |
| 1124 list_args[8] = Qnil; | |
| 1125 else | |
| 1126 list_args[8] = make_int (difftm (&save_tm, decoded_time)); | |
| 1127 return Flist (9, list_args); | |
| 1128 } | |
| 1129 | |
| 771 | 1130 static void set_time_zone_rule (Extbyte *tzstring); |
| 428 | 1131 |
| 707 | 1132 /* from GNU Emacs 21, per Simon Josefsson, modified by stephen |
| 1133 The slight inefficiency is justified since negative times are weird. */ | |
| 1134 Lisp_Object | |
| 771 | 1135 make_time (time_t tiempo) |
| 707 | 1136 { |
| 771 | 1137 return list2 (make_int (tiempo < 0 ? tiempo / 0x10000 : tiempo >> 16), |
| 1138 make_int (tiempo & 0xFFFF)); | |
| 707 | 1139 } |
| 1140 | |
| 428 | 1141 DEFUN ("encode-time", Fencode_time, 6, MANY, 0, /* |
| 1142 Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time. | |
| 1143 This is the reverse operation of `decode-time', which see. | |
| 1144 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 | |
| 1146 \(as from `current-time-zone') or an integer (as from `decode-time') | |
| 1147 applied without consideration for daylight savings time. | |
| 1148 | |
| 1149 You can pass more than 7 arguments; then the first six arguments | |
| 1150 are used as SECOND through YEAR, and the *last* argument is used as ZONE. | |
| 1151 The intervening arguments are ignored. | |
| 1152 This feature lets (apply 'encode-time (decode-time ...)) work. | |
| 1153 | |
| 1154 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. | |
| 1156 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. | |
| 1158 */ | |
| 1159 (int nargs, Lisp_Object *args)) | |
| 1160 { | |
| 1161 time_t the_time; | |
| 1162 struct tm tm; | |
| 1163 Lisp_Object zone = (nargs > 6) ? args[nargs - 1] : Qnil; | |
| 1164 | |
| 1165 CHECK_INT (*args); tm.tm_sec = XINT (*args++); /* second */ | |
| 1166 CHECK_INT (*args); tm.tm_min = XINT (*args++); /* minute */ | |
| 1167 CHECK_INT (*args); tm.tm_hour = XINT (*args++); /* hour */ | |
| 1168 CHECK_INT (*args); tm.tm_mday = XINT (*args++); /* day */ | |
| 1169 CHECK_INT (*args); tm.tm_mon = XINT (*args++) - 1; /* month */ | |
| 1170 CHECK_INT (*args); tm.tm_year = XINT (*args++) - 1900;/* year */ | |
| 1171 | |
| 1172 tm.tm_isdst = -1; | |
| 1173 | |
| 1174 if (CONSP (zone)) | |
| 1175 zone = XCAR (zone); | |
| 1176 if (NILP (zone)) | |
| 1177 the_time = mktime (&tm); | |
| 1178 else | |
| 1179 { | |
| 771 | 1180 /* #### This business of modifying environ is horrendous! |
| 1181 Why don't we just putenv()? Why don't we implement our own | |
| 1182 funs that don't require this futzing? */ | |
| 1183 Extbyte tzbuf[100]; | |
| 1184 Extbyte *tzstring; | |
| 1185 Extbyte **oldenv = environ, **newenv; | |
| 428 | 1186 |
| 1187 if (STRINGP (zone)) | |
| 771 | 1188 LISP_STRING_TO_EXTERNAL (zone, tzstring, Qnative); |
| 428 | 1189 else if (INTP (zone)) |
| 1190 { | |
| 1191 int abszone = abs (XINT (zone)); | |
| 1192 sprintf (tzbuf, "XXX%s%d:%02d:%02d", "-" + (XINT (zone) < 0), | |
| 1193 abszone / (60*60), (abszone/60) % 60, abszone % 60); | |
| 1194 tzstring = tzbuf; | |
| 1195 } | |
| 1196 else | |
| 771 | 1197 invalid_argument ("Invalid time zone specification", Qunbound); |
| 428 | 1198 |
| 1199 /* Set TZ before calling mktime; merely adjusting mktime's returned | |
| 1200 value doesn't suffice, since that would mishandle leap seconds. */ | |
| 1201 set_time_zone_rule (tzstring); | |
| 1202 | |
| 1203 the_time = mktime (&tm); | |
| 1204 | |
| 1205 /* Restore TZ to previous value. */ | |
| 1206 newenv = environ; | |
| 1207 environ = oldenv; | |
| 1208 free (newenv); | |
| 1209 #ifdef LOCALTIME_CACHE | |
| 1210 tzset (); | |
| 1211 #endif | |
| 1212 } | |
| 1213 | |
| 1214 if (the_time == (time_t) -1) | |
| 563 | 1215 invalid_argument ("Specified time is not representable", Qunbound); |
| 428 | 1216 |
| 707 | 1217 return make_time (the_time); |
| 428 | 1218 } |
| 1219 | |
| 1220 DEFUN ("current-time-string", Fcurrent_time_string, 0, 1, 0, /* | |
| 1221 Return the current time, as a human-readable string. | |
| 1222 Programs can use this function to decode a time, | |
| 1223 since the number of columns in each field is fixed. | |
| 1224 The format is `Sun Sep 16 01:03:52 1973'. | |
| 1225 If an argument is given, it specifies a time to format | |
| 1226 instead of the current time. The argument should have the form: | |
| 1227 (HIGH . LOW) | |
| 1228 or the form: | |
| 1229 (HIGH LOW . IGNORED). | |
| 1230 Thus, you can use times obtained from `current-time' | |
| 1231 and from `file-attributes'. | |
| 1232 */ | |
| 1233 (specified_time)) | |
| 1234 { | |
| 1235 time_t value; | |
| 867 | 1236 Ibyte *the_ctime; |
| 647 | 1237 EMACS_INT len; /* this is what make_ext_string() accepts; #### |
| 665 | 1238 should it be an Bytecount? */ |
| 428 | 1239 |
| 1240 if (! lisp_to_time (specified_time, &value)) | |
| 1241 value = -1; | |
| 771 | 1242 the_ctime = qxe_ctime (&value); |
| 428 | 1243 |
| 442 | 1244 /* ctime is documented as always returning a "\n\0"-terminated |
| 1245 26-byte American time string, but let's be careful anyways. */ | |
| 1246 for (len = 0; the_ctime[len] != '\n' && the_ctime[len] != '\0'; len++) | |
| 1247 ; | |
| 428 | 1248 |
| 771 | 1249 return make_string (the_ctime, len); |
| 428 | 1250 } |
| 1251 | |
| 1252 #define TM_YEAR_ORIGIN 1900 | |
| 1253 | |
| 1254 /* Yield A - B, measured in seconds. */ | |
| 1255 static long | |
| 442 | 1256 difftm (const struct tm *a, const struct tm *b) |
| 428 | 1257 { |
| 1258 int ay = a->tm_year + (TM_YEAR_ORIGIN - 1); | |
| 1259 int by = b->tm_year + (TM_YEAR_ORIGIN - 1); | |
| 1260 /* Some compilers can't handle this as a single return statement. */ | |
| 1261 long days = ( | |
| 1262 /* difference in day of year */ | |
| 1263 a->tm_yday - b->tm_yday | |
| 1264 /* + intervening leap days */ | |
| 1265 + ((ay >> 2) - (by >> 2)) | |
| 1266 - (ay/100 - by/100) | |
| 1267 + ((ay/100 >> 2) - (by/100 >> 2)) | |
| 1268 /* + difference in years * 365 */ | |
| 1269 + (long)(ay-by) * 365 | |
| 1270 ); | |
| 1271 return (60*(60*(24*days + (a->tm_hour - b->tm_hour)) | |
| 1272 + (a->tm_min - b->tm_min)) | |
| 1273 + (a->tm_sec - b->tm_sec)); | |
| 1274 } | |
| 1275 | |
| 1276 DEFUN ("current-time-zone", Fcurrent_time_zone, 0, 1, 0, /* | |
| 1277 Return the offset and name for the local time zone. | |
| 1278 This returns a list of the form (OFFSET NAME). | |
| 1279 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich). | |
| 1280 A negative value means west of Greenwich. | |
| 1281 NAME is a string giving the name of the time zone. | |
| 1282 If an argument is given, it specifies when the time zone offset is determined | |
| 1283 instead of using the current time. The argument should have the form: | |
| 1284 (HIGH . LOW) | |
| 1285 or the form: | |
| 1286 (HIGH LOW . IGNORED). | |
| 1287 Thus, you can use times obtained from `current-time' | |
| 1288 and from `file-attributes'. | |
| 1289 | |
| 1290 Some operating systems cannot provide all this information to Emacs; | |
| 1291 in this case, `current-time-zone' returns a list containing nil for | |
| 1292 the data it can't find. | |
| 1293 */ | |
| 1294 (specified_time)) | |
| 1295 { | |
| 1296 time_t value; | |
| 1297 struct tm *t = NULL; | |
| 1298 | |
| 1299 if (lisp_to_time (specified_time, &value) | |
| 1300 && (t = gmtime (&value)) != 0) | |
| 1301 { | |
| 1302 struct tm gmt = *t; /* Make a copy, in case localtime modifies *t. */ | |
| 1303 long offset; | |
| 771 | 1304 Extbyte *s; |
| 1305 Lisp_Object tem; | |
| 428 | 1306 |
| 1307 t = localtime (&value); | |
| 1308 offset = difftm (t, &gmt); | |
| 1309 s = 0; | |
| 1310 #ifdef HAVE_TM_ZONE | |
| 1311 if (t->tm_zone) | |
| 771 | 1312 s = (Extbyte *) t->tm_zone; |
| 428 | 1313 #else /* not HAVE_TM_ZONE */ |
| 1314 #ifdef HAVE_TZNAME | |
| 1315 if (t->tm_isdst == 0 || t->tm_isdst == 1) | |
| 1316 s = tzname[t->tm_isdst]; | |
| 1317 #endif | |
| 1318 #endif /* not HAVE_TM_ZONE */ | |
| 771 | 1319 if (s) |
| 1320 tem = build_ext_string (s, Qnative); | |
| 1321 else | |
| 428 | 1322 { |
| 867 | 1323 Ibyte buf[6]; |
| 771 | 1324 |
| 428 | 1325 /* No local time zone name is available; use "+-NNNN" instead. */ |
| 1326 int am = (offset < 0 ? -offset : offset) / 60; | |
| 771 | 1327 qxesprintf (buf, "%c%02d%02d", (offset < 0 ? '-' : '+'), am/60, |
| 1328 am%60); | |
| 1329 tem = build_intstring (buf); | |
| 428 | 1330 } |
| 771 | 1331 return list2 (make_int (offset), tem); |
| 428 | 1332 } |
| 1333 else | |
| 1334 return list2 (Qnil, Qnil); | |
| 1335 } | |
| 1336 | |
| 1337 #ifdef LOCALTIME_CACHE | |
| 1338 | |
| 1339 /* These two values are known to load tz files in buggy implementations, | |
| 1340 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2. | |
| 1341 Their values shouldn't matter in non-buggy implementations. | |
| 1342 We don't use string literals for these strings, | |
| 1343 since if a string in the environment is in readonly | |
| 1344 storage, it runs afoul of bugs in SVR4 and Solaris 2.3. | |
| 1345 See Sun bugs 1113095 and 1114114, ``Timezone routines | |
| 1346 improperly modify environment''. */ | |
| 1347 | |
| 2367 | 1348 static Ascbyte set_time_zone_rule_tz1[] = "TZ=GMT+0"; |
| 1349 static Ascbyte set_time_zone_rule_tz2[] = "TZ=GMT+1"; | |
| 428 | 1350 |
| 1351 #endif | |
| 1352 | |
| 1353 /* Set the local time zone rule to TZSTRING. | |
| 1354 This allocates memory into `environ', which it is the caller's | |
| 1355 responsibility to free. */ | |
| 1356 static void | |
| 771 | 1357 set_time_zone_rule (Extbyte *tzstring) |
| 428 | 1358 { |
| 1359 int envptrs; | |
| 771 | 1360 Extbyte **from, **to, **newenv; |
| 428 | 1361 |
| 1362 for (from = environ; *from; from++) | |
| 1363 continue; | |
| 1364 envptrs = from - environ + 2; | |
| 771 | 1365 newenv = to = (Extbyte **) xmalloc (envptrs * sizeof (Extbyte *) |
| 428 | 1366 + (tzstring ? strlen (tzstring) + 4 : 0)); |
| 1367 if (tzstring) | |
| 1368 { | |
| 771 | 1369 Extbyte *t = (Extbyte *) (to + envptrs); |
| 428 | 1370 strcpy (t, "TZ="); |
| 1371 strcat (t, tzstring); | |
| 1372 *to++ = t; | |
| 1373 } | |
| 1374 | |
| 1375 for (from = environ; *from; from++) | |
| 1376 if (strncmp (*from, "TZ=", 3) != 0) | |
| 1377 *to++ = *from; | |
| 1378 *to = 0; | |
| 1379 | |
| 1380 environ = newenv; | |
| 1381 | |
| 1382 #ifdef LOCALTIME_CACHE | |
| 1383 { | |
| 1384 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like | |
| 1385 "US/Pacific" that loads a tz file, then changes to a value like | |
| 1386 "XXX0" that does not load a tz file, and then changes back to | |
| 1387 its original value, the last change is (incorrectly) ignored. | |
| 1388 Also, if TZ changes twice in succession to values that do | |
| 1389 not load a tz file, tzset can dump core (see Sun bug#1225179). | |
| 1390 The following code works around these bugs. */ | |
| 1391 | |
| 1392 if (tzstring) | |
| 1393 { | |
| 1394 /* Temporarily set TZ to a value that loads a tz file | |
| 1395 and that differs from tzstring. */ | |
| 771 | 1396 Extbyte *tz = *newenv; |
| 428 | 1397 *newenv = (strcmp (tzstring, set_time_zone_rule_tz1 + 3) == 0 |
| 1398 ? set_time_zone_rule_tz2 : set_time_zone_rule_tz1); | |
| 1399 tzset (); | |
| 1400 *newenv = tz; | |
| 1401 } | |
| 1402 else | |
| 1403 { | |
| 1404 /* The implied tzstring is unknown, so temporarily set TZ to | |
| 1405 two different values that each load a tz file. */ | |
| 1406 *to = set_time_zone_rule_tz1; | |
| 1407 to[1] = 0; | |
| 1408 tzset (); | |
| 1409 *to = set_time_zone_rule_tz2; | |
| 1410 tzset (); | |
| 1411 *to = 0; | |
| 1412 } | |
| 1413 | |
| 1414 /* Now TZ has the desired value, and tzset can be invoked safely. */ | |
| 1415 } | |
| 1416 | |
| 1417 tzset (); | |
| 1418 #endif | |
| 1419 } | |
| 1420 | |
| 1421 DEFUN ("set-time-zone-rule", Fset_time_zone_rule, 1, 1, 0, /* | |
| 1422 Set the local time zone using TZ, a string specifying a time zone rule. | |
| 1423 If TZ is nil, use implementation-defined default time zone information. | |
| 1424 */ | |
| 1425 (tz)) | |
| 1426 { | |
| 771 | 1427 Extbyte *tzstring; |
| 428 | 1428 |
| 1429 if (NILP (tz)) | |
| 1430 tzstring = 0; | |
| 1431 else | |
| 1432 { | |
| 1433 CHECK_STRING (tz); | |
| 771 | 1434 LISP_STRING_TO_EXTERNAL (tz, tzstring, Qnative); |
| 428 | 1435 } |
| 1436 | |
| 1437 set_time_zone_rule (tzstring); | |
| 1438 if (environbuf) | |
| 1726 | 1439 xfree (environbuf, Extbyte **); |
| 428 | 1440 environbuf = environ; |
| 1441 | |
| 1442 return Qnil; | |
| 1443 } | |
| 1444 | |
| 1445 | |
| 1446 void | |
| 1447 buffer_insert1 (struct buffer *buf, Lisp_Object arg) | |
| 1448 { | |
| 1449 /* This function can GC */ | |
| 1450 struct gcpro gcpro1; | |
| 1451 GCPRO1 (arg); | |
| 1452 retry: | |
| 1453 if (CHAR_OR_CHAR_INTP (arg)) | |
| 1454 { | |
| 1455 buffer_insert_emacs_char (buf, XCHAR_OR_CHAR_INT (arg)); | |
| 1456 } | |
| 1457 else if (STRINGP (arg)) | |
| 1458 { | |
| 1459 buffer_insert_lisp_string (buf, arg); | |
| 1460 } | |
| 1461 else | |
| 1462 { | |
| 1463 arg = wrong_type_argument (Qchar_or_string_p, arg); | |
| 1464 goto retry; | |
| 1465 } | |
| 1466 UNGCPRO; | |
| 1467 } | |
| 1468 | |
| 1469 | |
| 1470 /* Callers passing one argument to Finsert need not gcpro the | |
| 1471 argument "array", since the only element of the array will | |
| 1472 not be used after calling insert_emacs_char or insert_lisp_string, | |
| 1473 so we don't care if it gets trashed. */ | |
| 1474 | |
| 1475 DEFUN ("insert", Finsert, 0, MANY, 0, /* | |
| 1476 Insert the arguments, either strings or characters, at point. | |
| 1477 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. | |
| 1479 If a string has non-null string-extent-data, new extents will be created. | |
| 1480 */ | |
| 1481 (int nargs, Lisp_Object *args)) | |
| 1482 { | |
| 1483 /* This function can GC */ | |
| 1484 REGISTER int argnum; | |
| 1485 | |
| 1486 for (argnum = 0; argnum < nargs; argnum++) | |
| 1487 { | |
| 1488 buffer_insert1 (current_buffer, args[argnum]); | |
| 1489 } | |
| 1490 | |
| 1491 return Qnil; | |
| 1492 } | |
| 1493 | |
| 1494 DEFUN ("insert-before-markers", Finsert_before_markers, 0, MANY, 0, /* | |
| 1495 Insert strings or characters at point, relocating markers after the text. | |
| 1496 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. | |
| 1498 */ | |
| 1499 (int nargs, Lisp_Object *args)) | |
| 1500 { | |
| 1501 /* This function can GC */ | |
| 1502 REGISTER int argnum; | |
| 1503 REGISTER Lisp_Object tem; | |
| 1504 | |
| 1505 for (argnum = 0; argnum < nargs; argnum++) | |
| 1506 { | |
| 1507 tem = args[argnum]; | |
| 1508 retry: | |
| 1509 if (CHAR_OR_CHAR_INTP (tem)) | |
| 1510 { | |
| 1511 buffer_insert_emacs_char_1 (current_buffer, -1, | |
| 1512 XCHAR_OR_CHAR_INT (tem), | |
| 1513 INSDEL_BEFORE_MARKERS); | |
| 1514 } | |
| 1515 else if (STRINGP (tem)) | |
| 1516 { | |
| 1517 buffer_insert_lisp_string_1 (current_buffer, -1, tem, | |
| 1518 INSDEL_BEFORE_MARKERS); | |
| 1519 } | |
| 1520 else | |
| 1521 { | |
| 1522 tem = wrong_type_argument (Qchar_or_string_p, tem); | |
| 1523 goto retry; | |
| 1524 } | |
| 1525 } | |
| 1526 return Qnil; | |
| 1527 } | |
| 1528 | |
| 1529 DEFUN ("insert-string", Finsert_string, 1, 2, 0, /* | |
| 1530 Insert STRING into BUFFER at BUFFER's point. | |
| 1531 Point moves forward so that it ends up after the inserted text. | |
| 1532 Any other markers at the point of insertion remain before the text. | |
| 1533 If a string has non-null string-extent-data, new extents will be created. | |
| 1534 BUFFER defaults to the current buffer. | |
| 1535 */ | |
| 1536 (string, buffer)) | |
| 1537 { | |
| 1538 struct buffer *b = decode_buffer (buffer, 1); | |
| 1539 CHECK_STRING (string); | |
| 1540 buffer_insert_lisp_string (b, string); | |
| 1541 return Qnil; | |
| 1542 } | |
| 1543 | |
| 1544 /* Third argument in FSF is INHERIT: | |
| 1545 | |
| 1546 "The optional third arg INHERIT, if non-nil, says to inherit text properties | |
| 1547 from adjoining text, if those properties are sticky." | |
| 1548 | |
| 1549 Jamie thinks this is bogus. */ | |
| 1550 | |
| 1551 | |
| 1552 DEFUN ("insert-char", Finsert_char, 1, 4, 0, /* | |
| 444 | 1553 Insert COUNT copies of CHARACTER into BUFFER. |
| 428 | 1554 Point and all markers are affected as in the function `insert'. |
| 1555 COUNT defaults to 1 if omitted. | |
| 1556 The optional third arg IGNORED is INHERIT under FSF Emacs. | |
| 1557 This is highly bogus, however, and XEmacs always behaves as if | |
| 1558 `t' were passed to INHERIT. | |
| 1559 The optional fourth arg BUFFER specifies the buffer to insert the | |
| 1560 text into. If BUFFER is nil, the current buffer is assumed. | |
| 1561 */ | |
| 2286 | 1562 (character, count, UNUSED (ignored), buffer)) |
| 428 | 1563 { |
| 1564 /* This function can GC */ | |
| 867 | 1565 REGISTER Ibyte *string; |
| 814 | 1566 REGISTER Bytecount slen; |
| 1567 REGISTER Bytecount i, j; | |
| 428 | 1568 REGISTER Bytecount n; |
| 1569 REGISTER Bytecount charlen; | |
| 867 | 1570 Ibyte str[MAX_ICHAR_LEN]; |
| 428 | 1571 struct buffer *b = decode_buffer (buffer, 1); |
| 1572 int cou; | |
| 1573 | |
| 444 | 1574 CHECK_CHAR_COERCE_INT (character); |
| 428 | 1575 if (NILP (count)) |
| 1576 cou = 1; | |
| 1577 else | |
| 1578 { | |
| 1579 CHECK_INT (count); | |
| 1580 cou = XINT (count); | |
| 1581 } | |
| 1582 | |
| 867 | 1583 charlen = set_itext_ichar (str, XCHAR (character)); |
| 428 | 1584 n = cou * charlen; |
| 1585 if (n <= 0) | |
| 1586 return Qnil; | |
| 814 | 1587 slen = min (n, (Bytecount) 768); |
| 2367 | 1588 string = alloca_ibytes (slen); |
| 428 | 1589 /* Write as many copies of the character into the temp string as will fit. */ |
| 1590 for (i = 0; i + charlen <= slen; i += charlen) | |
| 1591 for (j = 0; j < charlen; j++) | |
| 1592 string[i + j] = str[j]; | |
| 1593 slen = i; | |
| 1594 while (n >= slen) | |
| 1595 { | |
| 1596 buffer_insert_raw_string (b, string, slen); | |
| 1597 n -= slen; | |
| 1598 } | |
| 1599 if (n > 0) | |
| 1600 #if 0 /* FSFmacs bogosity */ | |
| 1601 { | |
| 1602 if (!NILP (inherit)) | |
| 1603 insert_and_inherit (string, n); | |
| 1604 else | |
| 1605 insert (string, n); | |
| 1606 } | |
| 1607 #else | |
| 1608 buffer_insert_raw_string (b, string, n); | |
| 1609 #endif | |
| 1610 | |
| 1611 return Qnil; | |
| 1612 } | |
| 1613 | |
| 1614 | |
| 1615 /* Making strings from buffer contents. */ | |
| 1616 | |
| 1617 DEFUN ("buffer-substring", Fbuffer_substring, 0, 3, 0, /* | |
| 1618 Return the contents of part of BUFFER as a string. | |
| 1619 The two arguments START and END are character positions; | |
| 1620 they can be in either order. If omitted, they default to the beginning | |
| 1621 and end of BUFFER, respectively. | |
| 1622 If there are duplicable extents in the region, the string remembers | |
| 1623 them in its extent data. | |
| 1624 If BUFFER is nil, the current buffer is assumed. | |
| 1625 */ | |
| 1626 (start, end, buffer)) | |
| 1627 { | |
| 1628 /* This function can GC */ | |
| 665 | 1629 Charbpos begv, zv; |
| 428 | 1630 struct buffer *b = decode_buffer (buffer, 1); |
| 1631 | |
| 1632 get_buffer_range_char (b, start, end, &begv, &zv, GB_ALLOW_NIL); | |
| 1633 return make_string_from_buffer (b, begv, zv - begv); | |
| 1634 } | |
| 1635 | |
| 1636 /* It might make more sense to name this | |
| 1637 `buffer-substring-no-extents', but this name is FSFmacs-compatible, | |
| 1638 and what the function does is probably good enough for what the | |
| 1639 user-code will typically want to use it for. */ | |
| 1640 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties, 0, 3, 0, /* | |
| 444 | 1641 Return the text from START to END as a string, without copying the extents. |
| 428 | 1642 */ |
| 1643 (start, end, buffer)) | |
| 1644 { | |
| 1645 /* This function can GC */ | |
| 665 | 1646 Charbpos begv, zv; |
| 428 | 1647 struct buffer *b = decode_buffer (buffer, 1); |
| 1648 | |
| 1649 get_buffer_range_char (b, start, end, &begv, &zv, GB_ALLOW_NIL); | |
| 1650 return make_string_from_buffer_no_extents (b, begv, zv - begv); | |
| 1651 } | |
| 1652 | |
| 1653 DEFUN ("insert-buffer-substring", Finsert_buffer_substring, 1, 3, 0, /* | |
| 1654 Insert before point a substring of the contents of buffer BUFFER. | |
| 1655 BUFFER may be a buffer or a buffer name. | |
| 1656 Arguments START and END are character numbers specifying the substring. | |
| 1657 They default to the beginning and the end of BUFFER. | |
| 1658 */ | |
| 1659 (buffer, start, end)) | |
| 1660 { | |
| 1661 /* This function can GC */ | |
| 665 | 1662 Charbpos b, e; |
| 428 | 1663 struct buffer *bp; |
| 1664 | |
| 1665 bp = XBUFFER (get_buffer (buffer, 1)); | |
| 1666 get_buffer_range_char (bp, start, end, &b, &e, GB_ALLOW_NIL); | |
| 1667 | |
| 1668 if (b < e) | |
| 1669 buffer_insert_from_buffer (current_buffer, bp, b, e - b); | |
| 1670 | |
| 1671 return Qnil; | |
| 1672 } | |
| 1673 | |
| 1674 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings, 6, 6, 0, /* | |
| 1675 Compare two substrings of two buffers; return result as number. | |
| 1676 the value is -N if first string is less after N-1 chars, | |
| 1677 +N if first string is greater after N-1 chars, or 0 if strings match. | |
| 1678 Each substring is represented as three arguments: BUFFER, START and END. | |
| 1679 That makes six args in all, three for each substring. | |
| 1680 | |
| 1681 The value of `case-fold-search' in the current buffer | |
| 1682 determines whether case is significant or ignored. | |
| 1683 */ | |
| 1684 (buffer1, start1, end1, buffer2, start2, end2)) | |
| 1685 { | |
| 665 | 1686 Charbpos begp1, endp1, begp2, endp2; |
| 428 | 1687 REGISTER Charcount len1, len2, length, i; |
| 1688 struct buffer *bp1, *bp2; | |
| 1689 Lisp_Object trt = ((!NILP (current_buffer->case_fold_search)) ? | |
| 446 | 1690 XCASE_TABLE_CANON (current_buffer->case_table) : Qnil); |
| 428 | 1691 |
| 1692 /* Find the first buffer and its substring. */ | |
| 1693 | |
| 1694 bp1 = decode_buffer (buffer1, 1); | |
| 1695 get_buffer_range_char (bp1, start1, end1, &begp1, &endp1, GB_ALLOW_NIL); | |
| 1696 | |
| 1697 /* Likewise for second substring. */ | |
| 1698 | |
| 1699 bp2 = decode_buffer (buffer2, 1); | |
| 1700 get_buffer_range_char (bp2, start2, end2, &begp2, &endp2, GB_ALLOW_NIL); | |
| 1701 | |
| 1702 len1 = endp1 - begp1; | |
| 1703 len2 = endp2 - begp2; | |
| 1704 length = len1; | |
| 1705 if (len2 < length) | |
| 1706 length = len2; | |
| 1707 | |
| 1708 for (i = 0; i < length; i++) | |
| 1709 { | |
| 867 | 1710 Ichar c1 = BUF_FETCH_CHAR (bp1, begp1 + i); |
| 1711 Ichar c2 = BUF_FETCH_CHAR (bp2, begp2 + i); | |
| 428 | 1712 if (!NILP (trt)) |
| 1713 { | |
| 1714 c1 = TRT_TABLE_OF (trt, c1); | |
| 1715 c2 = TRT_TABLE_OF (trt, c2); | |
| 1716 } | |
| 1717 if (c1 < c2) | |
| 1718 return make_int (- 1 - i); | |
| 1719 if (c1 > c2) | |
| 1720 return make_int (i + 1); | |
| 1721 } | |
| 1722 | |
| 1723 /* The strings match as far as they go. | |
| 1724 If one is shorter, that one is less. */ | |
| 1725 if (length < len1) | |
| 1726 return make_int (length + 1); | |
| 1727 else if (length < len2) | |
| 1728 return make_int (- length - 1); | |
| 1729 | |
| 1730 /* Same length too => they are equal. */ | |
| 1731 return Qzero; | |
| 1732 } | |
| 1733 | |
| 1734 | |
| 1735 static Lisp_Object | |
| 1736 subst_char_in_region_unwind (Lisp_Object arg) | |
| 1737 { | |
| 1738 XBUFFER (XCAR (arg))->undo_list = XCDR (arg); | |
| 1739 return Qnil; | |
| 1740 } | |
| 1741 | |
| 1742 static Lisp_Object | |
| 1743 subst_char_in_region_unwind_1 (Lisp_Object arg) | |
| 1744 { | |
| 1745 XBUFFER (XCAR (arg))->filename = XCDR (arg); | |
| 1746 return Qnil; | |
| 1747 } | |
| 1748 | |
| 1749 DEFUN ("subst-char-in-region", Fsubst_char_in_region, 4, 5, 0, /* | |
| 1750 From START to END, replace FROMCHAR with TOCHAR each time it occurs. | |
| 1751 If optional arg NOUNDO is non-nil, don't record this change for undo | |
| 1752 and don't mark the buffer as really changed. | |
| 1753 */ | |
| 1754 (start, end, fromchar, tochar, noundo)) | |
| 1755 { | |
| 1756 /* This function can GC */ | |
| 665 | 1757 Charbpos pos, stop; |
| 867 | 1758 Ichar fromc, toc; |
| 428 | 1759 int mc_count; |
| 1760 struct buffer *buf = current_buffer; | |
| 1761 int count = specpdl_depth (); | |
| 1762 | |
| 1763 get_buffer_range_char (buf, start, end, &pos, &stop, 0); | |
| 1764 CHECK_CHAR_COERCE_INT (fromchar); | |
| 1765 CHECK_CHAR_COERCE_INT (tochar); | |
| 1766 | |
| 1767 fromc = XCHAR (fromchar); | |
| 1768 toc = XCHAR (tochar); | |
| 1769 | |
| 1770 /* If we don't want undo, turn off putting stuff on the list. | |
| 1771 That's faster than getting rid of things, | |
| 1772 and it prevents even the entry for a first change. | |
| 1773 Also inhibit locking the file. */ | |
| 1774 if (!NILP (noundo)) | |
| 1775 { | |
| 1776 record_unwind_protect (subst_char_in_region_unwind, | |
| 1777 Fcons (Fcurrent_buffer (), buf->undo_list)); | |
| 1778 buf->undo_list = Qt; | |
| 1779 /* Don't do file-locking. */ | |
| 1780 record_unwind_protect (subst_char_in_region_unwind_1, | |
| 1781 Fcons (Fcurrent_buffer (), buf->filename)); | |
| 1782 buf->filename = Qnil; | |
| 1783 } | |
| 1784 | |
| 1785 mc_count = begin_multiple_change (buf, pos, stop); | |
| 1786 while (pos < stop) | |
| 1787 { | |
| 1788 if (BUF_FETCH_CHAR (buf, pos) == fromc) | |
| 1789 { | |
| 1790 /* There used to be some code here that set the buffer to | |
| 1791 unmodified if NOUNDO was specified and there was only | |
| 1792 one change to the buffer since it was last saved. | |
| 1793 This is a crock of shit, so I'm not duplicating this | |
| 1794 behavior. I think this was left over from when | |
| 1795 prepare_to_modify_buffer() actually bumped MODIFF, | |
| 1796 so that code was supposed to undo this change. --ben */ | |
| 1797 buffer_replace_char (buf, pos, toc, !NILP (noundo), 0); | |
| 1798 | |
| 1799 /* If noundo is not nil then we don't mark the buffer as | |
| 1800 modified. In reality that needs to happen externally | |
| 1801 only. Internally redisplay needs to know that the actual | |
| 1802 contents it should be displaying have changed. */ | |
| 1803 if (!NILP (noundo)) | |
| 1804 Fset_buffer_modified_p (Fbuffer_modified_p (Qnil), Qnil); | |
| 1805 } | |
| 1806 pos++; | |
| 1807 } | |
| 1808 end_multiple_change (buf, mc_count); | |
| 1809 | |
| 771 | 1810 unbind_to (count); |
| 428 | 1811 return Qnil; |
| 1812 } | |
| 1813 | |
| 1814 /* #### Shouldn't this also accept a BUFFER argument, in the good old | |
| 1815 XEmacs tradition? */ | |
| 1816 DEFUN ("translate-region", Ftranslate_region, 3, 3, 0, /* | |
| 1817 Translate characters from START to END according to TABLE. | |
| 1818 | |
| 1819 If TABLE is a string, the Nth character in it is the mapping for the | |
| 1820 character with code N. | |
| 1821 | |
| 1822 If TABLE is a vector, its Nth element is the mapping for character | |
| 1823 with code N. The values of elements may be characters, strings, or | |
| 1824 nil (nil meaning don't replace.) | |
| 1825 | |
| 1826 If TABLE is a char-table, its elements describe the mapping between | |
|
4469
c661944aa259
Fill out docstrings for #'translate-region, #'make-char-table.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
1827 characters and their replacements. The char-table should be of type `char' |
|
4470
c76b1bc6bd28
Correct a thinko in the #'translate-region docstring
Aidan Kehoe <kehoea@parhasard.net>
parents:
4469
diff
changeset
|
1828 or `generic'. If the value given by `get-char-table' for a given character |
|
4469
c661944aa259
Fill out docstrings for #'translate-region, #'make-char-table.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
1829 is nil, that character will not be translated by `translate-region'. Since |
|
4470
c76b1bc6bd28
Correct a thinko in the #'translate-region docstring
Aidan Kehoe <kehoea@parhasard.net>
parents:
4469
diff
changeset
|
1830 `get-char-table' can never return nil with a char table of type `char', and |
|
c76b1bc6bd28
Correct a thinko in the #'translate-region docstring
Aidan Kehoe <kehoea@parhasard.net>
parents:
4469
diff
changeset
|
1831 since most translation involves a subset of the possible XEmacs characters, |
|
c76b1bc6bd28
Correct a thinko in the #'translate-region docstring
Aidan Kehoe <kehoea@parhasard.net>
parents:
4469
diff
changeset
|
1832 not all of them, the most generally useful table type here is `generic'. |
| 428 | 1833 |
| 1834 Returns the number of substitutions performed. | |
| 1835 */ | |
| 1836 (start, end, table)) | |
| 1837 { | |
| 1838 /* This function can GC */ | |
| 665 | 1839 Charbpos pos, stop; /* Limits of the region. */ |
| 428 | 1840 int cnt = 0; /* Number of changes made. */ |
| 1841 int mc_count; | |
| 1842 struct buffer *buf = current_buffer; | |
| 867 | 1843 Ichar oc; |
| 428 | 1844 |
| 1845 get_buffer_range_char (buf, start, end, &pos, &stop, 0); | |
| 1846 mc_count = begin_multiple_change (buf, pos, stop); | |
| 1847 if (STRINGP (table)) | |
| 1848 { | |
| 826 | 1849 Charcount size = string_char_length (table); |
| 428 | 1850 #ifdef MULE |
| 867 | 1851 /* Under Mule, string_ichar(n) is O(n), so for large tables or |
| 1852 large regions it makes sense to create an array of Ichars. */ | |
| 428 | 1853 if (size * (stop - pos) > 65536) |
| 1854 { | |
| 867 | 1855 Ichar *etable = alloca_array (Ichar, size); |
| 1856 convert_ibyte_string_into_ichar_string | |
| 793 | 1857 (XSTRING_DATA (table), XSTRING_LENGTH (table), etable); |
| 428 | 1858 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++) |
| 1859 { | |
| 1860 if (oc < size) | |
| 1861 { | |
| 867 | 1862 Ichar nc = etable[oc]; |
| 428 | 1863 if (nc != oc) |
| 1864 { | |
| 1865 buffer_replace_char (buf, pos, nc, 0, 0); | |
| 1866 ++cnt; | |
| 1867 } | |
| 1868 } | |
| 1869 } | |
| 1870 } | |
| 1871 else | |
| 1872 #endif /* MULE */ | |
| 1873 { | |
| 1874 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++) | |
| 1875 { | |
| 1876 if (oc < size) | |
| 1877 { | |
| 867 | 1878 Ichar nc = string_ichar (table, oc); |
| 428 | 1879 if (nc != oc) |
| 1880 { | |
| 1881 buffer_replace_char (buf, pos, nc, 0, 0); | |
| 1882 ++cnt; | |
| 1883 } | |
| 1884 } | |
| 1885 } | |
| 1886 } | |
| 1887 } | |
| 1888 else if (VECTORP (table)) | |
| 1889 { | |
| 1890 Charcount size = XVECTOR_LENGTH (table); | |
| 1891 Lisp_Object *vtable = XVECTOR_DATA (table); | |
| 1892 | |
| 1893 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++) | |
| 1894 { | |
| 1895 if (oc < size) | |
| 1896 { | |
| 1897 Lisp_Object replacement = vtable[oc]; | |
| 1898 retry: | |
| 1899 if (CHAR_OR_CHAR_INTP (replacement)) | |
| 1900 { | |
| 867 | 1901 Ichar nc = XCHAR_OR_CHAR_INT (replacement); |
| 428 | 1902 if (nc != oc) |
| 1903 { | |
| 1904 buffer_replace_char (buf, pos, nc, 0, 0); | |
| 1905 ++cnt; | |
| 1906 } | |
| 1907 } | |
| 1908 else if (STRINGP (replacement)) | |
| 1909 { | |
| 826 | 1910 Charcount incr = string_char_length (replacement) - 1; |
| 428 | 1911 buffer_delete_range (buf, pos, pos + 1, 0); |
| 1912 buffer_insert_lisp_string_1 (buf, pos, replacement, 0); | |
| 1913 pos += incr, stop += incr; | |
| 1914 ++cnt; | |
| 1915 } | |
| 1916 else if (!NILP (replacement)) | |
| 1917 { | |
| 1918 replacement = wrong_type_argument (Qchar_or_string_p, replacement); | |
| 1919 goto retry; | |
| 1920 } | |
| 1921 } | |
| 1922 } | |
| 1923 } | |
| 1924 else if (CHAR_TABLEP (table) | |
| 1925 && (XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_GENERIC | |
| 1926 || XCHAR_TABLE_TYPE (table) == CHAR_TABLE_TYPE_CHAR)) | |
| 1927 { | |
| 1928 | |
| 1929 for (; pos < stop && (oc = BUF_FETCH_CHAR (buf, pos), 1); pos++) | |
| 1930 { | |
| 826 | 1931 Lisp_Object replacement = get_char_table (oc, table); |
| 428 | 1932 retry2: |
| 1933 if (CHAR_OR_CHAR_INTP (replacement)) | |
| 1934 { | |
| 867 | 1935 Ichar nc = XCHAR_OR_CHAR_INT (replacement); |
| 428 | 1936 if (nc != oc) |
| 1937 { | |
| 1938 buffer_replace_char (buf, pos, nc, 0, 0); | |
| 1939 ++cnt; | |
| 1940 } | |
| 1941 } | |
| 1942 else if (STRINGP (replacement)) | |
| 1943 { | |
| 826 | 1944 Charcount incr = string_char_length (replacement) - 1; |
| 428 | 1945 buffer_delete_range (buf, pos, pos + 1, 0); |
| 1946 buffer_insert_lisp_string_1 (buf, pos, replacement, 0); | |
| 1947 pos += incr, stop += incr; | |
| 1948 ++cnt; | |
| 1949 } | |
| 1950 else if (!NILP (replacement)) | |
| 1951 { | |
| 826 | 1952 replacement = wrong_type_argument (Qchar_or_string_p, |
| 1953 replacement); | |
| 428 | 1954 goto retry2; |
| 1955 } | |
| 1956 } | |
| 1957 } | |
| 1958 else | |
| 1959 dead_wrong_type_argument (Qstringp, table); | |
| 1960 end_multiple_change (buf, mc_count); | |
| 1961 | |
| 1962 return make_int (cnt); | |
| 1963 } | |
| 1964 | |
| 1965 DEFUN ("delete-region", Fdelete_region, 2, 3, "r", /* | |
| 1966 Delete the text between point and mark. | |
| 444 | 1967 When called from a program, expects two arguments START and END |
| 1968 \(integers or markers) specifying the stretch to be deleted. | |
| 1969 If optional third arg BUFFER is nil, the current buffer is assumed. | |
| 428 | 1970 */ |
| 444 | 1971 (start, end, buffer)) |
| 428 | 1972 { |
| 1973 /* This function can GC */ | |
| 826 | 1974 Charbpos char_start, char_end; |
| 428 | 1975 struct buffer *buf = decode_buffer (buffer, 1); |
| 1976 | |
| 826 | 1977 get_buffer_range_char (buf, start, end, &char_start, &char_end, 0); |
| 1978 buffer_delete_range (buf, char_start, char_end, 0); | |
| 428 | 1979 return Qnil; |
| 1980 } | |
| 1981 | |
| 1982 void | |
| 1983 widen_buffer (struct buffer *b, int no_clip) | |
| 1984 { | |
| 1985 if (BUF_BEGV (b) != BUF_BEG (b)) | |
| 1986 { | |
| 1987 clip_changed = 1; | |
| 826 | 1988 SET_BOTH_BUF_BEGV (b, BUF_BEG (b), BYTE_BUF_BEG (b)); |
| 428 | 1989 } |
| 1990 if (BUF_ZV (b) != BUF_Z (b)) | |
| 1991 { | |
| 1992 clip_changed = 1; | |
| 826 | 1993 SET_BOTH_BUF_ZV (b, BUF_Z (b), BYTE_BUF_Z (b)); |
| 428 | 1994 } |
| 1995 if (clip_changed) | |
| 1996 { | |
| 1997 if (!no_clip) | |
| 1998 MARK_CLIP_CHANGED; | |
| 1999 /* Changing the buffer bounds invalidates any recorded current | |
| 2000 column. */ | |
| 2001 invalidate_current_column (); | |
| 2002 narrow_line_number_cache (b); | |
| 2003 } | |
| 2004 } | |
| 2005 | |
| 2006 DEFUN ("widen", Fwiden, 0, 1, "", /* | |
| 2007 Remove restrictions (narrowing) from BUFFER. | |
| 2008 This allows the buffer's full text to be seen and edited. | |
| 2009 If BUFFER is nil, the current buffer is assumed. | |
| 2010 */ | |
| 2011 (buffer)) | |
| 2012 { | |
| 2013 struct buffer *b = decode_buffer (buffer, 1); | |
| 2014 widen_buffer (b, 0); | |
| 2015 return Qnil; | |
| 2016 } | |
| 2017 | |
| 2018 DEFUN ("narrow-to-region", Fnarrow_to_region, 2, 3, "r", /* | |
| 2019 Restrict editing in BUFFER to the current region. | |
| 2020 The rest of the text becomes temporarily invisible and untouchable | |
| 2021 but is not deleted; if you save the buffer in a file, the invisible | |
| 2022 text is included in the file. \\[widen] makes all visible again. | |
| 2023 If BUFFER is nil, the current buffer is assumed. | |
| 2024 See also `save-restriction'. | |
| 2025 | |
| 2026 When calling from a program, pass two arguments; positions (integers | |
| 2027 or markers) bounding the text that should remain visible. | |
| 2028 */ | |
| 444 | 2029 (start, end, buffer)) |
| 428 | 2030 { |
| 826 | 2031 Charbpos char_start, char_end; |
| 428 | 2032 struct buffer *buf = decode_buffer (buffer, 1); |
| 826 | 2033 Bytebpos byte_start, byte_end; |
| 428 | 2034 |
| 826 | 2035 get_buffer_range_char (buf, start, end, &char_start, &char_end, |
| 444 | 2036 GB_ALLOW_PAST_ACCESSIBLE); |
| 826 | 2037 byte_start = charbpos_to_bytebpos (buf, char_start); |
| 2038 byte_end = charbpos_to_bytebpos (buf, char_end); | |
| 428 | 2039 |
| 826 | 2040 SET_BOTH_BUF_BEGV (buf, char_start, byte_start); |
| 2041 SET_BOTH_BUF_ZV (buf, char_end, byte_end); | |
| 2042 if (BUF_PT (buf) < char_start) | |
| 2043 BUF_SET_PT (buf, char_start); | |
| 2044 if (BUF_PT (buf) > char_end) | |
| 2045 BUF_SET_PT (buf, char_end); | |
| 428 | 2046 MARK_CLIP_CHANGED; |
| 2047 /* Changing the buffer bounds invalidates any recorded current column. */ | |
| 2048 invalidate_current_column (); | |
| 2049 narrow_line_number_cache (buf); | |
| 2050 return Qnil; | |
| 2051 } | |
| 2052 | |
| 2053 Lisp_Object | |
| 844 | 2054 save_restriction_save (struct buffer *buf) |
| 428 | 2055 { |
| 844 | 2056 Lisp_Object bottom = noseeum_make_marker (); |
| 2057 Lisp_Object top = noseeum_make_marker (); | |
| 2058 | |
| 2059 /* Formerly, this function remembered the amount of text on either side | |
| 2060 of the restricted area, in a halfway attempt to account for insertion -- | |
| 2061 it handles insertion inside the old restricted area, but not outside. | |
| 2062 The comment read: | |
| 2063 | |
| 2064 [[ Note: I tried using markers here, but it does not win | |
| 428 | 2065 because insertion at the end of the saved region |
| 844 | 2066 does not advance mh and is considered "outside" the saved region. ]] |
| 2067 | |
| 2068 But that was clearly before the advent of marker-insertion-type. --ben */ | |
| 428 | 2069 |
| 844 | 2070 Fset_marker (bottom, make_int (BUF_BEGV (buf)), wrap_buffer (buf)); |
| 2071 Fset_marker (top, make_int (BUF_ZV (buf)), wrap_buffer (buf)); | |
| 2072 Fset_marker_insertion_type (top, Qt); | |
| 2073 | |
| 2074 return noseeum_cons (wrap_buffer (buf), noseeum_cons (bottom, top)); | |
| 428 | 2075 } |
| 2076 | |
| 2077 Lisp_Object | |
| 2078 save_restriction_restore (Lisp_Object data) | |
| 2079 { | |
| 2080 struct buffer *buf; | |
| 844 | 2081 Lisp_Object markers = XCDR (data); |
| 428 | 2082 int local_clip_changed = 0; |
| 2083 | |
| 2084 buf = XBUFFER (XCAR (data)); | |
| 844 | 2085 /* someone could have killed the buffer in the meantime ... */ |
| 2086 if (BUFFER_LIVE_P (buf)) | |
| 428 | 2087 { |
| 844 | 2088 Charbpos start = marker_position (XCAR (markers)); |
| 2089 Charbpos end = marker_position (XCDR (markers)); | |
| 2090 Bytebpos byte_start = charbpos_to_bytebpos (buf, start); | |
| 2091 Bytebpos byte_end = charbpos_to_bytebpos (buf, end); | |
| 428 | 2092 |
| 844 | 2093 if (BUF_BEGV (buf) != start) |
| 2094 { | |
| 2095 local_clip_changed = 1; | |
| 2096 SET_BOTH_BUF_BEGV (buf, start, byte_start); | |
| 2097 narrow_line_number_cache (buf); | |
| 2098 } | |
| 2099 if (BUF_ZV (buf) != end) | |
| 2100 { | |
| 2101 local_clip_changed = 1; | |
| 2102 SET_BOTH_BUF_ZV (buf, end, byte_end); | |
| 2103 } | |
| 428 | 2104 |
| 844 | 2105 if (local_clip_changed) |
| 2106 MARK_CLIP_CHANGED; | |
| 2107 | |
| 2108 /* If point is outside the new visible range, move it inside. */ | |
| 2109 BUF_SET_PT (buf, charbpos_clip_to_bounds (BUF_BEGV (buf), BUF_PT (buf), | |
| 2110 BUF_ZV (buf))); | |
| 428 | 2111 } |
| 2112 | |
| 844 | 2113 /* Free all the junk we allocated, so that a `save-restriction' comes |
| 2114 for free in terms of GC junk. */ | |
| 1204 | 2115 free_marker (XCAR (markers)); |
| 2116 free_marker (XCDR (markers)); | |
| 853 | 2117 free_cons (markers); |
| 2118 free_cons (data); | |
| 428 | 2119 |
| 2120 return Qnil; | |
| 2121 } | |
| 2122 | |
| 2123 DEFUN ("save-restriction", Fsave_restriction, 0, UNEVALLED, 0, /* | |
| 2124 Execute BODY, saving and restoring current buffer's restrictions. | |
| 2125 The buffer's restrictions make parts of the beginning and end invisible. | |
| 2126 \(They are set up with `narrow-to-region' and eliminated with `widen'.) | |
| 2127 This special form, `save-restriction', saves the current buffer's restrictions | |
| 2128 when it is entered, and restores them when it is exited. | |
| 2129 So any `narrow-to-region' within BODY lasts only until the end of the form. | |
| 2130 The old restrictions settings are restored | |
| 2131 even in case of abnormal exit (throw or error). | |
| 2132 | |
| 2133 The value returned is the value of the last form in BODY. | |
| 2134 | |
| 844 | 2135 As of XEmacs 22.0, `save-restriction' correctly handles all modifications |
| 2136 made within BODY. (Formerly, it got confused if, within the BODY, you | |
| 2137 widened and then made changes outside the old restricted area.) | |
| 428 | 2138 |
| 2139 Note: if you are using both `save-excursion' and `save-restriction', | |
| 2140 use `save-excursion' outermost: | |
| 2141 (save-excursion (save-restriction ...)) | |
| 2142 */ | |
| 2143 (body)) | |
| 2144 { | |
| 2145 /* This function can GC */ | |
| 844 | 2146 int speccount = |
| 2147 record_unwind_protect (save_restriction_restore, | |
| 2148 save_restriction_save (current_buffer)); | |
| 428 | 2149 |
| 771 | 2150 return unbind_to_1 (speccount, Fprogn (body)); |
| 428 | 2151 } |
| 2152 | |
| 2153 | |
| 2154 DEFUN ("format", Fformat, 1, MANY, 0, /* | |
| 2155 Format a string out of a control-string and arguments. | |
| 2156 The first argument is a control string. | |
| 2157 The other arguments are substituted into it to make the result, a string. | |
| 2158 It may contain %-sequences meaning to substitute the next argument. | |
| 2159 %s means print all objects as-is, using `princ'. | |
| 2160 %S means print all objects as s-expressions, using `prin1'. | |
| 2161 %d or %i means print as an integer in decimal (%o octal, %x lowercase hex, | |
|
4329
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4266
diff
changeset
|
2162 %X uppercase hex, %b binary). |
| 428 | 2163 %c means print as a single character. |
| 2164 %f means print as a floating-point number in fixed notation (e.g. 785.200). | |
| 2165 %e or %E means print as a floating-point number in scientific notation | |
| 2166 (e.g. 7.85200e+03). | |
| 2167 %g or %G means print as a floating-point number in "pretty format"; | |
| 2168 depending on the number, either %f or %e/%E format will be used, and | |
| 2169 trailing zeroes are removed from the fractional part. | |
| 2170 The argument used for all but %s and %S must be a number. It will be | |
| 2171 converted to an integer or a floating-point number as necessary. | |
| 2172 | |
| 2173 %$ means reposition to read a specific numbered argument; for example, | |
| 2174 %3$s would apply the `%s' to the third argument after the control string, | |
| 2175 and the next format directive would use the fourth argument, the | |
| 2176 following one the fifth argument, etc. (There must be a positive integer | |
| 2177 between the % and the $). | |
| 2178 Zero or more of the flag characters `-', `+', ` ', `0', and `#' may be | |
| 2179 specified between the optional repositioning spec and the conversion | |
| 2180 character; see below. | |
| 2181 An optional minimum field width may be specified after any flag characters | |
| 2182 and before the conversion character; it specifies the minimum number of | |
| 2183 characters that the converted argument will take up. Padding will be | |
| 2184 added on the left (or on the right, if the `-' flag is specified), as | |
| 2185 necessary. Padding is done with spaces, or with zeroes if the `0' flag | |
| 2186 is specified. | |
| 2187 If the field width is specified as `*', the field width is assumed to have | |
| 2188 been specified as an argument. Any repositioning specification that | |
| 2189 would normally specify the argument to be converted will now specify | |
| 2190 where to find this field width argument, not where to find the argument | |
| 2191 to be converted. If there is no repositioning specification, the normal | |
| 2192 next argument is used. The argument to be converted will be the next | |
| 2193 argument after the field width argument unless the precision is also | |
| 2194 specified as `*' (see below). | |
| 2195 | |
| 2196 An optional period character and precision may be specified after any | |
| 2197 minimum field width. It specifies the minimum number of digits to | |
| 2198 appear in %d, %i, %o, %x, and %X conversions (the number is padded | |
| 2199 on the left with zeroes as necessary); the number of digits printed | |
| 2200 after the decimal point for %f, %e, and %E conversions; the number | |
| 2201 of significant digits printed in %g and %G conversions; and the | |
| 2202 maximum number of non-padding characters printed in %s and %S | |
| 2203 conversions. The default precision for floating-point conversions | |
| 2204 is six. | |
| 2205 If the precision is specified as `*', the precision is assumed to have been | |
| 2206 specified as an argument. The argument used will be the next argument | |
| 2207 after the field width argument, if any. If the field width was not | |
| 2208 specified as an argument, any repositioning specification that would | |
| 2209 normally specify the argument to be converted will now specify where to | |
| 2210 find the precision argument. If there is no repositioning specification, | |
| 2211 the normal next argument is used. | |
| 2212 | |
| 2213 The ` ' and `+' flags mean prefix non-negative numbers with a space or | |
| 2214 plus sign, respectively. | |
| 2215 The `#' flag means print numbers in an alternate, more verbose format: | |
| 2216 octal numbers begin with zero; hex numbers begin with a 0x or 0X; | |
| 2217 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 | |
| 2219 %g and %G conversions. | |
| 2220 | |
| 2221 Use %% to put a single % into the output. | |
| 2222 */ | |
| 2223 (int nargs, Lisp_Object *args)) | |
| 2224 { | |
| 2225 /* It should not be necessary to GCPRO ARGS, because | |
| 2226 the caller in the interpreter should take care of that. */ | |
| 2227 | |
| 2228 CHECK_STRING (args[0]); | |
| 771 | 2229 return emacs_vsprintf_string_lisp (0, args[0], nargs - 1, args + 1); |
| 428 | 2230 } |
| 2231 | |
| 2232 | |
| 2233 DEFUN ("char-equal", Fchar_equal, 2, 3, 0, /* | |
| 2234 Return t if two characters match, optionally ignoring case. | |
| 2235 Both arguments must be characters (i.e. NOT integers). | |
| 2236 Case is ignored if `case-fold-search' is non-nil in BUFFER. | |
| 2237 If BUFFER is nil, the current buffer is assumed. | |
| 2238 */ | |
| 444 | 2239 (character1, character2, buffer)) |
| 428 | 2240 { |
| 867 | 2241 Ichar x1, x2; |
| 428 | 2242 struct buffer *b = decode_buffer (buffer, 1); |
| 2243 | |
| 444 | 2244 CHECK_CHAR_COERCE_INT (character1); |
| 2245 CHECK_CHAR_COERCE_INT (character2); | |
| 2246 x1 = XCHAR (character1); | |
| 2247 x2 = XCHAR (character2); | |
| 428 | 2248 |
| 2249 return (!NILP (b->case_fold_search) | |
| 2250 ? DOWNCASE (b, x1) == DOWNCASE (b, x2) | |
| 2251 : x1 == x2) | |
| 2252 ? Qt : Qnil; | |
| 2253 } | |
| 2254 | |
| 434 | 2255 DEFUN ("char=", Fchar_Equal, 2, 2, 0, /* |
| 428 | 2256 Return t if two characters match, case is significant. |
| 2257 Both arguments must be characters (i.e. NOT integers). | |
| 2258 */ | |
| 444 | 2259 (character1, character2)) |
| 428 | 2260 { |
| 444 | 2261 CHECK_CHAR_COERCE_INT (character1); |
| 2262 CHECK_CHAR_COERCE_INT (character2); | |
| 428 | 2263 |
| 444 | 2264 return EQ (character1, character2) ? Qt : Qnil; |
| 428 | 2265 } |
| 2266 | |
| 2267 #if 0 /* Undebugged FSFmacs code */ | |
| 2268 /* Transpose the markers in two regions of the current buffer, and | |
| 2269 adjust the ones between them if necessary (i.e.: if the regions | |
| 2270 differ in size). | |
| 2271 | |
| 2272 Traverses the entire marker list of the buffer to do so, adding an | |
| 2273 appropriate amount to some, subtracting from some, and leaving the | |
| 2274 rest untouched. Most of this is copied from adjust_markers in insdel.c. | |
| 2275 | |
| 2276 It's the caller's job to see that (start1 <= end1 <= start2 <= end2). */ | |
| 2277 | |
| 2278 void | |
| 665 | 2279 transpose_markers (Charbpos start1, Charbpos end1, Charbpos start2, Charbpos end2) |
| 428 | 2280 { |
| 2281 Charcount amt1, amt2, diff; | |
| 2282 Lisp_Object marker; | |
| 2283 struct buffer *buf = current_buffer; | |
| 2284 | |
| 2285 /* Update point as if it were a marker. */ | |
| 2286 if (BUF_PT (buf) < start1) | |
| 2287 ; | |
| 2288 else if (BUF_PT (buf) < end1) | |
| 2289 BUF_SET_PT (buf, BUF_PT (buf) + (end2 - end1)); | |
| 2290 else if (BUF_PT (buf) < start2) | |
| 2291 BUF_SET_PT (buf, BUF_PT (buf) + (end2 - start2) - (end1 - start1)); | |
| 2292 else if (BUF_PT (buf) < end2) | |
| 2293 BUF_SET_PT (buf, BUF_PT (buf) - (start2 - start1)); | |
| 2294 | |
| 2295 /* We used to adjust the endpoints here to account for the gap, but that | |
| 2296 isn't good enough. Even if we assume the caller has tried to move the | |
| 2297 gap out of our way, it might still be at start1 exactly, for example; | |
| 2298 and that places it `inside' the interval, for our purposes. The amount | |
| 2299 of adjustment is nontrivial if there's a `denormalized' marker whose | |
| 2300 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave | |
| 2301 the dirty work to Fmarker_position, below. */ | |
| 2302 | |
| 2303 /* The difference between the region's lengths */ | |
| 2304 diff = (end2 - start2) - (end1 - start1); | |
| 2305 | |
| 2306 /* For shifting each marker in a region by the length of the other | |
| 2307 * region plus the distance between the regions. | |
| 2308 */ | |
| 2309 amt1 = (end2 - start2) + (start2 - end1); | |
| 2310 amt2 = (end1 - start1) + (start2 - end1); | |
| 2311 | |
| 2312 for (marker = BUF_MARKERS (buf); !NILP (marker); | |
| 2313 marker = XMARKER (marker)->chain) | |
| 2314 { | |
| 665 | 2315 Charbpos mpos = marker_position (marker); |
| 428 | 2316 if (mpos >= start1 && mpos < end2) |
| 2317 { | |
| 2318 if (mpos < end1) | |
| 2319 mpos += amt1; | |
| 2320 else if (mpos < start2) | |
| 2321 mpos += diff; | |
| 2322 else | |
| 2323 mpos -= amt2; | |
| 2324 set_marker_position (marker, mpos); | |
| 2325 } | |
| 2326 } | |
| 2327 } | |
| 2328 | |
| 2329 #endif /* 0 */ | |
| 2330 | |
| 2331 DEFUN ("transpose-regions", Ftranspose_regions, 4, 5, 0, /* | |
| 2332 Transpose region START1 to END1 with START2 to END2. | |
| 2333 The regions may not be overlapping, because the size of the buffer is | |
| 2334 never changed in a transposition. | |
| 2335 | |
| 444 | 2336 Optional fifth arg LEAVE-MARKERS, if non-nil, means don't transpose |
| 428 | 2337 any markers that happen to be located in the regions. (#### BUG: currently |
| 444 | 2338 this function always acts as if LEAVE-MARKERS is non-nil.) |
| 428 | 2339 |
| 2340 Transposing beyond buffer boundaries is an error. | |
| 2341 */ | |
| 2286 | 2342 (start1, end1, start2, end2, UNUSED (leave_markers))) |
| 428 | 2343 { |
| 665 | 2344 Charbpos startr1, endr1, startr2, endr2; |
| 428 | 2345 Charcount len1, len2; |
| 2346 Lisp_Object string1, string2; | |
| 2347 struct buffer *buf = current_buffer; | |
| 2348 | |
| 444 | 2349 get_buffer_range_char (buf, start1, end1, &startr1, &endr1, 0); |
| 2350 get_buffer_range_char (buf, start2, end2, &startr2, &endr2, 0); | |
| 428 | 2351 |
| 444 | 2352 len1 = endr1 - startr1; |
| 2353 len2 = endr2 - startr2; | |
| 428 | 2354 |
| 444 | 2355 if (startr2 < endr1) |
| 563 | 2356 invalid_argument ("transposed regions not properly ordered", Qunbound); |
| 444 | 2357 else if (startr1 == endr1 || startr2 == endr2) |
| 563 | 2358 invalid_argument ("transposed region may not be of length 0", Qunbound); |
| 428 | 2359 |
| 444 | 2360 string1 = make_string_from_buffer (buf, startr1, len1); |
| 2361 string2 = make_string_from_buffer (buf, startr2, len2); | |
| 2362 buffer_delete_range (buf, startr2, endr2, 0); | |
| 2363 buffer_insert_lisp_string_1 (buf, startr2, string1, 0); | |
| 2364 buffer_delete_range (buf, startr1, endr1, 0); | |
| 2365 buffer_insert_lisp_string_1 (buf, startr1, string2, 0); | |
| 428 | 2366 |
| 2367 /* In FSFmacs there is a whole bunch of really ugly code here | |
| 2368 to attempt to transpose the regions without using up any | |
| 2369 extra memory. Although the intent may be good, the result | |
| 2370 was highly bogus. */ | |
| 2371 | |
| 2372 return Qnil; | |
| 2373 } | |
| 2374 | |
| 2375 | |
| 2376 /************************************************************************/ | |
| 2377 /* initialization */ | |
| 2378 /************************************************************************/ | |
| 2379 | |
| 2380 void | |
| 2381 syms_of_editfns (void) | |
| 2382 { | |
| 563 | 2383 DEFSYMBOL (Qpoint); |
| 2384 DEFSYMBOL (Qmark); | |
| 2385 DEFSYMBOL (Qregion_beginning); | |
| 2386 DEFSYMBOL (Qregion_end); | |
| 2387 DEFSYMBOL (Qformat); | |
| 2388 DEFSYMBOL (Quser_files_and_directories); | |
| 428 | 2389 |
| 2390 DEFSUBR (Fchar_equal); | |
| 2391 DEFSUBR (Fchar_Equal); | |
| 2392 DEFSUBR (Fgoto_char); | |
| 2393 DEFSUBR (Fstring_to_char); | |
| 2394 DEFSUBR (Fchar_to_string); | |
| 2395 DEFSUBR (Fbuffer_substring); | |
| 2396 DEFSUBR (Fbuffer_substring_no_properties); | |
| 2397 | |
| 2398 DEFSUBR (Fpoint_marker); | |
| 2399 DEFSUBR (Fmark_marker); | |
| 2400 DEFSUBR (Fpoint); | |
| 2401 DEFSUBR (Fregion_beginning); | |
| 2402 DEFSUBR (Fregion_end); | |
| 2403 DEFSUBR (Fsave_excursion); | |
| 2404 DEFSUBR (Fsave_current_buffer); | |
| 2405 | |
| 2406 DEFSUBR (Fbuffer_size); | |
| 2407 DEFSUBR (Fpoint_max); | |
| 2408 DEFSUBR (Fpoint_min); | |
| 2409 DEFSUBR (Fpoint_min_marker); | |
| 2410 DEFSUBR (Fpoint_max_marker); | |
| 2411 | |
| 2412 DEFSUBR (Fbobp); | |
| 2413 DEFSUBR (Feobp); | |
| 2414 DEFSUBR (Fbolp); | |
| 2415 DEFSUBR (Feolp); | |
| 2416 DEFSUBR (Ffollowing_char); | |
| 2417 DEFSUBR (Fpreceding_char); | |
| 2418 DEFSUBR (Fchar_after); | |
| 2419 DEFSUBR (Fchar_before); | |
| 2420 DEFSUBR (Finsert); | |
| 2421 DEFSUBR (Finsert_string); | |
| 2422 DEFSUBR (Finsert_before_markers); | |
| 2423 DEFSUBR (Finsert_char); | |
| 2424 | |
| 2425 DEFSUBR (Ftemp_directory); | |
| 2426 DEFSUBR (Fuser_login_name); | |
| 2427 DEFSUBR (Fuser_real_login_name); | |
| 2428 DEFSUBR (Fuser_uid); | |
| 2429 DEFSUBR (Fuser_real_uid); | |
| 2430 DEFSUBR (Fuser_full_name); | |
| 2431 DEFSUBR (Fuser_home_directory); | |
| 2432 DEFSUBR (Femacs_pid); | |
| 2433 DEFSUBR (Fcurrent_time); | |
| 2434 DEFSUBR (Fcurrent_process_time); | |
| 2435 DEFSUBR (Fformat_time_string); | |
| 2436 DEFSUBR (Fdecode_time); | |
| 2437 DEFSUBR (Fencode_time); | |
| 2438 DEFSUBR (Fcurrent_time_string); | |
| 2439 DEFSUBR (Fcurrent_time_zone); | |
| 2440 DEFSUBR (Fset_time_zone_rule); | |
| 2441 DEFSUBR (Fsystem_name); | |
| 2442 DEFSUBR (Fformat); | |
| 2443 | |
| 2444 DEFSUBR (Finsert_buffer_substring); | |
| 2445 DEFSUBR (Fcompare_buffer_substrings); | |
| 2446 DEFSUBR (Fsubst_char_in_region); | |
| 2447 DEFSUBR (Ftranslate_region); | |
| 2448 DEFSUBR (Fdelete_region); | |
| 2449 DEFSUBR (Fwiden); | |
| 2450 DEFSUBR (Fnarrow_to_region); | |
| 2451 DEFSUBR (Fsave_restriction); | |
| 2452 DEFSUBR (Ftranspose_regions); | |
| 2453 | |
| 563 | 2454 DEFSYMBOL (Qzmacs_update_region); |
| 2455 DEFSYMBOL (Qzmacs_deactivate_region); | |
| 2456 DEFSYMBOL (Qzmacs_region_buffer); | |
| 428 | 2457 } |
| 2458 | |
| 2459 void | |
| 2460 vars_of_editfns (void) | |
| 2461 { | |
| 2462 staticpro (&Vsystem_name); | |
| 2463 #if 0 | |
| 2464 staticpro (&Vuser_name); | |
| 2465 staticpro (&Vuser_real_name); | |
| 2466 #endif | |
| 2467 DEFVAR_BOOL ("zmacs-regions", &zmacs_regions /* | |
| 2468 *Whether LISPM-style active regions should be used. | |
| 2469 This means that commands which operate on the region (the area between the | |
| 2470 point and the mark) will only work while the region is in the ``active'' | |
| 2471 state, which is indicated by highlighting. Executing most commands causes | |
| 2472 the region to not be in the active state, so (for example) \\[kill-region] will only | |
| 2473 work immediately after activating the region. | |
| 2474 | |
| 2475 More specifically: | |
| 2476 | |
| 2477 - Commands which operate on the region only work if the region is active. | |
| 2478 - Only a very small set of commands cause the region to become active: | |
| 444 | 2479 Those commands whose semantics are to mark an area, like `mark-defun'. |
| 428 | 2480 - The region is deactivated after each command that is executed, except that: |
| 2481 - "Motion" commands do not change whether the region is active or not. | |
| 2482 | |
| 2483 set-mark-command (C-SPC) pushes a mark and activates the region. Moving the | |
| 2484 cursor with normal motion commands (C-n, C-p, etc) will cause the region | |
| 2485 between point and the recently-pushed mark to be highlighted. It will | |
| 2486 remain highlighted until some non-motion command is executed. | |
| 2487 | |
| 2488 exchange-point-and-mark (\\[exchange-point-and-mark]) activates the region. So if you mark a | |
| 2489 region and execute a command that operates on it, you can reactivate the | |
| 2490 same region with \\[exchange-point-and-mark] (or perhaps \\[exchange-point-and-mark] \\[exchange-point-and-mark]) to operate on it | |
| 2491 again. | |
| 2492 | |
| 2493 Generally, commands which push marks as a means of navigation (like | |
| 2494 beginning-of-buffer and end-of-buffer (M-< and M->)) do not activate the | |
| 2495 region. But commands which push marks as a means of marking an area of | |
| 2496 text (like mark-defun (\\[mark-defun]), mark-word (\\[mark-word]) or mark-whole-buffer (\\[mark-whole-buffer])) | |
| 2497 do activate the region. | |
| 2498 | |
| 2499 The way the command loop actually works with regard to deactivating the | |
| 2500 region is as follows: | |
| 2501 | |
| 2502 - If the variable `zmacs-region-stays' has been set to t during the command | |
| 2503 just executed, the region is left alone (this is how the motion commands | |
| 2504 make the region stay around; see the `_' flag in the `interactive' | |
| 2505 specification). `zmacs-region-stays' is reset to nil before each command | |
| 2506 is executed. | |
| 2507 - If the function `zmacs-activate-region' has been called during the command | |
| 2508 just executed, the region is left alone. Very few functions should | |
| 2509 actually call this function. | |
| 2510 - Otherwise, if the region is active, the region is deactivated and | |
| 2511 the `zmacs-deactivate-region-hook' is called. | |
| 2512 */ ); | |
| 2513 /* Zmacs style active regions are now ON by default */ | |
| 2514 zmacs_regions = 1; | |
| 2515 | |
| 2516 DEFVAR_BOOL ("zmacs-region-active-p", &zmacs_region_active_p /* | |
| 2517 Do not alter this. It is for internal use only. | |
| 2518 */ ); | |
| 2519 zmacs_region_active_p = 0; | |
| 2520 | |
| 2521 DEFVAR_BOOL ("zmacs-region-stays", &zmacs_region_stays /* | |
| 2522 Whether the current command will deactivate the region. | |
| 2523 Commands which do not wish to affect whether the region is currently | |
| 2524 highlighted should set this to t. Normally, the region is turned off after | |
| 2525 executing each command that did not explicitly turn it on with the function | |
| 2526 zmacs-activate-region. Setting this to true lets a command be non-intrusive. | |
| 2527 See the variable `zmacs-regions'. | |
| 2528 | |
| 2529 The same effect can be achieved using the `_' interactive specification. | |
| 442 | 2530 |
| 2531 `zmacs-region-stays' is reset to nil before each command is executed. | |
| 428 | 2532 */ ); |
| 2533 zmacs_region_stays = 0; | |
| 2534 | |
| 2535 DEFVAR_BOOL ("atomic-extent-goto-char-p", &atomic_extent_goto_char_p /* | |
| 2536 Do not use this -- it will be going away soon. | |
| 2537 Indicates if `goto-char' has just been run. This information is allegedly | |
| 2538 needed to get the desired behavior for atomic extents and unfortunately | |
| 2539 is not available by any other means. | |
| 2540 */ ); | |
| 2541 atomic_extent_goto_char_p = 0; | |
| 2542 #ifdef AMPERSAND_FULL_NAME | |
| 771 | 2543 Fprovide (intern ("ampersand-full-name")); |
| 428 | 2544 #endif |
| 2545 | |
| 2546 DEFVAR_LISP ("user-full-name", &Vuser_full_name /* | |
| 2547 *The name of the user. | |
| 4266 | 2548 The function `user-full-name' will return the value of this variable, when |
| 2549 called without arguments. | |
| 428 | 2550 This is initialized to the value of the NAME environment variable. |
| 2551 */ ); | |
| 2552 /* Initialized at run-time. */ | |
| 2553 Vuser_full_name = Qnil; | |
| 2554 } |