[Emacs-diffs] /srv/bzr/emacs/trunk r105566: Fix Emacs manual chapter numbers in last change.

[Chong Yidong]

------------------------------------------------------------
revno: 105566
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Thu 2011-08-25 12:30:46 -0400
message:
  Fix Emacs manual chapter numbers in last change.
modified:
  doc/emacs/ChangeLog
  doc/emacs/calendar.texi
  doc/emacs/emacs.texi
  doc/emacs/misc.texi
  doc/emacs/rmail.texi
  doc/emacs/sending.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-08-25 16:13:59 +0000
+++ b/doc/emacs/ChangeLog       2011-08-25 16:30:46 +0000
@@ -1,5 +1,7 @@
 2011-08-25  Chong Yidong  <address@hidden>
 
+       * misc.texi (Printing): Convert subnodes into subsections.
+
        * text.texi (Two-Column): Move into Text chapter.
 
        * picture-xtra.texi (Picture Mode): Group with Editing Binary

=== modified file 'doc/emacs/calendar.texi'
--- a/doc/emacs/calendar.texi   2011-05-17 02:26:56 +0000
+++ b/doc/emacs/calendar.texi   2011-08-25 16:30:46 +0000
@@ -2,7 +2,7 @@
 @c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2011
 @c   Free Software Foundation, Inc.
 @c See file emacs.texi for copying conditions.
address@hidden Calendar/Diary, Document View, Dired, Top
address@hidden Calendar/Diary
 @chapter The Calendar and the Diary
 @cindex calendar
 @findex calendar

=== modified file 'doc/emacs/emacs.texi'
--- a/doc/emacs/emacs.texi      2011-08-25 16:13:59 +0000
+++ b/doc/emacs/emacs.texi      2011-08-25 16:30:46 +0000
@@ -195,10 +195,10 @@
                           the number of characters you must type.
 * Dired::               Directory and file manager.
 * Calendar/Diary::      Calendar and diary facilities.
-* Document View::       Viewing PDF, PS and DVI files.
 * Sending Mail::        Sending mail in Emacs.
 * Rmail::               Reading mail in Emacs.
 * Gnus::                A flexible mail and news reader.
+* Document View::       Viewing PDF, PS and DVI files.
 * Shell::               Executing shell commands from Emacs.
 * Emacs Server::        Using Emacs as an editing server.
 * Printing::            Printing hardcopies of buffers or regions.
@@ -1489,12 +1489,13 @@
 @c Includes vc1-xtra, emerge-xtra.
 @include maintaining.texi
 @include abbrevs.texi
address@hidden sending.texi
address@hidden rmail.texi
 @c Includes dired-xtra.
 @include dired.texi
 @c Includes cal-xtra.
 @include calendar.texi
address@hidden sending.texi
address@hidden rmail.texi
address@hidden Includes picture-xtra.texi
 @include misc.texi
 @include custom.texi
 @include trouble.texi

=== modified file 'doc/emacs/misc.texi'
--- a/doc/emacs/misc.texi       2011-08-25 16:13:59 +0000
+++ b/doc/emacs/misc.texi       2011-08-25 16:30:46 +0000
@@ -20,187 +20,7 @@
 @raisesections
 @end ifnottex
 
