2 files changed, 28 insertions, 22 deletions

diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 62a4b62cfca..38413a7543a 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -1144,46 +1144,48 @@ right-to-left paragraphs.
 @cindex mode, fill-column-indicator
 @findex display-fill-column-indicator-mode
 @findex global-display-fill-column-indicator-mode
-  Emacs can add an indicator to display a fill column position. The
+  Emacs can add an indicator to display a fill column position.  The
 fill column indicator is a useful functionality specially in
 prog-mode to indicate the position of an specific column.
 
-  You can set the buffer-local variables @code{display-fill-column-indicator} 
+  You can set the buffer-local variables @code{display-fill-column-indicator}
 and @code{display-fill-column-indicator-character} to activate the
 indicator and controls how the indicator looks.
 
-Alternatively you can type @kbd{M-x display-fill-column-indicator-mode} or 
-@kbd{M-x global-display-fill-column-indicator-mode} which enables the indicator
-locally and globally respectively and also chooses the character to
-use if none is set. It is possible to use the first one to activate the 
-indicator in a hook or the second one to enable it globally.
+Alternatively you can type @w{@kbd{M-x display-fill-column-indicator-mode}}
+or @w{@kbd{M-x global-display-fill-column-indicator-mode}} which enables the
+indicator locally and globally respectively and also chooses the
+character to use if none is set already.  It is possible to use the
+first one to activate the indicator in a hook or the second one to
+enable it globally.
 
-There are 2 new buffer local variables and 1 face to customize this
-mode:
+There are 2 buffer local variables and 1 face to customize this mode:
 
 @table @code
 @item display-fill-column-indicator-column
 @vindex display-fill-column-indicator-column
-Is the column number where the indicator should be set. It can take
-positive numerical values for the column or the special value t which
-means that the variable 'fill-column' will be used.
+Specifies the column number where the indicator should be set.  It can
+take positive numerical values for the column or the special value
+@code{t} which means that the variable @code{fill-column} will be
+used.
 
-Any other value disables the indicator. The default value is t.
+Any other value disables the indicator.  The default value is @code{t}.
 
 @item display-fill-column-indicator-char
 @vindex display-fill-column-indicator-char
-Is the character used for the indicator. This character can be any
-valid char including unicode ones if the actual font supports them.
-    
-When the mode is enabled throw the functions
+Specifies the character used for the indicator.  This character can be
+any valid char including unicode ones if the actual font supports
+them.
+
+When the mode is enabled through the functions
 @code{display-fill-column-indicator-mode} or
 @code{global-display-fill-column-indicator-mode}, the initialization
-functions check if this variable is non-nil, otherwise the
+functions check if this variable is @code{non-nil}, otherwise the
 initialization tries to set it to U+2502 or '|'.
-    
-@item fill-column-face 
-Is the face used to display the indicator it inherits its default
-values from shadow and the default face.
+
+@item fill-column-face
+Specifies the face used to display the indicator it inherits its
+default values from shadow and the default face.
 @end table
 
 @vindex indicate-buffer-boundaries
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index 96492783b92..df2f6c00068 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -644,6 +644,10 @@ or before @samp{)}, @samp{:} or @samp{?}); and
 @code{fill-polish-nobreak-p} (don't break after a one letter word,
 even if preceded by a non-whitespace character).
 
+  Emacs can display an indicator in the @code{fill-column} position
+using the Display fill column indicator mode 
+(@xref{Displaying Boundaries, display-fill-column-indicator}).
+
 @node Fill Prefix
 @subsection The Fill Prefix