From de399203f20433cbaae6689e53beb130fe5a4771 Mon Sep 17 00:00:00 2001
From: Karan Anand <anandkarancompsci@gmail.com>
Date: Thu, 27 Aug 2026 10:14:26 +0530
Subject: [PATCH] docs: add equations to rounding function READMEs

Add defining equations to the intro sections of ceil, floor, round,
trunc and their power-of-2, power-of-10, base-b, decimal-place, and
significant-figures variants. Includes piecewise formulas for
ceil2/ceil10/floor2/floor10 to correctly handle negative inputs.

Ref: https://github.com/stdlib-js/metr-issue-tracker/issues/1257
---
 .../@stdlib/math/base/special/ceil/README.md   | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/ceil10/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/ceil2/README.md  | 14 ++++++++++++++
 .../@stdlib/math/base/special/ceilb/README.md  | 14 ++++++++++++++
 .../@stdlib/math/base/special/ceilf/README.md  | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/ceiln/README.md  | 14 ++++++++++++++
 .../@stdlib/math/base/special/ceilsd/README.md | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/floor/README.md  | 18 ++++++++++++++++++
 .../math/base/special/floor10/README.md        | 14 ++++++++++++++
 .../@stdlib/math/base/special/floor2/README.md | 14 ++++++++++++++
 .../math/base/special/floor2f/README.md        | 14 ++++++++++++++
 .../@stdlib/math/base/special/floorb/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/floorf/README.md | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/floorn/README.md | 14 ++++++++++++++
 .../math/base/special/floornf/README.md        | 14 ++++++++++++++
 .../math/base/special/floorsd/README.md        | 18 ++++++++++++++++++
 .../base/special/round-nearest-even/README.md  |  6 ++++++
 .../@stdlib/math/base/special/round/README.md  | 14 ++++++++++++++
 .../math/base/special/round10/README.md        |  6 ++++++
 .../math/base/special/round10f/README.md       |  6 ++++++
 .../@stdlib/math/base/special/round2/README.md |  6 ++++++
 .../@stdlib/math/base/special/roundb/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/roundf/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/roundn/README.md | 14 ++++++++++++++
 .../math/base/special/roundnf/README.md        | 14 ++++++++++++++
 .../math/base/special/roundsd/README.md        | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/trunc/README.md  | 18 ++++++++++++++++++
 .../math/base/special/trunc10/README.md        | 14 ++++++++++++++
 .../@stdlib/math/base/special/trunc2/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/truncb/README.md | 14 ++++++++++++++
 .../@stdlib/math/base/special/truncf/README.md | 18 ++++++++++++++++++
 .../@stdlib/math/base/special/truncn/README.md | 14 ++++++++++++++
 .../math/base/special/truncsd/README.md        | 18 ++++++++++++++++++
 33 files changed, 470 insertions(+)

diff --git a/lib/node_modules/@stdlib/math/base/special/ceil/README.md b/lib/node_modules/@stdlib/math/base/special/ceil/README.md
index 3efaa939ac4e..7edcfed83cbf 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceil/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceil/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a double-precision floating-point number toward positive infinity.
 
