Branch
Hash :
67d14683
Author :
Date :
2017-05-10T19:19:51
Prepare for reordering sections in the manual. * doc/gnulib.texi: Move several sections to separate files. Include these files. * doc/out-of-memory.texi: New file, extracted from doc/gnulib.texi. * doc/obsolete.texi: Likewise. * doc/extra-tests.texi: Likewise. * doc/transversal.texi: Likewise. * doc/namespace.texi: Likewise. * doc/check-version.texi: Likewise. * doc/windows-sockets.texi: Likewise. * doc/windows-libtool.texi: Likewise. * doc/licenses-texi.texi: Likewise. * doc/build-automation.texi: Likewise. * doc/c-locale.texi: Likewise.
@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
command line, and by default ignores dependencies from modules to obsolete
modules. When you pass the option @code{--with-obsolete} to
@code{gnulib-tool}, dependencies to obsolete modules will be included,
however, unless blocked through an @code{--avoid} option. This option
is useful if your package should be portable even to very old platforms.
In order to mark a module obsolete, you need to add this to the module
description:
@example
Status:
obsolete
Notice:
This module is obsolete.
@end example