Mercurial > octave
changeset 31476:77072a5e99a5 stable
doc: Update Markdown syntax in NEWS.[567].md.
* NEWS.5.md, NEWS.6.md, NEWS.7.md:
Update Markdown syntax to get tables to render properly.
Add code marks `...` around filenames and code words.
| author | Rik <rik@octave.org> |
|---|---|
| date | Fri, 18 Nov 2022 14:48:22 -0800 |
| parents | 681201d7ce29 |
| children | 63f808063238 ef9c804676b9 |
| files | etc/NEWS.5.md etc/NEWS.6.md etc/NEWS.7.md |
| diffstat | 3 files changed, 200 insertions(+), 200 deletions(-) [+] |
line wrap: on
line diff
--- a/etc/NEWS.5.md Fri Nov 18 16:58:47 2022 +0100 +++ b/etc/NEWS.5.md Fri Nov 18 14:48:22 2022 -0800 @@ -10,47 +10,47 @@ - Lock amd and symbfact to avoid segmentation fault with SuiteSparse (bug #57435) - Fix segfault when calculating patch vertex normals (bug #57353) - Fix segfault in constructing patch normals for lighting (bug #57353) -- mat2str.m: Fix for logical matrix (add `transpose`). +- `mat2str.m`: Fix for logical matrix (add `transpose`). - improve file equality check for MS Windows (bug #55161) -- ismember.m: Fix second return argument when values are complex (bug #52437) -- findobj.m: Fix typo and correctly handle numeric properties (bug #57030) +- `ismember.m`: Fix second return argument when values are complex (bug #52437) +- `findobj.m`: Fix typo and correctly handle numeric properties (bug #57030) - Correctly display integer types with format hex (bug #56966) - Cast `winqueryreg` `REG_DWORD` types to `DWORD` (bug #56703) - Fix numerous errors in `audiowrite` / `audioread` (bug #56889) -- print.m: Pass quoted path to `octave-svgconvert` (bug #56768) -- dir.m: Fix occasionally returning incorrect folder field (bug #55448) +- `print.m`: Pass quoted path to `octave-svgconvert` (bug #56768) +- `dir.m`: Fix occasionally returning incorrect folder field (bug #55448) - Stop segfault when calling 3-input form of `diag` with cell arrays (bug #56711) - improve message for setting breakpoint in nonexistent function (bug #56157) - Use framebuffer object for printing invisible Qt figures on mac (bug #55268) -- Escape backslash characters in `EPS` output (bug #56448) +- Escape backslash characters in EPS output (bug #56448) - Use replacement characters to display non UTF-8 strings in figures (bug #55974) -- inputrc: Add warning about modification (bug #56079) -- documentation.cc (global_search): just return if query string is empty (bug #56388) +- `inputrc`: Add warning about modification (bug #56079) +- `documentation.cc` (global_search): just return if query string is empty (bug #56388) - Default (c)transpose for old style class arrays (bug #56323) - Always reserve at least 1 element of storage for sparse matrices (bug #56232) - Don't segfault at exit after reading malformed HDF5 file (bug #56149) -- Fix pause() with no arguments called on Windows (bug #55943) +- Fix `pause()` with no arguments called on Windows (bug #55943) - refactor minimum eigenvalue index search in `qp` (bug #56037) - qp: fix obscure corner case when calculating `qp` caused by a typo (bug #56037) - use `std::streampos` instead of `std::ios::streampos` (patch #9782). - fix `pause` and `kbhit` with glibc 2.28 end-of-file state behavior (bug #55029) - Fix return of left-handed vectors when inputs are complex (bug #56026) -- waitbar.m: Fix hang when using `createcancelbtn` property (bug #55963) -- shading.m: Fix unexpected error when multiple `hggroups` present (bug #55993) -- dec2base.m: Correctly handle zero matrix input (bug #56005) +- `waitbar.m`: Fix hang when using `createcancelbtn` property (bug #55963) +- `shading.m`: Fix unexpected error when multiple `hggroups` present (bug #55993) +- `dec2base.m`: Correctly handle zero matrix input (bug #56005) - eliminate duplicate graphics callback object stack (bug #55908) - Improve performance when closing figures (bug #55908) - Reduce time to process `pkg -forge list` by 30X (bug #39479) - Feed `fig2dev` with PDF files converted from svg (bug #55906) - Improve error checking for `iconv_open`. -- poly.m: fix the fix for input of complex conjugate pairs (bug #53897) -- mkoctfile: use the `TMPDIR` environment variable if set (bug #55814) -- line.m: Fix creation of unwanted axes (bug #55840) -- Accept 4-input form for quiver3 (bug #55570) -- pkg.m: restore installing packages from zip archives (bug #55788) -- axis.m: Fix issues with `equal` argument (bug #55619, bug #55614, bug #55574, +- `poly.m`: fix the fix for input of complex conjugate pairs (bug #53897) +- `mkoctfile`: use the `TMPDIR` environment variable if set (bug #55814) +- `line.m`: Fix creation of unwanted axes (bug #55840) +- Accept 4-input form for `quiver3` (bug #55570) +- `pkg.m`: restore installing packages from zip archives (bug #55788) +- `axis.m`: Fix issues with `equal` argument (bug #55619, bug #55614, bug #55574, bug #55514, bug #54848, bug #53724, bug #53504, bug #53336, bug #51938, bug #50356). -- ordeig.m: Do not fail on 1x1 matrices (bug #55779) +- `ordeig.m`: Do not fail on 1x1 matrices (bug #55779) ### GUI @@ -67,9 +67,9 @@ - configure: prevent overlinking when SUNDIALS is disabled (bug #55956) - use QtCore and Qt5Gui modules instead of Qt5OpenGL (bug #55735) - make building with Qt4 QGLWidget work again (bug #55735) -- build: adapt mk-qthelp.pl to changes in Texinfo 6.7. +- build: adapt `mk-qthelp.pl` to changes in Texinfo 6.7. - BIST should not rely on the current directory to be writable. -- bp-table.cc: Fix test. +- `bp-table.cc`: Fix test. - maint: Make old style class tests Matlab compatible. - Add BIST tests for `unlink` (bug #56097) @@ -77,17 +77,17 @@ - fix many spelling errors (bug #57613) - help: improve documentation for the `startup.m` user script. -- avoid conflict with @seealso macro in Texinfo 6.6 (bug #55952) -- mk-doc-cache.pk: Also translate `@seealso` here. (bug #55952) -- __makeinfo__.m: Also translate `@seealso` here (bug #55952) -- polar.m: Document that input is expected to be in radians (bug #57052) -- gallery.m: Fix typo in docstring for poisson (bug #56267) +- avoid conflict with `@seealso` macro in Texinfo 6.6 (bug #55952) +- `mk-doc-cache.pk`: Also translate `@seealso` here. (bug #55952) +- `__makeinfo__.m`: Also translate `@seealso` here (bug #55952) +- `polar.m`: Document that input is expected to be in radians (bug #57052) +- `gallery.m`: Fix typo in docstring for `poisson` (bug #56267) - Add 1024x1024 Octave logo icon (bug #55836) - add `.editorconfig` for default file encoding and indentation. -- octave.doap: Copy localized (short) description over from appdata (bug #55279) -- org.octave.Octave.appdata.xml: Add German and French description (bug #55279) -- languages/*.ts: updated language files (bug #55772) -- quiver3.m: Fix texinfo typo in docstring from cset f7b10bd40045. +- `octave.doap`: Copy localized (short) description over from appdata (bug #55279) +- `org.octave.Octave.appdata.xml`: Add German and French description (bug #55279) +- `languages/*.ts`: updated language files (bug #55772) +- `quiver3.m`: Fix texinfo typo in docstring from cset f7b10bd40045. - doc: fix `.` Operator Index entry to build with Texinfo 6.7. - doc: improve example of using global variables from oct-files. - doc: Create en-dashes and em-dashes correctly in documentation. @@ -152,7 +152,7 @@ different results in existing code. If it is necessary to reproduce the exact random integer sequence as in previous versions use - `ri = imin + floor ((imax - imin + 1) * rand ());` + ri = imin + floor ((imax - imin + 1) * rand ()); - The function `isdefinite` now returns `true` or `false` rather than `-1`, `0`, or `1`. To test for a positive semi-definite matrix (old @@ -166,7 +166,7 @@ required. For example defining the variable `x = int8 (3)` in the workspace, calls like - `range = [ intmin(class(x)), intmax(class(x)) ]` + range = [ intmin(class(x)), intmax(class(x)) ] can in Octave 5 be simplified to `range = [ intmin(x), intmax(x) ]`. @@ -177,10 +177,10 @@ - A new printing device is available, `"-ddumb"`, which produces ASCII art for plots. This device is only available with the gnuplot toolkit. -- The `msgbox` function has changed in two respects: the default WindowStyle +- The `msgbox` function has changed in two respects: the default `WindowStyle` is now `"non-modal"`, and the default interpreter for the message is now - `"tex"`. Both WindowStyle and Interpreter can be controlled by passing an - option struct argument. + `"tex"`. Both `WindowStyle` and `Interpreter` can be controlled by passing + an option struct argument. ### Dependencies @@ -240,36 +240,36 @@ - `fsolve` - Option | New Default | Old Default - ---------------|------------------|------------- - `FinDiffType` | `"forward"` | `"central"` - `MaxFunEvals` | `100*length(x0)` | `Inf` - `TolFun` | `1e-6` | `1e-7` - `TolX` | `1e-6` | `1e-7` - `Updating` | `"off"` | `"on"` + Option | New Default | Old Default + ---------------|------------------|------------- + FinDiffType | "forward" | "central" + MaxFunEvals | 100*length(x0) | Inf + TolFun | 1e-6 | 1e-7 + TolX | 1e-6 | 1e-7 + Updating | "off" | "on" - `fminsearch` - Option | New Default | Old Default - ---------|-------------|------------ - `TolFun` | `1e-7` | `1e-4` + Option | New Default | Old Default + ---------|-------------|------------ + TolFun | 1e-7 | 1e-4 - `fminbnd` - Option | New Default | Old Default - ---------------|-------------|------------ - `MaxFunEvals` | `500` | `Inf` - `MaxIter` | `500` | `Inf` - `TolX` | `1e-4` | `1e-8` + Option | New Default | Old Default + ---------------|-------------|------------ + MaxFunEvals | 500 | Inf + MaxIter | 500 | Inf + TolX | 1e-4 | 1e-8 - `fminunc` - Option | New Default | Old Default - ---------------|------------------|------------ - `FinDiffType` | `"forward"` | `"central"` - `MaxFunEvals` | `100*length(x0)` | `Inf` - `TolX` | `1e-6` | `1e-7` - `TolFun` | `1e-6` | `1e-7` + Option | New Default | Old Default + ---------------|------------------|------------ + FinDiffType | "forward" | "central" + MaxFunEvals | 100*length(x0) | Inf + TolX | 1e-6 | 1e-7 + TolFun | 1e-6 | 1e-7 #### Graphic objects @@ -324,17 +324,17 @@ Unlike deprecated functions, however, their removal from Octave has not yet been scheduled. - Function | Replacement - -----------------------|------------------ - `findstr` | `strfind` - `flipdim` | `flip` - `isdir` | `isfolder` or `dir_in_loadpath` - `isequalwithequalnans` | `isequaln` - `isstr` | `ischar` - `setstr` | `char` - `strmatch` | `strncmp` or `strcmp` - `strread` | `textscan` - `textread` | `textscan` + Function | Replacement + ----------------------|------------------ + findstr | strfind + flipdim | flip + isdir | isfolder or dir_in_loadpath + isequalwithequalnans | isequaln + isstr | ischar + setstr | char + strmatch | strncmp or strcmp + strread | textscan + textread | textscan ### Deprecated functions and properties @@ -345,20 +345,20 @@ - Functions - Function | Replacement - -------------------------|------------------- - `output_max_field_width` | `output_precision` - `is_keyword` | `iskeyword` + Function | Replacement + -------------------------|------------------- + output_max_field_width | output_precision + is_keyword | iskeyword - Graphics properties - Object | Property | Value - -----------------|---------------|------------ - `text` | `fontangle` | `"oblique"` - `uibuttongroup` | `fontangle` | `"oblique"` - `uicontrol` | `fontangle` | `"oblique"` - `uipanel` | `fontangle` | `"oblique"` - `uitable` | `fontangle` | `"oblique"` + Object | Property | Value + -----------------|---------------|------------ + text | fontangle | "oblique" + uibuttongroup | fontangle | "oblique" + uicontrol | fontangle | "oblique" + uipanel | fontangle | "oblique" + uitable | fontangle | "oblique" - Specifying `legend` position with a numeric argument is deprecated. Use a string argument instead. @@ -375,33 +375,32 @@ - Functions - Function | Replacement - -----------------------|------------------ - `bitmax` | `flintmax` - `mahalanobis` | `mahal` in Octave Forge statistics pkg - `md5sum` | `hash` - `octave_config_info` | `__octave_config_info__` - `onenormest` | `normest1` - `sleep` | `pause` - `usleep` | `pause` - `wavread` | `audioread` - `wavwrite` | `audiowrite` + Function | Replacement + ---------------------|------------------ + bitmax | flintmax + mahalanobis | mahal in Octave Forge statistics pkg + md5sum | hash + octave_config_info | __octave_config_info__ + onenormest | normest1 + sleep | pause + usleep | pause + wavread | audioread + wavwrite | audiowrite - Properties - Object | Property | Value - ------------|-------------------|--------- - `axes` | `xaxislocation` | `"zero"` - | `yaxislocation` | `"zero"` - `hggroup` | `erasemode` | - `image` | `erasemode` | - `line` | `erasemode` | - `patch` | `erasemode` | - `patch` | `normalmode` | - `surface` | `erasemode` | - `surface` | `normalmode` | - `text` | `erasemode` | - + Object | Property | Value + ------------|-------------------|--------- + axes | xaxislocation | "zero" + | yaxislocation | "zero" + hggroup | erasemode | + image | erasemode | + line | erasemode | + patch | erasemode | + patch | normalmode | + surface | erasemode | + surface | normalmode | + text | erasemode | ### Alphabetical list of new functions added in 5
--- a/etc/NEWS.6.md Fri Nov 18 16:58:47 2022 +0100 +++ b/etc/NEWS.6.md Fri Nov 18 14:48:22 2022 -0800 @@ -28,7 +28,7 @@ - `cbrt`: Clarify that function errors for non-real input. - `dsearchn.m`: Added optional distance output description (bug #61156). - Add Hungarian translation for project description files. -- Document fsolve output "info" -2 (bug #61310). +- Document `fsolve` output `"info"` -2 (bug #61310). ### Build system @@ -61,7 +61,7 @@ - Hold references to closure frames in anon functions if needed (bug #60237). - `eigs`: Prevent possible segmentation fault at exit (bug #60311). - Issue warning when gnuplot graphics toolkit is initialized. -- mpoles.m: Fix detection of pole multiplicity (bug #60384). +- `mpoles.m`: Fix detection of pole multiplicity (bug #60384). - Perform shutdown actions in interpreter destructor (bug #60334). - build: Make relocation of dependencies with Octave optional (bug #60413). - `qz.cc`: Return correct number of eigenvalues (bug #60357). @@ -83,7 +83,7 @@ - `logm.m`: Fix check for real negative values in complex vector (bug #60738). - build: Set necessary flags to allow execution on Windows Vista (bug #60746). - Declare base_parser destructor virtual. -- `hist.m`: Improve handling and docstring for third parameter "norm" (bug #60783). +- `hist.m`: Improve handling and docstring for third parameter `"norm"` (bug #60783). - `logm.m`: Allow tolerance in check for real negative values in complex vector (bug #60738). - `expm.m`, `logm.m`: Use function `isdiag` to detect if input is a diagonal matrix (bug #60738). - tests: Relax tolerance for some tests on macOS. @@ -93,7 +93,7 @@ - `logm.m`: Allow larger tolerance for test on macOS. - build: Use correct path to `octave` binary in build tree on macOS. - build: Fix typo in folder to libraries when building `.oct` or `.mex` files. -- build: Set DL_LDFLAGS in the build rules for .oct or .mex files. +- build: Set `DL_LDFLAGS` in the build rules for `.oct` or `.mex` files. - `rgb2ind.m`: Suppress output in test. - Improve documentation for `log2` function (bug #60817). - `ind2sub`: Fix typo in "see also" section of docstring (bug #60842). @@ -120,8 +120,8 @@ ### Documentation -- Improve Differential Equations chapter and example for lsode (bug #57508). -- Clarify usage of "Depends" keyword in package `DESCRIPTION` file (bug #60053). +- Improve Differential Equations chapter and example for `lsode` (bug #57508). +- Clarify usage of `"Depends"` keyword in package `DESCRIPTION` file (bug #60053). - Add note that wildcard patterns for `save` are glob patterns (bug #60157). - Change example for Delaunay triangulation to match the generating code (bug #60216). - Document single precision issues with OpenGL graphics toolkits (bug #59418). @@ -204,9 +204,9 @@ - Add default value to `OCTAVE_MIPS_NAN` configure macro for cross-compiling (bug #59830). - tests: Function name should match file name (bug #59704). - Avoid build errors with Qt4 (bug #59813). -- eigs.m: Make tests that depend on CHOLMOD conditional. +- `eigs.m`: Make tests that depend on CHOLMOD conditional. - tests: Make tests that depend on CXSparse conditional. -- build: Use `SPARSE_XCPPFLAGS` in `CPP_FLAGS` for libcorefcn (bug #59806). +- build: Use `SPARSE_XCPPFLAGS` in `CPP_FLAGS` for `libcorefcn` (bug #59806). - Add test case for bug #59661. - `hgsave.m`: Allow test to run with qt or gnuplot graphics toolkits (bug #57241). @@ -214,7 +214,7 @@ - `embedded.cc`: Fix syntax error interpreter shutdown. - Update Octave Project Developers copyright for the new year. -- Use the same comment style for copyright headers in .m files and shell scripts. +- Use the same comment style for copyright headers in `.m` files and shell scripts. Summary of important user-visible changes for version 6.1.0 (2020-11-26): @@ -256,15 +256,15 @@ - The `edit` function option `"editinplace"` now defaults to `true` and the option `"home"` now defaults to the empty matrix `[]`. Files will - no longer be copied to the user's HOME directory for editing. The old + no longer be copied to the user's `HOME` directory for editing. The old behavior can be restored by setting `"editinplace"` to `false` and `"home"` to `"~/octave"`. - The `format` command supports two new options: `uppercase` and - `lowercase` (default). With the default, print a lowercase 'e' for - the exponent character in scientific notation and lowercase 'a-f' for - the hex digits representing 10-15. With `uppercase`, print 'E' and - 'A-F' instead. The previous uppercase formats, `E` and `G`, no longer + `lowercase` (default). With the default, print a lowercase `'e'` for + the exponent character in scientific notation and lowercase `'a-f'` for + the hex digits representing 10-15. With `uppercase`, print `'E'` and + `'A-F'` instead. The previous uppercase formats, `E` and `G`, no longer control the case of the output. Additionally, the `format` command can be called with multiple options @@ -277,15 +277,15 @@ one is used, and, in case of an error, the previous format remains unchanged. -- L-value references (e.g., increment (++), decrement (--), and all - in-place assignment operators (+=, -=, *=, /=, etc.)) are no longer +- L-value references (e.g., increment (`++`), decrement (`--`), and all + in-place assignment operators (`+=`, `-=`, `*=`, `/=`, etc.)) are no longer allowed in anonymous functions. -- New warnings have been added about questionable uses of the colon ':' +- New warnings have been added about questionable uses of the colon `':'` range operator. Each has a new warning ID so that it can be disabled if desired. - > `Octave:colon-complex-argument` : when any arg is complex + > `Octave:colon-complex-argument` : when any arg is complex > `Octave:colon-nonscalar-argument` : when any arg is non-scalar - The `regexp` and related functions now correctly handle and *require* @@ -296,8 +296,8 @@ - The startup file `octaverc` can now be located in the platform dependent location for user local configuration files (e.g., - ${XDG_CONFIG_HOME}/octave/octaverc on Unix-like operating systems or - %APPDATA%\octave\octaverc on Windows). + `${XDG_CONFIG_HOME}/octave/octaverc` on Unix-like operating systems or + `%APPDATA%\octave\octaverc` on Windows). - `pkg describe` now lists dependencies and inverse dependencies (i.e., other installed packages that depend on the package in @@ -312,7 +312,7 @@ - The command - dbstop in CLASS at METHOD + dbstop in CLASS at METHOD now works to set breakpoints in classdef constructors and methods. @@ -407,8 +407,8 @@ exist as an alias until Octave version 8.1. - Inline functions created by the function `inline` are now of type - "inline" when interrogated with the `class` function. In previous - versions of Octave, the class returned was "function_handle". This + `"inline"` when interrogated with the `class` function. In previous + versions of Octave, the class returned was `"function_handle"`. This change is Matlab compatible. Inline functions are deprecated in both Matlab and Octave and support may eventually be removed. Anonymous functions can be used to replace all instances of inline @@ -480,15 +480,15 @@ - Functions - Function | Replacement - -----------------------|------------------ - `runtests` | `oruntests` + Function | Replacement + -----------------|------------------ + runtests | oruntests - Properties - Object | Property | Value - -----------------|---------------|------------ - | | + Object | Property | Value + -----------------|---------------|------------ + | | - The environment variable used by `mkoctfile` for linker flags is now `LDFLAGS` rather than `LFLAGS`. `LFLAGS` is deprecated, and a warning @@ -502,35 +502,35 @@ - Functions - Function | Replacement - ---------------------|------------------ - `chop` | `sprintf` for visual results - `desktop` | `isguirunning` - `tmpnam` | `tempname` - `toascii` | `double` - `java2mat` | `__java2mat__` + Function | Replacement + -----------------|------------------ + chop | sprintf for visual results + desktop | isguirunning + tmpnam | tempname + toascii | double + java2mat | __java2mat__ - Properties - Object | Property | Value - ---------------------|---------------------------|----------------------- - `annotation` | `edgecolor ("rectangle")` | - `axes` | `drawmode` | - `figure` | `doublebuffer` | - | `mincolormap` | - | `wvisual` | - | `wvisualmode` | - | `xdisplay` | - | `xvisual` | - | `xvisualmode` | - `line` | `interpreter` | - `patch` | `interpreter` | - `surface` | `interpreter` | - `text` | `fontweight` | `"demi"` and `"light"` - `uibuttongroup` | `fontweight` | `"demi"` and `"light"` - `uicontrol` | `fontweight` | `"demi"` and `"light"` - `uipanel` | `fontweight` | `"demi"` and `"light"` - `uitable` | `fontweight` | `"demi"` and `"light"` + Object | Property | Value + -----------------|---------------------------|----------------------- + annotation | edgecolor ("rectangle") | + axes | drawmode | + figure | doublebuffer | + | mincolormap | + | wvisual | + | wvisualmode | + | xdisplay | + | xvisual | + | xvisualmode | + line | interpreter | + patch | interpreter | + surface | interpreter | + text | fontweight | "demi" and "light" + uibuttongroup | fontweight | "demi" and "light" + uicontrol | fontweight | "demi" and "light" + uipanel | fontweight | "demi" and "light" + uitable | fontweight | "demi" and "light" ### Old release news
--- a/etc/NEWS.7.md Fri Nov 18 16:58:47 2022 +0100 +++ b/etc/NEWS.7.md Fri Nov 18 14:48:22 2022 -0800 @@ -30,10 +30,10 @@ - `canonicalize_file_name`: Trim trailing file separators from root of mapped network drive (bug #62847). - `imformats.m`: Fix `isa` function in return value (bug #62974). - `pie3`: Fix "Too many input" args error. -- Accept negative inputs to -2^63 for `dec2bin` and `dec2hex` (bug #63089). +- Accept negative inputs to `-2^63` for `dec2bin` and `dec2hex` (bug #63089). - Fix incorrect `lambda` outputs for `lsqnonneg` and `pqpnonneg` (bug #63178). - `addtodate.m`: Fix wrong month returned when subtracting a month from some end-of-month dates (bug #60671). -- `var.m`: Fix some Inf and NaN inputs returning 0 instead of NaN (bug #63203) +- `var.m`: Fix some `Inf` and `NaN` inputs returning `0` instead of `NaN` (bug #63203) - `var.m`: Fix automatic broadcasting error for sparse and diagonal matrix inputs with vector weighting (bug #63291). - `legend.m`: Fix error with `contour` plot containing `clabel`s (bug #63262). - `dec2bin.m`: Fix input validation (bug #63089). @@ -49,7 +49,7 @@ - `io.tst`: Add test case for `scanf` (bug #62723). - `nextpow2.m`: Add bug number tag to regression tests (bug #62947). - `quad2d.m`: Add BIST to cset b0e90ca8e679 (bug #62972). -- Add test for number of methods with `classdef` in @folder (bug #62802). +- Add test for number of methods with `classdef` in `@folder` (bug #62802). - Use Autoconf macro to find `egrep` executable. ### Documentation @@ -182,8 +182,8 @@ - Calling a user-defined function with too many inputs or outputs is now an error. The interpreter makes this check automatically. If a -function uses varargin then the check is skipped for function inputs, -and if a function uses varargout then the check is skipped for function +function uses `varargin` then the check is skipped for function inputs, +and if a function uses `varargout` then the check is skipped for function outputs. Input validation for functions typically begins with checking that the number of inputs and outputs match expectations. Existing code can be simplified by removing these checks which are now done by the @@ -212,7 +212,7 @@ constants are limited to 16 hexadecimal digits with no automatic rounding or conversion to floating point values. Note that this may cause problems in existing code. For example, an expression like -`[0x1; 0x100; 0x10000]` will be uint8 (because of the rules of +`[0x1; 0x100; 0x10000]` will be `uint8` (because of the rules of concatenating integers of different sizes) with the larger values truncated (because of the saturation semantics of integer values). To avoid these kinds of problems either: 1) declare the first integer to be @@ -221,8 +221,8 @@ same number of digits for each value such as `[0x00_00_01; 0x00_01_00; 0x01_00_00]`. -- The colon operator now works for integer (int8, int16, ..., uint64) -and single data types. However, only double ranges use a +- The colon operator now works for integer (`int8`, `int16`, ..., `uint64`) +and single data types. However, only `double` ranges use a memory-efficient storage scheme internally. Other data types are stored as ordinary arrays. @@ -280,9 +280,9 @@ that is up to 50,000 times faster for inputs > 1e14. - The `betainc` function now calculates an exact output for the -important special cases where a or b are 1. +important special cases where `a` or `b` are `1`. -- The `whos` function now displays an additional attribute 's' when +- The `whos` function now displays an additional attribute `'s'` when the variable is a sparse type. - As part of GSoC 2020, Abdallah K. Elshamy implemented the @@ -294,10 +294,10 @@ itself. Making the evaluation of long-running Jupyter Notebooks on a computing server without permanent browser connection possible. -- By default, the history file is now located at $DATA/octave/history, -where $DATA is a platform dependent location for (roaming) user data -files (e.g., ${XDG_DATA_HOME} or, if that is not set, ~/.local/share on -Unix-like operating systems or %APPDATA% on Windows). +- By default, the history file is now located at `$DATA/octave/history`, +where `$DATA` is a platform dependent location for (roaming) user data +files (e.g., `${XDG_DATA_HOME}` or, if that is not set, `~/.local/share` on +Unix-like operating systems or `%APPDATA%` on Windows). - For Octave on Windows OS, the minimum required version of the Windows API is now 6.1 (Windows 7 or newer). @@ -312,8 +312,8 @@ trailing "++") needs to be set in that option now. - The `pkg update` command now accepts options that are passed to `pkg -install` for each updated package. Specifying @option{-local} or -@option{-global} will restrict update checks to local or global +install` for each updated package. Specifying `-local` or +`-global` will restrict update checks to local or global installed packages, respectively. ### Graphical User Interface @@ -330,7 +330,7 @@ key strokes in the Command Window. Unlike versions prior to Octave 7, this preference now also affects the Ctrl-C/V shortcuts for copy/paste. -- In command line mode, i.e. when Octave is started without the --gui option, +- In command line mode, i.e. when Octave is started without the `--gui` option, the doc command now opens the GUI documentation browser as a standalone widget, provided that Octave was compiled with GUI support. @@ -377,6 +377,7 @@ to the title displayed on the figure window which contains the plot. - Additional properties have been added to the `axes` graphics object: + * `"alphamap"` (not yet implemented) * `"alphascale"` (not yet implemented) * `"colorscale"` (not yet implemented) @@ -411,7 +412,7 @@ - The function `dec2bin` and `dec2hex` now support negative numbers. -- The function `factor` now supports uint64 inputs larger than +- The function `factor` now supports `uint64` inputs larger than `flintmax`. - The function `primes` now supports char inputs. @@ -501,11 +502,11 @@ - Functions - Function | Replacement - ---------------------------- |---------------------------- - `disable_diagonal_matrix` | `optimize_diagonal_matrix` - `disable_permutation_matrix` | `optimize_permutation_matrix` - `disable_range` | `optimize_range` + Function | Replacement + ---------------------------- |---------------------------- + disable_diagonal_matrix | optimize_diagonal_matrix + disable_permutation_matrix | optimize_permutation_matrix + disable_range | optimize_range For plot functions, the use of numbers to select line colors in shorthand formats was an undocumented feature that is deprecated in @@ -513,12 +514,12 @@ - Operators - Operator | Replacement | Description - ---------|-------------|------------ - `**` | `^` | Matrix exponent - `.**` | `.^` | Element-by-element exponent - `.+` | `+` | Element-by-element addition - `.-` | `-` | Element-by-element subtraction + Operator | Replacement | Description + ---------|-------------|------------ + ** | ^ | Matrix exponent + .** | .^ | Element-by-element exponent + .+ | + | Element-by-element addition + .- | - | Element-by-element subtraction - Interpreter @@ -539,9 +540,9 @@ - Functions - Function | Replacement - -----------------------|------------------ - `runtests` | `oruntests` + Function | Replacement + -----------------------|------------------ + runtests | oruntests - The environment variable used by `mkoctfile` for linker flags is now `LDFLAGS` rather than `LFLAGS`. `LFLAGS` was deprecated in Octave 6, @@ -555,20 +556,20 @@ - Functions - Function | Replacement - -------------------------|------------------ - `output_max_field_width` | `output_precision` - `is_keyword` | `iskeyword` + Function | Replacement + -------------------------|------------------ + output_max_field_width | output_precision + is_keyword | iskeyword - Properties - Object | Property | Value - -----------------|---------------|------------ - `text` | `fontangle` | `"oblique"` - `uibuttongroup` | `fontangle` | `"oblique"` - `uicontrol` | `fontangle` | `"oblique"` - `uipanel` | `fontangle` | `"oblique"` - `uitable` | `fontangle` | `"oblique"` + Object | Property | Value + -----------------|---------------|------------ + text | fontangle | "oblique" + uibuttongroup | fontangle | "oblique" + uicontrol | fontangle | "oblique" + uipanel | fontangle | "oblique" + uitable | fontangle | "oblique" - The prototype JIT compiler has been removed from Octave. Since it was first added as part of a Google Summer of Code project in 2012, no one