From c015f0ce15b025201bd5ffc30d55ab020f45a4f7 Mon Sep 17 00:00:00 2001
From: "Harry T. Vennik" <htvennik@gmail.com>
Date: Sat, 4 Nov 2017 12:57:55 +0100
Subject: [PATCH] Improved documentation comments

- Reformat
- Added warning against usage of direct DBusAny constructor in user code
---
 source/ddbus/thin.d | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/source/ddbus/thin.d b/source/ddbus/thin.d
index 4009607..0cc9707 100644
--- a/source/ddbus/thin.d
+++ b/source/ddbus/thin.d
@@ -175,15 +175,24 @@ struct DBusAny {
     ubyte[] binaryData;
   }
 
-  /// Manually creates a DBusAny object using a type, signature and implicit specifier.
+  /++
+    Manually creates a DBusAny object using a type, signature and explicit
+    variant specifier.
+
+    Direct use of this constructor from user code should be avoided.
+   +/
   this(int type, string signature, bool explicit) {
     this.type = type;
     this.signature = signature;
     this.explicitVariant = explicit;
   }
 
-  /// Automatically creates a DBusAny object with fitting parameters from a D type or Variant!T.
-  /// Pass a `Variant!T` to make this an explicit variant.
+  /++
+    Automatically creates a DBusAny object with fitting parameters from a D
+    type or Variant!T.
+
+    Pass a `Variant!T` to make this an explicit variant.
+   +/
   this(T)(T value) {
     static if (is(T == byte) || is(T == ubyte)) {
       this(typeCode!byte, null, false);