changeset 2775:0c3a065aa01b octave-forge

Documentation update.
author whyly
date Wed, 29 Nov 2006 22:53:32 +0000
parents 565688af8f70
children 56be401b6fdb
files main/statistics/inst/betastat.m main/statistics/inst/binostat.m main/statistics/inst/chi2stat.m main/statistics/inst/expstat.m main/statistics/inst/fstat.m main/statistics/inst/gamstat.m main/statistics/inst/geostat.m main/statistics/inst/hygestat.m main/statistics/inst/lognstat.m main/statistics/inst/normstat.m main/statistics/inst/pascal_stat.m main/statistics/inst/poisstat.m main/statistics/inst/raylstat.m main/statistics/inst/tstat.m main/statistics/inst/unidstat.m main/statistics/inst/unifstat.m main/statistics/inst/weibstat.m
diffstat 17 files changed, 358 insertions(+), 214 deletions(-) [+]
line wrap: on
line diff
--- a/main/statistics/inst/betastat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/betastat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,49 +18,59 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} betastat (@var{a}, @var{b})
 ## Returns mean and variance of the beta distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{a} is the first parameter of the beta distribution. @var{a} must be
 ## positive
+##
 ## @item
 ## @var{b} is the second parameter of the beta distribution. @var{b} must be
 ## positive
 ## @end itemize
 ## @var{a} and @var{b} must be of common size or one of them must be scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the beta distribution
+##
 ## @item
 ## @var{v} is the variance of the beta distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## a = 1:6;
 ## b = 1:0.2:2;
 ## [m, v] = betastat (a, b)
+## @end group
 ##
+## @group
 ## [m, v] = betastat (a, 1.5)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Beta_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the beta distribution
 
 function [m, v] = betastat (a, b)
 
--- a/main/statistics/inst/binostat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/binostat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,49 +18,59 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} binostat (@var{n}, @var{p})
 ## Returns mean and variance of the binomial distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{n} is the first parameter of the binomial distribution. The elements
 ## of @var{n} must be natural numbers
+##
 ## @item
 ## @var{p} is the second parameter of the binomial distribution. The
 ## elements of @var{p} must be probabilities
 ## @end itemize
 ## @var{n} and @var{p} must be of common size or one of them must be scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the binomial distribution
+##
 ## @item
 ## @var{v} is the variance of the binomial distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## n = 1:6;
 ## p = 0:0.2:1;
 ## [m, v] = binostat (n, p)
+## @end group
 ##
+## @group
 ## [m, v] = binostat (n, 0.5)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Binomial_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the binomial distribution
 
 function [m, v] = binostat (n, p)
 
--- a/main/statistics/inst/chi2stat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/chi2stat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,42 +18,49 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} chi2stat (@var{n})
 ## Returns mean and variance of the chi-square distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{n} is the parameter of the chi-square distribution. The elements
 ## of @var{n} must be positive
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the chi-square distribution
+##
 ## @item
 ## @var{v} is the variance of the chi-square distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## n = 1:6;
 ## [m, v] = chi2stat (n)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Chi-square}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the chi-square distribution
 
 function [m, v] = chi2stat (n)
 
--- a/main/statistics/inst/expstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/expstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,42 +18,49 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} expstat (@var{l})
 ## Returns mean and variance of the exponential distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{l} is the rate parameter of the exponential distribution. The
 ## elements of @var{l} must be positive
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the exponential distribution
+##
 ## @item
 ## @var{v} is the variance of the exponential distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## l = 1 ./ (1:6);
 ## [m, v] = expstat (l)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Exponential_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the exponential distribution
 
 function [m, v] = expstat (l)
 
--- a/main/statistics/inst/fstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/fstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,51 +18,61 @@
 ## @deftypefn {Function File} {[@var{mn}, @var{v}] =} fstat (@var{m}, @var{n})
 ## Returns mean and variance of the F distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the first parameter of the F distribution. The elements
 ## of @var{m} must be positive
+##
 ## @item
 ## @var{n} is the second parameter of the F distribution. The
 ## elements of @var{n} must be positive
 ## @end itemize
 ## @var{m} and @var{n} must be of common size or one of them must be scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{mn} is the mean of the F distribution. The mean is undefined for
 ## @var{n} not greater than 2
