# HG changeset patch
# User Rik <rik@octave.org>
# Date 1582131433 28800
# Node ID 42892c93bd255b2f69343450126289afc41ed12c
# Parent  8e8a6e6ddf9c8b55f1dcab1cb1366a522c072e04
NEWS: Document change in error handling of command-form functions (bug #57830).

* NEWS: Document change in error handling of command-form functions.

diff -r 8e8a6e6ddf9c -r 42892c93bd25 NEWS
--- 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