X-Git-Url: http://gitweb.michael.orlitzky.com/?p=octave.git;a=blobdiff_plain;f=has_root.m;h=ffd96666b0bca58366fc5b641c43a2893cf3b16c;hp=da518e9f3e03524db06a9a1c10f4a41fbdfd9afe;hb=f731b63a9705d1365df898881b7aaafe371e5dde;hpb=1a5bceb9de6bd3a511e7edcb6ab08f84dae63948 diff --git a/has_root.m b/has_root.m index da518e9..ffd9666 100644 --- a/has_root.m +++ b/has_root.m @@ -7,7 +7,19 @@ function has_root = has_root(fa, fb) ## Call the function whose roots we're concerned with 'f'. The two ## parameters `fa` and `fb` should correspond to f(a) and f(b). ## - + ## + ## INPUTS: + ## + ## * ``fa`` - The value of `f` at one end of the interval. + ## + ## * ``fb`` - The value of `f` at the other end of the interval. + ## + ## OUTPUTS: + ## + ## * ``has_root`` - True if we can use the I.V.T. to conclude that + ## there is a root on [a,b], false otherwise. + ## + ## If either f(a) or f(b) is zero, the product of their signs will be ## zero and either a or b is a root. If the product of their signs is ## negative, then f(a) and f(b) are non-zero and have opposite sign,