Index: generic/include/security/cap.h
===================================================================
--- generic/include/security/cap.h	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/include/security/cap.h	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -28,5 +28,10 @@
 
 /**
- * Capabilities definitions.
+ * @file	cap.h
+ * @brief	Capabilities definitions.
+ *
+ * Capabilities represent virtual rights that entitle their
+ * holder to perform certain security sensitive tasks.
+ *
  * Each task can have arbitrary combination of the capabilities
  * defined in this file. Therefore, they are required to be powers
Index: generic/src/console/cmd.c
===================================================================
--- generic/src/console/cmd.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/console/cmd.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -28,4 +28,7 @@
 
 /**
+ * @file	cmd.c
+ * @brief	Kernel console command wrappers.
+ *
  * This file is meant to contain all wrapper functions for
  * all kconsole commands. The point is in separating
Index: generic/src/console/kconsole.c
===================================================================
--- generic/src/console/kconsole.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/console/kconsole.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,11 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	kconsole.c
+ * @brief	Kernel console.
+ *
+ * This file contains kernel thread managing the kernel console.
  */
 
Index: generic/src/cpu/cpu.c
===================================================================
--- generic/src/cpu/cpu.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/cpu/cpu.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	cpu.c
+ * @brief	CPU subsystem initialization and listing.
+ */
+ 
 #include <cpu.h>
 #include <arch.h>
Index: generic/src/debug/print.c
===================================================================
--- generic/src/debug/print.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/debug/print.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -26,4 +26,9 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	print.c
+ * @brief	Printing functions.
  */
 
Index: generic/src/debug/symtab.c
===================================================================
--- generic/src/debug/symtab.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/debug/symtab.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,8 @@
  */
 
+/**
+ * @file	symtab.c
+ * @brief	Kernel symbol resolver.
+ */
 
 #include <symtab.h>
@@ -34,5 +38,5 @@
 #include <print.h>
 
-/** Return entry that seems most likely to correspond to address
+/** Return entry that seems most likely to correspond to argument.
  *
  * Return entry that seems most likely to correspond
@@ -56,5 +60,5 @@
 }
 
-/** Find symbols that match the parameter forward and print them 
+/** Find symbols that match the parameter forward and print them.
  *
  * @param name - search string
Index: generic/src/interrupt/interrupt.c
===================================================================
--- generic/src/interrupt/interrupt.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/interrupt/interrupt.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,13 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	interrupt.c
+ * @brief	Interrupt redirector.
+ *
+ * This file provides means of registering interrupt handlers
+ * by kernel functions and calling the handlers when interrupts
+ * occur.
  */
 
Index: generic/src/lib/elf.c
===================================================================
--- generic/src/lib/elf.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/lib/elf.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	elf.c
+ * @brief	Kernel ELF loader.
+ */
+
 #include <elf.h>
 #include <debug.h>
Index: generic/src/lib/func.c
===================================================================
--- generic/src/lib/func.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/lib/func.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,9 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	func.c
+ * @brief	Miscellaneous functions.
  */
 
Index: generic/src/lib/memstr.c
===================================================================
--- generic/src/lib/memstr.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/lib/memstr.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,16 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	memstr.c
+ * @brief	Memory string operations.
+ *
+ * This file provides architecture independent functions
+ * to manipulate blocks of memory. These functions
+ * are optimized as much as generic functions of
+ * this type can be. However, architectures are
+ * free to provide even more optimized versions of these
+ * functions.
  */
 
Index: generic/src/lib/sort.c
===================================================================
--- generic/src/lib/sort.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/lib/sort.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,12 @@
  */
 
+/**
+ * @file	sort.c
+ * @brief	Sorting functions.
+ *
+ * This files contains functions implementing several sorting
+ * algorithms (e.g. quick sort and bubble sort).
+ */
+ 
 #include <mm/slab.h>
 #include <memstr.h>
Index: generic/src/preempt/preemption.c
===================================================================
--- generic/src/preempt/preemption.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/preempt/preemption.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	preemption.c
+ * @brief	Preemption control.
+ */
+ 
 #include <preemption.h>
 #include <arch.h>
