From eb4b1eb28f2605e48810be495f088bb55e0e5101 Mon Sep 17 00:00:00 2001
From: Keith Hall <kingkeith+github@gmail.com>
Date: Fri, 28 Jan 2022 22:15:26 +0200
Subject: [PATCH] README.md: Clarify --map-syntax argument

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index f108a943..2862c058 100644
--- a/README.md
+++ b/README.md
@@ -515,8 +515,9 @@ command line option. The option takes an argument of the form `pattern:syntax` w
 the absolute file path. The `syntax` part is the full name of a supported language
 (use `bat --list-languages` for an overview).
 
-Note: You probably want to use this option as an entry in `bat`s configuration file instead
-of passing it on the command line (see below).
+Note: You probably want to use this option as [an entry in `bat`s configuration file](#configuration-file)
+for persistence, instead of passing it on the command line as a one-off, as generally
+you'd just use `-l` unless you are passing multiple filenames as arguments.
 
 Example: To use "INI" syntax highlighting for all files with a `.conf` file extension, use
 ```bash