Formalize comments for Protocols and PPIs.

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

diff --git a/MdePkg/Include/Protocol/ServiceBinding.h b/MdePkg/Include/Protocol/ServiceBinding.h
index ae6cd323a4689372ac16678436b708c0fdfefd28..afd25efb5706356f75b668974391d1f9f0c5e0eb 100644 (file)
--- a/MdePkg/Include/Protocol/ServiceBinding.h
+++ b/MdePkg/Include/Protocol/ServiceBinding.h
@@ -67,18 +67,17 @@ EFI_STATUS
   IN EFI_HANDLE                            ChildHandle\r
   );\r
 \r
-/**  \r
-  @par Protocol Description:\r
-  The EFI_SERVICE_BINDING_PROTOCOL provides member functions to create and destroy \r
-  child handles. A driver is responsible for adding protocols to the child handle \r
-  in CreateChild() and removing protocols in DestroyChild(). It is also required \r
-  that the CreateChild() function opens the parent protocol BY_CHILD_CONTROLLER \r
-  to establish the parent-child relationship, and closes the protocol in DestroyChild().\r
-  The pseudo code for CreateChild() and DestroyChild() is provided to specify the \r
-  required behavior, not to specify the required implementation. Each consumer of \r
-  a software protocol is responsible for calling CreateChild() when it requires the \r
-  protocol and calling DestroyChild() when it is finished with that protocol.\r
-**/\r
+///\r
+/// The EFI_SERVICE_BINDING_PROTOCOL provides member functions to create and destroy \r
+/// child handles. A driver is responsible for adding protocols to the child handle \r
+/// in CreateChild() and removing protocols in DestroyChild(). It is also required \r
+/// that the CreateChild() function opens the parent protocol BY_CHILD_CONTROLLER \r
+/// to establish the parent-child relationship, and closes the protocol in DestroyChild().\r
+/// The pseudo code for CreateChild() and DestroyChild() is provided to specify the \r
+/// required behavior, not to specify the required implementation. Each consumer of \r
+/// a software protocol is responsible for calling CreateChild() when it requires the \r
+/// protocol and calling DestroyChild() when it is finished with that protocol.\r
+///\r
 struct _EFI_SERVICE_BINDING_PROTOCOL {\r
   EFI_SERVICE_BINDING_CREATE_CHILD         CreateChild;\r
   EFI_SERVICE_BINDING_DESTROY_CHILD        DestroyChild;\r