Minor doc updates. - gsl-shell.git - gsl-shell

diff --git a/DIST-FILES b/DIST-FILES
index 4bd33b4c..dab491a7 100644
--- a/DIST-FILES
+++ b/DIST-FILES

@@ -200,3 +200,6 @@ doc/source/random.rst

doc/source/randist.rst

doc/source/pdf.rst

doc/source/cdf.rst

+scripts/project-diff.sh

+scripts/makedist.sh

+scripts/www-cvs-sync.sh

diff --git a/doc/source/cdf.rst b/doc/source/cdf.rst
index ce036143..8160fc87 100644
--- a/doc/source/cdf.rst
+++ b/doc/source/cdf.rst

@@ -2,12 +2,16 @@

.. include:: <isogrk1.txt>

+.. _cdf-section:

+

:mod:`cdf` -- Probability Distribution Functions

================================================

.. module:: cdf

-The module ``cdf`` offer the same functions of the module ``pdf`` but the *culumative* probability is calculated for the given value of ``x``. So the cumulative probability is calculated like:

+The module ``cdf`` offer the same functions of the module ``pdf`` but

+the gives the *cumulative* probability for the given value of

+``x``. The cumulative probability is defined like:

.. math::

\int_a^x p(\xi) d\xi

diff --git a/doc/source/randist.rst b/doc/source/randist.rst
index d571fb3f..f6cd1df0 100644
--- a/doc/source/randist.rst
+++ b/doc/source/randist.rst

@@ -27,14 +27,14 @@ The library also provides cumulative distribution functions and

inverse cumulative distribution functions, sometimes referred to as

quantile functions. The cumulative distribution functions and their

inverses are computed separately for the upper and lower tails of the

-distribution, allowing full accuracy to be retained for small results.

+distribution, allowing full accuracy to be retained for small results. See the chapter :ref:`cdf-section` for more details.

.. _rnd_gaussian:

.. function:: gaussian(r [, sigma])

This function returns a Gaussian random variate, with mean zero and

- standard deviation SIGMA. The probability distribution for

+ standard deviation 'sigma'. The probability distribution for

Gaussian random variates is,

.. math::

@@ -42,16 +42,24 @@ distribution, allowing full accuracy to be retained for small results.

for x in the range -\ |infin| to +\ |infin| . Use the transformation z =

|mgr| + x on the numbers returned by 'gsl_ran_gaussian' to obtain a

- Gaussian distribution with mean \mu. This function uses the

+ Gaussian distribution with mean |mgr|. This function uses the

Box-Mueller algorithm which requires two calls to the random

number generator R.

+ .. figure:: gaussian-pdf.png

+

+ Probability distribution function

+

+ .. figure:: gaussian-cdf.png

+

+ Cumulative distribution function

+

.. _rnd_exponential:

.. function:: exponential(r [, mu])

This function returns a random variate from the exponential

- distribution with mean MU. The distribution is,

+ distribution with mean 'mu'. The distribution is,

.. math::

p(x) dx = {1 \over \mu} \exp(-x/\mu) dx

@@ -72,7 +80,7 @@ distribution, allowing full accuracy to be retained for small results.

has a chi-squared distribution with n degrees of freedom.

This function returns a random variate from the chi-squared

- distribution with NU degrees of freedom. The distribution function

+ distribution with |ngr| degrees of freedom. The distribution function

is,

.. math::

@@ -80,6 +88,10 @@ distribution, allowing full accuracy to be retained for small results.

for x >= 0.

+ .. figure:: chisq-pdf.png

+

+ Probability distribution function

+

.. _rnd_laplace:

.. function:: laplace(r [, a])

@@ -125,7 +137,7 @@ distribution, allowing full accuracy to be retained for small results.

.. math::

p(x) dx = {1 \over a\pi (1 + (x/a)^2) } dx

- for x in the range -\infty to +\infty. The Cauchy distribution is

+ for x in the range - |infin| to + |infin| . The Cauchy distribution is

also known as the Lorentz distribution.

.. _rnd_rayleigh:

@@ -133,7 +145,7 @@ distribution, allowing full accuracy to be retained for small results.

.. function:: rayleigh(r [, sigma])

This function returns a random variate from the Rayleigh

- distribution with scale parameter SIGMA. The distribution is,

+ distribution with scale parameter |sgr|. The distribution is,

.. math::

p(x) dx = {x \over \sigma^2} \exp(- x^2/(2 \sigma^2)) dx

@@ -151,10 +163,11 @@ distribution, allowing full accuracy to be retained for small results.

.. math::

X = { (Y_1 / \nu_1) \over (Y_2 / \nu_2) }

- has an F-distribution F(x; |ngr|\ :sub:`1`, |ngr|\ :sub:`1`).

+ has an F-distribution F(x; |ngr|\ :sub:`1`, |ngr|\ :sub:`2`).

