From fbe8a7ab90165ebfd9f3fab166cefe74e4e6de6d Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Wed, 3 Apr 2019 12:44:42 +0200 Subject: doxygen: Rework some Doxygen comments They are intended as examples in the RTEMS Software Engineering manual. Update #3704. --- cpukit/include/rtems/score/wkspace.h | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) (limited to 'cpukit/include/rtems/score/wkspace.h') diff --git a/cpukit/include/rtems/score/wkspace.h b/cpukit/include/rtems/score/wkspace.h index cbb4011824..551a10d50d 100644 --- a/cpukit/include/rtems/score/wkspace.h +++ b/cpukit/include/rtems/score/wkspace.h @@ -57,19 +57,16 @@ void _Workspace_Handler_initialization( ); /** - * @brief Allocate memory from workspace. + * @brief Allocates a memory block of the specified size from the workspace. * - * This routine returns the address of a block of memory of size - * bytes. If a block of the appropriate size cannot be allocated - * from the workspace, then NULL is returned. - * - * @param size is the requested size + * @param size The size of the memory block. * - * @retval a pointer to the requested memory or NULL. + * @retval pointer The pointer to the memory block. The pointer is at least + * aligned by CPU_HEAP_ALIGNMENT. + * @retval NULL No memory block with the requested size is available in the + * workspace. */ -void *_Workspace_Allocate( - size_t size -); +void *_Workspace_Allocate( size_t size ); /** * @brief Allocate aligned memory from workspace. -- cgit v1.2.3