From fa2455df2400a5bc674856290ddb2b327c00b2b0 Mon Sep 17 00:00:00 2001
From: devnoname120
Date: Tue, 22 Nov 2016 01:24:56 +0100
Subject: Add documentation for promoterutil.h

---
 include/user/promoterutil.h | 67 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 65 insertions(+), 2 deletions(-)

diff --git a/include/user/promoterutil.h b/include/user/promoterutil.h
index e6244d0..c3d2009 100644
--- a/include/user/promoterutil.h
+++ b/include/user/promoterutil.h
@@ -7,18 +7,81 @@
 extern "C" {
 #endif
 
+/** Parameters for scePromoterUtilityUpdateLiveArea() */
 typedef struct ScePromoterUtilityLAUpdate {
-	char titleid[12]; // target app
-	char path[128]; // directory of extracted LA update data
+	char titleid[12]; //!< Target app.
+	char path[128]; //!< Directory of extracted LA update data.
 } ScePromoterUtilityLAUpdate;
 
+/**
+ * Init the promoter utility.
+ * \note Needs to be called before using the other functions.
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityInit(void);
+
+/**
+ * Deinit the promoter utility.
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityExit(void);
+
+/**
+ * Delete a package from the LiveArea.
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityDeletePkg(void *unk);
+
+/**
+ * Update the LiveArea ressources of an app
+ *
+ * @param[in] *args - see ::ScePromoterUtilityLAUpdate
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityUpdateLiveArea(ScePromoterUtilityLAUpdate *args);
+
+/**
+ * Install a package from a directory, and add an icon on the LiveArea.
+ * \note It is an asynchronous function.
+ *
+ * @param[in] *path - the path of the directory where the extracted content of the package is
+ * @param unk - unknown, pass 0
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityPromotePkg(const char *path, int unk);
+
+/**
+ * Install a package from a directory and generate a rif.
+ * \note It is an asynchronous function.
+ *
+ * @param[in] *path - the path of the directory where the extracted content of the package is
+ * @param unk - unknown, pass 0
+ *
+ * @return 0 on success.
+ */
 int scePromoterUtilityPromotePkgWithRif(const char *path, int unk);
+
+/**
+ * Returns the state of an operation.
+ *
+ * @param[out] *state - the current status, 0 when finished
+ *
+ * @return <0 if failed.
+ */
 int scePromoterUtilityGetState(int *state);
+
+/**
+ * Returns the result of a finished operation
+ *
+ * @param[out] *res - the result, 0 on success
+ *
+ * @return <0 if failed.
+ */
 int scePromoterUtilityGetResult(int *res);
 
 #ifdef __cplusplus
-- 
cgit v1.2.3