new API prioritised

Author: sebastian-mutz

doc/specs/stdlib_stats_distribution_exponential.md

@@ -34,11 +34,11 @@ The algorithm used for generating exponential random variates is fundamentally l
 
 ### Syntax
 
-`result = ` [[stdlib_stats_distribution_exponential(module):rvs_exp(interface)]] `([lambda] [[, array_size]])`
+`result = ` [[stdlib_stats_distribution_exponential(module):rvs_exp(interface)]] `([loc, scale] [[, array_size]])`
 
 or
 
-`result = ` [[stdlib_stats_distribution_exponential(module):rvs_exp(interface)]] `([loc, scale] [[, array_size]])`
+`result = ` [[stdlib_stats_distribution_exponential(module):rvs_exp(interface)]] `([lambda] [[, array_size]])`
 
 ### Class
 
@@ -90,11 +90,11 @@ Instead of of the inverse scale parameter `lambda`, it is possible to pass `loc`
 
 ### Syntax
 
-`result = ` [[stdlib_stats_distribution_exponential(module):pdf_exp(interface)]] `(x, lambda)`
+`result = ` [[stdlib_stats_distribution_exponential(module):pdf_exp(interface)]] `(x, loc, scale)`
 
 or
 
-`result = ` [[stdlib_stats_distribution_exponential(module):pdf_exp(interface)]] `(x, loc, scale)`
+`result = ` [[stdlib_stats_distribution_exponential(module):pdf_exp(interface)]] `(x, lambda)`
 
 ### Class
 
@@ -145,11 +145,11 @@ Alternative to the inverse scale parameter `lambda`, it is possible to pass `loc
 
 ### Syntax
 
-`result = ` [[stdlib_stats_distribution_exponential(module):cdf_exp(interface)]] `(x, lambda)`
+`result = ` [[stdlib_stats_distribution_exponential(module):cdf_exp(interface)]] `(x, loc, scale)`
 
 or
 
-`result = ` [[stdlib_stats_distribution_exponential(module):cdf_exp(interface)]] `(x, loc, scale)`
+`result = ` [[stdlib_stats_distribution_exponential(module):cdf_exp(interface)]] `(x, lambda)`
 
 ### Class
 

example/stats_distribution_exponential/example_exponential_cdf.f90

@@ -12,14 +12,14 @@ program example_exponential_cdf
   seed_put = 1234567
   call random_seed(seed_put, seed_get)
 
-  ! standard exponential cumulative distribution at x=1.0 with lambda=1.0
-  print *, exp_cdf(1.0, 1.0)
-  ! 0.632120550
-
   ! standard exponential cumulative distribution at x=1.0 with loc=0.0, scale=1.0
   print *, exp_cdf(1.0, 0.0, 1.0)
   ! 0.632120550
 
+  ! standard exponential cumulative distribution at x=1.0 with lambda=1.0
+  print *, exp_cdf(1.0, 1.0)
+  ! 0.632120550
+
   ! cumulative distribution at x=2.0 with lambda=2
   print *, exp_cdf(2.0, 2.0)
   ! 0.981684387

example/stats_distribution_exponential/example_exponential_pdf.f90

@@ -12,14 +12,14 @@ program example_exponential_pdf
   seed_put = 1234567
   call random_seed(seed_put, seed_get)
 
-  ! probability density at x=1.0 with lambda=1.0
-  print *, exp_pdf(1.0, 1.0)
-  ! 0.367879450
-
   ! probability density at x=1.0 with loc=0 and scale=1.0
   print *, exp_pdf(1.0, 0.0, 1.0)
   ! 0.367879450
 
+  ! probability density at x=1.0 with lambda=1.0
+  print *, exp_pdf(1.0, 1.0)
+  ! 0.367879450
+
   ! probability density at x=2.0 with lambda=2.0
   print *, exp_pdf(2.0, 2.0)
   ! 3.66312787E-02

example/stats_distribution_exponential/example_exponential_rvs.f90

@@ -9,18 +9,18 @@ program example_exponential_rvs
   seed_put = 1234567
   call random_seed(seed_put, seed_get)
 
- ! single standard exponential random variate
+  ! single standard exponential random variate
   print *, rexp()
   ! 0.358690143
 
-  ! exponential random variate with lambda=2
-   print *, rexp(2.0)
-  ! 0.204114929
-
   ! exponential random variate with loc=0 and scale=0.5 (lambda=2)
   print *, rexp(0.0, 0.5)
   ! 0.122672431
 
+  ! exponential random variate with lambda=2
+   print *, rexp(2.0)
+  ! 0.204114929
+
   ! exponential random variate with loc=0.6 and scale=0.2 (lambda=5)
   print *, rexp(0.6, 0.2)
   ! 0.681645989