From c18e0ba12799ea40693428b0a731bb561e61cab0 Mon Sep 17 00:00:00 2001 From: Alex Ivanov Date: Tue, 4 Dec 2012 17:59:11 -0500 Subject: rtems misc: Clean up Doxygen GCI Task #4 http://www.google-melange.com/gci/task/view/google/gci2012/7950205 --- cpukit/rtems/include/rtems/rtems/region.h | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) (limited to 'cpukit/rtems/include/rtems/rtems/region.h') diff --git a/cpukit/rtems/include/rtems/rtems/region.h b/cpukit/rtems/include/rtems/rtems/region.h index 61162cbb99..055e25d570 100644 --- a/cpukit/rtems/include/rtems/rtems/region.h +++ b/cpukit/rtems/include/rtems/rtems/region.h @@ -176,15 +176,26 @@ rtems_status_code rtems_region_delete( ); /** - * @brief rtems_region_get_segment + * @brief RTEMS Get Region Segment * * This routine implements the rtems_region_get_segment directive. It - * attempts to allocate a segment from the region associated with ID. - * If a segment of the requested size can be allocated, its address - * is returned in segment. If no segment is available, then the task + * attempts to allocate a segment from the region associated with @a id. + * If a segment of the requested @a size size can be allocated, its address + * is returned in @a segment. If no segment is available, then the task * may return immediately or block waiting for a segment with an optional - * timeout of timeout clock ticks. Whether the task blocks or returns - * immediately is based on the no_wait option in the option_set. + * timeout of @a timeout clock ticks. Whether the task blocks or returns + * immediately is based on the no_wait option in the @a option_set. + * + * @param[in] id is the region id + * @param[in] size is the segment size in bytes + * @param[in] option_set is the wait option + * @param[in] timeout is the number of ticks to wait (0 means wait forever) + * @param[in] segment is the pointer to segment address + * + * @return This method returns RTEMS_SUCCESSFUL if there was not an + * error. Otherwise, a status code is returned indicating the + * source of the error. If successful, the segment will + * be filled in with the segment address. */ rtems_status_code rtems_region_get_segment( rtems_id id, -- cgit v1.2.3