Changeset cc73a8a1 in mainline


Ignore:
Timestamp:
2006-06-20T12:26:16Z (19 years ago)
Author:
Jakub Jermar <jakub@…>
Branches:
lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export
Children:
2c8a70a
Parents:
1e0a5fc
Message:

Cleanup of comments.

Files:
43 edited

Legend:

Unmodified
Added
Removed
  • genarch/src/i8042/i8042.c

    r1e0a5fc rcc73a8a1  
    3131 */
    3232/**
    33  * @file        i8042.c
     33 * @file
    3434 * @brief       i8042 processor driver.
    3535 *
  • generic/include/config.h

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    5757
    5858typedef struct {
    59         count_t cpu_count;
    60         volatile count_t cpu_active;
     59        count_t cpu_count;              /**< Number of processors detected. */
     60        volatile count_t cpu_active;    /**< Number of processors that are up and running. */
    6161
    6262        __address base;
    63         size_t memory_size;
    64         size_t kernel_size;           /**< Size of memory in bytes taken by kernel and stack */
    65        
    66         bool mm_initialized;
     63        size_t memory_size;             /**< Size of detected memory in bytes. */
     64        size_t kernel_size;             /**< Size of memory in bytes taken by kernel and stack */
    6765} config_t;
    6866
     
    7270#endif
    7371
    74  /** @}
     72/** @}
    7573 */
    76 
  • generic/src/adt/bitmap.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericadt
     29/** @addtogroup genericadt
    3030 * @{
    3131 */
     
    186186}
    187187
    188  /** @}
     188/** @}
    189189 */
    190 
  • generic/src/adt/btree.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericadt
     29/** @addtogroup genericadt
    3030 * @{
    3131 */
     
    558558/** Split full B-tree node and insert new key-value-right-subtree triplet.
    559559 *
    560  * This function will split a node and return pointer to a newly created
     560 * This function will split a node and return a pointer to a newly created
    561561 * node containing keys greater than or equal to the greater of medians
    562562 * (or median) of the old keys and the newly added key. It will also write
     
    999999}
    10001000
    1001  /** @}
    1002  */
    1003 
     1001/** @}
     1002 */
  • generic/src/adt/hash_table.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericadt
     29/** @addtogroup genericadt
    3030 * @{
    3131 */
     
    174174}
    175175
    176  /** @}
     176/** @}
    177177 */
    178 
  • generic/src/adt/list.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericadt
     29/** @addtogroup genericadt
    3030 * @{
    3131 */
     
    9191}
    9292
    93  /** @}
     93/** @}
    9494 */
    95 
  • generic/src/interrupt/interrupt.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericinterrupt
     29/** @addtogroup genericinterrupt
    3030 * @{
    3131 */
     
    150150}
    151151
    152 
    153  /** @}
     152/** @}
    154153 */
    155 
  • generic/src/ipc/ipc.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericipc
     29/** @addtogroup genericipc
    3030 * @{
    3131 */
     
    531531}
    532532
    533  /** @}
    534  */
    535 
     533/** @}
     534 */
  • generic/src/ipc/ipcrsc.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericipc
     29/** @addtogroup genericipc
    3030 * @{
    3131 */
     
    214214}
    215215
    216  /** @}
    217  */
    218 
     216/** @}
     217 */
  • generic/src/ipc/irq.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericipc
     29/** @addtogroup genericipc
    3030 * @{
    3131 */
    32 /** @file
    33  */
    34 
    35 /** IRQ notification framework
     32/**
     33 * @file
     34 * @brief IRQ notification framework.
    3635 *
    3736 * This framework allows applications to register to receive a notification
     
    317316/** Disconnect all irq's notifications
    318317 *
    319  * TODO: It may be better to do some linked list, so that
     318 * @todo It may be better to do some linked list, so that
    320319 *       we wouldn't need to go through whole array every cleanup
    321320 */
     
    335334}
    336335
    337  /** @}
    338  */
    339 
     336/** @}
     337 */
  • generic/src/ipc/sysipc.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericipc
     29/** @addtogroup genericipc
    3030 * @{
    3131 */
     
    593593}
    594594
    595  /** @}
    596  */
    597 
     595/** @}
     596 */
  • generic/src/lib/elf.c

    r1e0a5fc rcc73a8a1  
    2828 */
    2929
    30  /** @addtogroup generic       
     30/** @addtogroup generic
    3131 * @{
    3232 */
     
    222222}
    223223
    224  /** @}
    225  */
    226 
     224/** @}
     225 */
  • generic/src/lib/func.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    193193}
    194194
    195  /** @}
     195/** @}
    196196 */
    197 
  • generic/src/lib/memstr.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    116116}
    117117
    118  /** @}
     118/** @}
    119119 */
    120 
  • generic/src/lib/sort.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    200200}
    201201
    202  /** @}
    203  */
    204 
     202/** @}
     203 */
  • generic/src/main/main.c

    r1e0a5fc rcc73a8a1  
    8888
    8989/** Global configuration structure. */
    90 config_t config = {
    91         .mm_initialized = false
    92 };
     90config_t config;
    9391
    9492/** Initial user-space tasks */
     
    9997context_t ctx;
    10098
    101 /**
     99/*
    102100 * These 'hardcoded' variables will be intialized by
    103101 * the linker or the low level assembler code with
    104102 * appropriate sizes and addresses.
    105103 */
    106 __address hardcoded_load_address = 0;
    107 size_t hardcoded_ktext_size = 0;
    108 size_t hardcoded_kdata_size = 0;
     104__address hardcoded_load_address = 0;   /**< Virtual address of where the kernel is loaded. */
     105size_t hardcoded_ktext_size = 0;        /**< Size of the kernel code in bytes. */
     106size_t hardcoded_kdata_size = 0;        /**< Size of the kernel data in bytes. */
    109107
    110108void main_bsp(void);
     
    202200        page_init();
    203201        tlb_init();
    204         config.mm_initialized = true;
    205202        arch_post_mm_init();
    206203
  • generic/src/main/version.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup main
     29/** @addtogroup main
    3030 * @{
    3131 */
     
    6060}
    6161
    62  /** @}
     62/** @}
    6363 */
    64 
  • generic/src/mm/as.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    4040 *
    4141 * Functionality provided by this file allows one to
    42  * create address space and create, resize and share
     42 * create address spaces and create, resize and share
    4343 * address space areas.
    4444 *
     
    7979#include <arch/interrupt.h>
    8080
     81/**
     82 * Each architecture decides what functions will be used to carry out
     83 * address space operations such as creating or locking page tables.
     84 */
    8185as_operations_t *as_operations = NULL;
    8286
     
    15301534}
    15311535
    1532  /** @}
    1533  */
    1534 
     1536/** @}
     1537 */
  • generic/src/mm/backend_anon.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    206206}
    207207
    208  /** @}
    209  */
    210 
     208/** @}
     209 */
  • generic/src/mm/backend_elf.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    306306}
    307307
    308  /** @}
    309  */
    310 
     308/** @}
     309 */
  • generic/src/mm/backend_phys.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    9292}
    9393
    94  /** @}
     94/** @}
    9595 */
    96 
  • generic/src/mm/buddy.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    322322}
    323323
    324  /** @}
    325  */
    326 
     324/** @}
     325 */
  • generic/src/mm/frame.c

    r1e0a5fc rcc73a8a1  
    2828 */
    2929
    30  /** @addtogroup genericmm
     30/** @addtogroup genericmm
    3131 * @{
    3232 */
     
    11501150}
    11511151
    1152 
    1153  /** @}
    1154  */
    1155 
     1152/** @}
     1153 */
  • generic/src/mm/page.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    140140}
    141141
    142  /** @}
     142/** @}
    143143 */
    144 
  • generic/src/mm/slab.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    8484 * magazines.
    8585 *
    86  * TODO:@n
     86 * @todo
    8787 * For better CPU-scaling the magazine allocation strategy should
    8888 * be extended. Currently, if the cache does not have magazine, it asks
     
    9494 * magazine cache.
    9595 *
    96  * @li it might be good to add granularity of locks even to slab level,
    97  *     we could then try_spinlock over all partial slabs and thus improve
    98  *     scalability even on slab level
     96 * @todo
     97 * it might be good to add granularity of locks even to slab level,
     98 * we could then try_spinlock over all partial slabs and thus improve
     99 * scalability even on slab level
    99100 */
    100101
     
    908909}
    909910
    910  /** @}
    911  */
    912 
     911/** @}
     912 */
  • generic/src/mm/tlb.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericmm
     29/** @addtogroup genericmm
    3030 * @{
    3131 */
     
    186186#endif /* CONFIG_SMP */
    187187
    188  /** @}
     188/** @}
    189189 */
    190 
  • generic/src/preempt/preemption.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    5757}
    5858
    59  /** @}
     59/** @}
    6060 */
    61 
  • generic/src/proc/scheduler.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  
    30  /** @addtogroup genericproc
     29/** @addtogroup genericproc
    3130 * @{
    3231 */
     
    699698}
    700699
    701  /** @}
    702  */
    703 
     700/** @}
     701 */
  • generic/src/proc/task.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericproc
     29/** @addtogroup genericproc
    3030 * @{
    3131 */
     
    496496}
    497497
    498  /** @}
    499  */
    500 
     498/** @}
     499 */
  • generic/src/proc/the.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericproc
     29/** @addtogroup genericproc
    3030 * @{
    3131 */
     
    7373}
    7474
    75  /** @}
     75/** @}
    7676 */
    77 
  • generic/src/proc/thread.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup genericproc
     29/** @addtogroup genericproc
    3030 * @{
    3131 */
     
    614614}
    615615
    616  /** @}
    617  */
    618 
     616/** @}
     617 */
  • generic/src/smp/ipi.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    6767#endif /* CONFIG_SMP */
    6868
    69  /** @}
     69/** @}
    7070 */
    71 
  • generic/src/synch/condvar.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    105105}
    106106
    107  /** @}
     107/** @}
    108108 */
    109 
  • generic/src/synch/futex.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    336336}
    337337
    338  /** @}
    339  */
    340 
     338/** @}
     339 */
  • generic/src/synch/mutex.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    8181}
    8282
    83 
    84  /** @}
     83/** @}
    8584 */
    86 
  • generic/src/synch/rwlock.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    3939 *
    4040 * These locks are not recursive.
    41  * Because technique called direct hand-off is used, neither readers
     41 * Because a technique called direct hand-off is used and because
     42 * waiting takes place in a single wait queue, neither readers
    4243 * nor writers will suffer starvation.
    4344 *
     
    385386}
    386387
    387  /** @}
    388  */
    389 
     388/** @}
     389 */
  • generic/src/synch/semaphore.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    9595}
    9696
    97  /** @}
     97/** @}
    9898 */
    99 
  • generic/src/synch/spinlock.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    159159#endif
    160160
    161  /** @}
     161/** @}
    162162 */
    163 
  • generic/src/synch/waitq.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup sync
     29/** @addtogroup sync
    3030 * @{
    3131 */
     
    451451}
    452452
    453  /** @}
    454  */
    455 
     453/** @}
     454 */
  • generic/src/sysinfo/sysinfo.c

    r1e0a5fc rcc73a8a1  
    2727 */
    2828
    29  /** @addtogroup generic       
     29/** @addtogroup generic
    3030 * @{
    3131 */
     
    307307}
    308308
    309  /** @}
     309/** @}
    310310 */
    311 
  • generic/src/time/clock.c

    r1e0a5fc rcc73a8a1  
    190190/** @}
    191191 */
    192 
  • generic/src/time/delay.c

    r1e0a5fc rcc73a8a1  
    6767/** @}
    6868 */
    69 
  • generic/src/time/timeout.c

    r1e0a5fc rcc73a8a1  
    217217/** @}
    218218 */
    219 
Note: See TracChangeset for help on using the changeset viewer.