X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/283ccc1841a43a9426b7fa4c397fc9593ae4022b..14a29deb45df18c2e6e62cc1dfefcd63d46f168b:/doc/emacs/help.texi diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi index ac3539881d..9ff995138f 100644 --- a/doc/emacs/help.texi +++ b/doc/emacs/help.texi @@ -1,6 +1,6 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001, -@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. +@c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2011 +@c Free Software Foundation, Inc. @c See file emacs.texi for copying conditions. @node Help, Mark, M-x, Top @chapter Help @@ -69,14 +69,14 @@ This displays the available Emacs packages based on keywords. @end table @menu -* Help Summary:: Brief list of all Help commands. -* Key Help:: Asking what a key does in Emacs. -* Name Help:: Asking about a command, variable or function name. -* Apropos:: Asking what pertains to a given topic. +* Help Summary:: Brief list of all Help commands. +* Key Help:: Asking what a key does in Emacs. +* Name Help:: Asking about a command, variable or function name. +* Apropos:: Asking what pertains to a given topic. * Help Mode:: Special features of Help mode and Help buffers. -* Library Keywords:: Finding Lisp libraries by keywords (topics). +* Library Keywords:: Finding Lisp libraries by keywords (topics). * Language Help:: Help relating to international language support. -* Misc Help:: Other help commands. +* Misc Help:: Other help commands. * Help Files:: Commands to display pre-written help files. * Help Echo:: Help on active text and tooltips (`balloon help'). @end menu @@ -126,21 +126,28 @@ The complete Emacs manual is available on-line in Info. Display the name and documentation of the command that @var{key} runs (@code{describe-key}). @item C-h l -Display a description of your last 300 keystrokes +Display a description of your last 300 keystrokes (@code{view-lossage}). @item C-h m Display documentation of the current major mode (@code{describe-mode}). @item C-h n Display news of recent Emacs changes (@code{view-emacs-news}). @item C-h p -Find packages by topic keyword (@code{finder-by-keyword}). For an -alternative interface to the same information, try the @code{info-finder} -command. +Find packages by topic keyword (@code{finder-by-keyword}). This lists +packages using a package menu buffer (@pxref{Package Menu}); for an +alternative interface to the same information, try the +@code{info-finder} command. +@item C-h P @var{package} @key{RET} +Display documentation about the package named @var{package} +(@code{describe-package}; @pxref{Packages}). @item C-h r Display the Emacs manual in Info (@code{info-emacs-manual}). @item C-h s -Display the current contents of the syntax table, with an explanation of -what they mean (@code{describe-syntax}). @xref{Syntax}. +Display the current contents of the @dfn{syntax table}, with an +explanation of what they mean (@code{describe-syntax}). The syntax +table says which characters are opening delimiters, which are parts of +words, which are string quotes, and so on. @xref{Syntax Tables,, +Syntax Tables, elisp, The Emacs Lisp Reference Manual}, for details. @item C-h t Enter the Emacs interactive tutorial (@code{help-with-tutorial}). @item C-h v @var{var} @key{RET} @@ -398,8 +405,8 @@ the variable @code{apropos-documentation-sort-by-scores} is @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} @@ -583,13 +590,16 @@ bindings now in effect: first the local bindings of the current minor modes, then the local bindings defined by the current major mode, and finally the global bindings (@pxref{Key Bindings}). @kbd{C-h s} displays the contents of the syntax table, with explanations of each -character's syntax (@pxref{Syntax}). +character's syntax (@pxref{Syntax Tables,, Syntax Tables, elisp, The +Emacs Lisp Reference Manual}). +@findex describe-prefix-bindings You can get a list of subcommands for a particular prefix key by -typing @kbd{C-h} after the prefix key. (There are a few prefix keys -for which this does not work---those that provide their own bindings -for @kbd{C-h}. One of these is @key{ESC}, because @kbd{@key{ESC} C-h} -is actually @kbd{C-M-h}, which marks a defun.) +typing @kbd{C-h} (@code{describe-prefix-bindings}) after the prefix +key. (There are a few prefix keys for which this does not +work---those that provide their own bindings for @kbd{C-h}. One of +these is @key{ESC}, because @kbd{@key{ESC} C-h} is actually +@kbd{C-M-h}, which marks a defun.) @node Help Files @section Help Files @@ -629,7 +639,10 @@ C-@var{char}}; that is, @kbd{C-h} followed by a control character. Display the Emacs copying conditions (@code{describe-copying}). These are the rules under which you can copy and redistribute Emacs. @item C-h C-d -Display how to debug Emacs problems (@code{view-emacs-debugging}). +Display help for debugging Emacs (@code{view-emacs-debugging}). +@item C-h C-e +Display external packages and information about Emacs +(@code{view-external-packages}). @item C-h C-f Display the Emacs frequently-answered-questions list (@code{view-emacs-FAQ}). @item C-h g @@ -676,7 +689,3 @@ help text for active buffer text using the keyboard. @kbd{C-h .} character after point, using the echo area. To display help text automatically whenever it is available on the character after point, set the variable @code{help-at-pt-display-when-idle} to @code{t}. - -@ignore - arch-tag: 6f33ab62-bc75-4367-8057-fd67cc15c3a1 -@end ignore