+##
 ## @item
 ## @var{v} is the variance of the F distribution. The variance is undefined
 ## for @var{n} not greater than 4
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## m = 1:6;
 ## n = 5:10;
 ## [mn, v] = fstat (m, n)
+## @end group
 ##
+## @group
 ## [mn, v] = fstat (m, 5)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/F_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the F distribution
 
 function [mn, v] = fstat (m, n)
 
--- a/main/statistics/inst/gamstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/gamstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,49 +18,59 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} gamstat (@var{a}, @var{b})
 ## Returns mean and variance of the gamma distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{a} is the first parameter of the gamma distribution. @var{a} must be
 ## positive
+##
 ## @item
 ## @var{b} is the second parameter of the gamma distribution. @var{b} must be
 ## positive
 ## @end itemize
 ## @var{a} and @var{b} must be of common size or one of them must be scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the gamma distribution
+##
 ## @item
 ## @var{v} is the variance of the gamma distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## a = 1:6;
 ## b = 1:0.2:2;
 ## [m, v] = gamstat (a, b)
+## @end group
 ##
+## @group
 ## [m, v] = gamstat (a, 1.5)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Gamma_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the gamma distribution
 
 function [m, v] = gamstat (a, b)
 
--- a/main/statistics/inst/geostat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/geostat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,42 +18,49 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} geostat (@var{p})
 ## Returns mean and variance of the geometric distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{p} is the rate parameter of the geometric distribution. The
 ## elements of @var{p} must be probabilities
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the geometric distribution
+##
 ## @item
 ## @var{v} is the variance of the geometric distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## p = 1 ./ (1:6);
 ## [m, v] = geostat (p)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Geometric_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the geometric distribution
 
 function [m, v] = geostat (p)
 
--- a/main/statistics/inst/hygestat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/hygestat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,53 +18,64 @@
 ## @deftypefn {Function File} {[@var{mn}, @var{v}] =} hygestat (@var{m}, @var{t}, @var{n})
 ## Returns mean and variance of the hypergeometric distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the number of marked items of the hypergeometric distribution.
 ## The elements of @var{n} must be natural numbers
+##
 ## @item
 ## @var{t} is the total size of the population of the hypergeometric
 ## distribution. The elements of @var{p} must be positive natural numbers
+##
 ## @item
 ## @var{n} is the size of the drawn sample of the hypergeometric
 ## distribution. The elements of @var{p} must be positive natural numbers
 ## @end itemize
 ## @var{m}, @var{t} and @var{n} must be of common size or scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{mn} is the mean of the hypergeometric distribution
+##
 ## @item
 ## @var{v} is the variance of the hypergeometric distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## m = 0:5;
 ## t = 4:9;
 ## n = 1:6;
 ## [mn, v] = hygestat (m, t, n)
+## @end group
 ##
+## @group
 ## [mn, v] = hygestat (m, t, 2)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Hypergeometric_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the hypergeometric distribution
 
 function [mn, v] = hygestat (m, t, n)
 
--- a/main/statistics/inst/lognstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/lognstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,11 +18,12 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} lognstat (@var{mu}, @var{sigma})
 ## Returns mean and variance of the lognormal distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{mu} is the first parameter of the lognormal distribution
+##
 ## @item
 ## @var{sigma} is the second parameter of the lognormal distribution.
 ## @var{sigma} must be positive or zero
@@ -30,37 +31,46 @@
 ## @var{mu} and @var{sigma} must be of common size or one of them must be
 ## scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the lognormal distribution
+##
 ## @item
 ## @var{v} is the variance of the lognormal distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## mu = 0:0.2:1;
 ## sigma = 0.2:0.2:1.2;
 ## [m, v] = lognstat (mu, sigma)
+## @end group
 ##
+## @group
 ## [m, v] = lognstat (0, sigma)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Lognormal_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the lognormal distribution
 
 function [m, v] = lognstat (mu, sigma)
 
