From 7f2f669c085c29dc6eaa0c1591afe779c20c17ec Mon Sep 17 00:00:00 2001
From: Jaroslav Barton <djaara@djaara.net>
Date: Mon, 27 Apr 2009 16:47:24 +0200
Subject: [PATCH] Updated doc in FignerManagerDevicesModel.

---
 src/FingerManagerDevicesModel.cpp | 47 +++++++++++++++++++++++++++++++++++++--
 src/FingerManagerDevicesModel.h   |  2 +-
 2 files changed, 46 insertions(+), 3 deletions(-)

diff --git a/src/FingerManagerDevicesModel.cpp b/src/FingerManagerDevicesModel.cpp
index 0151a5e..199ca40 100644
--- a/src/FingerManagerDevicesModel.cpp
+++ b/src/FingerManagerDevicesModel.cpp
@@ -1,13 +1,23 @@
 #include "FingerManagerDevicesModel.h"
 
+/**
+ * FingerManagerDevicesModel - data model for combo box.
+ */
 FingerManagerDevicesModel::FingerManagerDevicesModel(QObject *parent) :
 	QAbstractListModel(parent) {
 }
 
+/**
+ * destructor
+ */
 FingerManagerDevicesModel::~FingerManagerDevicesModel() {
 	devices.clear();
 }
 
+/**
+ * setDefault - set default device
+ * @param dev device
+ */
 void FingerManagerDevicesModel::setDefault(QString dev) {
 	for (int i = 0; i < devices.size(); i++) {
 		if (devices.at(i).device == dev) {
@@ -17,10 +27,19 @@ void FingerManagerDevicesModel::setDefault(QString dev) {
 	}
 }
 
+/**
+ * getDefault - return default device index
+ * @return int
+ */
 int FingerManagerDevicesModel::getDefault() {
 	return(default_);
 }
 
+/**
+ * addDevice - add new device to model
+ * @param device device object path
+ * @param name device name
+ */
 void FingerManagerDevicesModel::addDevice(QString device, QString name) {
 	DeviceModel d;
 	d.name = name;
@@ -28,11 +47,20 @@ void FingerManagerDevicesModel::addDevice(QString device, QString name) {
 	devices.push_back(d);
 }
 
-int FingerManagerDevicesModel::rowCount(const QModelIndex& parent) const {
-	Q_UNUSED(parent);
+/**
+ * rowCount - returns number of devices in model 
+ * @return int
+ */
+int FingerManagerDevicesModel::rowCount(const QModelIndex&) const {
 	return(devices.size());
 }
 
+/**
+ * data - return data for selected row and role
+ * @param index row index
+ * @param role role
+ * @return QVariant
+ */
 QVariant FingerManagerDevicesModel::data(const QModelIndex& index, int role) const {
 	QVariant result;
 	if (role == Qt::DisplayRole) {
@@ -41,14 +69,29 @@ QVariant FingerManagerDevicesModel::data(const QModelIndex& index, int role) con
 	return(result);
 }
 
+/**
+ * getDeviceName - return device name
+ * @param row row index
+ * @return QString
+ */
 QString FingerManagerDevicesModel::getDeviceName(int row) {
 	return(devices.at(row).name);
 }
 
+/**
+ * getDevicePath - return device path
+ * @param row row index
+ * @return QString
+ */
 QString FingerManagerDevicesModel::getDevicePath(int row) {
 	return(devices.at(row).device);
 }
 
+/**
+ * getDeviceModel - return device model
+ * @param int row index
+ * @return DeviceModel
+ */
 DeviceModel FingerManagerDevicesModel::getDeviceModel(int row) {
 	return(devices.at(row));
 }
\ No newline at end of file
diff --git a/src/FingerManagerDevicesModel.h b/src/FingerManagerDevicesModel.h
index ebb3945..62a9021 100644
--- a/src/FingerManagerDevicesModel.h
+++ b/src/FingerManagerDevicesModel.h
@@ -23,7 +23,7 @@ class FingerManagerDevicesModel : public QAbstractListModel {
 		FingerManagerDevicesModel(QObject *parent = 0);
 		~FingerManagerDevicesModel();
 		
-		int rowCount(const QModelIndex& parent = QModelIndex()) const;
+		int rowCount(const QModelIndex&) const;
 		QVariant data(const QModelIndex& index, int role = Qt::DisplayRole) const;
 
 		void addDevice(QString device, QString name);
-- 
2.11.4.GIT