From 64e0313090a655354dfdebfbaddb19d954d71cb2 Mon Sep 17 00:00:00 2001
From: Florian Bruhin <git@the-compiler.org>
Date: Mon, 2 Oct 2017 20:08:02 +0200
Subject: [PATCH] Fix commas in settings docs

Otherwise, asciidoc interprets it as a third parameter to the xref...

Fixes #3046
---
 doc/help/settings.asciidoc  | 4 ++--
 scripts/dev/src2asciidoc.py | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 864ffcf2f..642aec436 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -1944,7 +1944,7 @@ Default: +pass:[ask]+
 === content.user_stylesheets
 A list of user stylesheet filenames to use.
 
-Type: <<types,List of File, or File>>
+Type: <<types,List of File&#44; or File>>
 
 Default: empty
 
@@ -3065,7 +3065,7 @@ Default:
 === url.start_pages
 The page(s) to open at the start.
 
-Type: <<types,List of FuzzyUrl, or FuzzyUrl>>
+Type: <<types,List of FuzzyUrl&#44; or FuzzyUrl>>
 
 Default: +pass:[https://start.duckduckgo.com]+
 
diff --git a/scripts/dev/src2asciidoc.py b/scripts/dev/src2asciidoc.py
index 817b44a00..f12d6601b 100755
--- a/scripts/dev/src2asciidoc.py
+++ b/scripts/dev/src2asciidoc.py
@@ -416,7 +416,8 @@ def _generate_setting_option(f, opt):
     f.write("=== {}".format(opt.name) + "\n")
     f.write(opt.description + "\n")
     f.write("\n")
-    f.write('Type: <<types,{typ}>>\n'.format(typ=opt.typ.get_name()))
+    typ = opt.typ.get_name().replace(',', '&#44;')
+    f.write('Type: <<types,{typ}>>\n'.format(typ=typ))
     f.write("\n")
 
     valid_values = opt.typ.get_valid_values()