+2011-08-28 Chong Yidong <cyd@stupidchicken.com>
+
+ * files.texi (File Archives):
+ * cal-xtra.texi (Diary Display):
+ * help.texi (Help Mode): Add xref to View Mode.
+
2011-08-28 Chong Yidong <cyd@stupidchicken.com>
* display.texi (View Mode): New node. Move view-file here from
days to be shown in the fancy diary buffer, set the variable
@code{diary-list-include-blanks} to @code{t}.@refill
-@c View mode does not seem to be described in the manual.
-@c buffers.texi has a brief mention.
- The fancy diary buffer enables View mode, a minor mode that provides
-commands for scrolling and searching the text. For example, @key{SPC}
-and @key{DEL} scroll forward and backward, and @key{s} starts an
-incremental search. See the documentation of the function
-@code{view-mode} for more information.
+ The fancy diary buffer enables View mode (@pxref{View Mode}).
The alternative display method @code{diary-simple-display} shows the
actual diary buffer, and uses invisible text to hide entries that don't
screenfuls. It provides commands for scrolling through the buffer
conveniently but not for changing it. Apart from the usual Emacs
cursor motion commands, you can type @key{SPC} to scroll forward one
-windowful, or @key{DEL} to scroll backward.
+windowful, @key{DEL} to scroll backward, and @kbd{s} to start an
+incremental search.
Typing @kbd{q} disables View mode, and switches back to the buffer
-and position before View mode was enabled. Alternatively, type
+and position before View mode was enabled. Alternatively, typing
@kbd{e} disables View mode, keeping the current buffer and position.
@findex view-buffer
The keys @kbd{e}, @kbd{f} and @key{RET} all extract a component file
into its own buffer. You can edit it there, and if you save the
buffer, the edited version will replace the version in the Tar buffer.
-@kbd{v} extracts a file into a buffer in View mode. @kbd{o} extracts
-the file and displays it in another window, so you could edit the file
-and operate on the archive simultaneously. @kbd{d} marks a file for
-deletion when you later use @kbd{x}, and @kbd{u} unmarks a file, as in
-Dired. @kbd{C} copies a file from the archive to disk and @kbd{R}
-renames a file within the archive. @kbd{g} reverts the buffer from
-the archive on disk.
+@kbd{v} extracts a file into a buffer in View mode (@pxref{View
+Mode}). @kbd{o} extracts the file and displays it in another window,
+so you could edit the file and operate on the archive simultaneously.
+@kbd{d} marks a file for deletion when you later use @kbd{x}, and
+@kbd{u} unmarks a file, as in Dired. @kbd{C} copies a file from the
+archive to disk and @kbd{R} renames a file within the archive.
+@kbd{g} reverts the buffer from the archive on disk.
The keys @kbd{M}, @kbd{G}, and @kbd{O} change the file's permission
bits, group, and owner, respectively.
@node Help Mode
@section Help Mode Commands
- Help buffers provide the same commands as View mode (@pxref{Misc File
-Ops}), plus a few special commands of their own.
+ Help buffers provide the same commands as View mode (@pxref{View
+Mode}), plus a few special commands of their own.
@table @kbd
@item @key{SPC}
* files.texi (Changing Files, Create/Delete Dirs): Document new
arguments for delete-file, delete-directory, and copy-directory.
+ (Visiting Functions): Remove view-file; it is documented in the
+ Emacs manual.
* frames.texi (Layout Parameters): The defaults for the
menu-bar-lines and tool-bar-lines parameters depend on the mode.
@var{filename}.
@end deffn
-@deffn Command view-file filename
-This command visits @var{filename} using View mode, returning to the
-previous buffer when you exit View mode. View mode is a minor mode that
-provides commands to skim rapidly through the file, but does not let you
-modify the text. Entering View mode runs the normal hook
-@code{view-mode-hook}. @xref{Hooks}.
-
-When @code{view-file} is called interactively, it prompts for
-@var{filename}.
-@end deffn
-
@defopt find-file-wildcards
If this variable is non-@code{nil}, then the various @code{find-file}
commands check for wildcard characters and visit all the files that