\input texinfo @c -*-texinfo-*-
-@comment $Id: gnulib.texi,v 1.29 2006-10-23 11:27:37 haible Exp $
+@comment $Id: gnulib.texi,v 1.33 2007-03-15 22:58:36 eggert Exp $
@comment %**start of header
@setfilename gnulib.info
@settitle GNU Gnulib
@syncodeindex pg cp
@comment %**end of header
-@set UPDATED $Date: 2006-10-23 11:27:37 $
+@set UPDATED $Date: 2007-03-15 22:58:36 $
@copying
This manual is for GNU Gnulib (updated @value{UPDATED}),
which is a library of common routines intended to be shared at the
source level.
-Copyright @copyright{} 2004, 2005, 2006 Free Software Foundation, Inc.
+Copyright @copyright{} 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
-@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,''
-and with the Back-Cover Texts as in (a) below. A copy of the
-license is included in the section entitled ``GNU Free Documentation
-License.''
-
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software. Copies published by the Free
-Software Foundation raise funds for GNU development.''
-@end quotation
+Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+Texts. A copy of the license is included in the section entitled
+``GNU Free Documentation License.''
@end copying
@dircategory Software development
@menu
* Introduction::
* Invoking gnulib-tool::
-* Miscellanous Notes::
+* Miscellaneous Notes::
* Particular Modules:: Documentation of Individual Modules
* Copying This Manual::
* Index::
@end menu
-
@node Introduction
@chapter Introduction
@include gnulib-tool.texi
-@node Miscellanous Notes
-@chapter Miscellanous Notes
+@node Miscellaneous Notes
+@chapter Miscellaneous Notes
@menu
* Comments::
* Windows sockets::
* Libtool and Windows::
* License Texinfo sources::
+* Build robot for gnulib::
@end menu
Of course the license texts themselves should not be changed at all.
+@node Build robot for gnulib
+@section Build robot for gnulib
+
+To simplify testing on a wide set of platforms, gnulib is built on
+many platforms every day and the results are uploaded to:
+
+@url{http://autobuild.josefsson.org/gnulib/}
+
+If you wish to help the gnulib development effort with build logs for
+your favorite platform, you may perform these steps:
+
+@enumerate
+
+@item Create gnulib directory
+
+On a machine with recent automake, autoconf, m4 installed and with a
+gnulib cvs checkout (typically a Linux machine), use
+
+@example
+gnulib-tool --create-megatestdir --with-tests --dir=..."
+@end example
+
+Note: The created directory uses ca. 512 MB on disk.
+
+@item Transfer gnulib directory
+
+Transfer this directory to a build machine (HP-UX, Cygwin, or
+whatever). Often it is easier to transfer one file, and this can be
+achieved by running, inside the directory the following commands:
+
+@example
+./configure
+make dist
+@end example
+
+And then transferring the @file{dummy-0.tar.gz} file.
+
+@item Build modules
+
+On the build machine, run ./autobuild (or "nohup ./autobuild"). It
+creates a directory 'logs/' with a log file for each module.
+
+@item Submit build logs
+
+Submit each log file to Simon's site, either through a
+
+@example
+mail `echo gnulib__at__autobuild.josefsson.org | sed -e s/__at__/@/`
+@end example
+
+or through netcat
+
+@example
+autobuild-submit logs/*
+@end example
+
+@end enumerate
@node Particular Modules
@chapter Particular Modules
@menu
* Quoting::
* ctime::
+* error and progname::
* gcd::
* inet_ntoa::
* Regular expressions::
+* Supporting Relocation::
@end menu
@include quote.texi
-
+@include error.texi
@include ctime.texi
-
@include gcd.texi
-
@include inet_ntoa.texi
+@include relocatable-maint.texi
@node Regular expressions
@section Regular expressions