[Emacs-diffs] Changes to emacs/lispref/files.texi [lexbind]

[Miles Bader]

Index: emacs/lispref/files.texi
diff -c emacs/lispref/files.texi:1.42.4.11 emacs/lispref/files.texi:1.42.4.12
*** emacs/lispref/files.texi:1.42.4.11  Tue Jul  6 10:23:38 2004
--- emacs/lispref/files.texi    Tue Jul  6 10:26:56 2004
***************
*** 415,431 ****
  
  @c Emacs 19 feature
  @defvar write-contents-functions
! This works just like @code{write-file-functions}, but it is intended for
! hooks that pertain to the contents of the file, as opposed to hooks that
! pertain to the file's name or location.  Such hooks are usually set up by
! major modes, as buffer-local bindings for this variable.  If any of the
! functions in this hook returns address@hidden, the file is considered
! already written and the rest are not called and neither are the functions
! in @code{write-file-functions}.
! 
! This variable automatically becomes buffer-local whenever it is set;
! switching to a new major mode always resets this variable, but
! calling @code{set-visited-file-name} does not.
  @end defvar
  
  @defopt before-save-hook
--- 415,431 ----
  
  @c Emacs 19 feature
  @defvar write-contents-functions
! This works just like @code{write-file-functions}, but it is intended
! for hooks that pertain to the buffer's contents, not to the particular
! visited file or its location.  Such hooks are usually set up by major
! modes, as buffer-local bindings for this variable.  This variable
! automatically becomes buffer-local whenever it is set; switching to a
! new major mode always resets this variable, but calling
! @code{set-visited-file-name} does not.
! 
! If any of the functions in this hook returns address@hidden, the file
! is considered already written and the rest are not called and neither
! are the functions in @code{write-file-functions}.
  @end defvar
  
  @defopt before-save-hook
***************
*** 2646,2652 ****
  @end defun
  
  @defun file-remote-p filename
! This function returns @code{t} if @var{filename} is a remote file.
  @end defun
  
  @defun unhandled-file-name-directory filename
--- 2646,2667 ----
  @end defun
  
  @defun file-remote-p filename
! This function tests whether @var{filename} is a remote file.  If
! @var{filename} is local (not remote), the return value is @code{nil}.
! If @var{filename} is indeed remote, the return value is a string that
! identifies the remote system.
! 
! This identifier string may include a host name, a user name, and
! characters designating the method used to access the remote system.
! For example, the remote identifier string for the filename
! @code{/ssh:user@@host:/some/file} is @code{/ssh:user@@host:}.
! 
! If @code{file-remote-p} returns the same identifier for two different
! filenames, that means they are stored on the same file system and can
! be accessed locally with respect to each other.  This means, for
! example, that it is possible to start a remote process accessing both
! files at the same time.  Implementors of file handlers need to ensure
! this principle is valid.
  @end defun
  
  @defun unhandled-file-name-directory filename