branch master updated: * README-hacking: add suggestion and instructions to run tests after turning off autovivification in Perl.

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new b9ab7cdc70 * README-hacking: add suggestion and instructions to run 
tests after turning off autovivification in Perl.
b9ab7cdc70 is described below

commit b9ab7cdc704848380066c8d6eb5ce878ab365b33
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Thu Nov 14 11:01:43 2024 +0100

    * README-hacking: add suggestion and instructions to run tests after
    turning off autovivification in Perl.
---
 ChangeLog      |  5 +++++
 README-hacking | 11 +++++++++++
 2 files changed, 16 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 4dc5252589..cdb39bc3cf 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-11-14  Patrice Dumas  <pertusus@free.fr>
+
+       * README-hacking: add suggestion and instructions to run tests after
+       turning off autovivification in Perl.
+
 2024-11-14  Patrice Dumas  <pertusus@free.fr>
 
        * tp/Texinfo/Common.pm (locate_file_in_dirs),
diff --git a/README-hacking b/README-hacking
index 1f3bf74e09..a1a0053193 100644
--- a/README-hacking
+++ b/README-hacking
@@ -317,6 +317,17 @@ run all tests with valgrind:
           perl -w $f ; done
  (could take 1-2 hours to finish).  check log files one by one afterwards.
 
+Consider doing make check with autovivification turned off to find bugs
+and make sure that it is possible to turn off autovivification during
+developpement.  It may be interesting to set TEXINFO_XS=omit for this
+verification.  The module turning off autovivification is not in Perl
+core, so when commiting the lines turning autovivification off should
+always be commented out.
+To turn off autovivification, you can use:
+ find tp/Texinfo tp/ext tp/init -type f -name '*.pm' -execdir perl -wpli -e 
's/^#no autovivification qw\(fetch delete exists store strict\);/no 
autovivification qw\(fetch delete exists store strict\);/' '{}' ';'
+To get back to the default:
+ find tp/Texinfo tp/ext tp/init -type f -name '*.pm' -execdir perl -wpli -e 
's/^no autovivification qw\(fetch delete exists store strict\);/#no 
autovivification qw\(fetch delete exists store strict\);/' '{}' ';'
+
 Manual testing:
 . try groff.texinfo from groff source repo.
 . process doc/texinfo-tex-test.texi with TeX and check that output is good.