]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Update regarding --create-megatestdir.
authorBruno Haible <bruno@clisp.org>
Sun, 3 Mar 2024 09:52:53 +0000 (10:52 +0100)
committerBruno Haible <bruno@clisp.org>
Sun, 3 Mar 2024 09:52:53 +0000 (10:52 +0100)
Reported by Alexei Sholomitskiy <asholomitskiy84@gmail.com> in
<https://lists.gnu.org/archive/html/bug-gnulib/2023-07/msg00071.html>
and by Collin Funk <collin.funk1@gmail.com> in
<https://lists.gnu.org/archive/html/bug-gnulib/2024-03/msg00007.html>.

* doc/build-automation.texi (Building gnulib): Discourage the use of
--create-megatestdir with all modules.

ChangeLog
doc/build-automation.texi

index 1778f34adcf0f77ff1916b55154157ba879ee314..0ad10de40543b72ae46061ab1beda037a75d7d69 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2024-03-03  Bruno Haible  <bruno@clisp.org>
+
+       doc: Update regarding --create-megatestdir.
+       Reported by Alexei Sholomitskiy <asholomitskiy84@gmail.com> in
+       <https://lists.gnu.org/archive/html/bug-gnulib/2023-07/msg00071.html>
+       and by Collin Funk <collin.funk1@gmail.com> in
+       <https://lists.gnu.org/archive/html/bug-gnulib/2024-03/msg00007.html>.
+       * doc/build-automation.texi (Building gnulib): Discourage the use of
+       --create-megatestdir with all modules.
+
 2024-03-01  Bruno Haible  <bruno@clisp.org>
 
        gnulib-tool.py: Clarify minimum supported Python version.
index bff5daf283350ef108669a9e25d8ba9833f30e90..250723e717d5b1ea6f66e6142519d43f02e32048 100644 (file)
@@ -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