From 54e609d65725ac6683714d365b65d3cf7832dd97 Mon Sep 17 00:00:00 2001
From: Andrew Gallant <jamslam@gmail.com>
Date: Fri, 7 Jul 2023 10:45:06 -0400
Subject: [PATCH] doc: add another example for the config file

Closes #2453
---
 doc/rg.1.txt.tpl | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/rg.1.txt.tpl b/doc/rg.1.txt.tpl
index ee37744f..62ef5630 100644
--- a/doc/rg.1.txt.tpl
+++ b/doc/rg.1.txt.tpl
@@ -232,6 +232,16 @@ would behave identically to the following command
 
     rg --glob '!.git' foo
 
+The bottom line is that every shell argument needs to be on its own line. So
+for example, a config file containing
+
+    -j 4
+
+is probably not doing what you intend. Instead, you want
+
+    -j
+    4
+
 ripgrep also provides a flag, *--no-config*, that when present will suppress
 any and all support for configuration. This includes any future support
 for auto-loading configuration files from pre-determined paths.