+<section class="intro">
+
+The [ceiling function][ceiling-function] is defined as
+
+<!-- <equation class="equation" label="eq:ceiling_function" align="center" raw="y = \lceil x \rceil = \min\{ n \in \mathbb{Z} : n \geq x \}" alt="Ceiling function"> -->
+
+```math
+y = \lceil x \rceil = \min\{ n \in \mathbb{Z} : n \geq x \}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -180,6 +196,8 @@ int main( void ) {
 
 <section class="links">
 
+[ceiling-function]: https://en.wikipedia.org/wiki/Floor_and_ceiling_functions
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceiln]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceiln
diff --git a/lib/node_modules/@stdlib/math/base/special/ceil10/README.md b/lib/node_modules/@stdlib/math/base/special/ceil10/README.md
index a702a97f1635..ba7af4d28df2 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceil10/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceil10/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of 10 toward positive infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:ceil10_function" align="center" raw="y = \begin{cases} 10^{\lceil \log_{10} x \rceil} & \textrm{if}\ x > 0 \\ -10^{\lfloor \log_{10} |x| \rfloor} & \textrm{if}\ x < 0 \end{cases}" alt="Round up to nearest power of ten"> -->
+
+```math
+y = \begin{cases} 10^{\lceil \log_{10} x \rceil} & \textrm{if}\ x > 0 \\ -10^{\lfloor \log_{10} |x| \rfloor} & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/ceil2/README.md b/lib/node_modules/@stdlib/math/base/special/ceil2/README.md
index d4b9fe956e23..b59bb26515ec 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceil2/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceil2/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of two toward positive infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:ceil2_function" align="center" raw="y = \begin{cases} 2^{\lceil \log_2 x \rceil} & \textrm{if}\ x > 0 \\ -2^{\lfloor \log_2 |x| \rfloor} & \textrm{if}\ x < 0 \end{cases}" alt="Round up to nearest power of two"> -->
+
+```math
+y = \begin{cases} 2^{\lceil \log_2 x \rceil} & \textrm{if}\ x > 0 \\ -2^{\lfloor \log_2 |x| \rfloor} & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/ceilb/README.md b/lib/node_modules/@stdlib/math/base/special/ceilb/README.md
index 164983ab8eb4..2097819c45e5 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceilb/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceilb/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of b^n toward positive infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:ceilb_function" align="center" raw="y = \left\lceil \frac{x}{b^n} \right\rceil \cdot b^n" alt="Round up to nearest multiple of b^n"> -->
+
+```math
+y = \left\lceil \frac{x}{b^n} \right\rceil \cdot b^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/ceilf/README.md b/lib/node_modules/@stdlib/math/base/special/ceilf/README.md
index a2647debe2aa..3f2b8089c8c7 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceilf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceilf/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a single-precision floating-point number toward positive infinity.
 
+<section class="intro">
+
+The [ceiling function][ceiling-function] is defined as
+
+<!-- <equation class="equation" label="eq:ceiling_function" align="center" raw="y = \lceil x \rceil = \min\{ n \in \mathbb{Z} : n \geq x \}" alt="Ceiling function"> -->
+
+```math
+y = \lceil x \rceil = \min\{ n \in \mathbb{Z} : n \geq x \}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -178,6 +194,8 @@ int main( void ) {
 
 <section class="links">
 
+[ceiling-function]: https://en.wikipedia.org/wiki/Floor_and_ceiling_functions
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/floorf]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/floorf
diff --git a/lib/node_modules/@stdlib/math/base/special/ceiln/README.md b/lib/node_modules/@stdlib/math/base/special/ceiln/README.md
index 2f5a5a0cdce9..adfdcc4945a9 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceiln/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceiln/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of 10^n toward positive infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:ceiln_function" align="center" raw="y = \left\lceil \frac{x}{10^n} \right\rceil \cdot 10^n" alt="Round up to n decimal places"> -->
+
+```math
+y = \left\lceil \frac{x}{10^n} \right\rceil \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/ceilsd/README.md b/lib/node_modules/@stdlib/math/base/special/ceilsd/README.md
index 7dfbb21f7141..dd245806879d 100644
--- a/lib/node_modules/@stdlib/math/base/special/ceilsd/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/ceilsd/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a numeric value to the nearest number toward positive infinity with N significant figures.
 
