[Bug-gsl] a few points in the reference manual

[Daisuke TOMINAGA]

Hello,

I found several ambiguous, or possibly miss-typed points in the  
reference manual (on cvs) while I've been updating the Japanese  
translated version. Please check a list below.

Among that, I also found that the C-keyword "const" is lack in many  
function definitions in the manual. It might not cause any compilation  
error even if readers could not know which arguments are declared as  
const, it should be better that it is shown correctly for programming  
security and code reuse. I checked the source codes only for functions  
in chapter 19 and 20. Those are listed below.

And I added several plots to the translated manual. I'll upload these  
EPS files to my site (below) under GFDL 1.2 because these are for the  
GSL reference manual version 1.11.
http://www.cbrc.jp/%7Etominaga/translations/gsl/

best regards,

Daisuke TOMINAGA, Ph. D.
Computational Biology Research Center, AIST
2-42 Aomi, Koto, Tokyo 135-0064, Japan


P. S.
The Japanese translation now caught up to v1.11. I know it's not the  
recent version. I'll reflect differences v1.11 and cvs in next few  
weeks.


The list
--------------------------
7.5.5
gsl_sf_bessel_jl_steed_array
name of the last argument of the function is different between the  
definition and the description (jl_x_array / result_array)

7.15.4
Mill's ratio -> Mills ratio/Mills' ratio

7.16.2 gsl_sf_exprel_n
_ is lack in the name of the function in the description

7.17.3 hyperbolic integrals
cosh[t] -> cosh(t)

7.17.4 Ei_3 → $\mathrm{Ei}_3$

7.19
The header file is mentioned twice.

7.19.1 lngamma_sign_e
exp(resultlg) -> exp(resultlg->val)

7.19.1 Temme
'suggestion of Temme' ->it might be better to show the reference.
(Nico M. Temme, Special Functions: An Introduction to the Classical  
Functions of Mathematical Physics, WileyBlackwell, ISBN  
978-0471113133, 1996?)

7.19.3 gsl_sf_lnpoch_sign_e
result=log(|(a)_x|)  ->  result->val = log(|(a)_x|)

7.21　gsl_sf_hyperg_2F1_conj
aR - iaI -> R and I should be suffix
"exceptions:" at the end of the description should be followed by  
something or be eliminated.

7.31.2 gsl_sf_complex_cos_e, gsl_sf_complex_logsin_e
szr, szi in the description -> czr, czi / lszr, lszi

7.34 ref.
The name of the author "Allan J. MacLeod" should be added for MISCFUN.

9.6 gsl_permutation_mul
"pb" in the description should be slanted.

12.1.1
gsl_blas_[cz]dot[uc]
"result" in the description should be replaced by "[cz]dot[uc]$.

13.7 gsl_linalg_hermtd_unpack
matrix "U" -> "Q"

15.7
z^*_{N-k}: N -> n

19.2
Mueller -> Muller

19.28
Marsaglia (1963), random numbers -> random variables

19.32
C. S. David -> C. S. Davis

19.39 Random walk figure
three 10-step runs -> it seems there are 40 or more points in the  
figure.
axis labels 'p(k)' and 'k' should be deleted.

19.40
the first reference book is now available online as PDF files. It  
should be better to show the URL below.
http://cg.scs.carleton.ca/~luc/rnbookindex.html

20.7 gsl_stat_w{skew,kurtosis}
xbar -> \bar{x}, sigma -> \sigma

26.3
five interpolation types -> six types

26.4
should gsl_interp_accel_reset (gsl_interp_accel * a) be added?

28.4 gsl_cheb_eval_n
given point n -> x

30.3.2 gsl_wavelet2d_transform
L. 2: "standard and non-standard forms" might be "standard form".

31.2 gsl_dht_init
given values of nu and x -> xmax

32.4 gsl_function_fdf
void (*fdf)(double x, ... , double * df)
font style differs between two letters of the last argument "df".

32.9 gsl_root_fdfsolver_steffenson
steffenson -> steffensen

35.10 ref
Nelder, Mead, pp. 308-315 -> 308-313
http://comjnl.oxfordjournals.org/content/vol7/issue4/index.dtl

39.3 Rydberg constant
R_\infty might be better than R in "R by Ry = hcR".

39.18 ref
new CODATA ref. available -> Peter J. Mohr, Barry N. Taylor, David B.  
Newell, ``CODATA Recommended Values of the Fundamental Physical  
Constants: 2006'', \textit{Reviews of Modern Physics}, \textbf{80}(2),  
pp. 633--730 (2008).

Apx. D.4 examples
the (3,2) element of the 2nd matrix in the left,
(1011 1012)
(1021 1022)
(1031 1031) -> (1031 1032)

---
argument type miss match
---

19.2 19.3, 19.5, 19.6, 19.7, 19.8, 19.9, 19.10, 19.11, 19.12, 19.13,  
19.14,
19.16, 19.17, 19.18, 19.19, 19.20, 19.21, 19.24, 19.25, 19.26, 19.35,  
19.37
all arguments of all functions are const

19.4
all arguments of gsl_ran_bivariate_gaussian_pdf are const

19.15
all arguments of gsl_ran_flat_pdf except the first 'x' are const

19.22
all arguments of gsl_ran_pareto except the 2nd 'a' are const

19.27
the 2nd argument of gsl_ran_dirichlet 'K' is const
the first arguments of gsl_ran_dirichlet_pdf and lnpdf, 'K', is const

19.29
all arguments of gsl_ran_poisson except the 2nd 'mu' are const

19.30
the first argument of gsl_ran_bernoulli_pdf is const

19.31
all arguments of all functions except gsl_ran_binomial are const

19.32
all arguments of gsl_ran_multiomial except the last are const

19.33
the first 2 arguments of gsl_cdf_negative_binomial_pdf are const
all arguments of gsl_cdf_negative_binomial_[PQ] are const

19.34
all arguments except last 2 of gsl_ran_pascal the last of  
gsl_ran_pascal_pdf are const

19.36
all arguments of gsl_ran_hypergeometric_pdf except the last are const
all arguments of gsl_ran_hypergeometric_[PQ] are const

20.1 20.2 20.3 20.7 20.9
all arguments of all functions are const

20.8
all arguments of all functions except type 'size_t *' and 'double *'  
are const

--------------------------EOF