From 0cb52ee74a8255eb0320c882bc9e70700317d16a Mon Sep 17 00:00:00 2001
From: Mat M <mathew1800@gmail.com>
Date: Sun, 26 Feb 2017 20:58:51 -0500
Subject: Doxygen: Amend minor issues (#2593)

Corrects a few issues with regards to Doxygen documentation, for example:

- Incorrect parameter referencing.
- Missing @param tags.
- Typos in @param tags.

and a few minor other issues.
---
 src/core/hle/ipc.h                       | 4 ++--
 src/core/hle/kernel/server_session.h     | 3 ++-
 src/core/hle/service/cam/cam.h           | 2 +-
 src/core/hle/service/gsp_gpu.cpp         | 6 +++---
 src/core/hle/service/ldr_ro/cro_helper.h | 4 ++--
 5 files changed, 10 insertions(+), 9 deletions(-)

(limited to 'src/core/hle')

diff --git a/src/core/hle/ipc.h b/src/core/hle/ipc.h
index bbaae8b79..cd9a5863d 100644
--- a/src/core/hle/ipc.h
+++ b/src/core/hle/ipc.h
@@ -72,8 +72,8 @@ union Header {
  * through modifications and checks by the kernel.
  * The translate parameters are described by headers generated with the IPC::*Desc functions.
  *
- * @note While #normal_params_size is equivalent to the number of normal parameters,
- * #translate_params_size includes the size occupied by the translate parameters headers.
+ * @note While @p normal_params_size is equivalent to the number of normal parameters,
+ * @p translate_params_size includes the size occupied by the translate parameters headers.
  */
 inline u32 MakeHeader(u16 command_id, unsigned int normal_params_size,
                       unsigned int translate_params_size) {
diff --git a/src/core/hle/kernel/server_session.h b/src/core/hle/kernel/server_session.h
index 4ffe97b78..761fc4781 100644
--- a/src/core/hle/kernel/server_session.h
+++ b/src/core/hle/kernel/server_session.h
@@ -45,7 +45,8 @@ public:
 
     /**
      * Creates a pair of ServerSession and an associated ClientSession.
-     * @param name Optional name of the ports
+     * @param name        Optional name of the ports.
+     * @param hle_handler Optional HLE handler for this server session.
      * @return The created session tuple
      */
     static SessionPair CreateSessionPair(
diff --git a/src/core/hle/service/cam/cam.h b/src/core/hle/service/cam/cam.h
index f6bff8bc6..34a9c8479 100644
--- a/src/core/hle/service/cam/cam.h
+++ b/src/core/hle/service/cam/cam.h
@@ -518,7 +518,7 @@ void FlipImage(Service::Interface* self);
 void SetDetailSize(Service::Interface* self);
 
 /**
- * Sets camera resolution from preset resolution parameters. .
+ * Sets camera resolution from preset resolution parameters.
  *  Inputs:
  *      0: 0x001F00C0
  *      1: u8 selected camera
diff --git a/src/core/hle/service/gsp_gpu.cpp b/src/core/hle/service/gsp_gpu.cpp
index 097ed87e4..a960778a7 100644
--- a/src/core/hle/service/gsp_gpu.cpp
+++ b/src/core/hle/service/gsp_gpu.cpp
@@ -119,10 +119,10 @@ static ResultCode WriteHWRegs(u32 base_address, u32 size_in_bytes, VAddr data_va
  * Updates sequential GSP GPU hardware registers using parallel arrays of source data and masks.
  * For each register, the value is updated only where the mask is high
  *
- * @param base_address The address of the first register in the sequence
+ * @param base_address  The address of the first register in the sequence
  * @param size_in_bytes The number of registers to update (size of data)
- * @param data A pointer to the source data to use for updates
- * @param masks A pointer to the masks
+ * @param data_vaddr    A virtual address to the source data to use for updates
+ * @param masks_vaddr   A virtual address to the masks
  * @return RESULT_SUCCESS if the parameters are valid, error code otherwise
  */
 static ResultCode WriteHWRegsWithMask(u32 base_address, u32 size_in_bytes, VAddr data_vaddr,
diff --git a/src/core/hle/service/ldr_ro/cro_helper.h b/src/core/hle/service/ldr_ro/cro_helper.h
index 060d5a55f..3bc10dbdc 100644
--- a/src/core/hle/service/ldr_ro/cro_helper.h
+++ b/src/core/hle/service/ldr_ro/cro_helper.h
@@ -57,7 +57,7 @@ public:
      * @param is_crs true if the module itself is the static module
      * @returns ResultCode RESULT_SUCCESS on success, otherwise error code.
      */
-    ResultCode Rebase(VAddr crs_address, u32 cro_size, VAddr data_segment_addresss,
+    ResultCode Rebase(VAddr crs_address, u32 cro_size, VAddr data_segment_address,
                       u32 data_segment_size, VAddr bss_segment_address, u32 bss_segment_size,
                       bool is_crs);
 
@@ -102,7 +102,7 @@ public:
     /**
      * Registers this module and adds it to the module list.
      * @param crs_address the virtual address of the static module
-     * @auto_link whether to register as an auto link module
+     * @param auto_link   whether to register as an auto link module
      */
     void Register(VAddr crs_address, bool auto_link);
 
-- 
cgit v1.2.3