From 0a53779a91bec25bb43dab956b61e104530bc292 Mon Sep 17 00:00:00 2001
From: Boyuan Yang <byang@debian.org>
Date: Wed, 30 Jan 2019 15:58:25 -0500
Subject: [PATCH] New upstream version 2.0.9.15

---
 CHANGELOG.md         |  11 +++
 debian/rules         |   2 +-
 src/base/dobject.cpp | 196 +++++++++++++++++++++++++++++++++++++++++++
 src/dtk_qmake.prf    |  54 ++++++++++--
 4 files changed, 256 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7db426e..4047f77 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,14 @@
+<a name="2.0.9.15"></a>
+## 2.0.9.15 (2019-01-25)
+
+
+#### Bug Fixes
+
+*   failed build the deepin-os-release on Qt 5.7.1 ([8bae8654](https://github.com/linuxdeepin/dtkcore/commit/8bae8654bdb20a7f773130d22b9db139460ba575))
+*   use main project c/cxx/ld flags on build deepin-os-release ([86dbd507](https://github.com/linuxdeepin/dtkcore/commit/86dbd507c1b3b101c1816f091782430ec1ce20ce))
+
+
+
 <a name="2.0.9.14"></a>
 ## 2.0.9.14 (2019-01-02)
 
diff --git a/debian/rules b/debian/rules
index 06264e9..46a20fc 100755
--- a/debian/rules
+++ b/debian/rules
@@ -8,7 +8,7 @@ DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)
 ifneq (,$(wildcard .git/config))
 	CONFIG_VERSION=
 else
-VERSION = $(shell dpkg-parsechangelog -ldebian/changelog -SVersion)
+VERSION = $(DEB_VERSION_UPSTREAM)
 _PACK_VER = $(shell echo $(VERSION) | awk -F'[+_~-]' '{print $$1}')
 _BUILD_VER = $(shell echo $(VERSION) | awk -F'[+_~-]' '{print $$2}' | sed 's/[^0-9]//g')
 ifeq ($(_BUILD_VER),)
diff --git a/src/base/dobject.cpp b/src/base/dobject.cpp
index 5f3cd7f..ac93d73 100644
--- a/src/base/dobject.cpp
+++ b/src/base/dobject.cpp
@@ -31,11 +31,207 @@ DObjectPrivate::~DObjectPrivate()
 
 }
 
+/*!
+ * \~chinese \file dobject.h
+ * \~chinese \brief 一些宏的定义
+*/
+
+/*!
+ * \~chinese \def D_DECLARE_PRIVATE(Class)
+ *
+ * \~chinese \brief 这个宏一定要放到类的私有区域，它定义了 d_func() 这个函数用于返回私有类的对象，
+ * \~chinese 这个对象只应该在类的内部使用，另外将私有类声明为公开类的友元类。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_D D_DC
+*/
+
+/*!
+ * \~chinese \def D_DECLARE_PUBLIC(Class)
+ *
+ * \~chinese \brief 这个宏用于私有类中，它定义了 q_func() 这个函数用于返回公开类的对象，另外将公开类
+ * \~chinese 声明为私有类的友元类。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRIVATE D_Q D_QC
+*/
+
+/*!
+ * \~chinese \def D_D(Class)
+ *
+ * \~chinese \brief 这个宏用于公开类中，它定义了一个名字为 d 的变量存储 d_func() 的返回值。用于在公开
+ * \~chinese 类中需要访问私有类的数据成员的函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRVATE D_DC
+*/
+
+/*!
+ * \~chinese \def D_DC(Class)
+ *
+ * \~chinese \brief 同 D_D，用在公开类加了 const 修饰符的成员函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PRVATE D_D
+*/
+
+/*!
+ * \~chinese \def D_Q(Class)
+ *
+ * \~chinese \brief 这个宏用于私有类中，它定义了一个名字为 q 的变量存储 q_func() 的返回值。用于在私有
+ * \~chinese 类中需要调用公开类的成员函数时。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_QC
+*/
+
+/*!
+ * \~chinese \def D_QC(Class)
+ *
+ * \~chinese \brief 同 D_Q，用在私有类加了 const 修饰符的成员函数中。
+ * \~chinese \param Class 公开类的类名
+ * \~chinese \sa D_DECLARE_PUBLIC D_Q
+*/
+
+/*!
+ * \~chinese \def D_PRIVATE_SLOT(Func)
+ *
+ * \~chinese \brief 同 Q_PRIVATE_SLOT，用在继承了 QObject 的公开类中，在公开类中定一个槽函数，且函数
+ * \~chinese 必须在私有类中有实现。用这个方式定义的槽函数无法被直接调用，只能用于 QObject::connect
+ * \~chinese 使用 SIGNAL 和 SLOT 的方式连接信号，或者使用 QMetaObject::invokeMethod 调用。
+ * \~chinese 一般来讲，这个槽函数应该只在类内部使用，外界不应该通过任何方式来调用它。
+ *
+ * \~chinese 例子：
+ *
+ * \~chinese a.h
+ * \code
+ * class APrivate;
+ * class A : public DObject
+ * {
+ *     D_DECLARE_PRIVATE(A)
+ * public:
+ *     A();
+ *
+ * protected:
+ *     A(APrivate &dd, DObject *parent = nullptr);
+ *
+ * private:
+ *     D_PRIVATE_SLOT(void _q_testSlot() const)
+ * };
+ * \endcode
+ * \~chinese a.cpp
+ * \code
+ * class APrivate : public DObjectPrivate
+ * {
+ * public:
+ *     D_DECLARE_PUBLIC(A)
+ *
+ *     APrivate(A *qq)
+ *         : DObjectPrivate(qq)
+ *     {
+ *         QTimer *timer = new QTimer();
+ *         QObject::connect(timer, SIGNAL(timeout()), qq, SLOT(_q_testSlot()));
+ *         timer->start(1000);
+ *     }
+ *
+ *     void _q_testSlot() const
+ *     {
+ *         qDebug() << "slot";
+ *     }
+ * };
+ *
+ * A::A()
+ *     : DObject(*new APrivate(this))
+ * {
+ *
+ * }
+ *
+ * A::A(APrivate &dd, DObject *parent)
+ *     : DObject(dd, parent)
+ * {
+ *
+ * }
+ *
+ * #include "moc_a.cpp"
+ * \endcode
+ * \~chinese \param Func 槽函数的完整签名
+ * \~chinese \note 添加或更新私有槽之后需要重新手动调用 qmake
+ * \~chinese \sa D_DECLARE_PUBLIC D_Q
+*/
+
+/*!
+ * \~chinese \class DObject
+ * \~chinese \brief deepin-tool-kit 中所有公开类的祖先类。
+ *
+ * \~chinese 通过和 \ref D_DECLARE_PRIVATE 、\ref D_DECLARE_PUBLIC
+ * \~chinese 等宏的配合方便派生类中实现 D-Point 结构。虽然 QObject 中已经有了这样的实现结构，但是没有
+ * \~chinese 办法在不使用 Qt 私有模块的情况下，在 DTK 库中达到同样的目的。D-Point 结构由“公共接口类”
+ * \~chinese 和“私有数据类”两部分组成，在 DTK 中，DObjectPrivate 是所有数据类的祖先类。在这种结构下，
+ * \~chinese 只有 DObject 这个基类中定了一个指向于私有数据类的对象指针，派生类中不会也不应该再定义任何
+ * \~chinese 成员变量，派生类中需要添加数据成员时，可以继承 DObjectPrivate，将新的成员变量放到私有类中
+ *
+ * \~chinese 例子：
+ *
+ * \~chinese a.h
+ * \code
+ * class APrivate;
+ * class A : public DObject
+ * {
+ *     D_DECLARE_PRIVATE(A)
+ * public:
+ *     A();
+ *     int test() const;
+ *
+ * protected:
+ *     A(APrivate &dd, DObject *parent = nullptr);
+ * };
+ * \endcode
+ * \~chinese a.cpp
+ * \code
+ * class APrivate : public DObjectPrivate
+ * {
+ * public:
+ *     APrivate(A *qq)
+ *         : DObjectPrivate(qq)
+ *     {
+ *
+ *     }
+ *
+ *     D_DECLARE_PUBLIC(A)
+ *     // 此处添加数据成员
+ *     int data;
+ * };
+ *
+ * A::A()
+ *     : DObject(*new APrivate(this))
+ * {
+ *
+ * }
+ *
+ * int test() const
+ * {
+ *     D_D(A);
+ *
+ *     return d->data;
+ * }
+ *
+ * A::A(APrivate &dd, DObject *parent)
+ *     : DObject(dd, parent)
+ * {
+ *
+ * }
+ * \endcode
+ * 一般来讲，DObject 只会用在 DTK 库中定义的类，对于使用 DTK 库的应用程序来说不用关心它的存在
+ * \~chinese \sa \href{https://wiki.qt.io/D-Pointer/zh,类的 D-Point 结构}
+ */
+
+/*!
+ * \~chinese \brief 只有在不需要数据成员的派生类中才会使用
+ */
 DObject::DObject(DObject * /*parent = nullptr*/)
 {
 
 }
 
+/*!
+ * \~chinese \brief 在派生类中比较常用的构造函数
+ * \~chinese \param dd 私有类对象
+ */
 DObject::DObject(DObjectPrivate &dd, DObject * /*parent = nullptr*/):
     d_d_ptr(&dd)
 {
diff --git a/src/dtk_qmake.prf b/src/dtk_qmake.prf
index a32db43..872ed86 100644
--- a/src/dtk_qmake.prf
+++ b/src/dtk_qmake.prf
@@ -1,14 +1,56 @@
 CONFIG += host_$$QMAKE_HOST.arch
 DEFINES += Q_HOST_NAME=\\\"$$QMAKE_HOST.arch\\\" Q_HOST_$$upper($$QMAKE_HOST.arch)
 
-isEqual(TARGET, dtkcore) {
-    # build tools/deepin-os-release first
-    QMAKE_CONFIG_TESTS_DIR_BAK=$$QMAKE_CONFIG_TESTS_DIR
+defineTest(buildQMAKEProject) {
+    pro_dir = $$1
+    pro_out_dir = $$shadowed($$pro_dir)
+    isEmpty(QMAKE_CD): QMAKE_CD=cd
+    pro_cmd_base = "$$QMAKE_CD $$system_quote($$system_path($$pro_out_dir)) &&"
+    mkpath($$pro_out_dir)
+    command = $$pro_cmd_base $$system_quote($$system_path($$QMAKE_QMAKE))
+    CONFIG(debug, debug|release) {
+        command += QMAKE_CFLAGS_DEBUG*=\"$$QMAKE_CFLAGS_DEBUG\" \
+            QMAKE_CXXFLAGS_DEBUG*=\"$$QMAKE_CXXFLAGS_DEBUG\" \
+            QMAKE_LFLAGS_DEBUG*=\"$$QMAKE_LFLAGS_DEBUG\" \
+            CONFIG+=debug
+    } else {
+        command += QMAKE_CFLAGS_RELEASE*=\"$$QMAKE_CFLAGS_RELEASE\" \
+            QMAKE_CXXFLAGS_RELEASE*=\"$$QMAKE_CXXFLAGS_RELEASE\" \
+            QMAKE_LFLAGS_RELEASE*=\"$$QMAKE_LFLAGS_RELEASE\"
+    }
+    command += -spec $$QMAKESPEC $$shell_quote($$pro_dir)
+    message($${command}:)
+    # Qt >= 5.8
+    greaterThan(QT_MINOR_VERSION, 7) {
+        !equals(3, false): 1 = "( $$1 ) 2>&1"
+        output = $$system("$$command", lines, result)
+        !isEmpty(output): message($$output)
+        !equals(result, 0): return(false)
+    } else {
+        system("$$command")|return(false)
+    }
     load(configure)
-    QMAKE_CONFIG_TESTS_DIR=$$_PRO_FILE_PWD_/../tools
-    qtCompileTest(deepin-os-release)
+    command = $$pro_cmd_base $$QMAKE_MAKE
+    message($${command}:)
+    # Qt >= 5.8
+    greaterThan(QT_MINOR_VERSION, 7) {
+        !equals(3, false): 1 = "( $$1 ) 2>&1"
+        output = $$system("$$command", lines, result)
+        !isEmpty(output): message($$output)
+        !equals(result, 0): return(false)
+    } else {
+        system("$$command")|return(false)
+    }
+    return(true)
+}
+
+isEqual(TARGET, dtkcore) {
     DEEPIN_OS_RELEASE_TOOL=$$_PRO_FILE_PWD_/../bin/deepin-os-release
-    QMAKE_CONFIG_TESTS_DIR=$$QMAKE_CONFIG_TESTS_DIR_BAK
+
+    !exists($$DEEPIN_OS_RELEASE_TOOL) {
+        tools_dir = $$_PRO_FILE_PWD_/../tools/deepin-os-release
+        !buildQMAKEProject($$tools_dir): error(Failed on build deepin-os-release)
+    }
 } else {
     isEmpty(QT.dtkcore.tools): error(QT += dtkcore first)
     DEEPIN_OS_RELEASE_TOOL=$${QT.dtkcore.tools}/deepin-os-release
-- 
2.30.2