v9999.24

• Document the clear downfalls of using file handles of any kind rather than just the file's path string.

WARNING - PENDING DOOM

Although you technically can, do NOT use this module to work on file handles,
pipes, sockets, standard IO, pseudo-files, or the DATA handle. These are
features implemented long ago that just really shouldn't be abused here.

Be warned: this activity will lead to inaccurate encoding/decoding of data.

All further mentions of actions on the above have been removed from this
documentation and that feature set will likely be deprecated in the future.

In other words, if you don't have a filename to pass, consider using the
standard do { local $/; <$fh> }, or
Data::Section/Data::Section::Simple for working with __DATA__.