Merge pull request #777 from stan-dev/distribution-stataments

sampling statement -> distribution statament

Author: WardBrian

gen_index.py

@@ -28,7 +28,7 @@ def make_index_mapping(sigs):
         sig = f"<!-- {returntype}; {name}"
         if args.strip() == "~":
             sig += " ~; "
-            index_entry = "sampling statement"
+            index_entry = "distribution statement"
         else:
             sig += f"; {args}; "
             index_entry = f"`{args} : {returntype}`"

src/reference-manual/blocks.qmd

@@ -93,7 +93,7 @@ Log-probability modifying functions to blocks where the log
 probability accumulator is in scope (transformed parameters and
 model); such functions are suffixed with `_lp`.
 
-Density functions defined in the program may be used in sampling
+Density functions defined in the program may be used in distribution
 statements.
 
 
@@ -393,8 +393,9 @@ in the `transformed data` block.
 
 The statements in the transformed data block are designed to be
 executed once and have a deterministic result.  Therefore, log
-probability is not accumulated and sampling statements may not be
-used.
+probability is not accumulated and 
+[distribution statements](statements.qmd#distribution-statements.section)
+may not be used.
 
 
 ### Variable constraint checking {-}
@@ -528,7 +529,7 @@ no well-defined way to have them be both flexible and easy to
 validate.
 
 The statements in the model block typically define the model.  This is
-the block in which probability (sampling notation) statements are
+the block in which probability (distribution notation) statements are
 allowed.  These are typically used when programming in the BUGS idiom
 to define the probability model.
 

src/reference-manual/expressions.qmd

@@ -1339,7 +1339,9 @@ model {
 }
 ```
 
-Algebraically, the sampling statement in the model could be reduced to
+Algebraically, 
+[statements.qmd#distribution-statements.section](the distribution statement) 
+in the model could be reduced to
 
 ```stan
   x ~ normal(0, 1);

src/reference-manual/removals.qmd

@@ -123,8 +123,9 @@ Replace `foo_ccdf_log(y, ...)` with `foo_lccdf(y | ...)`.
 
 ## User-defined function with `_log` suffix
 
-*Removed*: A user-defined function ending in `_log` can be no longer be used in
-sampling statements.
+*Removed*: A user-defined function ending in `_log` can be no longer be 
+used in
+[statements.qmd#distribution-statements.section](distribution statements).
 
 *Replacement*: Replace the `_log` suffix with `_lpdf` for density
 functions or `_lpmf` for mass functions in the user-defined function.