From: Bruno Haible Date: Sun, 3 Mar 2024 09:52:53 +0000 (+0100) Subject: doc: Update regarding --create-megatestdir. X-Git-Tag: v1.0~350 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=084ed31eeb56cd8e50b9486d13a364926eef7798;p=thirdparty%2Fgnulib.git doc: Update regarding --create-megatestdir. Reported by Alexei Sholomitskiy in and by Collin Funk in . * doc/build-automation.texi (Building gnulib): Discourage the use of --create-megatestdir with all modules. --- diff --git a/ChangeLog b/ChangeLog index 1778f34adc..0ad10de405 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,13 @@ +2024-03-03 Bruno Haible + + doc: Update regarding --create-megatestdir. + Reported by Alexei Sholomitskiy in + + and by Collin Funk in + . + * doc/build-automation.texi (Building gnulib): Discourage the use of + --create-megatestdir with all modules. + 2024-03-01 Bruno Haible gnulib-tool.py: Clarify minimum supported Python version. diff --git a/doc/build-automation.texi b/doc/build-automation.texi index bff5daf283..250723e717 100644 --- a/doc/build-automation.texi +++ b/doc/build-automation.texi @@ -28,10 +28,19 @@ On a machine with GNU development tools installed and with a gnulib git checkout, use @example -gnulib-tool --create-megatestdir --with-tests --dir=... +gnulib-tool --create-testdir --with-tests --dir=... @end example -Note: The created directory uses ca. 512 MB on disk. +Alternatively, pick a small set of modules and run + +@example +gnulib-tool --create-megatestdir --with-tests --dir=... autobuild MODULES +@end example + +@noindent +(You can't do this will all of Gnulib at once: @code{gnulib-tool} would run +for a week and produce a directory that takes more than 100 GB, maybe even 1 TB, +of disk space.) @item Transfer gnulib directory