From: Bruno Haible Date: Sat, 4 Jan 2025 09:53:07 +0000 (+0100) Subject: doc: Deal with tables that are overloaded in info mode. X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=353dcc07d66b3645f779ed45b6c8210f5fef8b83;p=gnulib.git 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 ( modules): Likewise. --- diff --git a/ChangeLog b/ChangeLog index cce0804a22..fe14499cbb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,15 @@ +2025-01-04 Bruno Haible + + 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 ( modules): Likewise. + 2025-01-04 Bruno Haible *_startswith, *_endswith: Change return type to 'bool'. 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 @@ 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 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 @@ The @code{} header file is provided by the module @code{unitypes-h}. @node modules @subsubsection Declarations in +@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 @@ 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}