address@hidden Document View, Sending Mail, Calendar/Diary, Top
address@hidden Document Viewing
address@hidden DVI file
address@hidden PDF file
address@hidden PS file
address@hidden Postscript file
address@hidden OpenDocument file
address@hidden Microsoft Office file
address@hidden DocView mode
address@hidden mode, DocView
address@hidden document viewer (DocView)
address@hidden doc-view-mode
-
-DocView mode (@code{doc-view-mode}) is a viewer for DVI, Postscript
-(PS), PDF, OpenDocument, and Microsoft Office documents.  It provides
-features such as slicing, zooming, and searching inside documents.  It
-works by converting the document to a set of images using the
address@hidden (GhostScript) command and other external tools
address@hidden@code{gs} is a hard requirement.  For DVI files,
address@hidden or @code{dvipdfm} is needed.  For OpenDocument and
-Microsoft Office documents, the @code{unoconv} tool is needed.}, and
-displaying those images.
-
address@hidden doc-view-toggle-display
address@hidden doc-view-toggle-display
address@hidden doc-view-minor-mode
-  When you visit a document file with the exception of Postscript
-files, Emacs automatically switches to DocView mode if possible
address@hidden needed external tools for this document type have to be
-available, emacs needs to run in a graphical frame, and PNG image
-support has to be compiled into emacs.  If any of these requirements
-is not fulfilled, DocView falls back to an appropriate mode.}.  When
-you visit a Postscript file, Emacs switches to PS mode, a major mode
-for editing Postscript files as text; however, it also enables DocView
-minor mode, so you can type @kbd{C-c C-c} to view the document with
-DocView.  (PDF and DVI files, unlike Postscript files, are not usually
-human-editable.)  In either case, repeating @kbd{C-c C-c}
-(@code{doc-view-toggle-display}) toggles between DocView and the file
-text.
-
-  You can explicitly toggle DocView mode with the command @code{M-x
-doc-view-mode}, and DocView minor mode with the command @code{M-x
-doc-view-minor-mode}.
-
-  When DocView mode starts, it displays a welcome screen and begins
-formatting the file, page by page.  It displays the first page once
-that has been formatted.
-
address@hidden doc-view-enlarge
address@hidden doc-view-shrink
address@hidden doc-view-resolution
-  When in DocView mode, you can enlarge or shrink the document with
address@hidden (@code{doc-view-enlarge}) and @kbd{-}
-(@code{doc-view-shrink}).  To specify the default size for DocView,
-set or customize the variable @code{doc-view-resolution}.
-
-  To kill the DocView buffer, type @kbd{k}
-(@code{doc-view-kill-proc-and-buffer}).  To bury it, type @kbd{q}
-(@code{quit-window}).
-
address@hidden
-* Navigation::  Navigation inside DocView buffers.
-* Searching::   Searching inside documents.
-* Slicing::     Specifying which part of pages should be displayed.
-* Conversion::  Influencing and triggering conversion.
address@hidden menu
-
address@hidden Navigation
address@hidden Navigation
-
-When in DocView mode, you can scroll the current page using the usual
-Emacs movement keys: @kbd{C-p}, @kbd{C-n}, @kbd{C-b}, @kbd{C-f}, and
-the arrow keys.
-
address@hidden doc-view-continuous
-  By default, the line-motion keys @kbd{C-p} and @kbd{C-n} stop
-scrolling at the beginning and end of the current page, respectively.
-However, if you change the variable @code{doc-view-continuous} to a
address@hidden value, then @kbd{C-p} displays the previous page if you
-are already at the beginning of the current page, and @kbd{C-n}
-displays the next page if you are at the end of the current page.
-
address@hidden doc-view-next-page
address@hidden doc-view-previous-page
-  You can also display the next page by typing @kbd{n}, @key{next} or
address@hidden ]} (@code{doc-view-next-page}).  To display the previous
-page, type @kbd{p}, @key{prior} or @kbd{C-x [}
-(@code{doc-view-previous-page}).
-
address@hidden doc-view-scroll-up-or-next-page
address@hidden doc-view-scroll-down-or-previous-page
-  The @key{SPC} (@code{doc-view-scroll-up-or-next-page}) key is a
-convenient way to advance through the document.  It scrolls within the
-current page or advances to the next.  @key{DEL} moves backwards in a
-similar way (@code{doc-view-scroll-down-or-previous-page}).
-
address@hidden doc-view-first-page
address@hidden doc-view-last-page
address@hidden doc-view-goto-page
-  To go to the first page, type @kbd{M-<}
-(@code{doc-view-first-page}); to go to the last one, type @kbd{M->}
-(@code{doc-view-last-page}).  To jump to a page by its number, type
address@hidden M-g} or @kbd{M-g g} (@code{doc-view-goto-page}).
-
address@hidden Searching
address@hidden Searching
-
-While in DocView mode, you can search the file's text for a regular
-expression (@pxref{Regexps}).  The interface for searching is inspired
-by @code{isearch} (@pxref{Incremental Search}).
-
address@hidden doc-view-search
address@hidden doc-view-search-backward
address@hidden doc-view-show-tooltip
-  To begin a search, type @kbd{C-s} (@code{doc-view-search}) or
address@hidden (@code{doc-view-search-backward}).  This reads a regular
-expression using a minibuffer, then echoes the number of matches found
-within the document.  You can move forward and back among the matches
-by typing @kbd{C-s} and @kbd{C-r}.  DocView mode has no way to show
-the match inside the page image; instead, it displays a tooltip (at
-the mouse position) listing all matching lines in the current page.
-To force display of this tooltip, type @kbd{C-t}
-(@code{doc-view-show-tooltip}).
-
-  To start a new search, use the search command with a prefix
-argument; i.e., @kbd{C-u C-s} for a forward search or @kbd{C-u C-r}
-for a backward search.
-
address@hidden Slicing
address@hidden Slicing
-
-Documents often have wide margins for printing.  They are annoying
-when reading the document on the screen, because they use up screen
-space and can cause inconvenient scrolling.
-
address@hidden doc-view-set-slice
address@hidden doc-view-set-slice-using-mouse
-  With DocView you can hide these margins by selecting a @dfn{slice}
-of pages to display.  A slice is a rectangle within the page area;
-once you specify a slice in DocView, it applies to whichever page you
-look at.
-
-  To specify the slice numerically, type @kbd{s s}
-(@code{doc-view-set-slice}); then enter the top left pixel position
-and the slice's width and height.
address@hidden ??? how does this work?
-
-  A more convenient graphical way to specify the slice is with @kbd{s
-m} (@code{doc-view-set-slice-using-mouse}), where you use the mouse to
-select the slice.
address@hidden ??? How does this work?
-
address@hidden doc-view-reset-slice
-  To cancel the selected slice, type @kbd{s r}
-(@code{doc-view-reset-slice}).  Then DocView shows the entire page
-including its entire margins.
-
address@hidden Conversion
address@hidden Conversion
-
address@hidden doc-view-cache-directory
address@hidden doc-view-clear-cache
-For efficiency, DocView caches the images produced by @command{gs}.
-The name of this directory is given by the variable
address@hidden  You can clear the cache directory by
-typing @code{M-x doc-view-clear-cache}.
-
address@hidden doc-view-kill-proc
address@hidden doc-view-kill-proc-and-buffer
-  To force a reconversion of the currently viewed document, type
address@hidden or @kbd{g} (@code{revert-buffer}).  To kill the converter
-process associated with the current buffer, type @kbd{K}
-(@code{doc-view-kill-proc}).  The command @kbd{k}
-(@code{doc-view-kill-proc-and-buffer}) kills the converter process and
-the DocView buffer.
-
-  The zoom commands @kbd{+} (@code{doc-view-enlarge}) and @kbd{-}
-(@code{doc-view-shrink}) need to reconvert the document at the new
-size.  The current page is converted first.
-
address@hidden Gnus, Shell, Rmail, Top
address@hidden Gnus
 @section Gnus
 @cindex Gnus
 @cindex reading netnews
