Mercurial > octave
changeset 33642:a88bbdbfba49 bytecode-interpreter
maint: Merge default to bytecode-interpreter.
author | Nicholas R. Jankowski <jankowski.nicholas@gmail.com> |
---|---|
date | Tue, 04 Jun 2024 10:45:39 -0400 |
parents | 65b1cf6aa60a (current diff) 0f34488a2ccd (diff) |
children | 42355b7ec5d7 |
files | etc/NEWS.9.md |
diffstat | 2 files changed, 13 insertions(+), 9 deletions(-) [+] |
line wrap: on
line diff
--- a/etc/NEWS.9.md Mon Jun 03 14:38:47 2024 -0400 +++ b/etc/NEWS.9.md Tue Jun 04 10:45:39 2024 -0400 @@ -85,6 +85,7 @@ - Section "Running Octave": Tell new users how to start Octave on their computers. - `tsearch`: Add programming note about expected performance. +- `load`: Correct documentaion of -v7.3 and -hdf5 options (bug #43530). ### Deprecated functions, properties, and operators
--- a/libinterp/corefcn/load-save.cc Mon Jun 03 14:38:47 2024 -0400 +++ b/libinterp/corefcn/load-save.cc Tue Jun 04 10:45:39 2024 -0400 @@ -1644,11 +1644,13 @@ @item -hdf5 Force Octave to assume the file is in @sc{hdf5} format. (@sc{hdf5} is a free, portable binary format developed by the National Center for Supercomputing -Applications at the University of Illinois.) Note that Octave can only -read @sc{hdf5} files that were created by itself with @code{save} or with -@sc{matlab}'s @code{-v7.3} option (which saves in @sc{hdf5} format). This -format is only available if Octave was built with a link to the @sc{hdf5} -libraries. +Applications at the University of Illinois.) Note that @code{load} is only +designed to read @sc{hdf5} files that were created by itself with @code{save}, +and attempts to read other @sc{hdf5} files may fail or produce unpredictable +results. The @code{-hdf5} option also provides a limited ability to read +files created using @sc{matlab}'s @code{-v7.3} option (which saves in @sc{hdf5} +format) although many data types are not yet supported. This format is only +available if Octave was built with a link to the @sc{hdf5} libraries. @item -import This option is accepted for backward compatibility but is ignored. @@ -1661,10 +1663,11 @@ @item -v7.3 @itemx -V7.3 @itemx -7.3 -Force Octave to assume the file is in @sc{matlab}'s v7.3 binary data format. -As the v7.3 format is an HDF5 based format, those files often can also be -opened with the @qcode{"-hdf5"} option. Note that Octave @strong{can not} -currently save in this format. +Octave does @strong{not} yet implement @sc{matlab}'s v7.3 binary data format. +As the v7.3 format is an @sc{hdf5} based format, the @qcode{"-hdf5"} option +may be used to attempt to open a v7.3 format file, although most non-numeric +data types are not yet supported. Note that Octave @strong{can not} currently +save in this format. @item -v7 @itemx -V7