From 9757bc0002dbdb436feb63be808676a60f7d9030 Mon Sep 17 00:00:00 2001
From: RollingStar <RollingStar@users.noreply.github.com>
Date: Sat, 29 Oct 2022 03:01:34 -0400
Subject: [PATCH 1/2] Sort and comment "replace"

---
 beets/config_default.yaml | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/beets/config_default.yaml b/beets/config_default.yaml
index 40598ae6a..514f7264c 100644
--- a/beets/config_default.yaml
+++ b/beets/config_default.yaml
@@ -40,14 +40,25 @@ ignore: [".*", "*~", "System Volume Information", "lost+found"]
 ignore_hidden: yes
 
 replace:
+    # Bad chars to _
+    # prohibited in many filesystem paths
+    '[<>:\?\*\|]': _
+    # double quotation mark "
+    "\"": _
+    # \ or /
     '[\\/]': _
+    # starting and closing periods
     '^\.': _
-    '[\x00-\x1f]': _
-    '[<>:"\?\*\|]': _
     '\.$': _
+    # control characters
+    '[\x00-\x1f]': _
+    # dash at the start of a filename (causes command line ambiguity)
+    # https://unix.stackexchange.com/questions/16357/usage-of-dash-in-place-of-a-filename
+    '^-': _
+    # Bad chars to nothing
+    # starting and closing whitespace
     '\s+$': ''
     '^\s+': ''
-    '^-': _
 path_sep_replace: _
 drive_sep_replace: _
 asciify_paths: false

From 409f2f85cb8b437878b1d5c8c18dfc787b328f9d Mon Sep 17 00:00:00 2001
From: RollingStar <RollingStar@users.noreply.github.com>
Date: Sun, 30 Oct 2022 20:43:05 -0400
Subject: [PATCH 2/2] Update config_default.yaml

---
 beets/config_default.yaml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/beets/config_default.yaml b/beets/config_default.yaml
index 514f7264c..2798b3872 100644
--- a/beets/config_default.yaml
+++ b/beets/config_default.yaml
@@ -40,12 +40,12 @@ ignore: [".*", "*~", "System Volume Information", "lost+found"]
 ignore_hidden: yes
 
 replace:
-    # Bad chars to _
+    # Replace bad characters with _
     # prohibited in many filesystem paths
     '[<>:\?\*\|]': _
     # double quotation mark "
-    "\"": _
-    # \ or /
+    '\"': _
+    # path separators: \ or /
     '[\\/]': _
     # starting and closing periods
     '^\.': _
@@ -53,9 +53,8 @@ replace:
     # control characters
     '[\x00-\x1f]': _
     # dash at the start of a filename (causes command line ambiguity)
-    # https://unix.stackexchange.com/questions/16357/usage-of-dash-in-place-of-a-filename
     '^-': _
-    # Bad chars to nothing
+    # Replace bad characters with nothing
     # starting and closing whitespace
     '\s+$': ''
     '^\s+': ''