Index: generic/src/proc/scheduler.c
===================================================================
--- generic/src/proc/scheduler.c	(revision a9e8b391eb50bc107c79551596bd8b68710ead90)
+++ generic/src/proc/scheduler.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
@@ -25,4 +25,12 @@
  * (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	scheduler.c
+ * @brief	Scheduler and load balancing.
+ *
+ * This file contains the scheduler and kcpulb kernel thread wich
+ * performs load-balancing of per-CPU run queues.
  */
 
Index: generic/src/proc/task.c
===================================================================
--- generic/src/proc/task.c	(revision a9e8b391eb50bc107c79551596bd8b68710ead90)
+++ generic/src/proc/task.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
@@ -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	task.c
+ * @brief	Task management.
  */
 
@@ -116,5 +121,5 @@
 /** Create new task with 1 thread and run it
  *
- * @param programe_addr Address of program executable image.
+ * @param program_addr Address of program executable image.
  * @param name Program name. 
  *
@@ -164,5 +169,5 @@
 /** Syscall for reading task ID from userspace.
  *
- * @param uaddr Userspace address of 8-byte buffer where to store current task ID.
+ * @param uspace_task_id Userspace address of 8-byte buffer where to store current task ID.
  *
  * @return Always returns 0.
Index: generic/src/proc/the.c
===================================================================
--- generic/src/proc/the.c	(revision a9e8b391eb50bc107c79551596bd8b68710ead90)
+++ generic/src/proc/the.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
@@ -25,4 +25,15 @@
  * (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	the.c
+ * @brief	THE structure functions.
+ *
+ * This file contains functions to manage the THE structure.
+ * The THE structure exists at the base address of every kernel
+ * stack and carries information about current settings
+ * (e.g. current CPU, current thread, task and address space
+ * and current preemption counter).
  */
 
Index: generic/src/proc/thread.c
===================================================================
--- generic/src/proc/thread.c	(revision a9e8b391eb50bc107c79551596bd8b68710ead90)
+++ generic/src/proc/thread.c	(revision 4fd61ba9ecb8f0f9026f3fa3a2b1cd920756fdb4)
@@ -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	thread.c
+ * @brief	Thread management functions.
  */