+<section class="intro">
+
+The function rounds a numeric value to the specified number of [significant figures][significant-figures] toward positive infinity
+
+<!-- <equation class="equation" label="eq:ceilsd_function" align="center" raw="y = \left\lceil x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} \right\rceil \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}" alt="Round up to n significant figures"> -->
+
+```math
+y = \left\lceil x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} \right\rceil \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -192,6 +208,8 @@ int main( void ) {
 
 <section class="links">
 
+[significant-figures]: https://en.wikipedia.org/wiki/Significant_figures
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceil]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceil
diff --git a/lib/node_modules/@stdlib/math/base/special/floor/README.md b/lib/node_modules/@stdlib/math/base/special/floor/README.md
index 14073137f7f0..13643d005483 100644
--- a/lib/node_modules/@stdlib/math/base/special/floor/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floor/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a double-precision floating-point number toward negative infinity.
 
+<section class="intro">
+
+The [floor function][floor-function] is defined as
+
+<!-- <equation class="equation" label="eq:floor_function" align="center" raw="y = \lfloor x \rfloor = \max\{ n \in \mathbb{Z} : n \leq x \}" alt="Floor function"> -->
+
+```math
+y = \lfloor x \rfloor = \max\{ n \in \mathbb{Z} : n \leq x \}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -179,6 +195,8 @@ int main( void ) {
 
 <section class="links">
 
+[floor-function]: https://en.wikipedia.org/wiki/Floor_and_ceiling_functions
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceil]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceil
diff --git a/lib/node_modules/@stdlib/math/base/special/floor10/README.md b/lib/node_modules/@stdlib/math/base/special/floor10/README.md
index cdf494f111f6..5f4e9cb875e1 100644
--- a/lib/node_modules/@stdlib/math/base/special/floor10/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floor10/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of 10 toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floor10_function" align="center" raw="y = \begin{cases} 10^{\lfloor \log_{10} x \rfloor} & \textrm{if}\ x > 0 \\ -10^{\lceil \log_{10} |x| \rceil} & \textrm{if}\ x < 0 \end{cases}" alt="Round down to nearest power of ten"> -->
+
+```math
+y = \begin{cases} 10^{\lfloor \log_{10} x \rfloor} & \textrm{if}\ x > 0 \\ -10^{\lceil \log_{10} |x| \rceil} & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floor2/README.md b/lib/node_modules/@stdlib/math/base/special/floor2/README.md
index 1e3e62d1fe67..e77b47b1fce8 100644
--- a/lib/node_modules/@stdlib/math/base/special/floor2/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floor2/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of two toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floor2_function" align="center" raw="y = \begin{cases} 2^{\lfloor \log_2 x \rfloor} & \textrm{if}\ x > 0 \\ -2^{\lceil \log_2 |x| \rceil} & \textrm{if}\ x < 0 \end{cases}" alt="Round down to nearest power of two"> -->
+
+```math
+y = \begin{cases} 2^{\lfloor \log_2 x \rfloor} & \textrm{if}\ x > 0 \\ -2^{\lceil \log_2 |x| \rceil} & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floor2f/README.md b/lib/node_modules/@stdlib/math/base/special/floor2f/README.md
index 6c9fde0b0946..0258e6405ac5 100644
--- a/lib/node_modules/@stdlib/math/base/special/floor2f/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floor2f/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a single-precision floating-point number to the nearest power of two toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floor2_function" align="center" raw="y = \begin{cases} 2^{\lfloor \log_2 x \rfloor} & \textrm{if}\ x > 0 \\ -2^{\lceil \log_2 |x| \rceil} & \textrm{if}\ x < 0 \end{cases}" alt="Round down to nearest power of two"> -->
+
+```math
+y = \begin{cases} 2^{\lfloor \log_2 x \rfloor} & \textrm{if}\ x > 0 \\ -2^{\lceil \log_2 |x| \rceil} & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floorb/README.md b/lib/node_modules/@stdlib/math/base/special/floorb/README.md
index c262b2e1ac05..8670758300c8 100644
--- a/lib/node_modules/@stdlib/math/base/special/floorb/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floorb/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of b^n toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floorb_function" align="center" raw="y = \left\lfloor \frac{x}{b^n} \right\rfloor \cdot b^n" alt="Round down to nearest multiple of b^n"> -->
+
+```math
+y = \left\lfloor \frac{x}{b^n} \right\rfloor \cdot b^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floorf/README.md b/lib/node_modules/@stdlib/math/base/special/floorf/README.md
index 513c4f1f5e99..f2bb29145d87 100644
--- a/lib/node_modules/@stdlib/math/base/special/floorf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floorf/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a single-precision floating-point numeric value toward negative infinity.
 
