Improve the Emacs manual's "Misc" node

* doc/emacs/misc.texi (Gnus): A more descriptive section name.
(Invoking emacsclient): Mention how to avoid errors when there's
no Emacs server.
(EWW, Embedded WebKit Widgets): Now subsections under
"Hyperlinking and Web Navigation Features".
(Amusements): Add "games" to the section name.  Suggested by Alex
Branham <alex.branham@gmail.com> in emacs-manual-bugs@gnu.org.

* doc/emacs/emacs.texi (Top): Adjust the top-level menus to the
above changes.

* doc/lispref/os.texi (Security Considerations): Fix typos.

diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index cda94631b9bdd93ca7d6c8bc3f59b9c921b1e77c..09817080c58c6e665117c0c32a3e414db487d3a3 100644 (file)
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -191,8 +191,6 @@ Advanced Features
 * Host Security::       Security issues on a single computer.
 * Network Security::    Managing the network security.
 * Document View::       Viewing PDF, PS and DVI files.
-* EWW::                 A web browser in Emacs.
-* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
 * Shell::               Executing shell commands from Emacs.
 * Emacs Server::        Using Emacs as an editing server.
 * Printing::            Printing hardcopies of buffers or regions.
@@ -1095,6 +1093,8 @@ Printing Hard Copies
 
 Hyperlinking and Navigation Features
 
+* EWW::                 A web browser in Emacs.
+* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
 * Browse-URL::          Following URLs.
 * Goto Address mode::   Activating URLs.
 * FFAP::                Finding files etc. at point.

diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index 633e1e881d8fd9e273cc2fb9a0a0a6189942a61e..172a2223ad95f977dba45cbbfa72e7c952ec271c 100644 (file)
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -21,7 +21,7 @@ hyperlinks, and various diversions and amusements.
 @end ifnottex
 
 @node Gnus
-@section Gnus
+@section Email and Usenet News with Gnus
 @cindex Gnus
 @cindex Usenet news
 @cindex newsreader
@@ -587,40 +587,6 @@ associated with the current buffer, type @kbd{K}
 (@code{doc-view-kill-proc-and-buffer}) kills the converter process and
 the DocView buffer.
 
-@node EWW
-@section Web Browsing with EWW
-
-@findex eww
-@findex eww-open-file
-  @dfn{EWW}, the Emacs Web Wowser, is a web browser package for Emacs.
-It allows browsing URLs within an Emacs buffer.  The command @kbd{M-x
-eww} will open a URL or search the web.  You can open a file
-using the command @kbd{M-x eww-open-file}.  You can use EWW as the
-web browser for @code{browse-url}, @pxref{Browse-URL}.  For full
-details, @pxref{Top, EWW,, eww, The Emacs Web Wowser Manual}.
-
-@node Embedded WebKit Widgets
-@section Embedded WebKit Widgets
-@cindex xwidget
-@cindex webkit widgets
-@cindex embedded widgets
-
-@findex xwidget-webkit-browse-url
-@findex xwidget-webkit-mode
-@cindex Xwidget-WebKit mode
-  If Emacs was compiled with the appropriate support packages, it is
-able to show browser widgets in its buffers.  The command @kbd{M-x
-xwidget-webkit-browse-url} asks for a URL to display in the browser
-widget.  The URL normally defaults to the URL at or before point, but
-if there is an active region (@pxref{Mark}), the default URL comes
-from the region instead, after removing any whitespace from it.  The
-command then creates a new buffer with the embedded browser showing
-the specified URL.  The buffer is put in the Xwidget-WebKit mode
-(similar to Image mode, @pxref{File Conveniences}), which provides
-one-key commands for scrolling the widget, changing its size, and
-reloading it.  Type @w{@kbd{C-h b}} in that buffer to see the key
-bindings.
-
 @node Shell
 @section Running Shell Commands from Emacs
 @cindex subshell
@@ -1745,7 +1711,9 @@ graphical frame, or one in a text terminal (@pxref{Frames}).  You
 can then select that frame to begin editing.
 
   If there is no Emacs server, the @command{emacsclient} program halts
-with an error message.  If the Emacs process has no existing
+with an error message (you can prevent this from happening by using
+the @samp{--alternate-editor=""} option to @command{emacsclient},
+@pxref{emacsclient Options}).  If the Emacs process has no existing
 frame---which can happen if it was started as a daemon (@pxref{Emacs
 Server})---then Emacs opens a frame on the terminal in which you
 called @command{emacsclient}.
@@ -2702,17 +2670,53 @@ key bindings.
 
 
 @node Hyperlinking
-@section Hyperlinking and Navigation Features
+@section Hyperlinking and Web Navigation Features
 
   The following subsections describe convenience features for handling
 URLs and other types of links occurring in Emacs buffer text.
 
 @menu
+* EWW::                         A web browser in Emacs.
+* Embedded WebKit Widgets::     Embedding browser widgets in Emacs buffers.
 * Browse-URL::                  Following URLs.
 * Goto Address mode::           Activating URLs.
 * FFAP::                        Finding files etc. at point.
 @end menu
 
+@node EWW
+@subsection Web Browsing with EWW
+
+@findex eww
+@findex eww-open-file
+  @dfn{EWW}, the Emacs Web Wowser, is a web browser package for Emacs.
+It allows browsing URLs within an Emacs buffer.  The command @kbd{M-x
+eww} will open a URL or search the web.  You can open a file
+using the command @kbd{M-x eww-open-file}.  You can use EWW as the
+web browser for @code{browse-url}, @pxref{Browse-URL}.  For full
+details, @pxref{Top, EWW,, eww, The Emacs Web Wowser Manual}.
+
+@node Embedded WebKit Widgets
+@subsection Embedded WebKit Widgets
+@cindex xwidget
+@cindex webkit widgets
+@cindex embedded widgets
+
+@findex xwidget-webkit-browse-url
+@findex xwidget-webkit-mode
+@cindex Xwidget-WebKit mode
+  If Emacs was compiled with the appropriate support packages, it is
+able to show browser widgets in its buffers.  The command @kbd{M-x
+xwidget-webkit-browse-url} asks for a URL to display in the browser
+widget.  The URL normally defaults to the URL at or before point, but
+if there is an active region (@pxref{Mark}), the default URL comes
+from the region instead, after removing any whitespace from it.  The
+command then creates a new buffer with the embedded browser showing
+the specified URL.  The buffer is put in the Xwidget-WebKit mode
+(similar to Image mode, @pxref{File Conveniences}), which provides
+one-key commands for scrolling the widget, changing its size, and
+reloading it.  Type @w{@kbd{C-h b}} in that buffer to see the key
+bindings.
+
 @node Browse-URL
 @subsection  Following URLs
 @cindex World Wide Web

diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index 6315574923fa31915647baff04ab7435849f19bd..0854468835012fb50a9385c53290f3a2c173a45b 100644 (file)
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -3001,10 +3001,10 @@ issues involved, rather than to be a security checklist.
 @table @asis
 @item File local variables
 @cindex file local variables
-A file that Emacs visits can contain variable settings that affects
+A file that Emacs visits can contain variable settings that affect
 the buffer visiting that file; @xref{File Local Variables}.
 Similarly, a directory can specify local variable values common to all
-files in that directory; @xref{Directory Local Variables}.  Although
+files in that directory; see @ref{Directory Local Variables}.  Although
 Emacs takes some effort to protect against misuse of these variables,
 a security hole can be created merely by a package setting
 @code{safe-local-variable} too optimistically, a problem that is all