Doc fixes for compile.el

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

3 files changed, 12 insertions, 2 deletions

diff --git a/etc/NEWS b/etc/NEWS
index f67cfd3e434..138689cff69 100644
--- 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 c1c7f74bf75..e51f41fb99e 100644
--- 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 d477569fb2d..6c48eee7f4b 100644
--- 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")