From 084ed31eeb56cd8e50b9486d13a364926eef7798 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Sun, 3 Mar 2024 10:52:53 +0100 Subject: [PATCH] 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. --- ChangeLog | 10 ++++++++++ doc/build-automation.texi | 13 +++++++++++-- 2 files changed, 21 insertions(+), 2 deletions(-) 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 -- 2.39.5