Avoid "overfull hboxes" in the TeXed documentation.

4 files changed, 34 insertions, 7 deletions

diff --git a/ChangeLog b/ChangeLog
index ed1cf76..2f93b7d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,15 @@
 2009-05-01  Bruno Haible  <bruno@clisp.org>
 
+	Avoid "overfull hboxes" in the TeXed documentation.
+	* doc/libunistring.texi (texnl): New macro.
+	(Unicode, Autoconf macro): Use it.
+	* doc/unictype.texi (Canonical combining class,
+	Bidirectional category): Likewise.
+	* doc/uniwbrk.texi (Word break property): Likewise.
+	Reported by Ralf Wildenhues.
+
+2009-05-01  Bruno Haible  <bruno@clisp.org>
+
 	* lib/exported.sh.in: Fix quoting of argument reference.
 
 2009-05-01  Bruno Haible  <bruno@clisp.org>
diff --git a/doc/libunistring.texi b/doc/libunistring.texi
index 5b6b617..46f43ee 100644
--- a/doc/libunistring.texi
+++ b/doc/libunistring.texi
@@ -54,6 +54,23 @@
 @code{\func\}
 @end macro
 
+@c Macro for forcing a line break in TeX mode.
+@c Needed because there are long unbreakable pieces of text (such as URLs or
+@c formulas), TeX is too shy to move them to a new file. TeX considers only
+@c two choices: a line break in aligned mode (which it rejects due to aesthetic
+@c reasons) and writing into the margin. What we want in many cases is a line
+@c break without filling the first line. Like what @* delivers.
+@c But we need it only in TeX mode. info and HTML modes are fine.
+@iftex
+@macro texnl
+@*
+@end macro
+@end iftex
+@ifnottex
+@macro texnl
+@end macro
+@end ifnottex
+
 @ifinfo
 @dircategory Software development
 @direntry
@@ -339,7 +356,7 @@ Definition of UTF-8: @url{http://www.rfc-editor.org/rfc/rfc3629.txt}
 @item
 Definition of UTF-16: @url{http://www.rfc-editor.org/rfc/rfc2781.txt}
 @item
-Markus Kuhn's UTF-8 and Unicode FAQ:
+Markus Kuhn's UTF-8 and Unicode FAQ:@texnl
 @url{http://www.cl.cam.ac.uk/~mgk25/unicode.html}
 @end itemize
 
@@ -834,7 +851,7 @@ that uses @code{libunistring} was installed.
 
 @cindex autoconf macro
 GNU Gnulib provides an autoconf macro that test for the availability
-of @code{libunistring}.  It is contained in the Gnulib module
+of @code{libunistring}.  It is contained in the Gnulib module@texnl
 @url{http://www.gnu.org/software/gnulib/MODULES.html#module=libunistring}.
 
 @amindex gl_LIBUNISTRING
diff --git a/doc/unictype.texi b/doc/unictype.texi
index 4dbcb15..cee4f45 100644
--- a/doc/unictype.texi
+++ b/doc/unictype.texi
@@ -377,8 +377,8 @@ combining classes are attached "first" or "closer" to the base character.
 
 The canonical combining class of a character is a number in the range
 0..255.  The possible values are described in the Unicode Character Database
-@url{http://www.unicode.org/Public/UNIDATA/UCD.html}.  The list here is not
-definitive; more values can be added in future versions.
+@texnl @url{http://www.unicode.org/Public/UNIDATA/UCD.html}.  The list here is
+not definitive; more values can be added in future versions.
 
 @deftypevr Constant int UC_CCC_NR
 The canonical combining class value for ``Not Reordered'' characters.
@@ -471,7 +471,7 @@ Returns the canonical combining class of a Unicode character.
 Every Unicode character or code point has a @emph{bidirectional category}
 assigned to it.
 
-The bidirectional category guides the bidirectional algorithm
+The bidirectional category guides the bidirectional algorithm@texnl
 (@url{http://www.unicode.org/reports/tr9/}).  The possible values are
 the following.
 
diff --git a/doc/uniwbrk.texi b/doc/uniwbrk.texi
index 1f4fece..ea0ec89 100644
--- a/doc/uniwbrk.texi
+++ b/doc/uniwbrk.texi
@@ -43,8 +43,8 @@ word break to be present at the beginning of the string (before
 
 This is a more low-level API.  The word break property is a property defined
 in Unicode Standard Annex #29, section ``Word Boundaries'', see
-@url{http://www.unicode.org/reports/tr29/#Word_Boundaries}.  It is used for
-determining the word breaks in a string.
+@url{http://www.unicode.org/reports/tr29/#Word_Boundaries}.@texnl  It is used
+for determining the word breaks in a string.
 
 The following are the possible values of the word break property.  More values
 may be added in the future.