+<section class="intro">
+
+The [floor function][floor-function] is defined as
+
+<!-- <equation class="equation" label="eq:floor_function" align="center" raw="y = \lfloor x \rfloor = \max\{ n \in \mathbb{Z} : n \leq x \}" alt="Floor function"> -->
+
+```math
+y = \lfloor x \rfloor = \max\{ n \in \mathbb{Z} : n \leq x \}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -179,6 +195,8 @@ int main( void ) {
 
 <section class="links">
 
+[floor-function]: https://en.wikipedia.org/wiki/Floor_and_ceiling_functions
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceilf]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceilf
diff --git a/lib/node_modules/@stdlib/math/base/special/floorn/README.md b/lib/node_modules/@stdlib/math/base/special/floorn/README.md
index 12d05141022e..d5a87cc048e5 100644
--- a/lib/node_modules/@stdlib/math/base/special/floorn/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floorn/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a double-precision floating-point number to the nearest multiple of 10^n toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floorn_function" align="center" raw="y = \left\lfloor \frac{x}{10^n} \right\rfloor \cdot 10^n" alt="Round down to n decimal places"> -->
+
+```math
+y = \left\lfloor \frac{x}{10^n} \right\rfloor \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floornf/README.md b/lib/node_modules/@stdlib/math/base/special/floornf/README.md
index ac32b895fbd3..d30b7cf2981f 100644
--- a/lib/node_modules/@stdlib/math/base/special/floornf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floornf/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a single-precision floating-point number to the nearest multiple of 10^n toward negative infinity.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:floorn_function" align="center" raw="y = \left\lfloor \frac{x}{10^n} \right\rfloor \cdot 10^n" alt="Round down to n decimal places"> -->
+
+```math
+y = \left\lfloor \frac{x}{10^n} \right\rfloor \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/floorsd/README.md b/lib/node_modules/@stdlib/math/base/special/floorsd/README.md
index cb967e5c925b..d8f9c213aded 100644
--- a/lib/node_modules/@stdlib/math/base/special/floorsd/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/floorsd/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a numeric value to the nearest number toward negative infinity with N significant figures.
 
+<section class="intro">
+
+The function rounds a numeric value to the specified number of [significant figures][significant-figures] toward negative infinity
+
+<!-- <equation class="equation" label="eq:floorsd_function" align="center" raw="y = \left\lfloor x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} \right\rfloor \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}" alt="Round down to n significant figures"> -->
+
+```math
+y = \left\lfloor x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} \right\rfloor \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -192,6 +208,8 @@ int main( void ) {
 
 <section class="links">
 
+[significant-figures]: https://en.wikipedia.org/wiki/Significant_figures
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceilsd]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceilsd
diff --git a/lib/node_modules/@stdlib/math/base/special/round-nearest-even/README.md b/lib/node_modules/@stdlib/math/base/special/round-nearest-even/README.md
index 69121fe3abc5..a341b9557594 100644
--- a/lib/node_modules/@stdlib/math/base/special/round-nearest-even/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/round-nearest-even/README.md
@@ -22,6 +22,12 @@ limitations under the License.
 
 > Round a double-precision floating-point number to the nearest integer value with ties rounding to the nearest even integer.
 
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/round/README.md b/lib/node_modules/@stdlib/math/base/special/round/README.md
index c6410e3b7c84..2ac18fec9014 100644
--- a/lib/node_modules/@stdlib/math/base/special/round/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/round/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest integer.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:round_function" align="center" raw="y = \lfloor x + 0.5 \rfloor" alt="Round to nearest integer"> -->
+
+```math
+y = \lfloor x + 0.5 \rfloor
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/round10/README.md b/lib/node_modules/@stdlib/math/base/special/round10/README.md
index e82a6c4b5c83..0e2174f1a0e9 100644
--- a/lib/node_modules/@stdlib/math/base/special/round10/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/round10/README.md
@@ -22,6 +22,12 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of 10 on a linear scale.
 
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/round10f/README.md b/lib/node_modules/@stdlib/math/base/special/round10f/README.md
index a4c9ae1af755..ec8ed320ea27 100644
--- a/lib/node_modules/@stdlib/math/base/special/round10f/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/round10f/README.md
@@ -22,6 +22,12 @@ limitations under the License.
 
 > Round a single-precision floating-point number to the nearest power of 10 on a linear scale.
 
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/round2/README.md b/lib/node_modules/@stdlib/math/base/special/round2/README.md
index 3cd0f351f932..1c226759af27 100644
--- a/lib/node_modules/@stdlib/math/base/special/round2/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/round2/README.md
@@ -22,6 +22,12 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of two on a linear scale.
 
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/roundb/README.md b/lib/node_modules/@stdlib/math/base/special/roundb/README.md
index 31b084e6e009..5e2b08e95150 100644
--- a/lib/node_modules/@stdlib/math/base/special/roundb/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/roundb/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of b^n on a linear scale.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:roundb_function" align="center" raw="y = \left\lfloor \frac{x}{b^n} + 0.5 \right\rfloor \cdot b^n" alt="Round to nearest multiple of b^n"> -->
+
+```math
+y = \left\lfloor \frac{x}{b^n} + 0.5 \right\rfloor \cdot b^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/roundf/README.md b/lib/node_modules/@stdlib/math/base/special/roundf/README.md
index bcc091c5d154..12d5f37a5509 100644
--- a/lib/node_modules/@stdlib/math/base/special/roundf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/roundf/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a single-precision floating-point number to the nearest integer.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:round_function" align="center" raw="y = \lfloor x + 0.5 \rfloor" alt="Round to nearest integer"> -->
+
+```math
+y = \lfloor x + 0.5 \rfloor
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/roundn/README.md b/lib/node_modules/@stdlib/math/base/special/roundn/README.md
index 8ba552480b04..74adb6a649dc 100644
--- a/lib/node_modules/@stdlib/math/base/special/roundn/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/roundn/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a double-precision floating-point number to the nearest multiple of 10^n.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:roundn_function" align="center" raw="y = \left\lfloor \frac{x}{10^n} + 0.5 \right\rfloor \cdot 10^n" alt="Round to n decimal places"> -->
+
+```math
+y = \left\lfloor \frac{x}{10^n} + 0.5 \right\rfloor \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/roundnf/README.md b/lib/node_modules/@stdlib/math/base/special/roundnf/README.md
index 667b29b0a91b..5498b43159d0 100644
--- a/lib/node_modules/@stdlib/math/base/special/roundnf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/roundnf/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a single-precision floating-point number to the nearest multiple of 10^n.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:roundn_function" align="center" raw="y = \left\lfloor \frac{x}{10^n} + 0.5 \right\rfloor \cdot 10^n" alt="Round to n decimal places"> -->
+
+```math
+y = \left\lfloor \frac{x}{10^n} + 0.5 \right\rfloor \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/roundsd/README.md b/lib/node_modules/@stdlib/math/base/special/roundsd/README.md
index f219dc7a20ce..988d2a09bba8 100644
--- a/lib/node_modules/@stdlib/math/base/special/roundsd/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/roundsd/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a double-precision floating-point number to the nearest value with `n` significant figures.
 
+<section class="intro">
+
+The function rounds a numeric value to the specified number of [significant figures][significant-figures]
+
+<!-- <equation class="equation" label="eq:roundsd_function" align="center" raw="y = \left\lfloor x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} + 0.5 \right\rfloor \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}" alt="Round to n significant figures"> -->
+
+```math
+y = \left\lfloor x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1} + 0.5 \right\rfloor \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -193,6 +209,8 @@ int main( void ) {
 
 <section class="links">
 
+[significant-figures]: https://en.wikipedia.org/wiki/Significant_figures
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceilsd]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceilsd
diff --git a/lib/node_modules/@stdlib/math/base/special/trunc/README.md b/lib/node_modules/@stdlib/math/base/special/trunc/README.md
index 064611949562..e5641ae6c94f 100644
--- a/lib/node_modules/@stdlib/math/base/special/trunc/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/trunc/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a double-precision floating-point number toward zero.
 
