Merge pull request #656 from dogandog/master

修正了部分doxygen注释格式
This commit is contained in:
Bernard Xiong 2016-09-25 21:32:38 +08:00 committed by GitHub
commit b8739a1363
13 changed files with 52 additions and 52 deletions

View File

@ -46,7 +46,7 @@ extern "C" {
* @addtogroup KernelObject
*/
/*@{*/
/**@{*/
/*
* kernel object interface
@ -72,13 +72,13 @@ void rt_object_take_sethook(void (*hook)(struct rt_object *object));
void rt_object_put_sethook(void (*hook)(struct rt_object *object));
#endif
/*@}*/
/**@}*/
/**
* @addtogroup Clock
*/
/*@{*/
/**@{*/
/*
* clock & timer interface
@ -116,13 +116,13 @@ void rt_timer_check(void);
void rt_timer_timeout_sethook(void (*hook)(struct rt_timer *timer));
#endif
/*@}*/
/**@}*/
/**
* @addtogroup Thread
*/
/*@{*/
/**@{*/
/*
* thread interface
@ -187,13 +187,13 @@ rt_uint16_t rt_critical_level(void);
void rt_scheduler_sethook(void (*hook)(rt_thread_t from, rt_thread_t to));
#endif
/*@}*/
/**@}*/
/**
* @addtogroup MM
*/
/*@{*/
/**@{*/
/*
* memory management interface
@ -266,13 +266,13 @@ void *rt_memheap_realloc(struct rt_memheap* heap, void* ptr, rt_size_t newsize);
void rt_memheap_free(void *ptr);
#endif
/*@}*/
/**@}*/
/**
* @addtogroup IPC
*/
/*@{*/
/**@{*/
#ifdef RT_USING_SEMAPHORE
/*
@ -371,14 +371,14 @@ rt_err_t rt_mq_recv(rt_mq_t mq,
rt_err_t rt_mq_control(rt_mq_t mq, rt_uint8_t cmd, void *arg);
#endif
/*@}*/
/**@}*/
#ifdef RT_USING_DEVICE
/**
* @addtogroup Device
*/
/*@{*/
/**@{*/
/*
* device (I/O) system interface
@ -411,7 +411,7 @@ rt_size_t rt_device_write(rt_device_t dev,
rt_size_t size);
rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void *arg);
/*@}*/
/**@}*/
#endif
#ifdef RT_USING_MODULE
@ -419,7 +419,7 @@ rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void *arg);
* @addtogroup Module
*/
/*@{*/
/**@{*/
/*
* module interface
@ -449,7 +449,7 @@ rt_err_t rt_module_destroy(rt_module_t module);
*/
int rt_system_module_init(void);
/*@}*/
/**@}*/
#endif
/*
@ -481,7 +481,7 @@ void rt_components_board_init(void);
* @addtogroup KernelService
*/
/*@{*/
/**@{*/
/*
* general kernel service
@ -534,7 +534,7 @@ void rt_assert_set_hook(void (*hook)(const char* ex, const char* func, rt_size_t
void rt_assert_handler(const char* ex, const char* func, rt_size_t line);
#endif /* RT_DEBUG */
/*@}*/
/**@}*/
#ifdef __cplusplus
}

View File

@ -50,7 +50,7 @@ void rt_system_tick_init(void)
* @addtogroup Clock
*/
/*@{*/
/**@{*/
/**
* This function will return current tick from operating system startup
@ -118,5 +118,5 @@ rt_tick_t rt_tick_from_millisecond(rt_uint32_t ms)
}
RTM_EXPORT(rt_tick_from_millisecond);
/*@}*/
/**@}*/

View File

@ -61,7 +61,7 @@ extern void (*rt_object_put_hook)(struct rt_object *object);
* @addtogroup IPC
*/
/*@{*/
/**@{*/
/**
* This function will initialize an IPC object
@ -2281,4 +2281,4 @@ rt_err_t rt_mq_control(rt_mq_t mq, rt_uint8_t cmd, void *arg)
RTM_EXPORT(rt_mq_control);
#endif /* end of RT_USING_MESSAGEQUEUE */
/*@}*/
/**@}*/

View File

@ -60,7 +60,7 @@ void rt_interrupt_leave_sethook(void (*hook)(void))
* @addtogroup Kernel
*/
/*@{*/
/**@{*/
volatile rt_uint8_t rt_interrupt_nest;
@ -123,5 +123,5 @@ RTM_EXPORT(rt_interrupt_get_nest);
RTM_EXPORT(rt_hw_interrupt_disable);
RTM_EXPORT(rt_hw_interrupt_enable);
/*@}*/
/**@}*/

View File

