[Emacs-diffs] /srv/bzr/emacs/trunk r106706: Update programs.texi and cc-mode.texi for new CC Mode features:

[Alan Mackenzie]

------------------------------------------------------------
revno: 106706
committer: Alan Mackenzie <address@hidden>
branch nick: trunk
timestamp: Tue 2011-12-20 16:00:47 +0000
message:
  Update programs.texi and cc-mode.texi for new CC Mode features:
  cc-mode.texi: Update version string to 5.32.
  programs.texi: Describe "guessing" of indentation style.  Update C-M-a/e.
modified:
  doc/emacs/ChangeLog
  doc/emacs/programs.texi
  doc/misc/ChangeLog
  doc/misc/cc-mode.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-12-20 03:00:10 +0000
+++ b/doc/emacs/ChangeLog       2011-12-20 16:00:47 +0000
@@ -1,3 +1,9 @@
+2011-12-20  Alan Mackenzie  <address@hidden>
+
+       * programs.texi (Motion in C): Update the description of C-M-a and
+       C-M-e, they now DTRT in enclosing scopes.
+       (Custom C Indent): Add @dfn{guessing} of the indentation style.
+
 2011-12-20  Chong Yidong  <address@hidden>
 
        * maintaining.texi (VCS Concepts): Add "working tree" terminology.

=== modified file 'doc/emacs/programs.texi'
--- a/doc/emacs/programs.texi   2011-12-08 13:21:58 +0000
+++ b/doc/emacs/programs.texi   2011-12-20 16:00:47 +0000
@@ -38,8 +38,8 @@
 * Glasses::             Making identifiersLikeThis more readable.
 * Semantic::            Suite of editing tools based on source code parsing.
 * Misc for Programs::   Other Emacs features useful for editing programs.
-* C Modes::             Special commands of C, C++, Objective-C,
-                          Java, and Pike modes.
+* C Modes::             Special commands of C, C++, Objective-C, Java,
+                          IDL, Pike and AWK modes.
 * Asm Mode::            Asm mode and its special features.
 @ifnottex
 * Fortran::             Fortran mode and its special features.
@@ -606,6 +606,13 @@
 including how to override parts of an existing style and how to define
 your own styles.
 
+  As an alternative to specifying a style, you can get Emacs to
address@hidden the style by scanning a code buffer which is already
+formatted.  To do this, call @kbd{M-x c-guess} in your sample buffer.
+You can then apply this guessed style to other buffers with @kbd{M-x
+c-guess-install}.  @xref{Guessing the Style,,, ccmode, the CC Mode
+Manual}, for more details about this mechanism.
+
 @node Parentheses
 @section Commands for Editing with Parentheses
 
@@ -1462,17 +1469,17 @@
 related modes.
 
 @table @code
address@hidden M-x c-beginning-of-defun
address@hidden M-x c-end-of-defun
address@hidden C-M-a
address@hidden C-M-e
 @findex c-beginning-of-defun
 @findex c-end-of-defun
 Move point to the beginning or end of the current function or
-top-level definition.  These are found by searching for the least
+top-level definition.  In languages with enclosing scopes (such as
+C++'s classes) the @dfn{current function} is the immediate one,
+possibly inside a scope.  Otherwise it is the one defined by the least
 enclosing braces.  (By contrast, @code{beginning-of-defun} and
address@hidden search for braces in column zero.)  If you are
-editing code where the opening brace of a function isn't placed in
-column zero, you may wish to bind @code{C-M-a} and @code{C-M-e} to
-these commands.  @xref{Moving by Defuns}.
address@hidden search for braces in column zero.)  @xref{Moving
+by Defuns}.
 
 @item C-c C-u
 @kindex C-c C-u @r{(C mode)}

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2011-12-06 01:30:54 +0000
+++ b/doc/misc/ChangeLog        2011-12-20 16:00:47 +0000
@@ -1,3 +1,7 @@
+2011-12-20  Alan Mackenzie  <address@hidden>
+
+       * cc-mode.texi: Update version string 5.31 -> 5.32.
+
 2011-12-06  Juanma Barranquero  <address@hidden>
 
        * gnus-faq.texi (FAQ 2-1, FAQ 3-8, FAQ 4-14, FAQ 9-1): Fix typos.

=== modified file 'doc/misc/cc-mode.texi'
--- a/doc/misc/cc-mode.texi     2011-12-12 05:32:49 +0000
+++ b/doc/misc/cc-mode.texi     2011-12-20 16:00:47 +0000
@@ -190,7 +190,7 @@
 @titlepage
 @sp 10
 
address@hidden @titlefont{CC Mode 5.31}
address@hidden @titlefont{CC Mode 5.32}
 @sp 2
 @center @subtitlefont{A GNU Emacs mode for editing C and C-like languages}
 @sp 2
@@ -378,7 +378,7 @@
 
 This manual describes @ccmode{}
 @comment The following line must appear on its own, so that the
-version 5.31.
+version 5.32.
 @comment Release.py script can update the version number automatically
 
 @ccmode{} supports the editing of K&R and ANSI C, C++, Objective-C,