Subject: | NOTICE: Critical change to File::HomeDir API |
You are receiving this bug report because you are a use of File::HomeDir.
Please note that in a few months, a significant change will be made to
File::HomeDir.
Currently, all methods in the newer API are documented as always
returning a directory.
Some downstream code may be relying on this.
Note that shortly, File::HomeDir will be changed so that for
environments in which there is NO logical home directory, File::HomeDir
will return C<undef> (even in list-context cases). This is intended to
create warnings or error, rather than potentially cause a silent change
in behaviour (if it returned '' or the null list).
However, note that any directory returned will still have been confirmed
to exist, and need to be checked further.
This bug has been filed pro-actively, you should resolve it once you
have confirmed that your module can handle false values being returned
for the home directory.