Fix doxygen comment for structure and macro

[mirror_edk2.git] / MdePkg / Include / Protocol / Ip4.h

diff --git a/MdePkg/Include/Protocol/Ip4.h b/MdePkg/Include/Protocol/Ip4.h
index b9040c2a10acf5161f4902631083a8cfe313b58e..df6fd03cd57730f426dd3e6847615a3010125a36 100644 (file)
--- a/MdePkg/Include/Protocol/Ip4.h
+++ b/MdePkg/Include/Protocol/Ip4.h
@@ -11,7 +11,7 @@
     may include support for the Internet Group Management\r
     Protocol (IGMP).\r
   \r
-  Copyright (c) 2006, Intel Corporation                                                         \r
+  Copyright (c) 2006 - 2008, Intel Corporation                                                         \r
   All rights reserved. This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -163,7 +163,7 @@ typedef struct {
   @param  This          Pointer to the EFI_IP4_PROTOCOL instance.\r
   @param  Ip4ModeData   Pointer to the EFI IPv4 Protocol mode data structure.\r
   @param  MnpConfigData Pointer to the managed network configuration data structure.\r
-  @param  SnpData       Pointer to the simple network mode data structure.\r
+  @param  SnpModeData   Pointer to the simple network mode data structure.\r
 \r
   @retval EFI_SUCCESS           The operation completed successfully.\r
   @retval EFI_INVALID_PARAMETER This is NULL.\r
@@ -177,8 +177,7 @@ EFI_STATUS
   OUT       EFI_IP4_MODE_DATA               *Ip4ModeData     OPTIONAL,\r
   OUT       EFI_MANAGED_NETWORK_CONFIG_DATA *MnpConfigData   OPTIONAL,\r
   OUT       EFI_SIMPLE_NETWORK_MODE         *SnpModeData     OPTIONAL\r
-  )\r
-;  \r
+  );  \r
 \r
 /**\r
   Assigns an IPv4 address and subnet mask to this EFI IPv4 Protocol driver instance.\r
@@ -200,7 +199,7 @@ EFI_STATUS
                                 IPv4 address or subnet mask can be changed. The interface must\r
                                 also be stopped when switching to/from raw packet mode.\r
   @retval EFI_DEVICE_ERROR      An unexpected system or network error occurred. The EFI IPv4\r
-                                 Protocol driver instance is not opened.\r
+                                Protocol driver instance is not opened.\r
 \r
 **/\r
 typedef \r
@@ -208,8 +207,7 @@ EFI_STATUS
 (EFIAPI *EFI_IP4_CONFIGURE)(\r
   IN EFI_IP4_PROTOCOL    *This,\r
   IN EFI_IP4_CONFIG_DATA *IpConfigData     OPTIONAL\r
-  )\r
-;  \r
+  );  \r
 \r
 /**\r
   Joins and leaves multicast groups.\r
@@ -241,8 +239,7 @@ EFI_STATUS
   IN EFI_IP4_PROTOCOL    *This,\r
   IN BOOLEAN             JoinFlag,\r
   IN EFI_IPv4_ADDRESS    *GroupAddress  OPTIONAL\r
-  )\r
-;    \r
+  );    \r
 \r
 /**\r
   Adds and deletes routing table entries.\r
@@ -281,8 +278,7 @@ EFI_STATUS
   IN EFI_IPv4_ADDRESS    *SubnetAddress,\r
   IN EFI_IPv4_ADDRESS    *SubnetMask,\r
   IN EFI_IPv4_ADDRESS    *GatewayAddress  \r
-  )\r
-;  \r
+  );  \r
 \r
 /**\r
   Places outgoing data packets into the transmit queue.\r
@@ -314,8 +310,7 @@ EFI_STATUS
 (EFIAPI *EFI_IP4_TRANSMIT)(\r
   IN EFI_IP4_PROTOCOL          *This,\r
   IN EFI_IP4_COMPLETION_TOKEN  *Token\r
-  )\r
-;    \r
+  );    \r
 \r
 /**\r
   Places a receiving request into the receiving queue.\r
@@ -346,8 +341,7 @@ EFI_STATUS
 (EFIAPI *EFI_IP4_RECEIVE)(\r
   IN EFI_IP4_PROTOCOL          *This,\r
   IN EFI_IP4_COMPLETION_TOKEN  *Token\r
-  )\r
-;      \r
+  );      \r
 \r
 /**\r
   Abort an asynchronous transmit or receive request.\r
@@ -376,8 +370,7 @@ EFI_STATUS
 (EFIAPI *EFI_IP4_CANCEL)(\r
   IN EFI_IP4_PROTOCOL          *This,\r
   IN EFI_IP4_COMPLETION_TOKEN  *Token OPTIONAL\r
-  )\r
-;      \r
+  );      \r
   \r
 /**\r
   Polls for incoming data packets and processes outgoing data packets.\r
@@ -399,9 +392,13 @@ typedef
 EFI_STATUS\r
 (EFIAPI *EFI_IP4_POLL)(\r
   IN EFI_IP4_PROTOCOL          *This\r
-  )\r
-;  \r
+  );  \r
 \r
+/**  \r
+  @par Protocol Description:\r
+  The EFI IPv4 Protocol implements a simple packet-oriented interface that can be \r
+  used by drivers, daemons, and applications to transmit and receive network packets.\r
+**/\r
 struct _EFI_IP4_PROTOCOL {\r
   EFI_IP4_GET_MODE_DATA        GetModeData;\r
   EFI_IP4_CONFIGURE            Configure;\r