[Octave-cvsupdate] SF.net SVN: octave:[10912] trunk/octave-forge/main/control/inst

[<par...@us...>]

Revision: 10912
          http://octave.svn.sourceforge.net/octave/?rev=10912&view=rev
Author:   paramaniac
Date:     2012-08-25 05:44:24 +0000 (Sat, 25 Aug 2012)
Log Message:
-----------
control: doc enhancements

Modified Paths:
--------------
    trunk/octave-forge/main/control/inst/margin.m
    trunk/octave-forge/main/control/inst/sensitivity.m

Modified: trunk/octave-forge/main/control/inst/margin.m
===================================================================
--- trunk/octave-forge/main/control/inst/margin.m	2012-08-24 16:27:38 UTC (rev 10911)
+++ trunk/octave-forge/main/control/inst/margin.m	2012-08-25 05:44:24 UTC (rev 10912)
@@ -18,9 +18,11 @@
 ## -*- texinfo -*-
 ## @deftypefn{Function File} {[@var{gamma}, @var{phi}, @var{w_gamma}, @var{w_phi}] =} margin (@var{sys})
 ## @deftypefnx{Function File} {[@var{gamma}, @var{phi}, @var{w_gamma}, @var{w_phi}] =} margin (@var{sys}, @var{tol})
-## Gain and phase margin of a system.  If no output arguments are given, both gain and phase margin
-## are plotted on a bode diagram.  Otherwise, the margins and their corresponding frequencies are
-## computed and returned.
+## Gain and phase margin of a system.
+## If no output arguments are given, both gain and phase margin are plotted on a bode diagram.
+## Otherwise, the margins and their corresponding frequencies are computed and returned.
+## A more robust criterion to assess the stability of a feedback system is the sensitivity Ms
+## computed by command @command{sensitivity}.
 ##
 ## @strong{Inputs}
 ## @table @var

Modified: trunk/octave-forge/main/control/inst/sensitivity.m
===================================================================
--- trunk/octave-forge/main/control/inst/sensitivity.m	2012-08-24 16:27:38 UTC (rev 10911)
+++ trunk/octave-forge/main/control/inst/sensitivity.m	2012-08-25 05:44:24 UTC (rev 10912)
@@ -37,7 +37,10 @@
 ##
 ## @end ifnottex
 ## If no output arguments are given, the critical distance 1/Ms
-## is plotted on a Nyquist diagram. 
+## is plotted on a Nyquist diagram.
+## In contrast to gain and phase margin as computed by command
+## @command{margin}, the sensitivity @var{Ms} is a more robust
+## criterion to assess the stability of a feedback system.
 ##
 ## @strong{Inputs}
 ## @table @var

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.