+<section class="intro">
+
+The [truncation function][truncation] rounds a numeric value toward zero
+
+<!-- <equation class="equation" label="eq:truncation_function" align="center" raw="y = \operatorname{trunc}(x) = \begin{cases} \lfloor x \rfloor & \textrm{if}\ x \geq 0 \\ \lceil x \rceil & \textrm{if}\ x < 0 \end{cases}" alt="Truncation function"> -->
+
+```math
+y = \mathop{\mathrm{trunc}}(x) = \begin{cases} \lfloor x \rfloor & \textrm{if}\ x \geq 0 \\ \lceil x \rceil & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -189,6 +205,8 @@ int main( void ) {
 
 <section class="links">
 
+[truncation]: https://en.wikipedia.org/wiki/Truncation
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceil]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceil
diff --git a/lib/node_modules/@stdlib/math/base/special/trunc10/README.md b/lib/node_modules/@stdlib/math/base/special/trunc10/README.md
index a17053b5d036..153c08d5c12e 100644
--- a/lib/node_modules/@stdlib/math/base/special/trunc10/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/trunc10/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of 10 toward zero.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:trunc10_function" align="center" raw="y = \operatorname{sgn}(x) \cdot 10^{\lfloor \log_{10} |x| \rfloor}" alt="Truncate to nearest power of ten"> -->
+
+```math
+y = \operatorname{sgn}(x) \cdot 10^{\lfloor \log_{10} |x| \rfloor}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/trunc2/README.md b/lib/node_modules/@stdlib/math/base/special/trunc2/README.md
index aa34c0ba3ce1..c574795d4e24 100644
--- a/lib/node_modules/@stdlib/math/base/special/trunc2/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/trunc2/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest power of two toward zero.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:trunc2_function" align="center" raw="y = \operatorname{sgn}(x) \cdot 2^{\lfloor \log_2 |x| \rfloor}" alt="Truncate to nearest power of two"> -->
+
+```math
+y = \operatorname{sgn}(x) \cdot 2^{\lfloor \log_2 |x| \rfloor}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/truncb/README.md b/lib/node_modules/@stdlib/math/base/special/truncb/README.md
index cdb45e6105ae..b2c484dbae1c 100644
--- a/lib/node_modules/@stdlib/math/base/special/truncb/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/truncb/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of b^n toward zero.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:truncb_function" align="center" raw="y = \operatorname{trunc}\left(\frac{x}{b^n}\right) \cdot b^n" alt="Truncate to nearest multiple of b^n"> -->
+
+```math
+y = \mathop{\mathrm{trunc}}\left(\frac{x}{b^n}\right) \cdot b^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/truncf/README.md b/lib/node_modules/@stdlib/math/base/special/truncf/README.md
index 0b1811a49625..2ce1fdca2df2 100644
--- a/lib/node_modules/@stdlib/math/base/special/truncf/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/truncf/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a single-precision floating-point number toward zero.
 
