Suggestion to improve install docs

[vuktw]

After running configure, make will fail if the OS has another version of autotools. Relevant log:

 cd . && /bin/sh /tmp/SBo/vcsh-2.0.10/build-aux/missing automake-1.16 --foreign Makefile            14:05:27 [156/474]
/tmp/SBo/vcsh-2.0.10/build-aux/missing: line 81: automake-1.16: command not found                                     
WARNING: 'automake-1.16' is missing on your system.                                                                   
         You should only need it if you modified 'Makefile.am' or                                                     
         'configure.ac' or m4 files included by 'configure.ac'.                                                       
         The 'automake' program is part of the GNU Automake package:     
         <https://www.gnu.org/software/automake>                                                                      
         It also requires GNU Autoconf, GNU m4 and Perl in order to run:                                              
         <https://www.gnu.org/software/autoconf>                                                                      
         <https://www.gnu.org/software/m4/>                                                                           
         <https://www.perl.org/>                                                                                      
make: *** [Makefile:356: Makefile.in] Error 127                                                                       

This is on Slackware64 -current (15.0+) with automake-1.18.1

This can be fixed by running autoreconf -f before ./configure, but it would be nice to have it in INSTALL.md

[alerque]

I'm all for making the docs better if it helps anybody, but this seems like it would be documenting a workaround for a bug that should be fixed instead.

Using a ./configure script on a machine should never result in an error about a previous version of autotools not being found. Something else is awry here. The only situation I know of that should need an autoreconf -f run before being able to use the configure script is in the case of running it on a platform that wasn't supported by the autotools version used to generate the configure script (e.g. on a RISC-V platform trying to build something from a source tarball that was generated on a machine without the RISC-V support being part of auto tools).

Can you tell me more about how you got here? What source did you download?

[vuktw]

You can see it in the log above, the directory there is the one extracted from the last release and downloaded from https://github.com/RichiH/vcsh/releases/download/v2.0.10/vcsh-2.0.10.tar.zst