@@ -411,82 +231,187 @@
 
 @end table
 
address@hidden
address@hidden Where to Look
address@hidden Where to Look Further
-
address@hidden Too many references to the name of the manual if done with xref 
in TeX!
-Gnus is powerful and customizable.  Here are references to a few
address@hidden
-additional topics:
-
address@hidden ifnottex
address@hidden
-additional topics in @cite{The Gnus Manual}:
-
address@hidden @bullet
address@hidden
-Follow discussions on specific address@hidden
-See section ``Threading.''
-
address@hidden
-Read digests.  See section ``Document Groups.''
-
address@hidden
-Refer to and jump to the parent of the current address@hidden
-See section ``Finding the Parent.''
-
address@hidden
-Refer to articles by using Message-IDs included in the address@hidden
-See section ``Article Keymap.''
-
address@hidden
-Save articles.  See section ``Saving Articles.''
-
address@hidden
-Have Gnus score articles according to various criteria, like author
-name, subject, or string in the body of the address@hidden
-See section ``Scoring.''
-
address@hidden
-Send an article to a address@hidden
-See section ``Composing Messages.''
address@hidden itemize
address@hidden iftex
address@hidden
address@hidden @bullet
address@hidden
-Follow discussions on specific address@hidden
address@hidden, , Reading Based on Conversation Threads,
-gnus, The Gnus Manual}.
-
address@hidden
-Read digests. @xref{Document Groups, , , gnus, The Gnus Manual}.
-
address@hidden
-Refer to and jump to the parent of the current address@hidden
address@hidden the Parent, , , gnus, The Gnus Manual}.
-
address@hidden
-Refer to articles by using Message-IDs included in the address@hidden
address@hidden Keymap, , , gnus, The Gnus Manual}.
-
address@hidden
-Save articles. @xref{Saving Articles, , , gnus, The Gnus Manual}.
-
address@hidden
-Have Gnus score articles according to various criteria, like author
-name, subject, or string in the body of the address@hidden
address@hidden, , , gnus, The Gnus Manual}.
-
address@hidden
-Send an article to a address@hidden
address@hidden Messages, , , gnus, The Gnus Manual}.
address@hidden itemize
address@hidden ifnottex
address@hidden ignore
-
address@hidden Shell, Emacs Server, Gnus, Top
address@hidden Document View
address@hidden Document Viewing
address@hidden DVI file
address@hidden PDF file
address@hidden PS file
address@hidden Postscript file
address@hidden OpenDocument file
address@hidden Microsoft Office file
address@hidden DocView mode
address@hidden mode, DocView
address@hidden document viewer (DocView)
address@hidden doc-view-mode
+
+DocView mode (@code{doc-view-mode}) is a viewer for DVI, Postscript
+(PS), PDF, OpenDocument, and Microsoft Office documents.  It provides
+features such as slicing, zooming, and searching inside documents.  It
+works by converting the document to a set of images using the
address@hidden (GhostScript) command and other external tools
address@hidden@code{gs} is a hard requirement.  For DVI files,
address@hidden or @code{dvipdfm} is needed.  For OpenDocument and
+Microsoft Office documents, the @code{unoconv} tool is needed.}, and
+displaying those images.
+
address@hidden doc-view-toggle-display
address@hidden doc-view-toggle-display
address@hidden doc-view-minor-mode
+  When you visit a document file with the exception of Postscript
+files, Emacs automatically switches to DocView mode if possible
address@hidden needed external tools for this document type have to be
+available, emacs needs to run in a graphical frame, and PNG image
+support has to be compiled into emacs.  If any of these requirements
+is not fulfilled, DocView falls back to an appropriate mode.}.  When
+you visit a Postscript file, Emacs switches to PS mode, a major mode
+for editing Postscript files as text; however, it also enables DocView
+minor mode, so you can type @kbd{C-c C-c} to view the document with
+DocView.  (PDF and DVI files, unlike Postscript files, are not usually
+human-editable.)  In either case, repeating @kbd{C-c C-c}
+(@code{doc-view-toggle-display}) toggles between DocView and the file
+text.
+
+  You can explicitly toggle DocView mode with the command @code{M-x
+doc-view-mode}, and DocView minor mode with the command @code{M-x
+doc-view-minor-mode}.
+
+  When DocView mode starts, it displays a welcome screen and begins
+formatting the file, page by page.  It displays the first page once
+that has been formatted.
+
address@hidden doc-view-enlarge
address@hidden doc-view-shrink
address@hidden doc-view-resolution
+  When in DocView mode, you can enlarge or shrink the document with
address@hidden (@code{doc-view-enlarge}) and @kbd{-}
+(@code{doc-view-shrink}).  To specify the default size for DocView,
+set or customize the variable @code{doc-view-resolution}.
+
+  To kill the DocView buffer, type @kbd{k}
+(@code{doc-view-kill-proc-and-buffer}).  To bury it, type @kbd{q}
+(@code{quit-window}).
+
address@hidden
+* Navigation::  Navigation inside DocView buffers.
+* Searching::   Searching inside documents.
+* Slicing::     Specifying which part of pages should be displayed.
+* Conversion::  Influencing and triggering conversion.
address@hidden menu
+
address@hidden Navigation
address@hidden Navigation
+
+When in DocView mode, you can scroll the current page using the usual
+Emacs movement keys: @kbd{C-p}, @kbd{C-n}, @kbd{C-b}, @kbd{C-f}, and
+the arrow keys.
+
address@hidden doc-view-continuous
+  By default, the line-motion keys @kbd{C-p} and @kbd{C-n} stop
+scrolling at the beginning and end of the current page, respectively.
+However, if you change the variable @code{doc-view-continuous} to a
address@hidden value, then @kbd{C-p} displays the previous page if you
+are already at the beginning of the current page, and @kbd{C-n}
+displays the next page if you are at the end of the current page.
+
address@hidden doc-view-next-page
address@hidden doc-view-previous-page
+  You can also display the next page by typing @kbd{n}, @key{next} or
address@hidden ]} (@code{doc-view-next-page}).  To display the previous
+page, type @kbd{p}, @key{prior} or @kbd{C-x [}
+(@code{doc-view-previous-page}).
+
address@hidden doc-view-scroll-up-or-next-page
address@hidden doc-view-scroll-down-or-previous-page
+  The @key{SPC} (@code{doc-view-scroll-up-or-next-page}) key is a
+convenient way to advance through the document.  It scrolls within the
+current page or advances to the next.  @key{DEL} moves backwards in a
+similar way (@code{doc-view-scroll-down-or-previous-page}).
+
address@hidden doc-view-first-page
address@hidden doc-view-last-page
address@hidden doc-view-goto-page
+  To go to the first page, type @kbd{M-<}
+(@code{doc-view-first-page}); to go to the last one, type @kbd{M->}
+(@code{doc-view-last-page}).  To jump to a page by its number, type
address@hidden M-g} or @kbd{M-g g} (@code{doc-view-goto-page}).
+
address@hidden Searching
address@hidden Searching
+
+While in DocView mode, you can search the file's text for a regular
+expression (@pxref{Regexps}).  The interface for searching is inspired
+by @code{isearch} (@pxref{Incremental Search}).
+
address@hidden doc-view-search
address@hidden doc-view-search-backward
address@hidden doc-view-show-tooltip
+  To begin a search, type @kbd{C-s} (@code{doc-view-search}) or
address@hidden (@code{doc-view-search-backward}).  This reads a regular
+expression using a minibuffer, then echoes the number of matches found
+within the document.  You can move forward and back among the matches
+by typing @kbd{C-s} and @kbd{C-r}.  DocView mode has no way to show
+the match inside the page image; instead, it displays a tooltip (at
+the mouse position) listing all matching lines in the current page.
+To force display of this tooltip, type @kbd{C-t}
+(@code{doc-view-show-tooltip}).
+
+  To start a new search, use the search command with a prefix
+argument; i.e., @kbd{C-u C-s} for a forward search or @kbd{C-u C-r}
+for a backward search.
+
address@hidden Slicing
address@hidden Slicing
+
+Documents often have wide margins for printing.  They are annoying
+when reading the document on the screen, because they use up screen
+space and can cause inconvenient scrolling.
+
address@hidden doc-view-set-slice
address@hidden doc-view-set-slice-using-mouse
+  With DocView you can hide these margins by selecting a @dfn{slice}
+of pages to display.  A slice is a rectangle within the page area;
+once you specify a slice in DocView, it applies to whichever page you
+look at.
+
+  To specify the slice numerically, type @kbd{s s}
+(@code{doc-view-set-slice}); then enter the top left pixel position
+and the slice's width and height.
address@hidden ??? how does this work?
+
+  A more convenient graphical way to specify the slice is with @kbd{s
+m} (@code{doc-view-set-slice-using-mouse}), where you use the mouse to
+select the slice.
address@hidden ??? How does this work?
+
address@hidden doc-view-reset-slice
+  To cancel the selected slice, type @kbd{s r}
+(@code{doc-view-reset-slice}).  Then DocView shows the entire page
+including its entire margins.
+
address@hidden Conversion
address@hidden Conversion
+
address@hidden doc-view-cache-directory
address@hidden doc-view-clear-cache
+For efficiency, DocView caches the images produced by @command{gs}.
+The name of this directory is given by the variable
address@hidden  You can clear the cache directory by
+typing @code{M-x doc-view-clear-cache}.
+
address@hidden doc-view-kill-proc
address@hidden doc-view-kill-proc-and-buffer
+  To force a reconversion of the currently viewed document, type
address@hidden or @kbd{g} (@code{revert-buffer}).  To kill the converter
+process associated with the current buffer, type @kbd{K}
+(@code{doc-view-kill-proc}).  The command @kbd{k}
+(@code{doc-view-kill-proc-and-buffer}) kills the converter process and
+the DocView buffer.
+
+  The zoom commands @kbd{+} (@code{doc-view-enlarge}) and @kbd{-}
+(@code{doc-view-shrink}) need to reconvert the document at the new
+size.  The current page is converted first.
+
address@hidden Shell
 @section Running Shell Commands from Emacs
 @cindex subshell
 @cindex shell commands
