X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;ds=inline;f=doc%2Fgnulib.texi;h=cc826994def4ad7089ee821996156b217dbd45b1;hb=f2e592bfe3e001764b5031e38e102dd914c84b5f;hp=8f6a41fda32111529ae5edf1450dbaf3967051c5;hpb=c0d8d21d1f6c731c09350f67e5dc9f4e196fee36;p=gnulib.git diff --git a/doc/gnulib.texi b/doc/gnulib.texi index 8f6a41fda..cc826994d 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -1,5 +1,5 @@ \input texinfo @c -*-texinfo-*- -@comment $Id: gnulib.texi,v 1.12 2005-07-11 16:45:26 haible Exp $ +@comment $Id: gnulib.texi,v 1.14 2005-07-27 00:16:01 karl Exp $ @comment %**start of header @setfilename gnulib.info @settitle GNU Gnulib @@ -7,7 +7,7 @@ @syncodeindex pg cp @comment %**end of header -@set UPDATED $Date: 2005-07-11 16:45:26 $ +@set UPDATED $Date: 2005-07-27 00:16:01 $ @copying This manual is for GNU Gnulib (updated @value{UPDATED}), @@ -87,6 +87,7 @@ Getting started: * inet_ntoa:: * Out of memory handling:: * Library version handling:: +* Regular expressions:: @end menu @@ -295,7 +296,7 @@ fail. @node Library version handling @section Library version handling -The module ``check_version'' can be useful when your gnulib +The module @samp{check-version} can be useful when your gnulib application is a system library. You will typically wrap the call to the @code{check_version} function through a library API, your library header file may contain: @@ -306,8 +307,16 @@ header file may contain: extern const char *stringprep_check_version (const char *req_version); @end example -The implementation of @code{stringprep_check_version} would simply -pass on the call to @code{check_version}. +To avoid ELF symbol collisions with other libraries that use the +@samp{check-version} module, add to @file{config.h} through a +AC_DEFINE something like: + +@example +AC_DEFINE(check_version, stringprep_check_version, [Rename check_version.]) +@end example + +The @code{stringprep_check_version} function will thus be implemented +by the @code{check_version} module. There are two uses of the interface. The first is a way to provide for applications to find out the version number of the library it @@ -338,6 +347,17 @@ Typical uses look like: @end example +@node Regular expressions +@section Regular expressions + +Gnulib supports many different types of regular expressions; although +the underlying features are the same or identical, the syntax used +varies. The descriptions given here for the different types are +generated automatically. + +@include regexprops-generic.texi + + @node Invoking gnulib-tool @chapter Invoking gnulib-tool