From d5016384f49acf2706e34596ba1aad5ee9953d7a Mon Sep 17 00:00:00 2001
From: John Kenny <johnkenny54@yahoo.com>
Date: Fri, 20 Sep 2024 16:16:52 -0700
Subject: [PATCH 1/4] Added doc for cleanupXlink.

---
 docs/plugins/cleanupXlink.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 docs/plugins/cleanupXlink.md

diff --git a/docs/plugins/cleanupXlink.md b/docs/plugins/cleanupXlink.md
new file mode 100644
index 0000000..3fe4a61
--- /dev/null
+++ b/docs/plugins/cleanupXlink.md
@@ -0,0 +1,9 @@
+# cleanupXlink
+
+Changes `xlink:href` attributes to `href` attributes. If an `href` attribute is already present, the `xlink:href` attribute is removed.
+
+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.
+- The document has `<style>` elements with attribute selectors.

From 32e6c3295c59fafd424ff0704336f972661d13b9 Mon Sep 17 00:00:00 2001
From: John Kenny <johnkenny54@yahoo.com>
Date: Fri, 20 Sep 2024 17:21:35 -0700
Subject: [PATCH 2/4] Added preset-next docs.

---
 docs/preset-next.md | 73 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 docs/preset-next.md

diff --git a/docs/preset-next.md b/docs/preset-next.md
new file mode 100644
index 0000000..7958bcc
--- /dev/null
+++ b/docs/preset-next.md
@@ -0,0 +1,73 @@
+`preset-next` is the set of plugins that will become the [defaults](./preset-default.md) in version 6. To enable these plugins, use the
+`--preset=next` option on the command line.
+
+## Plugins List
+
+The following plugins are included in `preset-next`, in the order that they're executed:
+
+- removeDoctype
+- removeXMLProcInst
+- removeComments
+- removeMetadata
+- removeEditorsNSData
+- removeDesc
+- cleanupAttrs
+- [cleanupXlink](./plugins/cleanupXlink.md)
+- cleanupStyleAttributes
+- combineStyleElements
+- inlineStyles
+- minifyStyles
+- cleanupIds
+- removeUselessDefs
+- convertColors
+- [removeUnknownsAndDefaults](./plugins/removeUnknownsAndDefaults.md)
+- removeNonInheritableGroupAttrs
+- removeUselessStrokeAndFill
+- removeHiddenElems
+- removeEmptyText
+- minifyTransforms
+- convertEllipseToCircle
+- moveElemsAttrsToGroup
+- moveElemsStylesToGroup
+- collapseGroups
+- convertShapeToPath
+- combinePaths
+- minifyPathData
+- removeEmptyAttrs
+- removeEmptyContainers
+- removeUnusedNS
+
+## Disable a Plugin
+
+Sometimes a specific plugin might not be appropriate for your workflow. You can continue using `preset-default` while disabling any plugin by using the `overrides` parameter.
+
+In `overrides`, reference the plugin ID and set it to `false` to disable it:
+
+```js
+module.exports = {
+  plugins: [
+    {
+      name: 'preset-default',
+      params: {
+        overrides: {
+          cleanupIds: false,
+        },
+      },
+    },
+  ],
+};
+```
+
+Alternatively, you can drop `preset-default` entirely, and configure your own plugin pipeline from scratch, with only the desirable plugins:
+
+```js
+module.exports = {
+  plugins: [
+    'removeDoctype',
+    'removeXMLProcInst',
+    'minifyStyles',
+    'sortAttrs',
+    'sortDefsChildren',
+  ],
+};
+```

From 98dc8eeccf6318de1026085436b243208e0ea851 Mon Sep 17 00:00:00 2001
From: John Kenny <johnkenny54@yahoo.com>
Date: Sat, 21 Sep 2024 11:14:51 -0700
Subject: [PATCH 3/4] Added command line options to docs.