+<section class="intro">
+
+The [truncation function][truncation] rounds a numeric value toward zero
+
+<!-- <equation class="equation" label="eq:truncation_function" align="center" raw="y = \operatorname{trunc}(x) = \begin{cases} \lfloor x \rfloor & \textrm{if}\ x \geq 0 \\ \lceil x \rceil & \textrm{if}\ x < 0 \end{cases}" alt="Truncation function"> -->
+
+```math
+y = \mathop{\mathrm{trunc}}(x) = \begin{cases} \lfloor x \rfloor & \textrm{if}\ x \geq 0 \\ \lceil x \rceil & \textrm{if}\ x < 0 \end{cases}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -189,6 +205,8 @@ int main( void ) {
 
 <section class="links">
 
+[truncation]: https://en.wikipedia.org/wiki/Truncation
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceilf]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceilf
diff --git a/lib/node_modules/@stdlib/math/base/special/truncn/README.md b/lib/node_modules/@stdlib/math/base/special/truncn/README.md
index 04e960cf0457..438b96c695ff 100644
--- a/lib/node_modules/@stdlib/math/base/special/truncn/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/truncn/README.md
@@ -22,6 +22,20 @@ limitations under the License.
 
 > Round a numeric value to the nearest multiple of 10^n toward zero.
 
+<section class="intro">
+
+<!-- <equation class="equation" label="eq:truncn_function" align="center" raw="y = \operatorname{trunc}\left(\frac{x}{10^n}\right) \cdot 10^n" alt="Truncate to n decimal places"> -->
+
+```math
+y = \mathop{\mathrm{trunc}}\left(\frac{x}{10^n}\right) \cdot 10^n
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
diff --git a/lib/node_modules/@stdlib/math/base/special/truncsd/README.md b/lib/node_modules/@stdlib/math/base/special/truncsd/README.md
index d9c227c5176d..423fa251df3c 100644
--- a/lib/node_modules/@stdlib/math/base/special/truncsd/README.md
+++ b/lib/node_modules/@stdlib/math/base/special/truncsd/README.md
@@ -22,6 +22,22 @@ limitations under the License.
 
 > Round a numeric value to the nearest number toward zero with `n` significant figures.
 
+<section class="intro">
+
+The function rounds a numeric value to the specified number of [significant figures][significant-figures] toward zero
+
+<!-- <equation class="equation" label="eq:truncsd_function" align="center" raw="y = \operatorname{trunc}\left(x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1}\right) \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}" alt="Truncate to n significant figures"> -->
+
+```math
+y = \mathop{\mathrm{trunc}}\left(x \cdot b^{n - \lfloor \log_b |x| \rfloor - 1}\right) \cdot b^{\lfloor \log_b |x| \rfloor - n + 1}
+```
+
+<!-- </equation> -->
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -192,6 +208,8 @@ int main( void ) {
 
 <section class="links">
 
+[significant-figures]: https://en.wikipedia.org/wiki/Significant_figures
+
 <!-- <related-links> -->
 
 [@stdlib/math/base/special/ceilsd]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/ceilsd