Log Message:
stow: update to 2.3.1.

From Chavdar Ivanov in PR pkg/57899.

* Changes in version 2.3.1

*** Remove dependencies on Hash::Merge and Clone::Choose

    stow 2.3.0 added external runtime dependencies on Hash::Merge and
    Clone::Choose. Historically stow hasn't had runtime dependencies
    other than Perl itself, which is a useful property if you're
    managing the installation of Perl using stow; the bootstrapping
    instructions in stow's manual would need updating to describe how
    to install these two modules (and any dependencies they have now
    or in the future) as well.

    However, Hash::Merge is much more general than stow actually
    needs, so replace the merge() call with a few lines of equivalent
    code -- this avoids the external dependencies, and is clearer than
    the merge() call.

    Many thanks to Adam Sampson for this patch!

    https://lists.gnu.org/archive/html/bug-stow/2019-06/msg00001.html

*** Fix an issue with the test suite

    t/cli.t was not testing with the right Perl executable, as
    reported here:

        https://rt.cpan.org/Ticket/Display.html?id=129944

    Thanks to Slaven Rezic for spotting this and reporting it!

*** Various maintainer tweaks

    Improved the release process and its documentation in various
    minor ways.

* Changes in version 2.3.0

*** New features / changes in behaviour

***** New --dotfiles option

      Enable special handling for "dotfiles" (files or folders whose name
      begins with a period) in the package directory. If this option is
      enabled, Stow will add a preprocessing step for each file or folder
      whose name begins with "dot-", and replace the "dot-" \ 
prefix in the
      name by a period (".").  This is useful when Stow is used to manage
      collections of dotfiles, to avoid having a package directory full
      of hidden files.

      For example, suppose we have a package containing two files,
      stow/dot-bashrc and stow/dot-emacs.d/init.el.  With this option,
      Stow will create symlinks from .bashrc to stow/dot-bashrc and from
      .emacs.d/init.el to stow/dot-emacs.d/init.el.  Any other files,
      whose name does not begin with "dot-", will be processed as usual.

      Thanks to Joris Vankerschaver for this feature!

***** Shell-like expansion in .stowrc files

      For options within .stowrc files which describe file paths, "~" can
      be included to expand to the current value of $HOME, and
      environment variables can be referenced e.g. via "$FOO" or
      "${FOO}".  To prevent expansion, escape with a backslash.

      Thanks a lot to Charles LeDoux for his diligent work on this
      feature!

***** chkstow now honours the $STOW_DIR environment variable

      The stow script already honoured the $STOW_DIR environment
      variable.  Now chkstow does too, for consistency.

***** Stow now has a non-zero exit code if option parsing failed

      Thanks to Brice Waegeneire for reporting this.

*** License upgraded from GPL version 2 to version 3

    Copyright and license notices were also added to the headers of
    various files in accordance with GNU guidelines.

*** Documentation fixes and enhancements