qtmobility/src/systeminfo/qsysteminfo.cpp
changeset 14 6fbed849b4f4
parent 11 06b8e2af4411
--- a/qtmobility/src/systeminfo/qsysteminfo.cpp	Fri Jun 11 14:26:25 2010 +0300
+++ b/qtmobility/src/systeminfo/qsysteminfo.cpp	Wed Jun 23 19:08:38 2010 +0300
@@ -152,7 +152,7 @@
     \value EmergencyOnly          Emergency calls only.
     \value Searching              Searching for or connecting with the network.
     \value Busy                   Network is busy.
-    \value Connected              Connected to newtwork.
+    \value Connected              Connected to network.
     \value HomeNetwork            On Home Network.
     \value Denied                 Network access denied.
     \value Roaming                On Roaming network.
@@ -495,7 +495,7 @@
 /*!
   \property QSystemNetworkInfo::cellId
   \brief The devices Cell ID
-    Returns the Cell ID of the connected tower or based station.
+    Returns the Cell ID of the connected tower or based station, or 0 if not connected.
 */
 int QSystemNetworkInfo::cellId()
 {
@@ -506,7 +506,7 @@
   \property QSystemNetworkInfo::locationAreaCode
   \brief The LAC.
 
-    Returns the Location Area Code. In the case of none such as a Desktop, an empty string.
+    Returns the Location Area Code. In the case of a Desktop computer, 0 is returned.
 */
 int QSystemNetworkInfo::locationAreaCode()
 {
@@ -517,8 +517,8 @@
    \property QSystemNetworkInfo::currentMobileCountryCode
    \brief The current MCC.
 
-    Returns the current Mobile Country Code. In the case of none such as a Desktop, an empty string.
-/*/
+    Returns the current Mobile Country Code. In the case of a Desktop computer, an empty string is returned.
+*/
 QString QSystemNetworkInfo::currentMobileCountryCode()
 {
     return netInfoPrivate()->currentMobileCountryCode();
@@ -528,7 +528,7 @@
   \property QSystemNetworkInfo::currentMobileNetworkCode
   \brief The current MNC.
 
-    Returns the current Mobile Network Code. In the case of none such as a Desktop, an empty string.
+    Returns the current Mobile Network Code. In the case of a Desktop computer, an empty string is returned.
 */
 QString QSystemNetworkInfo::currentMobileNetworkCode()
 {
@@ -539,7 +539,7 @@
   \property QSystemNetworkInfo::homeMobileCountryCode
   \brief The home MNC.
 
-    Returns the home Mobile Country Code. In the case of none such as a Desktop, an empty string.
+    Returns the home Mobile Country Code. In the case of a Desktop computer, an empty string is returned.
 */
 QString QSystemNetworkInfo::homeMobileCountryCode()
 {
@@ -550,7 +550,7 @@
   \property QSystemNetworkInfo::homeMobileNetworkCode
   \brief The home MCC.
 
-    Returns the home Mobile Network Code. In the case of none such as a Desktop, an empty string.
+    Returns the home Mobile Network Code. In the case of a Desktop computer, an empty string is returned.
     Note: Some platforms don't support retrieving this info. In this case the Network Code is
     returned only when the device is registered on home network.
 */
@@ -577,7 +577,7 @@
 }
 
 /*!
-  Returns the first found QNetworkInterface for type \a mode.
+  Returns the first found QNetworkInterface for type \a mode, or an invalid QNetworkInterface, if none is found.
   */
 QNetworkInterface QSystemNetworkInfo::interfaceForMode(QSystemNetworkInfo::NetworkMode mode)
 {
@@ -607,6 +607,8 @@
                                  networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode, int))))) {
         netInfoPrivate()->setWlanSignalStrengthCheckEnabled(true);
     }
+#else
+Q_UNUSED(signal)
 #endif
 }
 
@@ -627,6 +629,8 @@
                                  networkSignalStrengthChanged(QSystemNetworkInfo::NetworkMode, int))))) {
         netInfoPrivate()->setWlanSignalStrengthCheckEnabled(false);
     }
+#else
+Q_UNUSED(signal)
 #endif
 }
 
@@ -663,7 +667,7 @@
 }
 
 /*!
-    Returns the color depth of the screen with the index \a screenNumber, in bits per pixel.
+    Returns the color depth of the screen with the index \a screenNumber, in bits per pixel, or 0 if the screen is not found.
 
     \sa QDesktopWidget::screenCount()
 */
@@ -711,7 +715,7 @@
   \property QSystemStorageInfo::logicalDrives
   \brief The logical drives.
 
-    Returns a QStringList of volumes or partitions.
+    Returns a QStringList of volumes or partitions, or an empty list if no drives are found.
 */
 QStringList QSystemStorageInfo::logicalDrives()
 {
@@ -821,7 +825,7 @@
   \property QSystemDeviceInfo::productName
   \brief The product name.
 
-    Returns the product name of the device. In the case where no product information is available,
+    Returns the product name of the device. In the case where no product information is available, an empty string will be returned.
 
 */
 QString QSystemDeviceInfo::productName()
@@ -907,7 +911,7 @@
  /*!
    Constructs a QSystemScreenSaver object with the given \a parent.
 
-   On platforms where there is no one default screensaver mechanism, such as Linux, this class
+   On platforms where there is no default screensaver mechanism, such as Linux, this class
    may not be available.
  */
 
@@ -933,8 +937,9 @@
 /*!
     Temporarily inhibits the screensaver.
 
-    Will be reverted upon destruction of the QSystemScreenSaver object.
-    Returns true on success, otherwise false.
+    The screensaver will be set to a non inhibited state only when this QSystemScreenSaver object gets destroyed.
+
+    This is a non blocking function that will return true if the inhibit procedure was successful, otherwise false.
 
     On platforms that support it, if screensaver is secure by policy, the policy will be honored
     and this will fail.