[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.9 emacs/lispref/files.texi:1.42.4.10
*** emacs/lispref/files.texi:1.42.4.9   Tue Jul  6 09:31:53 2004
--- emacs/lispref/files.texi    Tue Jul  6 10:20:17 2004
***************
*** 329,336 ****
  @end itemize
  @end deffn
  
- @anchor{Definition of save-some-buffers}
  @deffn Command save-some-buffers &optional save-silently-p pred
  This command saves some modified file-visiting buffers.  Normally it
  asks the user about each buffer.  But if @var{save-silently-p} is
  address@hidden, it saves all the file-visiting buffers without querying
--- 329,336 ----
  @end itemize
  @end deffn
  
  @deffn Command save-some-buffers &optional save-silently-p pred
+ @anchor{Definition of save-some-buffers}
  This command saves some modified file-visiting buffers.  Normally it
  asks the user about each buffer.  But if @var{save-silently-p} is
  address@hidden, it saves all the file-visiting buffers without querying
***************
*** 352,359 ****
  value in a certain buffer, that means do offer to save that buffer.
  @end deffn
  
- @anchor{Definition of write-file}
  @deffn Command write-file filename &optional confirm
  This function writes the current buffer into file @var{filename}, makes
  the buffer visit that file, and marks it not modified.  Then it renames
  the buffer based on @var{filename}, appending a string like @samp{<2>}
--- 352,359 ----
  value in a certain buffer, that means do offer to save that buffer.
  @end deffn
  
  @deffn Command write-file filename &optional confirm
+ @anchor{Definition of write-file}
  This function writes the current buffer into file @var{filename}, makes
  the buffer visit that file, and marks it not modified.  Then it renames
  the buffer based on @var{filename}, appending a string like @samp{<2>}
***************
*** 416,426 ****
  @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 where the file came from.  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, @code{write-file-functions}
! is not run.
  
  This variable automatically becomes buffer-local whenever it is set;
  switching to a new major mode always resets this variable, but
--- 416,427 ----
  @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 buffer, as opposed to hooks that
! pertain to the file the buffers visits.  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
***************
*** 625,632 ****
  files that the user does not need to know about.
  @end deffn
  
- @anchor{Definition of with-temp-file}
  @defmac with-temp-file file body...
  The @code{with-temp-file} macro evaluates the @var{body} forms with a
  temporary buffer as the current buffer; then, at the end, it writes the
  buffer contents into file @var{file}.  It kills the temporary buffer
--- 626,633 ----
  files that the user does not need to know about.
  @end deffn
  
  @defmac with-temp-file file body...
+ @anchor{Definition of with-temp-file}
  The @code{with-temp-file} macro evaluates the @var{body} forms with a
  temporary buffer as the current buffer; then, at the end, it writes the
  buffer contents into file @var{file}.  It kills the temporary buffer
***************
*** 1124,1131 ****
  @end example
  @end defun
  
- @anchor{Definition of file-attributes}
  @defun file-attributes filename &optional id-format
  This function returns a list of attributes of file @var{filename}.  If
  the specified file cannot be opened, it returns @code{nil}.
  The optional parameter @var{id-format} specifies the preferred format
--- 1125,1132 ----
  @end example
  @end defun
  
  @defun file-attributes filename &optional id-format
+ @anchor{Definition of file-attributes}
  This function returns a list of attributes of file @var{filename}.  If
  the specified file cannot be opened, it returns @code{nil}.
  The optional parameter @var{id-format} specifies the preferred format
***************
*** 1823,1830 ****
    To convert a directory name to its abbreviation, use this
  function:
  
- @anchor{Definition of abbreviate-file-name}
  @defun abbreviate-file-name filename
  This function applies abbreviations from @code{directory-abbrev-alist}
  to its argument, and substitutes @samp{~} for the user's home
  directory.  You can use it for directory names and for file names,
--- 1824,1831 ----
    To convert a directory name to its abbreviation, use this
  function:
  
  @defun abbreviate-file-name filename
+ @anchor{Definition of abbreviate-file-name}
  This function applies abbreviations from @code{directory-abbrev-alist}
  to its argument, and substitutes @samp{~} for the user's home
  directory.  You can use it for directory names and for file names,
***************
*** 1951,1958 ****
  @end example
  @end defvar
  
- @anchor{Definition of substitute-in-file-name}
  @defun substitute-in-file-name filename
  This function replaces environment variable references in
  @var{filename} with the environment variable values.  Following
  standard Unix shell syntax, @samp{$} is the prefix to substitute an
--- 1952,1959 ----
  @end example
  @end defvar
  
  @defun substitute-in-file-name filename
+ @anchor{Definition of substitute-in-file-name}
  This function replaces environment variable references in
  @var{filename} with the environment variable values.  Following
  standard Unix shell syntax, @samp{$} is the prefix to substitute an