--- a/main/statistics/inst/normstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/normstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,11 +18,12 @@
 ## @deftypefn {Function File} {[@var{mn}, @var{vr}] =} normstat (@var{m}, @var{v})
 ## Returns mean and variance of the normal distribution, the given arguments
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the normal distribution
+##
 ## @item
 ## @var{v} is the variance of the normal distribution.
 ## @var{v} must be positive
@@ -30,37 +31,46 @@
 ## @var{m} and @var{v} must be of common size or one of them must be
 ## scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{mn} is the mean of the normal distribution
+##
 ## @item
 ## @var{vr} is the variance of the normal distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## m = 1:6;
 ## v = 0:0.2:1;
 ## [mn, vr] = normstat (m, v)
+## @end group
 ##
+## @group
 ## [mn, vr] = normstat (0, v)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Normal_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the normal distribution
 
 function [mn, vr] = normstat (m, v)
 
--- a/main/statistics/inst/pascal_stat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/pascal_stat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,49 +18,59 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} pascal_stat (@var{n}, @var{p})
 ## Returns mean and variance of the negative binomial distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{n} is the first parameter of the negative binomial distribution. The elements
 ## of @var{n} must be natural numbers
+##
 ## @item
 ## @var{p} is the second parameter of the negative binomial distribution. The
 ## elements of @var{p} must be probabilities
 ## @end itemize
 ## @var{n} and @var{p} must be of common size or one of them must be scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the negative binomial distribution
+##
 ## @item
 ## @var{v} is the variance of the negative binomial distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## n = 1:4;
 ## p = 0.2:0.2:0.8;
 ## [m, v] = pascal_stat (n, p)
+## @end group
 ##
+## @group
 ## [m, v] = pascal_stat (n, 0.5)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Pascal_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the negative binomial distribution
 
 function [m, v] = pascal_stat (n, p)
 
--- a/main/statistics/inst/poisstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/poisstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -16,44 +16,51 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} poisstat (@var{lambda})
-## Returns mean and variance of the poisson distribution
+## Returns mean and variance of the Poisson distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
-## @var{lambda} is the parameter of the poisson distribution. The
+## @var{lambda} is the parameter of the Poisson distribution. The
 ## elements of @var{lambda} must be positive
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
-## @var{m} is the mean of the poisson distribution
+## @var{m} is the mean of the Poisson distribution
+##
 ## @item
-## @var{v} is the variance of the poisson distribution
+## @var{v} is the variance of the Poisson distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## lambda = 1 ./ (1:6);
 ## [m, v] = poisstat (lambda)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Poisson_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the Poisson distribution
 
 function [m, v] = poisstat (lambda)
 
--- a/main/statistics/inst/raylstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/raylstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,17 +18,17 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} raylstat (@var{sigma})
 ## Returns mean and variance of the Rayleigh distribution.
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{sigma} is the parameter of the Rayleigh distribution. The elements
 ## of @var{sigma} must be positive.
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the Rayleigh distribution.
 ##
@@ -36,29 +36,30 @@
 ## @var{v} is the variance of the Rayleigh distribution.
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## sigma = 1:6;
 ## [m, v] = raylstat (sigma)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
 ## @enumerate
 ## @item
-## W. L. Martinez and A. R. Martinez. @cite{Computational Statistics
-## Handbook with MATLAB.} Chapman & Hall/CRC, pages 547-557, 2001.
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
 ##
 ## @item
-## Wikipedia contributors. Rayleigh distribution. @cite{Wikipedia, The Free
-## Encyclopedia.}
-## @uref{http://en.wikipedia.org/w/index.php?title=Rayleigh_distribution&oldid=69294908},
-## August 2006.
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
 ## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
 ## Description: Moments of the Rayleigh distribution
 
 function [m, v] = raylstat (sigma)
--- a/main/statistics/inst/tstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/tstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,42 +18,49 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} tstat (@var{n})
 ## Returns mean and variance of the t (Student) distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{n} is the parameter of the t (Student) distribution. The elements
 ## of @var{n} must be positive
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the t (Student) distribution
+##
 ## @item
 ## @var{v} is the variance of the t (Student) distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## n = 3:8;
 ## [m, v] = tstat (n)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/T_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the t (Student) distribution
 
 function [m, v] = tstat (n)
 
