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

[Richard M . Stallman]

Index: emacs/man/files.texi
diff -c emacs/man/files.texi:1.116 emacs/man/files.texi:1.117
*** emacs/man/files.texi:1.116  Wed Sep 14 20:20:55 2005
--- emacs/man/files.texi        Thu Sep 15 12:47:10 2005
***************
*** 366,371 ****
--- 366,386 ----
    @dfn{Saving} a buffer in Emacs means writing its contents back into the file
  that was visited in the buffer.
  
+ @menu
+ * Save Commands::       Commands for saving files.
+ * Backup::              How Emacs saves the old version of your file.
+ * Customize Save::      Customizing the saving of files.
+ * Interlocking::        How Emacs protects against simultaneous editing
+                           of one file by two users.
+ * Shadowing: File Shadowing.  Copying files to "shadows" automatically.
+ * Time Stamps::         Emacs can update time stamps on saved files.
+ @end menu
+ 
+ @node Saving Commands
+ @subsection Commands for Saving Files
+ 
+   These are the commands that relate to saving and writing files.
+ 
  @table @kbd
  @item C-x C-s
  Save the current buffer in its visited file on disk (@code{save-buffer}).
***************
*** 483,524 ****
  by simultaneous editing and requires your immediate attention.
  @xref{Interlocking,, Simultaneous Editing}.
  
- @vindex require-final-newline
-   If the value of the variable @code{require-final-newline} is
- @code{t}, Emacs silently puts a newline at the end of any file that
- doesn't already end in one, every time a file is saved or written.  If
- the value is @code{visit}, Emacs adds a newline at the end of any file
- that doesn't have one, just after it visits the file.  (This marks the
- buffer as modified, and you can undo it.)  If the value is
- @code{visit-save}, that means to add newlines both on visiting and on
- saving.  If the value is @code{nil}, Emacs leaves the end of the file
- unchanged; if it's neither @code{nil} nor @code{t}, Emacs asks you
- whether to add a newline.  The default is @code{nil}.
- 
- @vindex mode-require-final-newline
-   Many major modes are designed for specific kinds of files that are
- always supposed to end in newlines.  These major modes set the
- variable @code{require-final-newline} according to
- @code{mode-require-final-newline}.  By setting the latter variable,
- you can control how these modes handle final newlines.
- 
- @vindex write-region-inhibit-fsync
-   When Emacs saves a file to disk, it issues an @code{fsync} call to the
- operating system to ensure that your data has indeed reached the media.
- This is important for safety if the system crashes or in case of power
- outage.  However, it can be disruptive on laptops using power saving
- because it forces the system to spin up the drive each time you save a
- file; the variable @code{write-region-inhibit-fsync} disables this
- synchronization.  This may result in data loss, use with care!
- 
- @menu
- * Backup::              How Emacs saves the old version of your file.
- * Interlocking::        How Emacs protects against simultaneous editing
-                           of one file by two users.
- * Shadowing: File Shadowing.  Copying files to "shadows" automatically.
- * Time Stamps::         Emacs can update time stamps on saved files.
- @end menu
- 
  @node Backup
  @subsection Backup Files
  @cindex backup file
--- 498,503 ----
***************
*** 725,730 ****
--- 704,741 ----
  any alternate names for the same file.  This has nothing to do with
  Emacs---the version control system does it.
  
+ @node Customize Save
+ @subsection Customizing Saving of Files
+ 
+ @vindex require-final-newline
+   If the value of the variable @code{require-final-newline} is
+ @code{t}, saving or writing a file silently puts a newline at the end
+ if there isn't already one there.  If the value is @code{visit}, Emacs
+ adds a newline at the end of any file that doesn't have one, just
+ after it visits the file.  (This marks the buffer as modified, and you
+ can undo it.)  If the value is @code{visit-save}, that means to add
+ newlines both on visiting and on saving.  If the value is @code{nil},
+ Emacs leaves the end of the file unchanged; if it's neither @code{nil}
+ nor @code{t}, Emacs asks you whether to add a newline.  The default is
+ @code{nil}.
+ 
+ @vindex mode-require-final-newline
+   Many major modes are designed for specific kinds of files that are
+ always supposed to end in newlines.  These major modes set the
+ variable @code{require-final-newline} according to
+ @code{mode-require-final-newline}.  By setting the latter variable,
+ you can control how these modes handle final newlines.
+ 
+ @vindex write-region-inhibit-fsync
+   When Emacs saves a file, it invokes the @code{fsync} system call to
+ force the data immediately out to disk.  This is important for safety
+ if the system crashes or in case of power outage.  However, it can be
+ disruptive on laptops using power saving, because it requires the disk
+ to spin up each time you save a file.  Setting
+ @code{write-region-inhibit-fsync} to a address@hidden value disables
+ this synchronization.  Be careful---this means increased risk of data
+ loss.
+ 
  @node Interlocking
  @subsection Protection against Simultaneous Editing
  
***************
*** 3008,3015 ****
  @findex write-region
    @kbd{M-x write-region} is the inverse of @kbd{M-x insert-file}; it
  copies the contents of the region into the specified file.  @kbd{M-x
! append-to-file} adds the text of the region to the end of the specified
! file.  @xref{Accumulating Text}.
  
  @findex delete-file
  @cindex deletion (of files)
--- 3019,3028 ----
  @findex write-region
    @kbd{M-x write-region} is the inverse of @kbd{M-x insert-file}; it
  copies the contents of the region into the specified file.  @kbd{M-x
! append-to-file} adds the text of the region to the end of the
! specified file.  @xref{Accumulating Text}.  The variable
! @code{write-region-inhibit-fsync} applies to these commands, as well
! as saving files; see @ref{Customize Save}.
  
  @findex delete-file
  @cindex deletion (of files)