---
 docs/command-line-options.md | 72 ++++++++++++++++++++++++++++++++++++
 lib/svgo/coa.js              | 16 +++++---
 2 files changed, 82 insertions(+), 6 deletions(-)
 create mode 100644 docs/command-line-options.md

diff --git a/docs/command-line-options.md b/docs/command-line-options.md
new file mode 100644
index 0000000..e59a9a9
--- /dev/null
+++ b/docs/command-line-options.md
@@ -0,0 +1,72 @@
+# Command Line Options
+
+`-v, --version`  
+Output the version number.
+
+`-i, --input <INPUT...>`  
+One or more input files to process. Use "-" to take input from STDIN.
+
+`-s, --string <STRING>`  
+Process an input file specified as a string.
+
+`-f, --folder <FOLDER>`  
+Process all \*.svg files in the specified folder.
+
+`-o, --output <OUTPUT...>`  
+File or folder to which output should be written. If no output option is specified, the input file will be overwritten by the processed result. Use "-" to write output to STDOUT.
+
+`--preset <default | next | none>`  
+Specify which set of predefined plugins to use. If this option is not used, and no plugins are define by the `--config` option,
+[preset-default](./preset-default.md) is used.
+
+`--config <CONFIG>`  
+Custom configuration file.
+
+`--enable <plugin...>`  
+Specify one or more builtin plugins to run in addition to those specified by `--preset` or `--config`.
+
+`--disable <plugin...>`  
+Specify one or more plugins specified by `--preset` or `--config` which should not be run.
+
+`--datauri <base64 | enc | unenc>`  
+Output as Data URI string (base64), URI encoded (enc) or unencoded (unenc) rather than .svg.
+
+`--max-passes <INTEGER>`  
+Maximum number of iterations over the plugins. Must be an integer between 1 and 10. Default is 10.
+
+`--pretty`  
+Add line breaks and indentation to output.
+
+`--indent <INTEGER>`  
+Number of spaces to indent if `--pretty` is specified. Default is 4.
+
+`--eol <lf | crlf>`  
+Line break to use when outputting SVG. If unspecified, the platform default is used.
+
+`--final-newline`  
+Ensure output ends with a line break.
+
+`-r, --recursive`  
+If `--folder` is specified, process files in all sub-folders recursively.
+
+`--exclude <PATTERN...>`  
+If `--folder` is specified, exclude files matching any of the specified regular expression patterns.
+
+`-q, --quiet`  
+Only output error messages, not regular status messages.
+
+`--show-plugins`
+Show available plugins and exit.
+
+`--no-color`  
+Output messages in plain text without color.
+
+`-h, --help`  
+Display help for command line options.
+
+## Syntax
+
+If an option has exactly one value, it can be expressed either with or without an `=`, for example as `-i test.svg` or `-i=test.svg`.
+
+If an option has more than one value it can be expressed by followin the argument with the values separated by spaces,
+for example as `-i test1.svg test2.svg`.
diff --git a/lib/svgo/coa.js b/lib/svgo/coa.js
index 622bc36..8ee83a3 100644
--- a/lib/svgo/coa.js
+++ b/lib/svgo/coa.js
@@ -72,7 +72,7 @@ export default function makeProgram(program) {
       'Specify one or more plugins from the preset or config which should not be run ',
     )
     .option(
-      '--datauri <FORMAT>',
+      '--datauri <base64 | enc | unenc>',
       'Output as Data URI string (base64), URI encoded (enc) or unencoded (unenc)',
     )
     .option(
@@ -81,13 +81,17 @@ export default function makeProgram(program) {
       '10',
     )
     .option('--multipass', 'DEPRECATED - use --max-passes')
-    .option('--pretty', 'Make SVG pretty printed')
-    .option('--indent <INTEGER>', 'Indent number when pretty printing SVGs')
+    .option('--pretty', 'Add line breaks and indentation to output')
     .option(
-      '--eol <EOL>',
-      'Line break to use when outputting SVG: lf, crlf. If unspecified, uses platform default.',
+      '--indent <INTEGER>',
+      'Number of spaces to indent if --pretty is specified',
+      '4',
     )
-    .option('--final-newline', 'Ensure SVG ends with a line break')
+    .option(
+      '--eol <lf | crlf>',
+      'Line break to use when outputting SVG. If unspecified, the platform default is used',
+    )
+    .option('--final-newline', 'Ensure output ends with a line break')
     .option(
       '-r, --recursive',
       "Use with '--folder'. Optimizes *.svg files in folders recursively.",

From baca0aaba518480253fa8ff1855e3cfb76d5631b Mon Sep 17 00:00:00 2001
From: John Kenny <johnkenny54@yahoo.com>
Date: Sun, 22 Sep 2024 14:05:27 -0700
Subject: [PATCH 4/4] Create FAQ.

---
 README.md                       | 14 +++++---------
 docs/04-plugins/mergeStyles.mdx |  8 --------
 docs/command-line-options.md    |  2 ++
 docs/faq.md                     | 28 ++++++++++++++++++++++++++++
 4 files changed, 35 insertions(+), 17 deletions(-)
 delete mode 100644 docs/04-plugins/mergeStyles.mdx
 create mode 100644 docs/faq.md

diff --git a/README.md b/README.md
index 3187887..990a6ec 100644
--- a/README.md
+++ b/README.md
@@ -17,23 +17,19 @@ npm install -g svgo-ll
 
 ## Command-line usage
 
-Process single files:
+To process a single file with the default settings for **svgo-ll** version 5:
 
 ```sh
-svgo-ll one.svg two.svg -o one.min.svg two.min.svg
+svgo-ll -i one.svg -o one.min.svg
 ```
 
-Process a directory of files recursively with `-f`/`--folder`:
+To process a single file with the latest settings (which will become the defaults for **svgo-ll** version 6):
 
 ```sh
-svgo-ll -f path/to/directory_with_svgs -o path/to/output_directory
+svgo-ll --preset next -i one.svg -o one.min.svg
 ```
 
-Help for advanced usage:
-
-```sh
-svgo-ll --help
-```
+For more detailed options, see the [command line option documentation](https://github.com/svg-utils/svgo-ll/blob/main/docs/command-line-options.md) or [FAQ](https://github.com/svg-utils/svgo-ll/blob/main/docs/faq.md).
 
 ## Configuration
 
diff --git a/docs/04-plugins/mergeStyles.mdx b/docs/04-plugins/mergeStyles.mdx
deleted file mode 100644
index 0f33628..0000000
--- a/docs/04-plugins/mergeStyles.mdx
+++ /dev/null
@@ -1,8 +0,0 @@
----
-title: mergeStyles
-svgo:
-  pluginId: mergeStyles
-  defaultPlugin: true
----
-
-Merge multiple `<style>` elements into one.
diff --git a/docs/command-line-options.md b/docs/command-line-options.md
index e59a9a9..5f80b20 100644
--- a/docs/command-line-options.md
+++ b/docs/command-line-options.md
@@ -1,5 +1,7 @@
 # Command Line Options
 
+For examples of how these options can be used, see the [FAQ](./faq.md).
+
 `-v, --version`  
 Output the version number.
 
diff --git a/docs/faq.md b/docs/faq.md
new file mode 100644
index 0000000..7c67ca3
--- /dev/null
+++ b/docs/faq.md
@@ -0,0 +1,28 @@
+# FAQ
+
+Compression
+
+- [Just remove whitespace from a file](#comp-ws)
+- [Run a single plugin](#comp-1plugin)
+
+## Compression
+
+<a id="comp-1plugin"></a>
+
+### Run a single plugin
+
+Use `preset-none` and `--enable`. For example:
+
+```
+npx svgo-ll --preset none --enable minifyPathData -i test.svg
+```
+
+<a id="comp-ws"></a>
+
+### Just remove whitespace from a file
+
+Use `preset-none`. For example:
+
+```
+npx svgo-ll --preset none -i test.svg
+```