[Emacs-diffs] trunk r116184: Doc for fill-single-char-nobreak-p

[Glenn Morris]

------------------------------------------------------------
revno: 116184
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Mon 2014-01-27 21:50:16 -0500
message:
  Doc for fill-single-char-nobreak-p
  
  * doc/emacs/text.texi (Fill Commands): Mention fill-single-char-nobreak-p.
  
  * lisp/textmodes/fill.el (fill-single-char-nobreak-p): Doc tweak.
  
  * etc/NEWS: Related edit.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/text.texi            text.texi-20091113204419-o5vbwnq5f7feedwu-6278
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/textmodes/fill.el         fill.el-20091113204419-o5vbwnq5f7feedwu-127

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-28 02:16:13 +0000
+++ b/doc/emacs/ChangeLog       2014-01-28 02:50:16 +0000
@@ -1,5 +1,7 @@
 2014-01-28  Glenn Morris  <address@hidden>
 
+       * text.texi (Fill Commands): Mention fill-single-char-nobreak-p.
+
        * indent.texi (Tab Stops): Updates for new tab-stop behavior.
 
 2014-01-27  Glenn Morris  <address@hidden>

=== modified file 'doc/emacs/text.texi'
--- a/doc/emacs/text.texi       2014-01-01 23:13:59 +0000
+++ b/doc/emacs/text.texi       2014-01-28 02:50:16 +0000
@@ -562,10 +562,11 @@
 (@pxref{Hooks}).  Each function in this hook is called with no
 arguments, with point positioned where Emacs is considering breaking a
 line.  If a function returns a address@hidden value, Emacs will not
-break the line there.  Two functions you can use are
+break the line there.  Functions you can use there include:
 @code{fill-single-word-nobreak-p} (don't break after the first word of
-a sentence or before the last) and @code{fill-french-nobreak-p} (don't
-break after @samp{(} or before @samp{)}, @samp{:} or @samp{?}).
+a sentence or before the last); @code{fill-single-char-nobreak-p}
+(don't break after a one-letter word); and @code{fill-french-nobreak-p}
+(don't break after @samp{(} or before @samp{)}, @samp{:} or @samp{?}).
 
 @node Fill Prefix
 @subsection The Fill Prefix

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-28 02:16:13 +0000
+++ b/etc/NEWS  2014-01-28 02:50:16 +0000
@@ -280,11 +280,10 @@
 spacing.  Like `just-one-space', it can handle or ignore newlines and
 leave different number of spaces.
 
++++
 *** `fill-single-char-nobreak-p' prevents fill from breaking a line after
-a 1-letter word, which is an error according to Polish and
-Czech typography rules.  To globally enable this feature, evaluate:
-
-  (add-hook 'fill-nobreak-predicate 'fill-single-char-nobreak-p)
+a one-letter word, which is an error according to some rules of typography.
+To use it, add it to the `fill-nobreak-predicate' hook.
 
 +++
 ** Uniquify is enabled by default, with `post-forward-angle-brackets' style.

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2014-01-28 01:49:02 +0000
+++ b/lisp/ChangeLog    2014-01-28 02:50:16 +0000
@@ -1,5 +1,7 @@
 2014-01-28  Glenn Morris  <address@hidden>
 
+       * textmodes/fill.el (fill-single-char-nobreak-p): Doc tweak.
+
        * indent.el (tab-stop-list): Doc fix.  Add :version.
 
        * vc/pcvs.el (vc-editable-p, vc-checkout): Remove unused declarations.

=== modified file 'lisp/textmodes/fill.el'
--- a/lisp/textmodes/fill.el    2014-01-01 07:43:34 +0000
+++ b/lisp/textmodes/fill.el    2014-01-28 02:50:16 +0000
@@ -330,10 +330,10 @@
                   (eq (char-syntax (following-char)) ?w)))))))
 
 (defun fill-single-char-nobreak-p ()
-  "Return t if point is placed just after a 1-letter word.
-This is used in `fill-nobreak-predicate' to prevent breaking line just
-after a 1-letter word (usually conjunction or preposition) which is
-considered composition error in Polish and Czech typography."
+  "Return non-nil if a one-letter word is before point.
+This function is suitable for adding to the hook `fill-nobreak-predicate',
+to prevent the breaking of a line just after a one-letter word,
+which is an error according to some rules of typography."
   (save-excursion
     (skip-chars-backward " \t")
     (backward-char 2)