Add a comment to document the reason for the change in outline-level.

1 files changed, 5 insertions, 0 deletions

diff --git a/lisp/textmodes/ooutline.el b/lisp/textmodes/ooutline.el
index 1f86c51b6e..88d4c595ec 100644
--- a/lisp/textmodes/ooutline.el
+++ b/lisp/textmodes/ooutline.el
@@ -227,6 +227,11 @@ See the command `outline-mode' for more information on this mode."
   "Function of no args to compute a header's nesting level in an outline.
 It can assume point is at the beginning of a header line.")
 
+;; This used to count columns rather than characters, but that made ^L
+;; appear to be at level 2 instead of 1.  Columns would be better for
+;; tab handling, but the default regexp doesn't use tabs, and anyone
+;; who changes the regexp can also redefine the outline-level variable
+;; as appropriate.
 (defun outline-level ()
   "Return the depth to which a statement is nested in the outline.
 Point must be at the beginning of a header line.  This is actually