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