BaseTools: Source/C/Common: Fix doc block locations and convert to Doxygen

Move the documentation blocks from between the parameter list and function
body to above the function.

Convert all the documentation blocks to Doxygen format.

Signed-off-by: Rebecca Cran <rebecca@bsdio.com>
Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn>

BaseTools/Source/C/Common/MemoryFile.c

@@ -27,29 +27,21 @@ CheckMemoryFileState (
 // Function implementations
 //
 
+/**
+  This opens a file, reads it into memory and returns a memory file
+  object.
+
+  @param InputFile          Memory file image.
+  @param OutputMemoryFile   Handle to memory file
+
+  @return EFI_STATUS
+  OutputMemoryFile is valid if !EFI_ERROR
+**/
 EFI_STATUS
 GetMemoryFile (
   IN CHAR8       *InputFileName,
   OUT EFI_HANDLE *OutputMemoryFile
   )
-/*++
-
-Routine Description:
-
-  This opens a file, reads it into memory and returns a memory file
-  object.
-
-Arguments:
-
-  InputFile          Memory file image.
-  OutputMemoryFile   Handle to memory file
-
-Returns:
-
-  EFI_STATUS
-  OutputMemoryFile is valid if !EFI_ERROR
-
---*/
 {
   EFI_STATUS  Status;
   CHAR8       *InputFileImage;
@@ -78,26 +70,17 @@ Returns:
   return EFI_SUCCESS;
 }
 
+/**
+  Frees all memory associated with the input memory file.
 
+  @param InputMemoryFile   Handle to memory file
+
+  @return EFI_STATUS
+**/
 EFI_STATUS
 FreeMemoryFile (
   IN EFI_HANDLE InputMemoryFile
   )
-/*++
-
-Routine Description:
-
-  Frees all memory associated with the input memory file.
-
-Arguments:
-
-  InputMemoryFile   Handle to memory file
-
-Returns:
-
-  EFI_STATUS
-
---*/
 {
   MEMORY_FILE *MemoryFile;
 
@@ -118,31 +101,22 @@ Returns:
   return EFI_SUCCESS;
 }
 
-
-CHAR8 *
-ReadMemoryFileLine (
-  IN EFI_HANDLE     InputMemoryFile
-  )
-/*++
-
-Routine Description:
-
+/**
   This function reads a line from the memory file.  The newline characters
   are stripped and a null terminated string is returned.
 
   If the string pointer returned is non-NULL, then the caller must free the
   memory associated with this string.
 
-Arguments:
+  @param InputMemoryFile   Handle to memory file
 
-  InputMemoryFile   Handle to memory file
-
-Returns:
-
-  NULL if error or EOF
-  NULL character termincated string otherwise (MUST BE FREED BY CALLER)
-
---*/
+  @retval NULL if error or EOF
+  @retval NULL character termincated string otherwise (MUST BE FREED BY CALLER)
+**/
+CHAR8 *
+ReadMemoryFileLine (
+  IN EFI_HANDLE     InputMemoryFile
+  )
 {
   CHAR8       *EndOfLine;
   UINTN       CharsToCopy;