--- a/scripts/plot/axis.m	Sat Nov 20 14:52:42 1999 +0000
+++ b/scripts/plot/axis.m	Sat Nov 20 17:23:01 1999 +0000
@@ -17,17 +17,22 @@
 ## Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 ## 02111-1307, USA.
 
-## usage: axis ()
-##        axis ([xmin, xmax])
-##        axis ([xmin, xmax, ymin, ymax])
-##        axis ([xmin, xmax, ymin, ymax, zmin, zmax])
-##
-## Sets the axis limits.
-##
-## With no arguments, turns autoscaling on.
-##
-## If your plot is already drawn, then you need to REPLOT before
-## the new axis limits will take effect.
+## -*- texinfo -*-
+## @deftypefn {Function File} {} axis (@var{limits})
+## Sets the axis limits for plots.
+## 
+## The argument @var{limits} should be a 2, 4, or 6 element vector.  The
+## first and second elements specify the lower and upper limits for the x
+## axis.  The third and fourth specify the limits for the y axis, and the
+## fifth and sixth specify the limits for the z axis.
+## 
+## With no arguments, @code{axis} turns autoscaling on.
+## 
+## If your plot is already drawn, then you need to use @code{replot} before
+## the new axis limits will take effect.  You can get this to happen
+## automatically by setting the built-in variable @code{automatic_replot}
+## to a nonzero value.
+## @end deftypefn
 
 ## Author: jwe