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.
This commit is contained in:
Eli Zaretskii 2018-01-13 11:45:04 +02:00
parent 47aa85c7ec
commit 106bf8adc3
3 changed files with 45 additions and 41 deletions

View file

@ -191,8 +191,6 @@ Advanced Features
* Host Security:: Security issues on a single computer. * Host Security:: Security issues on a single computer.
* Network Security:: Managing the network security. * Network Security:: Managing the network security.
* Document View:: Viewing PDF, PS and DVI files. * 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. * Shell:: Executing shell commands from Emacs.
* Emacs Server:: Using Emacs as an editing server. * Emacs Server:: Using Emacs as an editing server.
* Printing:: Printing hardcopies of buffers or regions. * Printing:: Printing hardcopies of buffers or regions.
@ -1095,6 +1093,8 @@ Printing Hard Copies
Hyperlinking and Navigation Features Hyperlinking and Navigation Features
* EWW:: A web browser in Emacs.
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
* Browse-URL:: Following URLs. * Browse-URL:: Following URLs.
* Goto Address mode:: Activating URLs. * Goto Address mode:: Activating URLs.
* FFAP:: Finding files etc. at point. * FFAP:: Finding files etc. at point.

View file

@ -21,7 +21,7 @@ hyperlinks, and various diversions and amusements.
@end ifnottex @end ifnottex
@node Gnus @node Gnus
@section Gnus @section Email and Usenet News with Gnus
@cindex Gnus @cindex Gnus
@cindex Usenet news @cindex Usenet news
@cindex newsreader @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 (@code{doc-view-kill-proc-and-buffer}) kills the converter process and
the DocView buffer. 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 @node Shell
@section Running Shell Commands from Emacs @section Running Shell Commands from Emacs
@cindex subshell @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. can then select that frame to begin editing.
If there is no Emacs server, the @command{emacsclient} program halts 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 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 Server})---then Emacs opens a frame on the terminal in which you
called @command{emacsclient}. called @command{emacsclient}.
@ -2702,17 +2670,53 @@ key bindings.
@node Hyperlinking @node Hyperlinking
@section Hyperlinking and Navigation Features @section Hyperlinking and Web Navigation Features
The following subsections describe convenience features for handling The following subsections describe convenience features for handling
URLs and other types of links occurring in Emacs buffer text. URLs and other types of links occurring in Emacs buffer text.
@menu @menu
* EWW:: A web browser in Emacs.
* Embedded WebKit Widgets:: Embedding browser widgets in Emacs buffers.
* Browse-URL:: Following URLs. * Browse-URL:: Following URLs.
* Goto Address mode:: Activating URLs. * Goto Address mode:: Activating URLs.
* FFAP:: Finding files etc. at point. * FFAP:: Finding files etc. at point.
@end menu @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 @node Browse-URL
@subsection Following URLs @subsection Following URLs
@cindex World Wide Web @cindex World Wide Web

View file

@ -3001,10 +3001,10 @@ issues involved, rather than to be a security checklist.
@table @asis @table @asis
@item File local variables @item File local variables
@cindex 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}. the buffer visiting that file; @xref{File Local Variables}.
Similarly, a directory can specify local variable values common to all 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, Emacs takes some effort to protect against misuse of these variables,
a security hole can be created merely by a package setting a security hole can be created merely by a package setting
@code{safe-local-variable} too optimistically, a problem that is all @code{safe-local-variable} too optimistically, a problem that is all