From 116acebd102986303921d24209084b2c28e6416a Mon Sep 17 00:00:00 2001
From: Evilham <cvs@evilham.com>
Date: Tue, 15 Mar 2022 21:39:26 +0100
Subject: [PATCH] [__opendkim] Deprecate --userid

The parameter could produce inconsistencies permissions-wise.

Users of the type that need this functionality can still use:
--custom-config 'UserId $USERID'

Closes #17
---
 type/__opendkim/man.rst                     | 14 +++++++++-----
 type/__opendkim/parameter/deprecated/userid |  2 ++
 2 files changed, 11 insertions(+), 5 deletions(-)
 create mode 100644 type/__opendkim/parameter/deprecated/userid

diff --git a/type/__opendkim/man.rst b/type/__opendkim/man.rst
index e3f3e7a..996f16d 100644
--- a/type/__opendkim/man.rst
+++ b/type/__opendkim/man.rst
@@ -41,21 +41,25 @@ subdomains
 umask
   Set the umask for the socket and PID file.
 
-userid
-  Change the user the opendkim program is to run as.
-  By default, Alpine Linux's OpenRC service will set this to `opendkim` on the
-  command-line and FreeBSD's rc will set it to `mailnull`.
-
 custom-config
   The string following this parameter is appended as-is in the configuration, to
   enable more complex configurations.
 
+
 BOOLEAN PARAMETERS
 ------------------
 syslog
   Log to syslog.
 
 
+DEPRECATED PARAMETERS
+---------------------
+userid
+  Change the user the opendkim program is to run as.
+  By default, Alpine Linux's OpenRC service will set this to `opendkim` on the
+  command-line and FreeBSD's rc will set it to `mailnull`.
+
+
 EXAMPLES
 --------
 
diff --git a/type/__opendkim/parameter/deprecated/userid b/type/__opendkim/parameter/deprecated/userid
new file mode 100644
index 0000000..1815a0a
--- /dev/null
+++ b/type/__opendkim/parameter/deprecated/userid
@@ -0,0 +1,2 @@
+This can cause inconsistencies with permissions and will stop being supported.
+If you still need this, you can use --custom-config 'UserId $USERID'.