@ -43,7 +43,7 @@
* @addtogroup KernelService
*/
/*@{*/
/**@{*/
/* global errno in RT-Thread */
static volatile int _errno;
@ -1328,4 +1328,4 @@ int vsprintf(char *buf, const char *format, va_list arg_ptr) __attribute__((weak
#endif
/*@}*/
/**@}*/

View File

@ -76,7 +76,7 @@ static void (*rt_free_hook)(void *ptr);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when a memory
@ -100,7 +100,7 @@ void rt_free_sethook(void (*hook)(void *ptr))
rt_free_hook = hook;
}
/*@}*/
/**@}*/
#endif
@ -234,7 +234,7 @@ void rt_system_heap_init(void *begin_addr, void *end_addr)
* @addtogroup MM
*/
/*@{*/
/**@{*/
/**
* Allocate a block of memory with a minimum of 'size' bytes.
@ -585,7 +585,7 @@ FINSH_FUNCTION_EXPORT(list_mem, list memory usage information)
#endif
#endif
/*@}*/
/**@}*/
#endif /* end of RT_USING_HEAP */
#endif /* end of RT_USING_MEMHEAP_AS_HEAP */

View File

@ -43,7 +43,7 @@ static void (*rt_mp_free_hook)(struct rt_mempool *mp, void *block);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when a memory
@ -67,14 +67,14 @@ void rt_mp_free_sethook(void (*hook)(struct rt_mempool *mp, void *block))
rt_mp_free_hook = hook;
}
/*@}*/
/**@}*/
#endif
/**
* @addtogroup MM
*/
/*@{*/
/**@{*/
/**
* This function will initialize a memory pool object, normally which is used
@ -465,7 +465,7 @@ void rt_mp_free(void *block)
}
RTM_EXPORT(rt_mp_free);
/*@}*/
/**@}*/
#endif

View File

@ -366,7 +366,7 @@ static void (*rt_module_unload_hook)(rt_module_t module);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when module
@ -390,7 +390,7 @@ void rt_module_unload_sethook(void (*hook)(rt_module_t module))
rt_module_unload_hook = hook;
}
/*@}*/
/**@}*/
#endif
static struct rt_module *_load_shared_object(const char *name,

View File

@ -87,7 +87,7 @@ void (*rt_object_put_hook)(struct rt_object *object);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when object
@ -159,7 +159,7 @@ void rt_object_put_sethook(void (*hook)(struct rt_object *object))
rt_object_put_hook = hook;
}
/*@}*/
/**@}*/
#endif
/**
@ -178,7 +178,7 @@ void rt_system_object_init(void)
* @addtogroup KernelObject
*/
/*@{*/
/**@{*/
/**
* This function will return the specified type of object information.
@ -494,4 +494,4 @@ rt_object_t rt_object_find(const char *name, rt_uint8_t type)
return RT_NULL;
}
/*@}*/
/**@}*/

View File

@ -67,7 +67,7 @@ static void (*rt_scheduler_hook)(struct rt_thread *from, struct rt_thread *to);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when thread
@ -81,7 +81,7 @@ rt_scheduler_sethook(void (*hook)(struct rt_thread *from, struct rt_thread *to))
rt_scheduler_hook = hook;
}
/*@}*/
/**@}*/
#endif
#ifdef RT_USING_OVERFLOW_CHECK
@ -183,7 +183,7 @@ void rt_system_scheduler_start(void)
* @addtogroup Thread
*/
/*@{*/
/**@{*/
/**
* This function will perform one schedule. It will select one thread
@ -412,5 +412,5 @@ rt_uint16_t rt_critical_level(void)
return rt_scheduler_lock_nest;
}
RTM_EXPORT(rt_critical_level);
/*@}*/
/**@}*/

View File

@ -81,7 +81,7 @@ static void (*rt_free_hook)(void *ptr);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when a memory
@ -107,7 +107,7 @@ void rt_free_sethook(void (*hook)(void *ptr))
}
RTM_EXPORT(rt_free_sethook);
/*@}*/
/**@}*/
#endif
@ -472,7 +472,7 @@ rt_inline int zoneindex(rt_uint32_t *bytes)
* @addtogroup MM
*/
/*@{*/
/**@{*/
/**
* This function will allocate a block from system heap memory.
@ -963,6 +963,6 @@ FINSH_FUNCTION_EXPORT(list_mem, list memory usage information)
#endif
#endif
/*@}*/
/**@}*/
#endif

View File

@ -169,7 +169,7 @@ static rt_err_t _rt_thread_init(struct rt_thread *thread,
* @addtogroup Thread
*/
/*@{*/
/**@{*/
/**
* This function will initialize a thread, normally it's used to initialize a
@ -737,4 +737,4 @@ rt_thread_t rt_thread_find(char *name)
}
RTM_EXPORT(rt_thread_find);
/*@}*/
/**@}*/

View File

@ -63,7 +63,7 @@ static void (*rt_timer_timeout_hook)(struct rt_timer *timer);
* @addtogroup Hook
*/
/*@{*/
/**@{*/
/**
* This function will set a hook function, which will be invoked when timer
@ -76,7 +76,7 @@ void rt_timer_timeout_sethook(void (*hook)(struct rt_timer *timer))
rt_timer_timeout_hook = hook;
}
/*@}*/
/**@}*/
#endif
static void _rt_timer_init(rt_timer_t timer,
@ -164,7 +164,7 @@ void rt_timer_dump(rt_list_t timer_heads[])
* @addtogroup Clock
*/
/*@{*/
/**@{*/
/**
* This function will initialize a timer, normally this function is used to
@ -710,4 +710,4 @@ void rt_system_timer_thread_init(void)
#endif
}
/*@}*/
/**@}*/