remove link in brief tag
authorMinkyoung Kang <mklove.kang@samsung.com>
Wed, 12 Jun 2013 10:06:15 +0000 (19:06 +0900)
committerMinkyoung Kang <mklove.kang@samsung.com>
Wed, 12 Jun 2013 10:55:19 +0000 (19:55 +0900)
Change-Id: Ib6f3e8ddb42651d1dc730607a043d3c4ef910e57

18 files changed:
inc/FNetDhcpClientInfo.h
inc/FNetHttpHttpMessage.h
inc/FNetIDnsEventListener.h
inc/FNetNetAccountInfo.h
inc/FNetNetAccountManager.h
inc/FNetNetConnection.h
inc/FNetNetConnectionInfo.h
inc/FNetNetConnectionManager.h
inc/FNetNetEndPoint.h
inc/FNetNetStatistics.h
inc/FNetSockISecureSocketEventListener.h
inc/FNetSockSocket.h
inc/FNetSockSocketIpMulticastRequestOption.h
inc/FNetSockSocketLingerOption.h
inc/FNetSockSocketUtility.h
inc/FNetWifiIWifiDirectDeviceListener.h
inc/FNetWifiIWifiManagerEventListener.h
inc/FNetWifiWifiDirectGroupOwner.h

index efeb420..02bb81c 100644 (file)
@@ -82,7 +82,7 @@ public:
         *
         * @return              The MAC address in the form '00-00-00-00-00-00'
         * @remarks             In case of the Wi-Fi Direct bearer type, the MAC address is virtual and is used only for the frame packetization. @n
-        *                              This MAC address is different from the MAC address provided by the WifiManager or the WifiDirectDevice class.
+        *                              This MAC address is different from the MAC address provided by the Wifi::WifiManager or the Wifi::WifiDirectDevice class.
         */
        Tizen::Base::String GetMacAddress(void) const;
 
