+@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 alternative display method @code{diary-simple-display} shows the
+actual diary buffer, and uses invisible text to hide entries that don't
+apply. Holidays are shown in the mode line. The advantage of this
+method is that you can edit the buffer and save your changes directly to
+the diary file. This method is not as flexible as the fancy method,
+however. For example, it cannot sort entries. Another disadvantage is
+that invisible text can be confusing. For example, if you copy a region
+of text in order to paste it elsewhere, invisible text may be included.
+Similarly, since the diary buffer as you see it is an illusion, simply
+printing the buffer may not print what you see on your screen.
+
+@vindex diary-print-entries-hook
+@findex diary-print-entries
+ For this reason, there is a special command to print hard copy of the
+diary buffer @emph{as it appears}; this command is @kbd{M-x
+diary-print-entries}. It works with either display method, although
+with the fancy display you can also print the buffer like any other. To
+print a hard copy of a day-by-day diary for a week, position point on
+the first day of the week, type @kbd{7 d}, and then do @kbd{M-x
+diary-print-entries}. As usual, the inclusion of the holidays slows
+down the display slightly; you can speed things up by setting the
+variable @code{diary-show-holidays-flag} to @code{nil}.
+
+ This command prepares a temporary buffer that contains only the diary
+entries currently visible in the diary buffer. Unlike with the simple
+display, the other irrelevant entries are really absent, not just
+hidden. After preparing the buffer, it runs the hook
+@code{diary-print-entries-hook}. The default value of this hook sends
+the data directly to the printer with the command @code{lpr-buffer}
+(@pxref{Printing}). If you want to use a different command to do the
+printing, just change the value of this hook. Other uses might include,
+for example, rearranging the lines into order by day and time.
+
+ You can edit the diary entries as they appear in the simple diary
+window, but it is important to remember that the buffer displayed
+contains the @emph{entire} diary file, with portions of it concealed
+from view. This means, for instance, that the @kbd{C-f}
+(@code{forward-char}) command can put point at what appears to be the
+end of the line, but what is in reality the middle of some concealed
+line.
+
+ @emph{Be careful when editing the diary entries in the simple display!}
+Inserting additional lines or adding/deleting characters in the middle
+of a visible line cannot cause problems, but editing at the end of a
+line may not do what you expect. Deleting a line may delete other
+invisible entries that follow it. Before editing the simple diary
+buffer, it is best to display the entire file with @kbd{s}
+(@code{diary-show-all-entries}).
+
+@node Fancy Diary Display
+@subsection Fancy Diary Display
+
+The following features only work with the fancy diary display.
+
HCoop / bpt / emacs.git / blobdiff