changeset 33559:62fca924fe85

doc: Update NEWS.10.md file. * NEWS.10.md: Indent NEWS.10.md for clarity. Add note about changes to colormap() functionality.
author Rik <rik@octave.org>
date Thu, 09 May 2024 18:23:33 -0700
parents 805844e7ff9f
children 3485012a415a
files etc/NEWS.10.md
diffstat 1 files changed, 49 insertions(+), 42 deletions(-) [+]
line wrap: on
line diff
--- a/etc/NEWS.10.md	Mon May 06 22:25:25 2024 -0700
+++ b/etc/NEWS.10.md	Thu May 09 18:23:33 2024 -0700
@@ -18,24 +18,27 @@
 - `nchoosek` algorithm is now ~2x faster and provides greater precision.
 
 - `nextpow2` algorithm is now more accurate for inputs very close to a power
-of 2.  The output class now matches the input class for Matlab compatibility.
-The function no longer accepts complex inputs and will emit an error for these
-inputs.
+  of 2.  The output class now matches the input class for Matlab compatibility.
+  The function no longer accepts complex inputs and will emit an error for
+  these inputs.
 
 - `jsonencode` now outputs integers and floating point integers without ".0"
-suffix.
+  suffix.
 
 - `hist` now accepts N-dimensional array inputs for input `Y` which is
-processed in columns as if the array was flattened to a 2-dimensional array.
+  processed in columns as if the array was flattened to a 2-dimensional array.
+
+- The third output for `unique` is now correct when `stable` sort option is
+  used.
 
 ### Graphical User Interface
 
 ### Graphics backend
 
-- `polar` plots now include the center tick mark value, typically 0, in
-the `'rtick'` parameter when the plot is created.  Subsequent modifications
-to `'rtick'` by the function `rticks` will only include the center tick mark
-value if it is specified.
+- `polar` plots now include the center tick mark value, typically 0, in the
+  `'rtick'` parameter when the plot is created.  Subsequent modifications to
+  `'rtick'` by the function `rticks` will only include the center tick mark
+  value if it is specified.
 
 - `view` correctly interprets cartesian viewpoints on main axes (bug #65641).
 
@@ -43,32 +46,35 @@
 
 - `height` and `width` are now aliases for the `rows` and `columns` functions.
 
-- All colormaps now default to a size of 256 colors. (The previous default
-size was 64.)
+- All colormaps now default to a size of 256 colors. (The previous default size
+  was 64.)
+
+- The first argument to `colormap` may now be a figure or axes object.  Calling
+  `colormap` on a figure object will clear any "colormap" properties set at the
+  axes level.
 
 - `griddata` output size more consistently matches the input interpolation
-points when they are input as vectors.  When they are same-orientation vectors,
-the outputs will be the same size as those vectors.  When either is a row
-vector and the other is a column vector, the interpolating points are processed
-through meshgrid and the output is a matrix the same size as the meshgrid.
-
-- Enable the third output for `unique` with the `stable` sort option.
+  points when they are input as vectors.  When they are same-orientation
+  vectors, the outputs will be the same size as those vectors.  When either is
+  a row vector and the other is a column vector, the interpolating points are
+  processed through meshgrid and the output is a matrix the same size as the
+  meshgrid.
 
 - `iqr` now provides compatible output for empty inputs.
 
-- `cross` now produces row vector outputs when the inputs are a mix of row
-and column vectors (bug #61295).
+- `cross` now produces row vector outputs when the inputs are a mix of row and
+  column vectors (bug #61295).
 
 - `rat` now accepts complex inputs.
 
 - The optional second input argument of `system`, denoting whether to return
-the output as a variable, is now required to be a boolean value if used.
+  the output as a variable, is now required to be a boolean value if used.
 
 - Octave functions whose Matlab equivalents give errors when passed non-integer
-values as sizes or dimensions now also give similar errors. For example,
-`cell (e, pi)` now gives an error in Octave about requiring integer sizes
-for the cell array, matching Matlab behavior.  Previously, Octave's conversion
-from non-integers to integers was more lenient.
+  values as sizes or dimensions now also give similar errors.  For example,
+  `cell (e, pi)` now gives an error in Octave about requiring integer sizes for
+  the cell array, matching Matlab behavior.  Previously, Octave's conversion
+  from non-integers to integers was more lenient.
 
 ### Alphabetical list of new functions added in Octave 10
 
@@ -98,14 +104,15 @@
         interpreter::verbose                  | interpreter::init_trace
         cmdline_options::verbose              | cmdline_options::init_trace
 
-  - A new method `rwdata ()` provides direct read/write access (a pointer) to the
-data in a liboctave `Array` object (or its derived classes such as `Matrix`).
-Historically, the method `fortran_vec ()` provided this access, but the name
-is unclear, and it is recommended to use `rwdata ()` in any new code.  There
-are no plans to deprecate `fortran_vec`.
+  - A new method `rwdata ()` provides direct read/write access (a pointer) to
+    the data in a liboctave `Array` object (or its derived classes such as
+    `Matrix`).  Historically, the method `fortran_vec ()` provided this access,
+    but the name is unclear, and it is recommended to use `rwdata ()` in any
+    new code.  There are no plans to deprecate `fortran_vec`.
 
   - The `--verbose`,`-V` command-line option has been deprecated.  Use
-`--init-trace` to print the configuration files executed during initialization.
+    `--init-trace` to print the configuration files executed during
+    initialization.
 
 The following features were deprecated in Octave 8 and have been removed
 from Octave 10.
@@ -117,22 +124,22 @@
         shift                  | circshift
         sparse_auto_mutate     | none (see below)
 
-- `fminsearch` parameter passing:  A legacy, undocumented, and only partially
-supported syntax for passing parameters to the minimized function `fcn` called
-by `fminsearch` by appending them to the input argument list was partly
-implemented since Octave 4.4.0.  Due to conflicts with other input methods,
-the documentation of this syntax was removed in Octave 5.1.0.  The remaining
-functionality has been completely removed in Octave 10.  Attempts to call
-`fminsearch` with that syntax will result in an error.  The preferred method of
-passing parameters to any of the minimization functions (including
-`fminsearch`, `fminbnd`, and `fminunc`) is through the use of anonymous
-functions.  Specific examples of this can be found in the "Minimizers" section
-of the Octave manual.
+- `fminsearch` parameter passing: A legacy, undocumented, and only partially
+  supported syntax for passing parameters to the minimized function `fcn`
+  called by `fminsearch` by appending them to the input argument list was
+  partly implemented since Octave 4.4.0.  Due to conflicts with other input
+  methods, the documentation of this syntax was removed in Octave 5.1.0.  The
+  remaining functionality has been completely removed in Octave 10.  Attempts
+  to call `fminsearch` with that syntax will result in an error.  The preferred
+  method of passing parameters to any of the minimization functions (including
+  `fminsearch`, `fminbnd`, and `fminunc`) is through the use of anonymous
+  functions.  Specific examples of this can be found in the "Minimizers"
+  section of the Octave manual.
 
 ### Build system
 
 - Octave now requires a C++ compiler that is compliant with C++17 (preferably
-with GNU extensions).
+  with GNU extensions).
 
 
 Summary of bugs fixed for version 10.1.0 (yyyy-mm-dd):