[Emacs-diffs] emacs-26 559f64a 1/2: Backport: Update documentation for indent-relative functions

[Basil L. Contovounesios]

branch: emacs-26
commit 559f64a0b6b6f915d26ada8283b74ab6bbfbf3b2
Author: Alex Branham <address@hidden>
Commit: Basil L. Contovounesios <address@hidden>

    Backport: Update documentation for indent-relative functions
    
    * lisp/indent.el (indent-relative): Document what happens when there
      is no previous nonblank line.
    * doc/lispref/text.texi (Relative Indent): Document
      indent-relative-first-indent-point instead of obsolete
      indent-relative-maybe. Fix documentation of which argument from
      'indent-relative' is used.
    
    Bug#34858
    
    (cherry picked from commit 10cd65878c741d2a22a1f2c36c54fcad4e516f72)
---
 doc/lispref/text.texi | 4 ++--
 lisp/indent.el        | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index fb5f56e..73312bb 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -2570,11 +2570,11 @@ The quick brown fox jum  @point{}ped.
 @end example
 @end deffn
 
address@hidden Command indent-relative-maybe
address@hidden Command indent-relative-first-indent-point
 @comment !!SourceFile indent.el
 This command indents the current line like the previous nonblank line,
 by calling @code{indent-relative} with @code{t} as the
address@hidden argument.  The return value is unpredictable.
address@hidden argument.  The return value is unpredictable.
 
 If the previous nonblank line has no indent points beyond the current
 column, this command does nothing.
diff --git a/lisp/indent.el b/lisp/indent.el
index 7be5a5a..8a0f837 100644
--- a/lisp/indent.el
+++ b/lisp/indent.el
@@ -592,8 +592,9 @@ considered.
 
 If the previous nonblank line has no indent points beyond the
 column point starts at, then `tab-to-tab-stop' is done, if both
-FIRST-ONLY and UNINDENTED-OK are nil, otherwise nothing is done
-in this case.
+FIRST-ONLY and UNINDENTED-OK are nil, otherwise nothing is done.
+If there isn't a previous nonblank line and UNINDENTED-OK is nil,
+call `tab-to-tab-stop'.
 
 See also `indent-relative-first-indent-point'."
   (interactive "P")