continue documentation efforts

1 files changed, 23 insertions, 2 deletions

diff --git a/include/apos/mem_nodes.h b/include/apos/mem_nodes.h
index f0d1361..866915d 100644
--- a/include/apos/mem_nodes.h
+++ b/include/apos/mem_nodes.h
@@ -9,10 +9,31 @@
 #include <apos/vmem.h>
 #include <apos/nodes.h>
 
-void init_mem_blocks();
-void destroy_mem_blocks();
+/**
+ * Initialize memory node subsystem.
+ *
+ * @pre Physical memory subsystem has been initialized.
+ */
+void init_mem_nodes();
+
+/**
+ * Destroy memory node subsystem.
+ * Free all associated allocations.
+ */
+void destroy_mem_nodes();
 
+/**
+ * Fetch a new memory node.
+ *
+ * @return Pointer to \ref mem_region node on success, \c NULL otherwise.
+ */
 struct mem_region *get_mem_node();
+
+/**
+ * Free a memory node.
+ *
+ * @param m Pointer to \ref mem_region node to free.
+ */
 void free_mem_node(struct mem_region *m);
 
 #endif /* APOS_MM_NODES_H */