@@ -1788,7 +1713,7 @@
 @end menu
 
 @node PostScript, PostScript Variables,, Printing
address@hidden PostScript Hardcopy
address@hidden PostScript Hardcopy
 
   These commands convert buffer contents to PostScript,
 either printing it or leaving it in another Emacs buffer.
@@ -1878,7 +1803,7 @@
 @end ifnottex
 
 @node PostScript Variables, Printing Package, PostScript, Printing
address@hidden Variables for PostScript Hardcopy
address@hidden Variables for PostScript Hardcopy
 
 @vindex ps-lpr-command
 @vindex ps-lpr-switches
@@ -1973,7 +1898,7 @@
 described in the Lisp files @file{ps-print.el} and @file{ps-mule.el}.
 
 @node Printing Package,, PostScript Variables, Printing
address@hidden Printing Package
address@hidden Printing Package
 @cindex Printing package
 
   The basic Emacs facilities for printing hardcopy can be extended

=== modified file 'doc/emacs/rmail.texi'
--- a/doc/emacs/rmail.texi      2011-08-25 15:38:49 +0000
+++ b/doc/emacs/rmail.texi      2011-08-25 16:30:46 +0000
@@ -2,7 +2,7 @@
 @c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2011
 @c   Free Software Foundation, Inc.
 @c See file emacs.texi for copying conditions.
address@hidden Rmail, Gnus, Sending Mail, Top
address@hidden Rmail
 @chapter Reading Mail with Rmail
 @cindex Rmail
 @cindex reading mail

=== modified file 'doc/emacs/sending.texi'
--- a/doc/emacs/sending.texi    2011-08-25 15:38:49 +0000
+++ b/doc/emacs/sending.texi    2011-08-25 16:30:46 +0000
@@ -2,7 +2,7 @@
 @c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2011
 @c   Free Software Foundation, Inc.
 @c See file emacs.texi for copying conditions.
address@hidden Sending Mail, Rmail, Document View, Top
address@hidden Sending Mail
 @chapter Sending Mail
 @cindex sending mail
 @cindex mail