changeset 28114:42892c93bd25

NEWS: Document change in error handling of command-form functions (bug #57830). * NEWS: Document change in error handling of command-form functions.
author Rik <rik@octave.org>
date Wed, 19 Feb 2020 08:57:13 -0800
parents 8e8a6e6ddf9c
children 91f245908132
files NEWS
diffstat 1 files changed, 31 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/NEWS	Wed Feb 19 10:11:19 2020 -0500
+++ b/NEWS	Wed Feb 19 08:57:13 2020 -0800
@@ -3,6 +3,37 @@
 
 ### General improvements
 
+- Many functions in Octave can be called in a command form---no
+parentheses for invocation and no return argument assignment---or in a
+functional form---parentheses and '=' for assignment of return values.
+
+    Command Form Example
+
+    `mkdir new_directory`
+
+    Function Form Example
+
+    `status = mkdir ("new_directory")`
+
+    Octave now handles errors that occur in a consistent manner.  If
+    called in command form and there is a failure, an error is thrown
+    and a message printed.  If called in functional form, no error or
+    message is printed and the failure is communicated to the programmer
+    via the output status variable.
+
+    The following list of functions have been modified.
+
+    * `copyfile`
+    * `fcntl`
+    * `fileattrib`
+    * `kill`
+    * `link`
+    * `mkfifo`
+    * `movefile`
+    * `rename`
+    * `rmdir`
+    * `symlink`
+    * `unlink`
 
 ### Graphics backend