Index: uspace/lib/c/arch/ia32/include/elf_linux.h
===================================================================
--- uspace/lib/c/arch/ia32/include/elf_linux.h	(revision 5baf2091c9d0ccfd0e7f817add7719093b215010)
+++ uspace/lib/c/arch/ia32/include/elf_linux.h	(revision a8bb38ceab1997348c644ee294eac3e8badf5d0b)
@@ -30,5 +30,5 @@
  * @{
  */
-/** @file
+/** @file Definitions needed to write core files in Linux-ELF format.
  */
 
@@ -39,4 +39,9 @@
 #include <sys/types.h>
 
+/** Linux kernel struct pt_regs structure.
+ *
+ * We need this to save register state to a core file in Linux format
+ * (readable by GDB configured for Linux target).
+ */
 typedef struct {
 	uint32_t ebx;
@@ -59,4 +64,5 @@
 } elf_regs_t;
 
+/** Convert istate_t to elf_regs_t. */
 static inline void istate_to_elf_regs(istate_t *istate, elf_regs_t *elf_regs)
 {