Merge from 2.2
[platform/framework/native/telephony.git] / inc / FTelITelephonyNetworkSettingListener.h
index 2df36f2..8deb288 100755 (executable)
@@ -34,34 +34,35 @@ namespace Tizen { namespace Telephony
 {
 /**
 * @interface   ITelephonyNetworkSettingListener
-* @brief       This interface provides result of the network settings.
+* @brief       This interface provides the result of the network settings.
 *
 * @since 2.0
 *
-* The %ITelephonyNetworkSettingListener interface provides result of the network search and response by selection mode.
+* The %ITelephonyNetworkSettingListener interface provides the result of a network search and response performed in the selection mode.
 */
 class _OSP_EXPORT_ ITelephonyNetworkSettingListener
     : virtual public Tizen::Base::Runtime::IEventListener
 {
 public:
     /**
-     * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+     * This polymorphic destructor should be overridden if required. @n
+        * This way, the destructors of the derived classes are called when the destructor of this interface is called.
      *
      * @since 2.0
      */
     virtual ~ITelephonyNetworkSettingListener(void) {}
 
     /**
-     * Called when a response of the network selection mode request is received.
+     * Called when the response of the network selection mode request is received.
      *
      * @since 2.0
      *
-     * @param[in]   isManual    @c true if the network selection is in manual mode, @n
-     *                          else @c false
-     * @param[in]   r           An error code
-     * @exception   E_SUCCESS                  The method is successful.
-     * @exception   E_NOT_RESPONDING    The server on the telephony network is not responding.
-     * @exception   E_SYSTEM                     The method cannot proceed due to a severe telephony modem error.
+     * @param[in]   isManual                   @c true if the network selection is done in the manual mode, @n
+     *                                         else @c false
+     * @param[in]   r                          An error code
+     * @exception   E_SUCCESS           The method is successful.
+     * @exception   E_NOT_RESPONDING    The server of the telephony network is not responding.
+     * @exception   E_SYSTEM            The method cannot proceed due to a severe telephony modem error.
      * @see NetworkManager::GetNetworkSelectionMode()
      */
     virtual void OnTelephonyNetworkSelectionModeReceived(bool isManual, result r) = 0;
@@ -71,23 +72,23 @@ public:
      *
      * @since 2.0
      *
-     * @param[in]   pNetworkInfoList    The list of NetworkInfo information representing the network discovered by the search
+     * @param[in]   pNetworkInfoList    The list of NetworkInfo information that represents the network discovered by the search
      * @param[in]   r                   An error code
      * @exception   E_SUCCESS           The method is successful.
-     * @exception   E_NOT_RESPONDING    The server on the telephony network is not responding.
+     * @exception   E_NOT_RESPONDING    The server of the telephony network is not responding.
      * @exception   E_SYSTEM            The method cannot proceed due to a severe telephony modem error.
      * @see NetworkManager::SearchNetwork()
      */
     virtual void OnTelephonyNetworkSearchCompletedN(Tizen::Base::Collection::IList* pNetworkInfoList, result r) = 0;
 
     /**
-     * Called when a response of the network selection request is completed.
+     * Called when the response of the network selection request is completed.
      *
      * @since 2.0
      *
-     * @param[in]   r   An error code
+     * @param[in]   r                                  An error code
      * @exception   E_SUCCESS           The method is successful.
-     * @exception   E_NOT_RESPONDING    The server on the telephony network is not responding.
+     * @exception   E_NOT_RESPONDING    The server of the telephony network is not responding.
      * @exception   E_SYSTEM            The method cannot proceed due to a severe telephony modem error.
      * @see NetworkManager::SelectNetwork()
      */