Add docs to WorkQueue and GlyphStore

1 files changed, 8 insertions, 1 deletions

diff --git a/src/mbgl/util/work_queue.hpp b/src/mbgl/util/work_queue.hpp
index dcec5668b9..55b687a468 100644
--- a/src/mbgl/util/work_queue.hpp
+++ b/src/mbgl/util/work_queue.hpp
@@ -14,11 +14,18 @@ namespace util {
 
 class RunLoop;
 
+// The WorkQueue will manage a queue of closures
+// and it will make sure they get executed on the
+// thread that created the WorkQueue. All pending
+// works are canceled when the queue gets destructed.
 class WorkQueue : private util::noncopyable {
 public:
     WorkQueue();
-    virtual ~WorkQueue();
+    ~WorkQueue();
 
+    // Push a closure to the queue. It is advised to
+    // only push tasks calling functions on the object
+    // that owns the queue to avoid use after free errors.
     void push(std::function<void()>&&);
 
 private: