From df6d7f314227bafec6fce798f4019a48d6634a8e Mon Sep 17 00:00:00 2001
From: rnhmjoj <rnhmjoj@inventati.org>
Date: Tue, 9 Mar 2021 16:59:35 +0100
Subject: [PATCH] nixos/privoxy: document repeated settings

---
 nixos/modules/services/networking/privoxy.nix | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/nixos/modules/services/networking/privoxy.nix b/nixos/modules/services/networking/privoxy.nix
index b8d339163425..f1a9c6029cb0 100644
--- a/nixos/modules/services/networking/privoxy.nix
+++ b/nixos/modules/services/networking/privoxy.nix
@@ -165,15 +165,29 @@ in
       };
       default = {};
       example = literalExample ''
-        { listen-address = "[::]:8118";               # listen on IPv6 only
-          forward-socks5 = ".onion localhost:9050 ."; # forward .onion requests to Tor
+        { # Listen on IPv6 only
+          listen-address = "[::]:8118";
+
+          # Forward .onion requests to Tor
+          forward-socks5 = ".onion localhost:9050 .";
+
+          # Log redirects and filters
+          debug = [ 128 64 ];
+          # This is equivalent to writing these lines
+          # in the Privoxy configuration file:
+          # debug 128
+          # debug 64
         }
       '';
       description = ''
         This option is mapped to the main Privoxy configuration file.
         Check out the Privoxy user manual at
-        <link xlink:href="file://${pkgs.privoxy}/share/doc/privoxy/user-manual/config.html"/>
+        <link xlink:href="https://www.privoxy.org/user-manual/config.html"/>
         for available settings and documentation.
+
+        <note><para>
+          Repeated settings can be represented by using a list.
+        </para></note>
       '';
     };