Formalize comments for Protocols and PPIs.

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

diff --git a/MdePkg/Include/Protocol/SerialIo.h b/MdePkg/Include/Protocol/SerialIo.h
index f057cffea08d9b1764d98fd466c6f691cd5ddc59..4af00fcad9d95ba14b654272ca76a942ca066744 100644 (file)
--- a/MdePkg/Include/Protocol/SerialIo.h
+++ b/MdePkg/Include/Protocol/SerialIo.h
@@ -266,12 +266,11 @@ typedef struct {
 #define EFI_SERIAL_IO_PROTOCOL_REVISION    0x00010000\r
 #define SERIAL_IO_INTERFACE_REVISION  EFI_SERIAL_IO_PROTOCOL_REVISION\r
 \r
-/**  \r
-  @par Protocol Description:\r
-  The Serial I/O protocol is used to communicate with UART-style serial devices. \r
-  These can be standard UART serial ports in PC-AT systems, serial ports attached \r
-  to a USB interface, or potentially any character-based I/O device.\r
-**/\r
+///\r
+/// The Serial I/O protocol is used to communicate with UART-style serial devices. \r
+/// These can be standard UART serial ports in PC-AT systems, serial ports attached \r
+/// to a USB interface, or potentially any character-based I/O device.\r
+///\r
 struct _EFI_SERIAL_IO_PROTOCOL {\r
   ///\r
   /// The revision to which the EFI_SERIAL_IO_PROTOCOL adheres. All future revisions \r
@@ -285,7 +284,9 @@ struct _EFI_SERIAL_IO_PROTOCOL {
   EFI_SERIAL_GET_CONTROL_BITS GetControl;\r
   EFI_SERIAL_WRITE            Write;\r
   EFI_SERIAL_READ             Read;\r
-\r
+  ///\r
+  /// Pointer to SERIAL_IO_MODE data.\r
+  ///\r
   EFI_SERIAL_IO_MODE          *Mode;\r
 };\r
 \r