comparison src/fileio.c @ 41993:0b548ba2f6d6

(Fwrite_region): Doc fix.
author Richard M. Stallman <rms@gnu.org>
date Wed, 12 Dec 2001 22:53:16 +0000
parents e669966d496e
children 12131c06473a
comparison
equal deleted inserted replaced
41992:01f706123cff 41993:0b548ba2f6d6
4646 } 4646 }
4647 4647
4648 DEFUN ("write-region", Fwrite_region, Swrite_region, 3, 7, 4648 DEFUN ("write-region", Fwrite_region, Swrite_region, 3, 7,
4649 "r\nFWrite region to file: \ni\ni\ni\np", 4649 "r\nFWrite region to file: \ni\ni\ni\np",
4650 doc: /* Write current region into specified file. 4650 doc: /* Write current region into specified file.
4651 When called from a program, takes three arguments: 4651 When called from a program, requires three arguments:
4652 START, END and FILENAME. START and END are buffer positions. 4652 START, END and FILENAME. START and END are normally buffer positions
4653 specifying the part of the buffer to write.
4654 If START is nil, that means to use the entire buffer contents.
4655 If START is a string, then output that string to the file
4656 instead of any buffer contents; END is ignored.
4657
4653 Optional fourth argument APPEND if non-nil means 4658 Optional fourth argument APPEND if non-nil means
4654 append to existing file contents (if any). If it is an integer, 4659 append to existing file contents (if any). If it is an integer,
4655 seek to that offset in the file before writing. 4660 seek to that offset in the file before writing.
4656 Optional fifth argument VISIT if t means 4661 Optional fifth argument VISIT if t means
4657 set the last-save-file-modtime of buffer to this file's modtime 4662 set the last-save-file-modtime of buffer to this file's modtime
4667 for an existing file with the same name. If MUSTBENEW is `excl', 4672 for an existing file with the same name. If MUSTBENEW is `excl',
4668 that means to get an error if the file already exists; never overwrite. 4673 that means to get an error if the file already exists; never overwrite.
4669 If MUSTBENEW is neither nil nor `excl', that means ask for 4674 If MUSTBENEW is neither nil nor `excl', that means ask for
4670 confirmation before overwriting, but do go ahead and overwrite the file 4675 confirmation before overwriting, but do go ahead and overwrite the file
4671 if the user confirms. 4676 if the user confirms.
4672 Kludgy feature: if START is a string, then that string is written
4673 to the file, instead of any buffer contents, and END is ignored.
4674 4677
4675 This does code conversion according to the value of 4678 This does code conversion according to the value of
4676 `coding-system-for-write', `buffer-file-coding-system', or 4679 `coding-system-for-write', `buffer-file-coding-system', or
4677 `file-coding-system-alist', and sets the variable 4680 `file-coding-system-alist', and sets the variable
4678 `last-coding-system-used' to the coding system actually used. */) 4681 `last-coding-system-used' to the coding system actually used. */)