[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-commits
Subject: KDE/kdepimlibs/microblog
From: Tom Albers <tomalbers () kde ! nl>
Date: 2009-04-07 20:35:08
Message-ID: 1239136508.711447.7661.nullmailer () svn ! kde ! org
[Download RAW message or body]
SVN commit 950813 by toma:
Fill in the doxygen page (per req. winterz), add an example and reindent.
CCMAIL: winter@kde.org
M +5 -2 Mainpage.dox
M +3 -3 microblog_export.h
M +14 -3 statusitem.h
--- trunk/KDE/kdepimlibs/microblog/Mainpage.dox #950812:950813
@@ -3,11 +3,14 @@
*
* @section purpose Purpose
*
- * Microblog provides...
+ * Microblog provides some helper functions for the Microblog Akonadi Resource.
*
* @section desc Description
*
- * Microblog is a library for ...
+ * Microblog is a library for using the Microblog Akonadi Resource. The Microblog
+ * Akonadi resource stores the payload in Akonadi as a StatusItem. Each application
+ * that wants to use this payload needs to use the StatusItem to get to the single
+ * representation of tweets and dents.
*
* @authors
* The major authors of this library are:\n
--- trunk/KDE/kdepimlibs/microblog/microblog_export.h #950812:950813
@@ -25,16 +25,16 @@
#ifndef MICROBLOG_EXPORT
# if defined(MAKE_MICROBLOG_LIB)
- /* We are building this library */
+/* We are building this library */
# define MICROBLOG_EXPORT KDE_EXPORT
# else
- /* We are using this library */
+/* We are using this library */
# define MICROBLOG_EXPORT KDE_IMPORT
# endif
#endif
/**
- @namespace Microblog
+ @namespace Microblog
@brief
Contains all the Microblog library global classes, objects, and functions.
--- trunk/KDE/kdepimlibs/microblog/statusitem.h #950812:950813
@@ -26,7 +26,8 @@
#include <QtCore/QByteArray>
#include <QtCore/QDateTime>
-namespace Microblog {
+namespace Microblog
+{
/**
* @class StatusItem
@@ -34,11 +35,21 @@
* This class is a representation of one Dent or Tweet. It is filled with
* xml which the REST API from ident.ca or Teitter and parses it and gives
* back the values. Also include ares some convenience functions.
+ *
+ * For example to get from an Akonadi::Item to the date of a tweet:
+ * @code
+ * Akonadi::Item item = itemForIndex( index );
+ * if ( item.hasPayload<Akonadi::StatusItem>() ) {
+ * Microblog::StatusItem msg = item.payload<Akonadi::StatusItem>();
+ * return msg.date();
+ * }
+ * @endcode
+ *
* @since 4.3
*/
class MICROBLOG_EXPORT StatusItem
{
- public:
+public:
/** Constructor */
StatusItem();
@@ -82,7 +93,7 @@
/** Gives the raw xml data of the tweet or dent */
QByteArray data() const;
- private:
+private:
class Private;
QSharedDataPointer<Private> d;
};
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic