IMP: Improve DDK documentation.

IMP: Improve FileMgr documentation.

3 files changed, 19 insertions, 19 deletions

diff --git a/dev/ddk/ddk.h b/dev/ddk/ddk.h
index 249ada72..8a2e2483 100644
--- a/dev/ddk/ddk.h
+++ b/dev/ddk/ddk.h
@@ -63,7 +63,7 @@ struct DDK_STATUS_STRUCT DK_FINAL
 	void*	s_object;
 };
 
-/// \brief Simple Message Struct
+/// \brief Simple Message Struct structure.
 struct DDK_SMS_STRUCT DK_FINAL
 {
 	char s_msg[DDK_SMS_MAX_SZ];
@@ -72,39 +72,39 @@ struct DDK_SMS_STRUCT DK_FINAL
 	int64_t s_receiver;
 };
 
-/// @brief Call Kernel (interrupt 0x33)
-/// @param KernelRpcName
+/// @brief Call Kernel procedure.
+/// @param name the procedure name.
 /// @param cnt number of elements in **dat**
-/// @param dat data ptr
-/// @param sz sz of whole data ptr.
+/// @param dat data argument pointer.
+/// @param sz sz of whole data argument pointer.
 /// @return result of call
 DK_EXTERN void* KernelCall(const char* name, int32_t cnt, void* dat, size_t sz);
 
-/// @brief add system call.
-/// @param slot system call slot
+/// @brief add a system call.
+/// @param slot system call slot id.
 /// @param slotFn, syscall slot.
 DK_EXTERN void KernelAddSyscall(const int32_t slot, void (*slotFn)(void* a0));
 
-/// @brief allocate heap ptr.
-/// @param sz size of ptr.
+/// @brief Allocates an heap ptr.
+/// @param sz size of the allocated struct/type.
 /// @return the pointer allocated or **nil**.
 DK_EXTERN void* KernelAlloc(size_t sz);
 
-/// @brief free heap ptr.
+/// @brief Frees an heap ptr.
 /// @param pointer kernel pointer to free.
 DK_EXTERN void KernelFree(void* the_ptr);
 
-/// @brief Get a Kernel property.
-/// @param slot property id (always 0)
+/// @brief Gets a Kernel object.
+/// @param slot object id (can be 0)
 /// @param name the property's name.
-/// @return property's object.
+/// @return DDK_OBJECT_MANIFEST.
 DK_EXTERN struct DDK_OBJECT_MANIFEST* KernelGetObject(const int slot, const char* name);
 
-/// @brief Set a Kernel property.
-/// @param slot property id (always 0)
+/// @brief Set a Kernel object.
+/// @param slot object id (can be 0)
 /// @param name the property's name.
-/// @param ddk_pr pointer to a  property's DDK_OBJECT_MANIFEST.
-/// @return property's object.
+/// @param ddk_pr pointer to a object's DDK_OBJECT_MANIFEST.
+/// @return returned object.
 DK_EXTERN void* KernelSetObject(const int32_t slot, const struct DDK_OBJECT_MANIFEST* ddk_pr);
 
 /// @brief The highest API version of the DDK.
diff --git a/dev/zka/src/ErrorOr.cxx b/dev/zka/src/ErrorOr.cxx
index 0205506d..78647113 100644
--- a/dev/zka/src/ErrorOr.cxx
+++ b/dev/zka/src/ErrorOr.cxx
@@ -8,5 +8,5 @@
 
 /***********************************************************************************/
 /// @file ErrorOr.cxx                                                            ///
-/// @brief Error Or Value class.                                                 ///
+/// @brief ErrorOr container class.                                                 ///
 /***********************************************************************************/
diff --git a/dev/zka/src/FileMgr.cxx b/dev/zka/src/FileMgr.cxx
index a7be26b8..50736448 100644
--- a/dev/zka/src/FileMgr.cxx
+++ b/dev/zka/src/FileMgr.cxx
@@ -8,7 +8,7 @@
 #include <NewKit/Utils.hxx>
 
 /// BUGS: 0
-//! @brief File manager for Kernel.
+//! @brief File System Manager API.
 
 namespace Kernel
 {