From ad634c0a9411ff0a6b98c06e5389b7d491c235dd Mon Sep 17 00:00:00 2001
From: Robert Helgesson <robert@rycee.net>
Date: Wed, 13 Jun 2018 23:51:53 +0200
Subject: [PATCH] compton: use docbook man page references

---
 modules/services/compton.nix | 47 +++++++++++++++++++++++++++---------
 1 file changed, 36 insertions(+), 11 deletions(-)

diff --git a/modules/services/compton.nix b/modules/services/compton.nix
index b6e85f04..a564cf9e 100644
--- a/modules/services/compton.nix
+++ b/modules/services/compton.nix
@@ -75,7 +75,12 @@ in {
       ];
       description = ''
         List of windows to exclude background blur.
-        See <literal>compton(1)</literal> man page for more examples.
+        See the
+        <citerefentry>
+          <refentrytitle>compton</refentrytitle>
+          <manvolnum>1</manvolnum>
+        </citerefentry>
+        man page for more examples.
       '';
     };
 
@@ -115,7 +120,12 @@ in {
       ];
       description = ''
         List of conditions of windows that should not be faded.
-        See <literal>compton(1)</literal> man page for more examples.
+        See the
+        <citerefentry>
+          <refentrytitle>compton</refentrytitle>
+          <manvolnum>1</manvolnum>
+        </citerefentry>
+        man page for more examples.
       '';
     };
 
@@ -155,7 +165,12 @@ in {
       ];
       description = ''
         List of conditions of windows that should have no shadow.
-        See <literal>compton(1)</literal> man page for more examples.
+        See the
+        <citerefentry>
+          <refentrytitle>compton</refentrytitle>
+          <manvolnum>1</manvolnum>
+        </citerefentry>
+        man page for more examples.
       '';
     };
 
@@ -195,7 +210,12 @@ in {
       ];
       description = ''
         List of opacity rules.
-        See <literal>compton(1)</literal> man page for more examples.
+        See the
+        <citerefentry>
+          <refentrytitle>compton</refentrytitle>
+          <manvolnum>1</manvolnum>
+        </citerefentry>
+        man page for more examples.
       '';
     };
 
@@ -208,13 +228,18 @@ in {
     };
 
     vSync = mkOption {
-     type = types.str;
-     default = "none";
-     example = "opengl-swc";
-     description = ''
-       Enable vertical synchronization using the specified method.
-       See <literal>compton(1)</literal> man page available methods.
-     '';
+      type = types.str;
+      default = "none";
+      example = "opengl-swc";
+      description = ''
+        Enable vertical synchronization using the specified method.
+        See the
+        <citerefentry>
+          <refentrytitle>compton</refentrytitle>
+          <manvolnum>1</manvolnum>
+        </citerefentry>
+        man page for available methods.
+      '';
     };
 
     refreshRate = mkOption {