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] 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