Blame SOURCES/0077-lokdocview-tilebuffer-Add-DOxygen-comments.patch

135360
From 490b3e99671ae4fee3b4e4bb2cc9b40e66f26e3c Mon Sep 17 00:00:00 2001
135360
From: Pranav Kant <pranavk@gnome.org>
135360
Date: Wed, 22 Jul 2015 20:25:36 +0530
135360
Subject: [PATCH 077/398] lokdocview, tilebuffer: Add DOxygen comments
135360
135360
Change-Id: I27377f0a758729a7877cfc6a56ea1b4bb3d1c3c9
135360
(cherry picked from commit e032b64451347f5079c2a5bfbfda8d843db91e2d)
135360
---
135360
 libreofficekit/source/gtk/lokdocview.cxx | 12 ++++++++++++
135360
 libreofficekit/source/gtk/tilebuffer.hxx |  5 +++++
135360
 2 files changed, 17 insertions(+)
135360
135360
diff --git a/libreofficekit/source/gtk/lokdocview.cxx b/libreofficekit/source/gtk/lokdocview.cxx
135360
index 0740e04dd6c8..ddb3c386b0ca 100644
135360
--- a/libreofficekit/source/gtk/lokdocview.cxx
135360
+++ b/libreofficekit/source/gtk/lokdocview.cxx
135360
@@ -36,6 +36,7 @@
135360
 // Number of handles around a graphic selection.
135360
 #define GRAPHIC_HANDLE_COUNT 8
135360
 
135360
+/// Private struct used by this GObject type
135360
 struct _LOKDocViewPrivate
135360
 {
135360
     gchar* m_aLOPath;
135360
@@ -162,6 +163,7 @@ G_DEFINE_TYPE_WITH_CODE (LOKDocView, lok_doc_view, GTK_TYPE_DRAWING_AREA,
135360
 
135360
 static GThreadPool* lokThreadPool;
135360
 
135360
+/// Helper struct used to pass the data from soffice thread -> main thread.
135360
 struct CallbackData
135360
 {
135360
     int m_nType;
135360
@@ -174,8 +176,16 @@ struct CallbackData
135360
           m_pDocView(pDocView) {}
135360
 };
135360
 
135360
+/**
135360
+   A struct that we use to store the data about the LOK call.
135360
+
135360
+   Object of this type is passed with all the LOK calls,
135360
+   so that they can be idenitified. Additionally, it also contains
135360
+   the data that LOK call needs.
135360
+*/
135360
 struct LOEvent
135360
 {
135360
+    /// To identify the type of LOK call
135360
     int m_nType;
135360
     const gchar* m_pCommand;
135360
     const gchar* m_pArguments;
135360
@@ -187,6 +197,8 @@ struct LOEvent
135360
     int m_nCharCode;
135360
     int m_nKeyCode;
135360
 
135360
+
135360
+    /// Constructor to easily instantiate an object for LOK call of `type' type.
135360
     LOEvent(int type)
135360
         : m_nType(type) {}
135360
 
135360
diff --git a/libreofficekit/source/gtk/tilebuffer.hxx b/libreofficekit/source/gtk/tilebuffer.hxx
135360
index 50de72d9d3b9..40fb2abbae6d 100644
135360
--- a/libreofficekit/source/gtk/tilebuffer.hxx
135360
+++ b/libreofficekit/source/gtk/tilebuffer.hxx
135360
@@ -131,6 +131,11 @@ class TileBuffer
135360
     Tile m_DummyTile;
135360
 };
135360
 
135360
+/**
135360
+   Helper struct used to pass the data from main thread to spawned threads.
135360
+   Spawned threads are responsible for calling paintTile, and store the result
135360
+   in tile buffer.
135360
+*/
135360
 struct GetTileCallbackData
135360
 {
135360
     int m_nX;
135360
-- 
135360
2.12.0
135360