Re: mem*/strr*/etc... obsolete warnings

[Bruno Haible]

Mike Frysinger wrote:
> i mean something simple like this (and the output from gnulib-tool still 
> looks 
> sane to me):
> --- a/modules/memcpy
> +++ b/modules/memcpy
> @@ -5,7 +5,7 @@ Status:
>  obsolete
> 
>  Notice:
> -This module is obsolete.
> +This module is obsolete (see gnulib.info::Obsolete modules).
> 
>  Files:
>  lib/memcpy.c

IMO that is excess verbosity. People have to learn by themselves that they
can look into the documentation. I'm not opposed to links into the doc in
general, and if the output would be in HTML
   <a href="gnulib.html#Obsolete-modules">obsolete</a>
I would in favour of it. But for plain-text output, it's too verbose.

You were in the unlucky situation that no doc existed for the term
"obsolete" when you were searching for it. This is now fixed.


2009-01-28  Bruno Haible  <address@hidden>

        * doc/gnulib.texi: Add "Obsolete modules" to index.

*** doc/gnulib.texi.orig        2009-01-28 11:02:05.000000000 +0100
--- doc/gnulib.texi     2009-01-28 10:57:33.000000000 +0100
***************
*** 265,270 ****
--- 265,271 ----
  @node Obsolete modules
  @section Obsolete modules
  
+ @cindex Obsolete modules
  Modules can be marked obsolete.  This means that the problems they fix
  don't occur any more on the platforms that are reasonable porting targets
  now.  @code{gnulib-tool} warns when obsolete modules are mentioned on the