]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Deal with tables that are overloaded in info mode.
authorBruno Haible <bruno@clisp.org>
Sat, 4 Jan 2025 09:53:07 +0000 (10:53 +0100)
committerBruno Haible <bruno@clisp.org>
Sat, 4 Jan 2025 10:08:23 +0000 (11:08 +0100)
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.

ChangeLog
doc/containers.texi
doc/libunistring.texi
doc/strings.texi

index cce0804a22cd3846535f8ae94ed5deca37bd3d80..fe14499cbb761dc1b906d4c0852ed5fdb6a92ddf 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+2025-01-04  Bruno Haible  <bruno@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.
+
 2025-01-04  Bruno Haible  <bruno@clisp.org>
 
        *_startswith, *_endswith: Change return type to 'bool'.
index 3bbdd436a2bec17d8edde92f166c252be4a66f86..476c36d95971dd32733e82e5e904a5f6ffb27fd1 100644 (file)
@@ -44,7 +44,12 @@ to organize collections of application-defined objects.
 @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 instance.
 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
index 8dca531d35b0d6521d11335c4b54bef4c4370707..6a756d7e50e337837c831a9dcacb62658efd69fb 100644 (file)
@@ -526,6 +526,12 @@ The @code{<unitypes.h>} header file is provided by the module @code{unitypes-h}.
 @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
index 67a2d75cef2fd0cfa1d17b43fd4b484a69737063..0493233ba0b67827772fa15c804a0e422c365e59 100644 (file)
@@ -489,12 +489,48 @@ and in Gnulib.
 @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}