Mercurial > hg > octave-lyh > gnulib-hg
changeset 10850:c68477777efb
Advocacy documentation.
author | Bruno Haible <bruno@clisp.org> |
---|---|
date | Sat, 06 Dec 2008 13:04:07 +0100 |
parents | ce362087a6b5 |
children | d31da80e6c50 |
files | ChangeLog doc/gnulib-intro.texi doc/gnulib.texi |
diffstat | 3 files changed, 42 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2008-12-06 Bruno Haible <bruno@clisp.org> + + Advocacy documentation. + * doc/gnulib-intro.texi (Benefits): New section. + * doc/gnulib.texi: Update. + 2008-12-06 Bruno Haible <bruno@clisp.org> Document the 'manywarnings' module.
--- a/doc/gnulib-intro.texi +++ b/doc/gnulib-intro.texi @@ -1,3 +1,37 @@ +@node Benefits +@section Benefits of using Gnulib + +Gnulib is useful to enhance various aspects of a package: + +@itemize @bullet +@item +Portability: With Gnulib, a package maintainer can program against the +POSIX and GNU libc APIs and nevertheless expect good portability to +platforms that don't implement POSIX. + +@item +Maintainability: When a package uses modules from Gnulib instead of code +written specifically for that package, the maintainer has less code to +maintain. + +@item +Security: Gnulib provides functions that are immune against vulnerabilities +that plagues the uses of the corresponding commonplace functions. For +example, @code{asprintf}, @code{canonicalize_file_name} are not affected +by buffer sizing problems that affect @code{sprintf}, @code{realpath}. +@code{openat} does not have the race conditions that @code{open} has. Etc. + +@item +Reliability: Gnulib provides functions that combine a call to a system +function with a check of the result. Examples are @code{xalloc}, +@code{xprintf}, @code{xstrtod}, @code{xgetcwd}. + +@item +Structure: Gnulib offers a way to structure code into modules, typically +one include file, one source code file, and one autoconf macro for each +functionality. Modularity helps maintainability. +@end itemize + @node Library vs Reusable Code @section Library vs. Reusable Code