--- a/main/statistics/inst/unidstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/unidstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,42 +18,49 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} unidstat (@var{n})
 ## Returns mean and variance of the discrete uniform distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{n} is the parameter of the discrete uniform distribution. The elements
 ## of @var{n} must be positive natural numbers
 ## @end itemize
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the discrete uniform distribution
+##
 ## @item
 ## @var{v} is the variance of the discrete uniform distribution
 ## @end itemize
 ##
-## Example:
+## @subheading Example
 ##
 ## @example
+## @group
 ## n = 1:6;
 ## [m, v] = unidstat (n)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Uniform_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the discrete uniform distribution
 
 function [m, v] = unidstat (n)
 
--- a/main/statistics/inst/unifstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/unifstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -18,48 +18,58 @@
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} unifstat (@var{a}, @var{b})
 ## Returns mean and variance of the continuous uniform distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{a} is the first parameter of the continuous uniform distribution
+##
 ## @item
 ## @var{b} is the second parameter of the continuous uniform distribution
 ## @end itemize
 ## @var{a} and @var{b} must be of common size or one of them must be scalar
 ## and @var{a} must be less than @var{b}
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
 ## @var{m} is the mean of the continuous uniform distribution
+##
 ## @item
 ## @var{v} is the variance of the continuous uniform distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## a = 1:6;
 ## b = 2:2:12;
 ## [m, v] = unifstat (a, b)
+## @end group
 ##
+## @group
 ## [m, v] = unifstat (a, 10)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Uniform_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the continuous uniform distribution
 
 function [m, v] = unifstat (a, b)
 
--- a/main/statistics/inst/weibstat.m	Wed Nov 29 21:42:42 2006 +0000
+++ b/main/statistics/inst/weibstat.m	Wed Nov 29 22:53:32 2006 +0000
@@ -16,52 +16,62 @@
 
 ## -*- texinfo -*-
 ## @deftypefn {Function File} {[@var{m}, @var{v}] =} weibstat (@var{alpha}, @var{sigma})
-## Returns mean and variance of the weibull distribution
+## Returns mean and variance of the Weibull distribution
 ##
-## Arguments are
+## @subheading Arguments
 ##
-## @itemize
+## @itemize @bullet
 ## @item
-## @var{alpha} is the shape parameter of the weibull distribution.
+## @var{alpha} is the shape parameter of the Weibull distribution.
 ## @var{alpha} must be positive
+##
 ## @item
-## @var{sigma} is the scale parameter of the weibull distribution.
+## @var{sigma} is the scale parameter of the Weibull distribution.
 ## @var{sigma} must be positive
 ## @end itemize
 ## @var{alpha} and @var{sigma} must be of common size or one of them must be
 ## scalar
 ##
-## Return values are
+## @subheading Return values
 ##
-## @itemize
+## @itemize @bullet
 ## @item
-## @var{m} is the mean of the weibull distribution
+## @var{m} is the mean of the Weibull distribution
+##
 ## @item
-## @var{v} is the variance of the weibull distribution
+## @var{v} is the variance of the Weibull distribution
 ## @end itemize
 ##
-## Examples:
+## @subheading Examples
 ##
 ## @example
+## @group
 ## alpha = 1:6;
 ## sigma = 3:8;
 ## [m, v] = weibstat (alpha, sigma)
+## @end group
 ##
+## @group
 ## [m, v] = weibstat (alpha, 6)
+## @end group
 ## @end example
 ##
-## References:
+## @subheading References
 ##
-## @itemize
+## @enumerate
 ## @item
-## @cite{Matlab 7.0 documentation (pdf)}
+## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics
+## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC,
+## 2001.
+##
 ## @item
-## @uref{http://en.wikipedia.org/wiki/Weibull_distribution}
-## @end itemize
-##
+## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic
+## Processes}. McGraw-Hill, New York, second edition, 1984.
+## @end enumerate
 ## @end deftypefn
 
-## Author: Arno Onken <whyly@gmx.net>
+## Author: Arno Onken <whyly@whyly.org>
+## Description: Moments of the Weibull distribution
 
 function [m, v] = weibstat (alpha, sigma)