index 04cd729..646bd44 100644 (file)
@@ -34,7 +34,7 @@ namespace Tizen { namespace Net { namespace Http
 class _HttpMessageImpl;
 /**
  * @class      HttpMessage
- * @brief      This class is the base class for HttpRequest and HttpResponse.
+ * @brief      This class is the base class for %HttpRequest and %HttpResponse.
  *
  * @since   2.0
  *
index 01031ac..9d84726 100644 (file)
@@ -72,8 +72,8 @@ public:
         * @exception   E_TIMEOUT                               An attempt to connect to the server has timed out.
         * @exception   E_NOT_RESPONDING                There is no response.
         * @exception   E_DNS_NOT_FOUND                 The DNS lookup has failed.
-        * @remarks             Always check the error code before accessing the result.
-        *                              If @c r is not E_SUCCESS, @c ipHostEntry may not exist.
+        * @remarks             Always check the error code before accessing the result. @n
+        *                              If @c r is not @c E_SUCCESS, @c ipHostEntry may not exist.
         */
        virtual void OnDnsResolutionCompletedN(IpHostEntry* pIpHostEntry, result r) = 0;
 }; // IDnsEventListener
index 096a76a..07e53c4 100644 (file)
@@ -219,8 +219,8 @@ public:
         * @return              An error code
         * @param[in]   localAddrScheme                 An indicator specifying whether to use a static local IP address
         * @param[in]   pLocalAddress                   The local IP address @n
-        *                                                                              If @c localAddrScheme is set to NET_ADDRESS_SCHEME_STATIC, the local IP address assigned is static.
-        *                                                                              If @c localAddrScheme is set to NET_ADDRESS_SCHEME_DYNAMIC or NET_ADDRESS_SCHEME_NONE, this parameter is ignored.
+        *                                                                              If @c localAddrScheme is set to @c NET_ADDRESS_SCHEME_STATIC, the local IP address assigned is static.
+        *                                                                              If @c localAddrScheme is set to @c NET_ADDRESS_SCHEME_DYNAMIC or @c NET_ADDRESS_SCHEME_NONE, this parameter is ignored.
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_INVALID_ARG                   A specified input parameter is invalid.
         * @see                 GetLocalAddress()
@@ -250,11 +250,12 @@ public:
         *                                      else @c null if an error occurs or the dynamic address scheme is being used
         * @exception           E_SUCCESS                               The method is successful.
         * @exception           E_INVALID_OPERATION             This operation is not allowed in the dynamic address scheme.
-        * @remarks                     When this instance is got by NetAccountManager::GetNetAccountInfoN(),
+        * @remarks             
+        *                              - When this instance is got by NetAccountManager::GetNetAccountInfoN(),
         *                                      - this method returns a statically assigned primary DNS address pointer if the DNS address scheme is NET_ADDRESS_SCHEME_STATIC
         *                                      - this method returns @n null if the DNS address scheme is @c NET_ADDRESS_SCHEME_DYNAMIC @n
-        *                      The specific error code can be accessed using the GetLastResult() method.
-        * @see                         GetSecondaryDnsAddress()
+        *                              - The specific error code can be accessed using the GetLastResult() method.
+        * @see                 GetSecondaryDnsAddress()
         */
        const IpAddress* GetPrimaryDnsAddress(void) const;
 
@@ -274,16 +275,16 @@ public:
 
        /**
         * Enables or disables the use of a static DNS address with the specified IpAddress objects. @n
-        * If @c dnsAddrScheme is NET_ADDRESS_SCHEME_DYNAMIC, both @c primaryDnsAddress and @c secondaryDnsAddress are ignored. @n
-        * If @c dnsAddrScheme is NET_ADDRESS_SCHEME_STATIC, @c primaryDnsAddress must be a valid IpAddress.
+        * If @c dnsAddrScheme is @c NET_ADDRESS_SCHEME_DYNAMIC, both @c primaryDnsAddress and @c secondaryDnsAddress are ignored. @n
+        * If @c dnsAddrScheme is @c NET_ADDRESS_SCHEME_STATIC, @c primaryDnsAddress must be a valid IpAddress.
         * However, @c pSecondaryDnsAddress can be @c null.
         *
         * @since               2.0
         *
         * @return              An error code
         * @param[in]   dnsAddrScheme                   An indicator specifying whether or not to use a static DNS address
-        * @param[in]   pPrimaryDnsAddress              The statically assigned primary DNS address if @c dnsAddrScheme is NET_ADDRESS_SCHEME_STATIC
-        * @param[in]   pSecondaryDnsAddress    The statically assigned secondary DNS address if @c dnsAddrScheme is NET_ADDRESS_SCHEME_STATIC
+        * @param[in]   pPrimaryDnsAddress              The statically assigned primary DNS address if @c dnsAddrScheme is @c NET_ADDRESS_SCHEME_STATIC
+        * @param[in]   pSecondaryDnsAddress    The statically assigned secondary DNS address if @c dnsAddrScheme is @c NET_ADDRESS_SCHEME_STATIC
         * @exception   E_SUCCESS                               The method is successful.
         * @exception   E_INVALID_ARG                   A specified input parameter is invalid.
         * @see                 GetPrimaryDnsAddress()
index 8b2bca6..b6673cd 100644 (file)
@@ -58,8 +58,6 @@ public:
         * For full construction, the Construct() method must be called right after calling this constructor.
         *
         * @since               2.0
-        *
-        * @remarks             After creating an instance of this class, the Construct() method must be called explicitly to initialize this instance.
         */
        NetAccountManager(void);
 
index 1ce2186..9a80add 100644 (file)
@@ -123,8 +123,6 @@ public:
         * For full construction, the Construct() method must be called right after calling this constructor.
         *
         * @since               2.0
-        *
-        * @remarks             After creating an instance of this class, the Construct() method must be called explicitly to initialize this instance.
         */
        NetConnection(void);
 
@@ -152,7 +150,7 @@ public:
         * @exception           E_INVALID_ACCOUNT       The specified network account ID is invalid.
         * @exception           E_SYSTEM                        An internal error has occurred.
         * @exception           E_INVALID_PROXY         The proxy address is invalid.
-        * @remarks                     If the application gets the last result by E_INVALID_PROXY, it must use a warning pop-up to notify the user.
+        * @remarks             If the application gets the last result by @c E_INVALID_PROXY, it must use a warning pop-up to notify the user.
         */
        result Construct(NetAccountId netAccountId);
 
@@ -170,7 +168,7 @@ public:
         * @exception   E_OUT_OF_MEMORY                 The memory is insufficient.
         * @exception   E_OBJ_ALREADY_EXIST             The listener is already added.
         * @exception   E_INVALID_OPERATION             The current state of the instance prohibits the execution of the specified operation, @n
-        *                                                                              because the caller thread is a worker thread.
+        *                                                                      because the caller thread is a worker thread.
         */
        result AddNetConnectionListener(INetConnectionEventListener& listener);
 
@@ -290,9 +288,10 @@ public:
         * @exception   E_INVALID_CONTEXT               The context information associated with the network connection account is invalid.
         * @exception   E_OUT_OF_MEMORY         The memory is insufficient.
         * @exception   E_SYSTEM                                An internal error has occurred.
-        * @remarks                     The specific error code can be accessed using the GetLastResult() method.
-        * @remarks             This method requires a NetConnectionInfo instance reference. The network connection information is only available when the network
-        *                              connection is "Active". For other states, this method returns @c null.
+        * @remarks             
+        *                      - The specific error code can be accessed using the GetLastResult() method.
+        *                      - This method requires a NetConnectionInfo instance reference. The network connection information is only available when the network
+        *                      connection is "Active". For other states, this method returns @c null.
         * @warning     Do not delete the returned NetConnectionInfo instance. This instance directly references the internal connection information of
         *                              %NetConnection.
         */
index 1083987..5fdc7c3 100644 (file)
@@ -39,7 +39,7 @@ class _NetConnectionInfoImpl;
  * @since      2.0\r
  *\r
  *     The %NetConnectionInfo class provides methods to obtain information related to a network connection. %NetConnectionInfo is valid when \r
- *     NetConnection is not in the "NET_CONNECTION_STATE_STOPPED" state.\r
+ *     NetConnection is not in the ::NET_CONNECTION_STATE_STOPPED state.\r
  *\r
  * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/net/managing_network_connections.htm">Managing Network Connections</a>.\r
  */\r
@@ -110,8 +110,8 @@ public:
         * @since               2.0\r
         *\r
         * @return              A pointer to the IpAddress instance representing the local address in the calling instance\r
-        * @remarks             If GetLocalAddressScheme() is NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
-        *                              If %GetLocalAddressScheme() is NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
+        * @remarks             If GetLocalAddressScheme() is ::NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
+        *                              If %GetLocalAddressScheme() is ::NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
         *                              In any case, check whether the IpAddress pointer is @c null or not.\r
         */\r
        const IpAddress* GetLocalAddress(void) const;\r
@@ -133,8 +133,8 @@ public:
         * @since               2.0\r
         *\r
         * @return              A pointer to the IpAddress instance representing the primary DNS Address of the network connection\r
-        * @remarks             If GetDnsAddressScheme() is NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
-        *                              If %GetDnsAddressScheme() is NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
+        * @remarks             If GetDnsAddressScheme() is ::NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
+        *                              If %GetDnsAddressScheme() is ::NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
         *                              In any case, check whether the IpAddress pointer is @c null or not, because the DNS address field is not mandatory.\r
         */\r
        const IpAddress* GetPrimaryDnsAddress(void) const;\r
@@ -145,8 +145,8 @@ public:
         * @since               2.0\r
         *\r
         * @return              A pointer to the IpAddress instance representing the secondary DNS Address of the network connection\r
-        * @remarks             If GetDnsAddressScheme() is NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
-        *                              If %GetDnsAddressScheme() is NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
+        * @remarks             If GetDnsAddressScheme() is ::NET_ADDRESS_SCHEME_STATIC, this method returns the statically assigned local addresses. @n\r
+        *                              If %GetDnsAddressScheme() is ::NET_ADDRESS_SCHEME_DYNAMIC, this method returns the dynamically assigned local addresses. @n\r
         *                              In any case, check whether the IpAddress pointer is @c null or not, because the DNS address field is not mandatory.\r
         */\r
        const IpAddress* GetSecondaryDnsAddress(void) const;\r
index 648d1fc..9835823 100644 (file)
@@ -52,8 +52,6 @@ public:
         * For full construction, the Construct() method must be called right after calling this constructor.
         *
         * @since       2.0
-        *
-        * @remarks             After creating an instance of this class, the Construct() method must be called explicitly to initialize this instance.
         */
        NetConnectionManager(void);
 
@@ -125,8 +123,8 @@ public:
         *
         * @privlevel   public
         * @privilege   %http://tizen.org/privilege/network.connection
-        * @feature             %http://tizen.org/feature/network.wifi for the NET_WIFI_ONLY value and @n
-        *                              %http://tizen.org/feature/network.telephony for the NET_PS_ONLY value of @c netPreference
+        * @feature             %http://tizen.org/feature/network.wifi for the @c  NET_WIFI_ONLY value and @n
+        *                              %http://tizen.org/feature/network.telephony for the @c NET_PS_ONLY value of @c netPreference
         *
         * @return              An error code
         * @param[in]   netPreference           The preferred network
index c283e86..0624555 100644 (file)
@@ -128,10 +128,11 @@ public:
         *                              else @c null string if an error occurs
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_STATE         This instance is in an invalid state.
-        * @remarks             The string output of this method is formatted as follows: IPADDRESS:PORT. @n
-        *                              IPADDRESS is a string representing a number expressed in the Internet Standard "." (dotted) notation (for example, 165.213.173.7). @n
-        *                              PORT is a string representing a port number in host byte order. For example, 165.213.173.7:2000 is a possible string. @n
-        *                              The specific error code can be accessed using the GetLastResult() method.
+        * @remarks             
+        *                      - The string output of this method is formatted as follows: IPADDRESS:PORT. @n
+        *                      IPADDRESS is a string representing a number expressed in the Internet Standard "." (dotted) notation (for example, 165.213.173.7). @n
+        *                      PORT is a string representing a port number in host byte order. For example, 165.213.173.7:2000 is a possible string.
+        *                      - The specific error code can be accessed using the GetLastResult() method.
         */
        Tizen::Base::String GetNetEndPoint(void) const;
 
index 23bfb8d..571815e 100644 (file)
@@ -54,8 +54,6 @@ public:
         * For full construction, the Construct() method must be called right after calling this constructor.
         *
         * @since               2.0
-        *
-        * @remarks             After creating an instance of this class, the Construct() method must be called explicitly to initialize this instance.
         */
        NetStatistics(void);
 
@@ -87,13 +85,13 @@ public:
         * @privlevel   public
         * @privilege   %http://tizen.org/privilege/network.statistics @n
         *                              (%http://tizen.org/privilege/network.statistics.read is deprecated.)
-        * @feature             %http://tizen.org/feature/network.wifi for the NET_BEARER_WIFI value and @n
-        *                              %http://tizen.org/feature/network.telephony for the NET_BEARER_PS value of @c bearerType
+        * @feature             %http://tizen.org/feature/network.wifi for the @c NET_BEARER_WIFI value and @n
+        *                              %http://tizen.org/feature/network.telephony for the @c NET_BEARER_PS value of @c bearerType
         *
         * @return              The number of bytes sent or received, @n
         *                              else @c INVALID_HANDLE if an error occurs
         * @param[in]   bearerType                      The bearer type of the data call operation @n
-        *                                                                              NET_BEARER_WIFI_DIRECT and NET_BEARER_USB are not supported.
+        *                                                                              @c NET_BEARER_WIFI_DIRECT and @c NET_BEARER_USB are not supported.
         * @param[in]   netStatType                     The type of statistical information to get
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
@@ -114,11 +112,12 @@ public:
         *
         * @privlevel   platform
         * @privilege   %http://tizen.org/privilege/netstatisticsmanager
-        * @feature             %http://tizen.org/feature/network.wifi for the NET_BEARER_WIFI value and @n
-        *                              %http://tizen.org/feature/network.telephony for the NET_BEARER_PS value of @c bearerType
+        * @feature             %http://tizen.org/feature/network.wifi for the @c NET_BEARER_WIFI value and @n
+        *                              %http://tizen.org/feature/network.telephony for the @c NET_BEARER_PS value of @c bearerType
         *
         * @return              An error code
-        * @param[in]   bearerType                      The bearer type (OperationMode) whose statistical information is reset @n NET_BEARER_WIFI_DIRECT and NET_BEARER_USB are not supported.
+        * @param[in]   bearerType                      The bearer type (OperationMode) whose statistical information is reset @n 
+        *                                                              @c NET_BEARER_WIFI_DIRECT and @c NET_BEARER_USB are not supported.
         * @param[in]   netStatType                     The type of statistical information to reset
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG           A specified input parameter is invalid.
@@ -141,11 +140,12 @@ public:
         *
         * @privlevel   platform
         * @privilege   %http://tizen.org/privilege/netstatisticsmanager
-        * @feature             %http://tizen.org/feature/network.wifi for the NET_BEARER_WIFI value and @n
-        *                              %http://tizen.org/feature/network.telephony for the NET_BEARER_PS value of @c bearerType
+        * @feature             %http://tizen.org/feature/network.wifi for the @c NET_BEARER_WIFI value and @n
+        *                              %http://tizen.org/feature/network.telephony for the @c NET_BEARER_PS value of @c bearerType
         *
         * @return              An error code
-        * @param[in]   bearerType                      The bearer type (OperationMode) whose statistical information would be reset @n NET_BEARER_WIFI_DIRECT and NET_BEARER_USB are not supported.
+        * @param[in]   bearerType                      The bearer type (OperationMode) whose statistical information would be reset @n 
+        *                                                              @c NET_BEARER_WIFI_DIRECT and @c NET_BEARER_USB are not supported.
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG           The specified input parameter is invalid.
         * @exception   E_SYSTEM                        An internal error has occurred.
index 07aa6c2..5c8af29 100644 (file)
@@ -78,7 +78,7 @@ public:
        *
        * @param[in]    socket          The SecureSocket instance
        * @param[in]    reason          The reason of type NetSocketClosedReason for a closed secure socket
-       * @remarks              If the reason is NET_SOCKET_CLOSED_REASON_NO_CERTIFICATE, start the Application control (L"tizen.certificatemanager") for getting the selected client certificate. @n
+       * @remarks              If the reason is @c NET_SOCKET_CLOSED_REASON_NO_CERTIFICATE, start the Application control (L"tizen.certificatemanager") for getting the selected client certificate. @n
        *               For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_certmgr.htm">here</a>.
        */
        virtual void OnSecureSocketClosed(SecureSocket& socket, NetSocketClosedReason reason) = 0;
index 3f69fde..2a847b4 100644 (file)
@@ -250,7 +250,7 @@ public:
     */
 
        /**
-       * Sends the data to a socket of the type NET_SOCKET_TYPE_STREAM.
+       * Sends the data to a socket of the type ::NET_SOCKET_TYPE_STREAM.
        *
        * @since        2.0
        *
@@ -417,11 +417,11 @@ public:
     *
     * @section      SocketSendToPage2ResolutionSection Resolutions
     * The issue mentioned above is resolved in %Tizen API version 2.1 as follows: @n
-    * -# If the application provides a loopback address in NetEndPoint, it returns E_SUCCESS instead of E_SYSTEM.
+    * -# If the application provides a loopback address in NetEndPoint, it returns @c E_SUCCESS instead of @c E_SYSTEM.
     */
 
        /**
-       * Receives the data from a socket of the type NET_SOCKET_TYPE_STREAM.
+       * Receives the data from a socket of the type ::NET_SOCKET_TYPE_STREAM.
        *
        * @since        2.0
        *
@@ -449,7 +449,7 @@ public:
        result Receive(Tizen::Base::ByteBuffer& buffer) const;
 
        /**
-       * Receives the data from a socket of the type NET_SOCKET_TYPE_STREAM.
+       * Receives the data from a socket of the type ::NET_SOCKET_TYPE_STREAM.
        *
        * @since        2.0
        *
index 79a805c..d39e190 100644 (file)
@@ -42,7 +42,7 @@ class _IpMulticastRequestOptionImpl;
 * @since       2.0
 *
 * The %IpMulticastRequestOption class supports the multicasting in sockets for sending and receiving multicast datagram packets.
-*                      For multicasting, a socket must be of type NET_SOCKET_TYPE_DATAGRAM.
+*                      For multicasting, a socket must be of type ::NET_SOCKET_TYPE_DATAGRAM.
 *
 *      For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/net/sockets.htm">Sockets Guide</a>.
 *
index 84b793c..98087a2 100644 (file)
@@ -35,7 +35,7 @@ class _LingerOptionImpl;
 
 /**
 * @class       LingerOption
-* @brief       This class specifies whether a socket remains connected after the Socket::Close() method is called.
+* @brief       This class specifies whether a socket remains connected after the %Socket::Close() method is called.
 *                      It also specifies the amount of time for which it remains connected, if the data is not sent.
 *
 * @since       2.0
index cd2545a..c10637c 100644 (file)
@@ -36,7 +36,7 @@ class _SocketUtilityImpl;
 
 /**
 * @class       SocketUtility
-* @brief       This class provides the utility methods for the Socket class.
+* @brief       This class provides the utility methods for the %Socket class.
 *
 * @since    2.0
 *
index 6fc782e..fdb345c 100644 (file)
@@ -39,7 +39,7 @@ class WifiDirectDeviceInfo;
 
 /**
  * @interface   IWifiDirectDeviceListener
- * @brief       This interface implements listeners for the WifiDirectDevice events.
+ * @brief       This interface implements listeners for the %WifiDirectDevice events.
  *
  * @since       2.0
  *
index 97f6c5b..f426cbd 100644 (file)
@@ -32,7 +32,7 @@ namespace Tizen { namespace Net { namespace Wifi
 {
 /**
  * @interface   IWifiManagerEventListener
- * @brief       This interface provides the listeners for WifiManager events.
+ * @brief       This interface provides the listeners for %WifiManager events.
  *
  * @since       2.0
  *
index 991d9c7..90c0097 100755 (executable)
 // limitations under the License.
 //
 /**
+ * @if OSPDEPREC
  * @file    FNetWifiWifiDirectGroupOwner.h
  * @brief   This is the header file for the %WifiDirectGroupOwner class.
  *
  * This header file contains the declarations of the %WifiDirectGroupOwner class.
+ * @endif
  */
 #ifndef _FNET_WIFI_WIFI_DIRECT_GROUP_OWNER_H_
 #define _FNET_WIFI_WIFI_DIRECT_GROUP_OWNER_H_