Index: sources/device/DeviceGlobals.h =================================================================== diff -u -rb7c9de054c6b7a1ca4bac9fbb0ec5d4ac06620a9 -re2dc7bd9995a3bb410aa472a1f95c1cc9ba3136d --- sources/device/DeviceGlobals.h (.../DeviceGlobals.h) (revision b7c9de054c6b7a1ca4bac9fbb0ec5d4ac06620a9) +++ sources/device/DeviceGlobals.h (.../DeviceGlobals.h) (revision e2dc7bd9995a3bb410aa472a1f95c1cc9ba3136d) @@ -55,14 +55,31 @@ } \ } \ public Q_SLOTS : \ + /*! \ + * \brief VDevice::doInit \ + * \details the slot to be called to initialize the attribute. }\ + */ \ void doInit##vATTRIBUTEFLC ( ); \ Q_SIGNALS: /*! the signals for property bindings(Changed) and communications */ \ void vATTRIBUTE##Changed (const vTYPE & v##vATTRIBUTE ); \ - private : /*! the function is called once the property is set in qml as request */ \ + private : \ + /*! \ + * \brief VDevice::bluetoothPairedResetRequest \ + * \details The slot which will be called in case \ + * the attribute value has been updated in the QML. \ + * The updated value is wrapped in the corresponding model \ + * and will be used to call the assigned script eventually. \ + */ \ void vATTRIBUTE##Request (const vTYPE & v##vATTRIBUTE ); \ Q_SIGNALS : \ void didAttributeRequest (const Device##vATTRIBUTEFLC##RequestData &vData ); \ private Q_SLOTS : \ + /*! \ + * \brief VDevice::onAttributeResponse \ + * \details The slot which will be called in case the updated value for the attribute\ + * has been receive by the output of designated script. \ + * \param vData - the data model containing the values. \ + */ \ void onAttributeResponse(const Device##vATTRIBUTEFLC##ResponseData &vData ); \ private : @@ -76,8 +93,21 @@ Model::MDevice##vATTRIBUTEFLC##Response _device##vATTRIBUTEFLC##Response; \ Model::MDevice##vATTRIBUTEFLC##Request _device##vATTRIBUTEFLC##Request ; \ Q_SIGNALS : void didAttributeResponse (const Device##vATTRIBUTEFLC##ResponseData &); \ - private Q_SLOTS : void onAttributeRequest (const Device##vATTRIBUTEFLC##RequestData &vData); \ - private Q_SLOTS : void onProcess##vATTRIBUTEFLC##ExitCode(int vExitCode, QProcess::ExitStatus vStatus); \ + private Q_SLOTS : \ + /*! \ + * \brief DeviceController::onAttributeRequest \ + * \details This slot will be called in case the attribute is updated in the QML, \ + * to start the corresponding process and call the script assigned to it. \ + */ \ + void onAttributeRequest (const Device##vATTRIBUTEFLC##RequestData &vData); \ + /*! \ + * \brief DeviceController::onProcessExitCode \ + * \details The slot which is being called once the started process is returning a value \ + * as an exit code, probably from within the called script \ + * \param vExitCode - the returned exit code \ + * \param vStatus - the status of the process \ + */ \ + void onProcess##vATTRIBUTEFLC##ExitCode(int vExitCode, QProcess::ExitStatus vStatus); \ private : #define DEVICE_DEV_INIT_CONNECTIONS( vATTRIBUTEFLC ) \