Doc fixes for compile.el

* lisp/progmodes/compile.el (compilation-first-column)
(compilation-error-screen-columns): Doc fixes.
* etc/NEWS: Related markup.

diff --git a/etc/NEWS b/etc/NEWS
index f67cfd3e434443747ece8f60341a0d9d3173a55e..138689cff69fa61d201d976ffa27e8b9343d8808 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -672,6 +672,7 @@ on platforms that support it.  This calls your desktop's preferred browser.
 inserted by the compilation filter function, when calling
 compilation-filter-hook.
 
+---
 *** `compilation-error-screen-columns' and `compilation-first-column'
 are obeyed in the editing buffer.  So programming language modes can
 set them, whereas previously only the value in the *compilation* buffer

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index c1c7f74bf75fb85b9d8a30c0c60ecc82a4685a40..e51f41fb99ef4cd0f20fc4c9795c2cfdb16b30e4 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2012-02-09  Glenn Morris  <rgm@gnu.org>
 
+       * progmodes/compile.el (compilation-first-column)
+       (compilation-error-screen-columns): Doc fixes.
+
        * vc/log-view.el (log-view-toggle-entry-display):
        * vc/vc.el (vc-merge, vc-pull): Doc fixes.
 

diff --git a/lisp/progmodes/compile.el b/lisp/progmodes/compile.el
index d477569fb2d677e6df2c22e2c57c073bc56f28f1..6c48eee7f4b12e60188d23e831ac6f35c3941621 100644 (file)
--- a/lisp/progmodes/compile.el
+++ b/lisp/progmodes/compile.el
@@ -78,7 +78,10 @@ after `call-process' inserts the grep output into the buffer.")
 This is bound to a buffer position before running `compilation-filter-hook'.")
 
 (defvar compilation-first-column 1
-  "*This is how compilers number the first column, usually 1 or 0.")
+  "*This is how compilers number the first column, usually 1 or 0.
+If this is buffer-local in the destination buffer, Emacs obeys
+that value, otherwise it uses the value in the *compilation*
+buffer.  This enables a major-mode to specify its own value.")
 
 (defvar compilation-parse-errors-filename-function nil
   "Function to call to post-process filenames while parsing error messages.
@@ -547,7 +550,10 @@ Otherwise they are interpreted as character positions, with
 each character occupying one column.
 The default is to use screen columns, which requires that the compilation
 program and Emacs agree about the display width of the characters,
-especially the TAB character."
+especially the TAB character.
+If this is buffer-local in the destination buffer, Emacs obeys
+that value, otherwise it uses the value in the *compilation*
+buffer.  This enables a major-mode to specify its own value."
   :type 'boolean
   :group 'compilation
   :version "20.4")