Paul Eggert wrote:
> > I don't know what to do about it. Generate an 'info' file with a
> > page width of 100 instead of 80? Splitting each table into 2 tables,
> > thus making it harder for the reader to get a synopsis?
>
> Maybe hyphenation? No solution is good here.
Automatic hyphenation is not supported by makeinfo in 'info' mode.
Therefore I added manual hyphenation here. Thanks for the suggestion.
For other tables, where even hyphenation does not help, I'm adding
a note to the user, referring to the HTML documentation:
2025-01-04 Bruno Haible <br...@clisp.org>
doc: Deal with tables that are overloaded in info mode.
Suggested by Paul Eggert.
* doc/strings.texi (Comparison of string APIs): In info mode, use manual
line breaking in the startswith row.
* doc/containers.texi (Ordinary containers): Use different column
proportions in info mode.
(Sequential lists): In info mode, suggest to look at the HTML-formatted
documentation.
* doc/libunistring.texi (<unictype.h> modules): Likewise.
diff --git a/doc/containers.texi b/doc/containers.texi
index 3bbdd436a2..476c36d959 100644
--- a/doc/containers.texi
+++ b/doc/containers.texi
@@ -44,7 +44,12 @@
@mindex map
@mindex omap
+@ifinfo
+@multitable @columnfractions .15 .45 .09 .15 .16
+@end ifinfo
+@ifnotinfo
@multitable @columnfractions .15 .5 .1 .1 .15
+@end ifnotinfo
@headitem Data type
@tab Details
@tab Module
@@ -107,6 +112,12 @@
The implementations and the guaranteed average performance for the operations
for the ``sequential list'' data type are:
+@ifinfo
+@noindent
+Note: This table is overloaded in the @command{info}-formatted documentation.
+It is better viewable in the HTML-formatted documentation.
+@end ifinfo
+
@multitable @columnfractions 0.2 0.1 0.1 0.1 0.1 0.1 0.1 0.1 0.1
@headitem Operation
@tab ARRAY
diff --git a/doc/libunistring.texi b/doc/libunistring.texi
index 8dca531d35..6a756d7e50 100644
--- a/doc/libunistring.texi
+++ b/doc/libunistring.texi
@@ -526,6 +526,12 @@
@node <unictype.h> modules
@subsubsection Declarations in <unictype.h>
+@ifinfo
+@noindent
+Note: This table is overloaded in the @command{info}-formatted documentation.
+It is better viewable in the HTML-formatted documentation.
+@end ifinfo
+
@mindex unictype/category-L
@mindex unictype/category-LC
@mindex unictype/category-Lu
diff --git a/doc/strings.texi b/doc/strings.texi
index 67a2d75cef..0493233ba0 100644
--- a/doc/strings.texi
+++ b/doc/strings.texi
@@ -489,12 +489,48 @@
@tab --
@tab --
-@item @code{str_startswith}
-@tab @code{str_startswith}
-@tab @code{mbs_startswith}
-@tab @code{sd_startswith}
+@item
+@c Special hack, to make this table line look reasonable in info mode.
+@ifinfo
+@code{str_
+ startswith}
+@end ifinfo
+@ifnotinfo
+@code{str_startswith}
+@end ifnotinfo
+@tab
+@ifinfo
+@code{str_
+ startswith}
+@end ifinfo
+@ifnotinfo
+@code{str_startswith}
+@end ifnotinfo
+@tab
+@ifinfo
+@code{mbs_
+ startswith}
+@end ifinfo
+@ifnotinfo
+@code{mbs_startswith}
+@end ifnotinfo
+@tab
+@ifinfo
+@code{sd_
+ startswith}
+@end ifinfo
+@ifnotinfo
+@code{sd_startswith}
+@end ifnotinfo
@tab --
-@tab @code{u32_startswith}
+@tab
+@ifinfo
+@code{u32_
+ startswith}
+@end ifinfo
+@ifnotinfo
+@code{u32_startswith}
+@end ifnotinfo
@item @code{str_endswith}
@tab @code{str_endswith}
