Edit spm_api.h

Edit file, mostly for minor grammar and style changes.

hal/spm_api.h

@@ -20,8 +20,8 @@
 
 
 /** @addtogroup SPM
- * The SPM (Secure Partition Manager) is responsible for isolating software in
- * partitions, managing the execution of software within partitions, and
+ * The Secure Partition Manager (SPM) is responsible for isolating software in
+ * partitions, managing the execution of software within partitions and
  * providing IPC between partitions.
  * @{
  */
@@ -47,8 +47,8 @@ extern "C" {
 /**
  * Start running the NSPE.
  *
- * SPE (Secure Processing Environment) expected to boot first. Once all
- * the initializations are done, NSPE (Non-Secure Processing Environment)
+ * Secure Processing Environment (SPE) expected to boot first. Once all
+ * the initializations are done, Nonsecure Processing Environment (NSPE)
  * should be booted.
  *
  * @note The function must be implemented by target specific code.
@@ -60,7 +60,7 @@ void spm_hal_start_nspe(void);
  * Configure memory protection mechanism.
  *
  * Apply memory protection schemes to ensure secure memory can only be accessed
- * from secure-state
+ * from secure-state.
  *
  * @note The function must be implemented by target specific code.
  *
@@ -75,7 +75,7 @@ void spm_hal_memory_protection_init(void);
 /**
  * @brief Wakeup mailbox dispatcher thread
  *
- * This function is implemented by ARM and expected to be called by target
+ * Arm implements this function, which is expected to be called by target-
  * specific Inter-Processor-Communication logic on mailbox interrupt handler.
  *
  */
@@ -84,9 +84,9 @@ void spm_mailbox_irq_callback(void);
 /**
  * @brief Notify the peer processor about a general event occurrence.
  *
- * Wakeup the peer processor waiting on the mailbox driver event.
+ * Wake up the peer processor waiting on the mailbox driver event.
  *
- * @note The functions below should be implemented by target specific code.
+ * @note Implement the functions below with target-specific code.
  */
 void spm_hal_mailbox_notify(void);