From 91df6f01243c2e866dec3f4624aa602e40a2c201 Mon Sep 17 00:00:00 2001
From: Lars Wirzenius <liw@liw.fi>
Date: Sat, 29 Aug 2015 19:05:39 +0300
Subject: Update manual page wrt string list options

---
 cliapp.5 | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

(limited to 'cliapp.5')

diff --git a/cliapp.5 b/cliapp.5
index bc2fa4d..0170d2a 100644
--- a/cliapp.5
+++ b/cliapp.5
@@ -96,16 +96,25 @@ and multiple patterns are allowed.
 On the command line,
 that happens by using the option multiple times.
 In the configuration file,
-all values are given on one line,
+all values are given on one logical line,
 separated by commas.
+.PP
 This is a non-standard extension to the INI file syntax.
-There is no way to escape commas.
+.PP
+To include an item that itself contains a comma,
+surround the item with double quotes.
+There is no way to escape double quotes.
 .PP
 Example:
 .IP
 .nf
 [config]
-pattern = foo, bar, foobar
+pattern = foo, bar, foobar, "hello, world"
+.fi
+.PP
+Note than in versions of cliapp prior to 1.20150829,
+the command line option would also break values with commas.
+This has since been fixed.
 .SS "Boolean (true/false or on/off or yes/no) settings"
 When a setting can be either on or off,
 it's called a Boolean setting.
-- 
cgit v1.2.1