From 78751ce780f18811fe2e878ba10be18d55c58e4d Mon Sep 17 00:00:00 2001
From: Kohei Yoshida <kohei.yoshida@collabora.com>
Date: Wed, 25 Jun 2014 20:02:59 -0400
Subject: Add class descriptions.  These two classes' roles were not very
 clear.

Change-Id: Ib45c9037f2c4b3ee5bfed79f3c93e5020bac477b
---
 chart2/source/inc/CachedDataSequence.hxx   |  3 +++
 chart2/source/inc/UncachedDataSequence.hxx | 10 ++++++++++
 2 files changed, 13 insertions(+)

diff --git a/chart2/source/inc/CachedDataSequence.hxx b/chart2/source/inc/CachedDataSequence.hxx
index e4c9d80f407f..243eea5d12bc 100644
--- a/chart2/source/inc/CachedDataSequence.hxx
+++ b/chart2/source/inc/CachedDataSequence.hxx
@@ -56,6 +56,9 @@ typedef ::cppu::WeakComponentImplHelper7<
     CachedDataSequence_Base;
 }
 
+/**
+ * This sequence object does store actual values within, hence "cached".
+ */
 class CachedDataSequence :
         public ::comphelper::OMutexAndBroadcastHelper,
         public ::comphelper::OPropertyContainer,
diff --git a/chart2/source/inc/UncachedDataSequence.hxx b/chart2/source/inc/UncachedDataSequence.hxx
index 2d31d9779d3f..a87b798ceed0 100644
--- a/chart2/source/inc/UncachedDataSequence.hxx
+++ b/chart2/source/inc/UncachedDataSequence.hxx
@@ -61,6 +61,16 @@ typedef ::cppu::WeakComponentImplHelper8<
     UncachedDataSequence_Base;
 }
 
+/**
+ * This sequence object does NOT store actual sequence data.  Instead, it
+ * references a column inside the internal data table (represented by class
+ * InternalData) via range representation string.  The range representation
+ * string ends with a numeric value that indicates the column index within
+ * the internal data table.
+ *
+ * <p>A range representation can be either '0', '1', '2', ..., or 'label 1',
+ * 'label 2', ....</p>
+ */
 class UncachedDataSequence :
         public ::comphelper::OMutexAndBroadcastHelper,
         public ::comphelper::OPropertyContainer,
-- 
cgit v1.2.3