Index: generic/src/proc/scheduler.c
===================================================================
--- generic/src/proc/scheduler.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/proc/scheduler.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -31,5 +31,5 @@
  * @brief	Scheduler and load balancing.
  *
- * This file contains the scheduler and kcpulb kernel thread wich
+ * This file contains the scheduler and kcpulb kernel thread which
  * performs load-balancing of per-CPU run queues.
  */
Index: generic/src/security/cap.c
===================================================================
--- generic/src/security/cap.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/security/cap.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,11 @@
  */
 
+/**
+ * @file	cap.c
+ * @brief	Capabilities control.
+ *
+ * @see cap.h
+ */
+ 
 #include <security/cap.h>
 #include <proc/task.h>
Index: generic/src/smp/ipi.c
===================================================================
--- generic/src/smp/ipi.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/smp/ipi.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	ipi.c
+ * @brief	Generic IPI interface.
+ */
+ 
 #ifdef CONFIG_SMP
 
@@ -39,4 +44,8 @@
  * @param ipi Message to broadcast.
  *
+ * @bugs The decision whether to actually send the IPI must be based
+ *	 on a different criterion. The current version has
+ *	 problems when some of the detected CPUs are marked
+ *	 disabled in machine configuration.
  */
 void ipi_broadcast(int ipi)
Index: generic/src/synch/condvar.c
===================================================================
--- generic/src/synch/condvar.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/synch/condvar.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,9 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	condvar.c
+ * @brief	Condition variables.
  */
 
Index: generic/src/synch/futex.c
===================================================================
--- generic/src/synch/futex.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/synch/futex.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -28,6 +28,8 @@
 
 /**
- * Kernel backend for futexes.
- * Deallocation of orphaned kernel-side futex structures is not currently implemented.
+ * @file	futex.c
+ * @brief	Kernel backend for futexes.
+ *
+ * @todo Deallocation of orphaned kernel-side futex structures is not currently implemented.
  */
 
Index: generic/src/synch/mutex.c
===================================================================
--- generic/src/synch/mutex.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/synch/mutex.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	mutex.c
+ * @brief	Mutexes.
+ */
+ 
 #include <synch/mutex.h>
 #include <synch/semaphore.h>
Index: generic/src/synch/semaphore.c
===================================================================
--- generic/src/synch/semaphore.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/synch/semaphore.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,9 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	semaphore.c
+ * @brief	Semaphores.
  */
 
Index: generic/src/synch/spinlock.c
===================================================================
--- generic/src/synch/spinlock.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/synch/spinlock.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	spinlock.c
+ * @brief	Spinlocks.
+ */
+ 
 #include <synch/spinlock.h>
 #include <atomic.h>
Index: generic/src/syscall/syscall.c
===================================================================
--- generic/src/syscall/syscall.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/syscall/syscall.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	syscall.c
+ * @brief	Syscall table and syscall wrappers.
+ */
+ 
 #include <syscall/syscall.h>
 #include <proc/thread.h>
Index: generic/src/time/clock.c
===================================================================
--- generic/src/time/clock.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/time/clock.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,13 @@
  */
 
+/**
+ * @file	clock.c
+ * @brief	High-level clock interrupt handler.
+ *
+ * This file contains the clock() function which is the source
+ * of preemption. It is also responsible for executing expired
+ * timeouts.
+ */
+ 
 #include <time/clock.h>
 #include <time/timeout.h>
Index: generic/src/time/delay.c
===================================================================
--- generic/src/time/delay.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/time/delay.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -27,4 +27,9 @@
  */
 
+/**
+ * @file	delay.c
+ * @brief	Active delay function.
+ */
+ 
 #include <time/delay.h>
 #include <arch/types.h>
Index: generic/src/time/timeout.c
===================================================================
--- generic/src/time/timeout.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
+++ generic/src/time/timeout.c	(revision 953b0f336c4e9e8b01c3fa6bd0ac99c8d7c49909)
@@ -25,4 +25,9 @@
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * @file	timeout.c
+ * @brief	Timeout management functions.
  */