[Emacs-diffs] Changes to emacs/man/programs.texi,v

[Alan Mackenzie]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Alan Mackenzie <acmacm> 06/12/17 22:04:05

Index: programs.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/programs.texi,v
retrieving revision 1.121
retrieving revision 1.122
diff -u -b -r1.121 -r1.122
--- programs.texi       30 Sep 2006 21:07:21 -0000      1.121
+++ programs.texi       17 Dec 2006 22:04:05 -0000      1.122
@@ -156,21 +156,9 @@
 @cindex open-parenthesis in leftmost column
 @cindex ( in leftmost column
   Emacs assumes by default that any opening delimiter found at the
-left margin is the start of a top-level definition, or defun.  You can
-override this default by setting this user option:
-
address@hidden open-paren-in-column-0-is-defun-start
-If this user option is set to @code{t} (the default), opening
-parentheses or braces at column zero always start defuns.  When it's
address@hidden, defuns are found by searching for parens or braces at the
-outermost level.  Some major modes, including C and related modes, set
address@hidden buffer-locally to
address@hidden
address@hidden defvar
-
-  In modes where @code{open-paren-in-column-0-is-defun-start} is
address@hidden, @strong{don't put an opening delimiter at the left margin
-unless it is a defun start}.  For instance, never put an
+left margin is the start of a top-level definition, or defun.
+Therefore, @strong{don't put an opening delimiter at the left margin
+unless it should have that significance}.  For instance, never put an
 open-parenthesis at the left margin in a Lisp file unless it is the
 start of a top-level list.
 
@@ -182,10 +170,10 @@
 
   The most likely problem case is when you want an opening delimiter
 at the start of a line inside a string.  To avoid trouble, put an
-escape character (@samp{\}, in Emacs Lisp, @samp{/} in some other Lisp
-dialects) before the opening delimiter.  This will not affect the
-contents of the string, but will prevent that opening delimiter from
-starting a defun.  Here's an example:
+escape character (@samp{\}, in C and Emacs Lisp, @samp{/} in some
+other Lisp dialects) before the opening delimiter.  This will not
+affect the contents of the string, but will prevent that opening
+delimiter from starting a defun.  Here's an example:
 
 @example
   (insert "Foo:
@@ -197,6 +185,25 @@
 highlights confusing opening delimiters (those that ought to be
 quoted) in bold red.
 
+If you need to override this convention, you can so by setting this
+user option:
+
address@hidden open-paren-in-column-0-is-defun-start
+If this user option is set to @code{t} (the default), opening
+parentheses or braces at column zero always start defuns.  When it's
address@hidden, defuns are found by searching for parens or braces at the
+outermost level.
address@hidden defvar
+
+  Usually, you shouldn't need to set
address@hidden to @code{nil}.  However,
+if your buffer contains parentheses or braces in column zero which
+don't start defuns and this confuses Emacs, it sometimes helps to set
+the option to @code{nil}.  Be aware, though, that this will make
+scrolling and display in large buffers quite sluggish, and that
+parentheses and braces must be correctly matched throughout the buffer
+for it to work properly.
+
   In the earliest days, the original Emacs found defuns by moving
 upward a level of parentheses or braces until there were no more
 levels to go up.  This always required scanning all the way back to
@@ -1557,10 +1564,10 @@
 @table @kbd
 @item C-c address@hidden
 @itemx C-c @key{DEL}
address@hidden c-hungry-backspace
address@hidden c-hungry-delete-backwards
 @kindex C-c address@hidden (C Mode)
 @kindex C-c @key{DEL} (C Mode)
address@hidden the entire block of whitespace
address@hidden the entire block of whitespace
 preceding point.
 
 @item C-c C-d