- This function returns a random variate from the F-distribution

- with degrees of freedom NU1 and NU2. The distribution function is,

+ This function returns a random variate from the F-distribution with

+ degrees of freedom |ngr|\ :sub:`1` and |ngr|\ :sub:`2`. The

+ distribution function is,

.. math::

p(x) dx =

diff --git a/doc/source/random.rst b/doc/source/random.rst
index a8e13c28..eacd5964 100644
--- a/doc/source/random.rst
+++ b/doc/source/random.rst

@@ -6,10 +6,10 @@ Random Numbers

==============

This chapter describes routines for generating random numbers. GSL

-provides use a large collection of random number generators which can

-be accessed through a uniform interface. You can select different

-generators and seeds very easily so that you can easily switch between

-generators without needing to change your program.

+provides a large collection of random number generators that can be

+accessed through a uniform interface. You can choose very easily the

+generator you want to use and even switch between generators without

+needing to change your commands.

Each instance of a generator keeps track of its own state so that you

can have several different generators and they will not interfere with

@@ -73,7 +73,7 @@ So, if you want to generate random numbers the first step is to use the :func:`r

This function returns a "random number generator" object of the

specified type ``name``. If you do not specify a particular

generator the default ``taus2`` generator will be used. See the

- paragraph on :ref:`algorithms <rng_algorithms>` for a description

+ paragraph on :ref:`algorithms <rng-algorithms>` for a description

of the different algorithms available.

.. class:: rng

@@ -150,7 +150,7 @@ randomness.

seeding procedure published by the two authors above in 2002. The

original seeding procedures could cause spurious artifacts for

some seed values. They are still available through the alternative

- generators 'mt19937\ :sub:`1999` ' and 'mt19937\ :sub:`1998` '.

+ generators 'mt19937_1999' and 'mt19937_1998'.

**ranlxs0, ranlxs1, ranlxs2**

The generator 'ranlxs0' is a second-generation version of the

diff --git a/makedist.sh b/makedist.sh
deleted file mode 100755
index 252b1c70..00000000
--- a/makedist.sh
+++ /dev/null

@@ -1,17 +0,0 @@

-#!/bin/bash

-

-for NM in `cat DIST-FILES`; do

- DIR=`dirname $NM`

-# BNM=`basename $NM`

- if test $DIR = "."; then

- LTARGET=$TARGET

- else

- LTARGET=$TARGET/$DIR

- fi

- if test ! -d $LTARGET; then

- echo "CREATING DIRECTORY: $LTARGET"

- mkdir -p $LTARGET

- fi

- echo "COPYING FILE: $NM"

- cp $NM $LTARGET

-done

diff --git a/scripts/www-cvs-sync.sh b/scripts/www-cvs-sync.sh
new file mode 100644
index 00000000..3ee5b94b
--- /dev/null
+++ b/scripts/www-cvs-sync.sh

@@ -0,0 +1,44 @@

+#!/bin/bash

+

+BASE_DIR="$HOME/sviluppo/gsl-shell"

+#BASE_DIR="."

+WWW_DIR="$BASE_DIR/www/gsl-shell"

+SRC_DIR="$BASE_DIR/doc/html"

+

+SRCLST=`find $SRC_DIR -type f -a -not -path '*/.doctree*' -a -not -iname '.buildinfo'`

+

+ADDLST=()

+FULLLST=()

+for NM in $SRCLST; do

+ DNM=`echo $NM | awk '{gsub(/doc\/html/, "www/gsl-shell"); print 0ドル }'`

+ echo "Treating: $NM"

+ RDNM=`echo $DNM | awk '{gsub(/^.*www\/gsl-shell\//, ""); print 0ドル }'`

+ if test ! -f $DNM; then

+ ADDLST[${#ADDLST[@]}]=$RDNM

+ fi

+ FULLLST[${#FULLLST[@]}]=$RDNM

+done

+

+WWWLST=`find $WWW_DIR -type f -a -not -path '*CVS*'`

+

+RMLST=()

+for NM in $WWWLST; do

+ SNM=`echo $NM | awk '{gsub(/www\/gsl-shell/, "doc/html"); print 0ドル }'`

+ echo "Treating: $NM"

+ if test ! -f $SNM; then

+ RMLST[${#RMLST[@]}]=`echo $NM | awk '{gsub(/^.*www\/gsl-shell\//, ""); print 0ドル }'`

+ fi;

+done

+

+cd www/gsl-shell

+for NM in ${FULLLST[@]}; do

+ cp "$SRC_DIR/$NM" "$NM"

+done

+if test ${#ADDLST[@]} -gt 0; then

+ cvs add "${ADDLST[@]}"

+fi

+if test ${#RMLST[@]} -gt 0; then

+ rm "${RMLST[@]}"

+ cvs remove "${RMLST[@]}"

+fi

+cd -