# HG changeset patch
# User José Luis García Pallero <jgpallero@gmail.com>
# Date 1627656862 -7200
# Node ID a3ac00db296b98e958fceee8e5bab1d00319bc25
# Parent  09b36aa7088a2f0adf87cb9389748d47c07212fe
doc: disable_diagonal_matrix, disable_diagonal_matrix, and disable_range (patch #10089).

* libinterp/octave-value/ov.cc (Fdisable_diagonal_matrix,
  Fdisable_diagonal_matrix, Fdisable_range): Clarify that the input and output
  arguments specify whether the corresponding special matrix types are disabled.

diff -r 09b36aa7088a -r a3ac00db296b libinterp/octave-value/ov.cc
--- a/libinterp/octave-value/ov.cc	Sun Jul 25 20:17:08 2021 +0200
+++ b/libinterp/octave-value/ov.cc	Fri Jul 30 16:54:22 2021 +0200
@@ -3309,15 +3309,15 @@
 @deftypefn  {} {@var{val} =} disable_permutation_matrix ()
 @deftypefnx {} {@var{old_val} =} disable_permutation_matrix (@var{new_val})
 @deftypefnx {} {} disable_permutation_matrix (@var{new_val}, "local")
-Query or set the internal variable that controls whether permutation
-matrices are stored in a special space-efficient format.
-
-The default value is true.  If this option is disabled Octave will store
+Query or set whether storing permutation matrices in a special space-efficient
+format is disabled.
+
+The default value is false.  If this option is set to true, Octave will store
 permutation matrices as full matrices.
 
-When called from inside a function with the @qcode{"local"} option, the
-variable is changed locally for the function and any subroutines it calls.
-The original variable value is restored when exiting the function.
+When called from inside a function with the @qcode{"local"} option, the setting
+is changed locally for the function and any subroutines it calls.  The original
+setting is restored when exiting the function.
 @seealso{disable_range, disable_diagonal_matrix}
 @end deftypefn */)
 {
@@ -3339,15 +3339,15 @@
 @deftypefn  {} {@var{val} =} disable_diagonal_matrix ()
 @deftypefnx {} {@var{old_val} =} disable_diagonal_matrix (@var{new_val})
 @deftypefnx {} {} disable_diagonal_matrix (@var{new_val}, "local")
-Query or set the internal variable that controls whether diagonal
-matrices are stored in a special space-efficient format.
-
-The default value is true.  If this option is disabled Octave will store
+Query or set whether storing diagonal matrices in a special space-efficient
+format is disabled.
+
+The default value is false.  If this option is set to true, Octave will store
 diagonal matrices as full matrices.
 
-When called from inside a function with the @qcode{"local"} option, the
-variable is changed locally for the function and any subroutines it calls.
-The original variable value is restored when exiting the function.
+When called from inside a function with the @qcode{"local"} option, the setting
+is changed locally for the function and any subroutines it calls. The original
+setting is restored when exiting the function.
 @seealso{disable_range, disable_permutation_matrix}
 @end deftypefn */)
 {
@@ -3383,15 +3383,15 @@
 @deftypefn  {} {@var{val} =} disable_range ()
 @deftypefnx {} {@var{old_val} =} disable_range (@var{new_val})
 @deftypefnx {} {} disable_range (@var{new_val}, "local")
-Query or set the internal variable that controls whether ranges are stored
-in a special space-efficient format.
-
-The default value is true.  If this option is disabled Octave will store
+Query or set whether storing ranges in a special space-efficient format is
+disabled.
+
+The default value is false.  If this option is set to true, Octave will store
 ranges as full matrices.
 
-When called from inside a function with the @qcode{"local"} option, the
-variable is changed locally for the function and any subroutines it calls.
-The original variable value is restored when exiting the function.
+When called from inside a function with the @qcode{"local"} option, the setting
+is changed locally for the function and any subroutines it calls.  The original
+setting is restored when exiting the function.
 @seealso{disable_diagonal_matrix, disable_permutation_matrix}
 @end deftypefn */)
 {