Show
Ignore:
Timestamp:
05/18/06 16:19:18 (3 years ago)
Author:
miyoshi
Message:

Sync up with Emacs CVS HEAD.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/lispref/files.texi

    r4079 r4085  
    115115 
    116116@defun find-file-noselect filename &optional nowarn rawfile wildcards 
    117 This function is the guts of all the file-visiting functions.  It finds 
    118 or creates a buffer visiting the file @var{filename}, and returns it. 
    119 It uses an existing buffer if there is one, and otherwise creates a new 
    120 buffer and reads the file into it.  You may make the buffer current or 
    121 display it in a window if you wish, but this function does not do so. 
    122  
    123 If @var{wildcards} is non-@code{nil}, 
    124 then @code{find-file-noselect} expands wildcard 
    125 characters in @var{filename} and visits all the matching files. 
    126  
    127 When @code{find-file-noselect} uses an existing buffer, it first 
    128 verifies that the file has not changed since it was last visited or 
    129 saved in that buffer.  If the file has changed, then this function asks 
    130 the user whether to reread the changed file.  If the user says 
    131 @samp{yes}, any changes previously made in the buffer are lost. 
     117This function is the guts of all the file-visiting functions.  It 
     118returns a buffer visiting the file @var{filename}.  You may make the 
     119buffer current or display it in a window if you wish, but this 
     120function does not do so. 
     121 
     122The function returns an existing buffer if there is one; otherwise it 
     123creates a new buffer and reads the file into it.  When 
     124@code{find-file-noselect} uses an existing buffer, it first verifies 
     125that the file has not changed since it was last visited or saved in 
     126that buffer.  If the file has changed, this function asks the user 
     127whether to reread the changed file.  If the user says @samp{yes}, any 
     128edits previously made in the buffer are lost. 
     129 
     130Reading the file involves decoding the file's contents (@pxref{Coding 
     131Systems}), including end-of-line conversion, and format conversion 
     132(@pxref{Format Conversion}).  If @var{wildcards} is non-@code{nil}, 
     133then @code{find-file-noselect} expands wildcard characters in 
     134@var{filename} and visits all the matching files. 
    132135 
    133136This function displays warning or advisory messages in various peculiar 
    …… 
    136139@var{filename}, it displays the message @samp{(New file)} in the echo 
    137140area, and leaves the buffer empty. 
    138  
    139 Reading the file(s) into their respective buffers involves decoding 
    140 the files' contents (@pxref{Coding Systems}), including end-of-line 
    141 conversion. 
    142141 
    143142The @code{find-file-noselect} function normally calls 
    …… 
    150149If the optional argument @var{rawfile} is non-@code{nil}, then 
    151150@code{after-find-file} is not called, and the 
    152 @code{find-file-not-found-functions} are not run in case of failure.  What's 
    153 more, a non-@code{nil} @var{rawfile} value suppresses coding system 
    154 conversion (@pxref{Coding Systems}) and format conversion (@pxref{Format 
    155 Conversion}). 
     151@code{find-file-not-found-functions} are not run in case of failure. 
     152What's more, a non-@code{nil} @var{rawfile} value suppresses coding 
     153system conversion and format conversion. 
    156154 
    157155The @code{find-file-noselect} function usually returns the buffer that