From 6064aefd6e2c87243cd271cdeb03bf2a8eb1e0ed Mon Sep 17 00:00:00 2001
From: johnkenny54 <45182853+johnkenny54@users.noreply.github.com>
Date: Sat, 2 Nov 2024 10:20:45 -0700
Subject: [PATCH] Update docs. (#73)

---
 docs/plugins/cleanupTextElements.md | 16 ++++++++++++++++
 docs/plugins/minifyGradients.md     | 16 ++++++++++++++++
 docs/plugins/round.md               |  7 ++++++-
 docs/preset-default.md              |  2 ++
 docs/preset-next.md                 |  2 ++
 5 files changed, 42 insertions(+), 1 deletion(-)
 create mode 100644 docs/plugins/cleanupTextElements.md
 create mode 100644 docs/plugins/minifyGradients.md

diff --git a/docs/plugins/cleanupTextElements.md b/docs/plugins/cleanupTextElements.md
new file mode 100644
index 0000000..3fd293a
--- /dev/null
+++ b/docs/plugins/cleanupTextElements.md
@@ -0,0 +1,16 @@
+# cleanupTextElements
+
+Simplifies and merges `<text>` and `<tspan>` elements.
+
+## Details
+
+The plugin has no effect if:
+
+- The document has scripts.
+- The document has `<style>` elements.
+
+This plugin makes the following transformations:
+
+- Removes `xml:space="preserve"` if the element does not contain significant whitespace.
+- Removes unused `x` and `y` attributes from `<text>` elements.
+- Merges `<text>` and `<tspan>` elements where possible.
diff --git a/docs/plugins/minifyGradients.md b/docs/plugins/minifyGradients.md
new file mode 100644
index 0000000..7b57d69
--- /dev/null
+++ b/docs/plugins/minifyGradients.md
@@ -0,0 +1,16 @@
+# minifyGradients
+
+Simplifies and merges gradients.
+
+## Details
+
+The plugin has no effect if:
+
+- The document has scripts.
+- The document has `<style>` elements with CSS which **svgo-ll** is not able to process.
+
+This plugin makes the following transformations:
+
+- `stop` attributes are written in the shortest format (for example, `"90%"` becomes `".9"`).
+- If a gradient consists of a single solid color, any references to the gradient are changed to use the color itself.
+- If a gradient is used as a [template](https://svgwg.org/svg2-draft/pservers.html#PaintServerTemplates) and is only referenced once, the template is merged with the referencing gradient.
diff --git a/docs/plugins/round.md b/docs/plugins/round.md
index a680c09..9302879 100644
--- a/docs/plugins/round.md
+++ b/docs/plugins/round.md
@@ -6,6 +6,7 @@ Rounds numbers to a shorter form.
 
 - `coordDigits`: **number** - the number of digits after the decimal place to round x/y coordinates and width/height values (default: **4**)
 - `opacityDigits`: **number** - the number of digits after the decimal place to round opacity values (default: **3**)
+- `stopOffsetDigits`: **number** - the number of digits after the decimal place to round stop offset values (default: **3**)
 
 ## Details
 
@@ -30,8 +31,12 @@ If the dimension of the element or its ancestors cannot be determined, or if the
 
 ### Opacities
 
-`opacity` and `fill-opacity` values are rounded to the number of digits specified by the `opacityDigits` parameter.
+`opacity`, `fill-opacity`, and `stop-opacity` values are rounded to the number of digits specified by the `opacityDigits` parameter.
 
 ### Colors
 
 Any colors specified using RGB percentages are converted to integer RGB values, and minified as they are in the [minifyColors](./minifyColors.md) plugin.
+
+### Stop Offsets
+
+The `offset` attribute of `<stop>` elements is rounded to the number of digits specified by the `stopOffsetDigits` parameter.
diff --git a/docs/preset-default.md b/docs/preset-default.md
index bf58cb6..a035ab9 100644
--- a/docs/preset-default.md
+++ b/docs/preset-default.md
@@ -17,6 +17,7 @@ The following plugins are included in `preset-default`, in the order that they a
 - minifyStyles
 - [cleanupIds](./plugins/cleanupIds.md)
 - [minifyColors](./plugins/minifyColors.md)
+- [minifyGradients](./plugins/minifyGradients.md)
 - [removeUnknownsAndDefaults](./plugins/removeUnknownsAndDefaults.md)
 - removeNonInheritableGroupAttrs
 - removeUselessStrokeAndFill
@@ -31,3 +32,4 @@ The following plugins are included in `preset-default`, in the order that they a
 - removeEmptyContainers
 - removeUnusedNS
 - [createGroups](./plugins/createGroups.md)
+- [cleanupTextElements](./plugins/cleanupTextElements.md)
diff --git a/docs/preset-next.md b/docs/preset-next.md
index f55e225..52b7197 100644
--- a/docs/preset-next.md
+++ b/docs/preset-next.md
@@ -18,6 +18,7 @@ The following plugins are included in `preset-next`, in the order that they are
 - minifyStyles
 - [cleanupIds](./plugins/cleanupIds.md)
 - [minifyColors](./plugins/minifyColors.md)
+- [minifyGradients](./plugins/minifyGradients.md)
 - [removeUnknownsAndDefaults](./plugins/removeUnknownsAndDefaults.md)
 - removeNonInheritableGroupAttrs
 - removeUselessStrokeAndFill
@@ -32,3 +33,4 @@ The following plugins are included in `preset-next`, in the order that they are
 - removeEmptyContainers
 - removeUnusedNS
 - [createGroups](./plugins/createGroups.md)
+- [cleanupTextElements](./plugins/cleanupTextElements.md)