# HG changeset patch
# User Rik <rik@octave.org>
# Date 1587759369 25200
# Node ID 2fb684dc2ec2f1ec171741f2ea454db262b0c887
# Parent  d37b1dd3acc8c542ebbccca7a4128c0d247f0701
axis.m: Implement "fill" option for Matlab compatibility.

* axis.m: Document that "fill" is a synonym for "normal".  Place "vis3d" option
in documentation table for modes which affect aspect ratio.  Add
strcmpi (opt, "fill") to decode opt and executed the same behavior as "normal".

diff -r d37b1dd3acc8 -r 2fb684dc2ec2 scripts/plot/appearance/axis.m
--- a/scripts/plot/appearance/axis.m	Fri Apr 24 13:05:06 2020 -0700
+++ b/scripts/plot/appearance/axis.m	Fri Apr 24 13:16:09 2020 -0700
@@ -54,14 +54,20 @@
 ## The following options control the aspect ratio of the axes.
 ##
 ## @table @asis
+## @item @qcode{"equal"}
+## Force x-axis unit distance to equal y-axis (and z-axis) unit distance.
+##
 ## @item @qcode{"square"}
 ## Force a square axis aspect ratio.
 ##
-## @item @qcode{"equal"}
-## Force x-axis unit distance to equal y-axis (and z-axis) unit distance.
+## @item @nospell{@qcode{"vis3d"}}
+## Set aspect ratio modes (@qcode{"DataAspectRatio"},
+## @qcode{"PlotBoxAspectRatio"}) to @qcode{"manual"} for rotation without
+## stretching.
 ##
-## @item @qcode{"normal"}
-## Restore default aspect ratio.
+## @item  @qcode{"normal"}
+## @itemx @qcode{"fill"}
+## Restore default automatically computed aspect ratios.
 ## @end table
 ##
 ## @noindent
@@ -83,8 +89,6 @@
 ## @item @qcode{"image"}
 ## Equivalent to @qcode{"tight"} and @qcode{"equal"}.
 ##
-## @item @nospell{@qcode{"vis3d"}}
-## Set aspect ratio modes to @qcode{"manual"} for rotation without stretching.
 ## @end table
 ##
 ## @noindent
@@ -250,7 +254,7 @@
         ## Fix aspect ratio modes for rotation without stretching.
         set (ca, "dataaspectratiomode", "manual",
                  "plotboxaspectratiomode", "manual");
-      elseif (strcmpi (opt, "normal"))
+      elseif (strcmpi (opt, "normal") || strcmpi (opt, "fill"))
         ## Set plotboxaspectratio to something obtuse so that switching
         ## back to "auto" will force a re-calculation.
         set (ca, "plotboxaspectratio", [3 2 1]);