doc/build-automation.texi

   1 @node Building gnulib
   2 @section Building gnulib
   3
   4 If you wish to help the gnulib development effort with build logs for
   5 your favorite platform, you may perform these steps:
   6
   7 @enumerate
   8
   9 @item Prerequisites tools
  10
  11 Install the proper development tools.  To build and test all of
  12 Gnulib, you will need development tools for the programming languages
  13 C, C++, Java, and Perl, along with standard POSIX utilities such as
  14 @command{awk}, @command{make} and @command{sh}.  You will also need
  15 development tools that include Autoconf, Automake, Bison, Gettext,
  16 Git, GNU M4, Gperf, Libtool, and Texinfo.  Some of these tools are
  17 needed only by some modules.  More details can be found in Gnulib's
  18 @file{DEPENDENCIES} file.
  19
  20 @item Obtain Gnulib
  21
  22 See @url{https://www.gnu.org/software/gnulib/} for how to get the
  23 current Gnulib sources via Git.
  24
  25 @item Create gnulib directory
  26
  27 On a machine with GNU development tools installed and with a gnulib
  28 git checkout, use
  29
  30 @example
  31 gnulib-tool --create-megatestdir --with-tests --dir=...
  32 @end example
  33
  34 Note: The created directory uses ca. 512 MB on disk.
  35
  36 @item Transfer gnulib directory
  37
  38 Transfer this directory to a build machine (HP-UX, Cygwin, or
  39 whatever).  Often it is easier to transfer one file, and this can be
  40 achieved by running, inside the directory the following commands:
  41
  42 @example
  43 ./configure
  44 make dist
  45 @end example
  46
  47 And then transferring the @file{dummy-0.tar.gz} file.
  48
  49 @item Build modules
  50
  51 On the build machine, run ./do-autobuild (or "nohup ./do-autobuild").
  52 It creates a directory @file{logs/} with a log file for each module.
  53
  54 @end enumerate