diff options
author | Ralf Corsepius <ralf.corsepius@rtems.org> | 2009-11-28 05:58:54 +0000 |
---|---|---|
committer | Ralf Corsepius <ralf.corsepius@rtems.org> | 2009-11-28 05:58:54 +0000 |
commit | 20f02c63a77bc9b21b0970dba1d808d6c2e8748f (patch) | |
tree | ce3984621695dcd0d19a975ef8c3ca12fe8e3a48 /cpukit/score/include/rtems | |
parent | White space removal. (diff) | |
download | rtems-20f02c63a77bc9b21b0970dba1d808d6c2e8748f.tar.bz2 |
Whitespace removal.
Diffstat (limited to 'cpukit/score/include/rtems')
34 files changed, 125 insertions, 125 deletions
diff --git a/cpukit/score/include/rtems/score/address.h b/cpukit/score/include/rtems/score/address.h index 405c5b715c..034d905d32 100644 --- a/cpukit/score/include/rtems/score/address.h +++ b/cpukit/score/include/rtems/score/address.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/address.h * * This include file contains the information required to manipulate diff --git a/cpukit/score/include/rtems/score/apimutex.h b/cpukit/score/include/rtems/score/apimutex.h index 0288fd9367..691f60b709 100644 --- a/cpukit/score/include/rtems/score/apimutex.h +++ b/cpukit/score/include/rtems/score/apimutex.h @@ -1,4 +1,4 @@ -/** +/** * @file * * @ingroup ScoreAPIMutex diff --git a/cpukit/score/include/rtems/score/bitfield.h b/cpukit/score/include/rtems/score/bitfield.h index 0efc574f58..c0fa9b6b56 100644 --- a/cpukit/score/include/rtems/score/bitfield.h +++ b/cpukit/score/include/rtems/score/bitfield.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/bitfield.h * * This include file contains all bit field manipulation routines. @@ -37,7 +37,7 @@ extern "C" { * This table is used by the generic bitfield routines to perform * a highly optimized bit scan without the use of special CPU * instructions. - */ + */ #ifndef SCORE_INIT extern const unsigned char __log2table[256]; #else diff --git a/cpukit/score/include/rtems/score/chain.h b/cpukit/score/include/rtems/score/chain.h index daf44a6bb2..8dbef1e543 100644 --- a/cpukit/score/include/rtems/score/chain.h +++ b/cpukit/score/include/rtems/score/chain.h @@ -146,7 +146,7 @@ Chain_Node *_Chain_Get( * @brief Insert a node on a chain * * This routine inserts @a the_node on a chain immediately following - * @a after_node. + * @a after_node. * * @note It disables interrupts to ensure the atomicity * of the extract operation. diff --git a/cpukit/score/include/rtems/score/context.h b/cpukit/score/include/rtems/score/context.h index fe78e6c26c..862cf48fcd 100644 --- a/cpukit/score/include/rtems/score/context.h +++ b/cpukit/score/include/rtems/score/context.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/context.h * * This include file contains all information about each thread's context. @@ -57,7 +57,7 @@ SCORE_EXTERN volatile bool _Context_Switch_necessary; * thread's initial state. * * @param[in] _the_context will be initialized - * @param[in] _stack is the lowest physical address of the thread's + * @param[in] _stack is the lowest physical address of the thread's * context * @param[in] _size is the size in octets of the thread's context * @param[in] _isr is the ISR enable level for this thread diff --git a/cpukit/score/include/rtems/score/copyrt.h b/cpukit/score/include/rtems/score/copyrt.h index 6e537dd1bb..8c418abd7c 100644 --- a/cpukit/score/include/rtems/score/copyrt.h +++ b/cpukit/score/include/rtems/score/copyrt.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/copyrt.h * * This include file contains the copyright notice for RTEMS diff --git a/cpukit/score/include/rtems/score/corebarrier.h b/cpukit/score/include/rtems/score/corebarrier.h index e7cd83cfbc..05ec152487 100644 --- a/cpukit/score/include/rtems/score/corebarrier.h +++ b/cpukit/score/include/rtems/score/corebarrier.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/corebarrier.h * * This include file contains all the constants and structures associated diff --git a/cpukit/score/include/rtems/score/coremsg.h b/cpukit/score/include/rtems/score/coremsg.h index 8f28373eea..4a93f6de25 100644 --- a/cpukit/score/include/rtems/score/coremsg.h +++ b/cpukit/score/include/rtems/score/coremsg.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/coremsg.h * * This include file contains all the constants and structures associated @@ -106,7 +106,7 @@ typedef enum { CORE_MESSAGE_QUEUE_DISCIPLINES_PRIORITY } CORE_message_queue_Disciplines; -/** +/** * @brief Message Priority for Appending * * This is the priority constant used when appending messages onto @@ -114,7 +114,7 @@ typedef enum { */ #define CORE_MESSAGE_QUEUE_SEND_REQUEST INT_MAX -/** +/** * @brief Message Priority for Prepending * * This is the priority constant used when prepending messages onto @@ -228,7 +228,7 @@ typedef struct { */ CORE_message_queue_Buffer *message_buffers; #if defined(RTEMS_SCORE_COREMSG_ENABLE_NOTIFICATION) - /** This is the routine invoked when the message queue transitions + /** This is the routine invoked when the message queue transitions * from zero (0) messages pending to one (1) message pending. */ CORE_message_queue_Notify_Handler notify_handler; @@ -255,7 +255,7 @@ typedef struct { * may be sent to this message queue instance * * @return true if the message queue can be initialized. In general, - * false will only be returned if memory for the pending + * false will only be returned if memory for the pending * messages cannot be allocated. */ bool _CORE_message_queue_Initialize( @@ -337,7 +337,7 @@ uint32_t _CORE_message_queue_Flush_support( * @param[in] size is the size of the message being broadcast * @param[in] id is the RTEMS object Id associated with this message queue. * It is used when unblocking a remote thread. - * @param[in] api_message_queue_mp_support is the routine to invoke if + * @param[in] api_message_queue_mp_support is the routine to invoke if * a thread that is unblocked is actually a remote thread. * @param[out] count points to the variable that will contain the * number of tasks that are sent this message @@ -368,7 +368,7 @@ CORE_message_queue_Status _CORE_message_queue_Broadcast( * @param[in] size is the size of the message being send * @param[in] id is the RTEMS object Id associated with this message queue. * It is used when unblocking a remote thread. - * @param[in] api_message_queue_mp_support is the routine to invoke if + * @param[in] api_message_queue_mp_support is the routine to invoke if * a thread that is unblocked is actually a remote thread. * @param[in] submit_type determines whether the message is prepended, * appended, or enqueued in priority order. @@ -408,7 +408,7 @@ CORE_message_queue_Status _CORE_message_queue_Submit( * if the message queue is empty. * @param[in] timeout is the maximum number of clock ticks that the calling * thread is willing to block if the message queue is empty. - * + * * @return indication of the successful completion or reason for failure * @note Returns message priority via return are in TCB. */ diff --git a/cpukit/score/include/rtems/score/coremutex.h b/cpukit/score/include/rtems/score/coremutex.h index 35007652c8..c047347327 100644 --- a/cpukit/score/include/rtems/score/coremutex.h +++ b/cpukit/score/include/rtems/score/coremutex.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/coremutex.h * * This include file contains all the constants and structures associated @@ -71,7 +71,7 @@ typedef enum { */ CORE_MUTEX_DISCIPLINES_PRIORITY_CEILING } CORE_mutex_Disciplines; - + /** * @brief Mutex method return statuses * @@ -195,7 +195,7 @@ typedef struct { #ifdef __RTEMS_STRICT_ORDER_MUTEX__ /*@beief Core Mutex Lock_Chain Struct * - * The following defines the control block used to manage lock chain of + * The following defines the control block used to manage lock chain of * priority inheritance mutex. */ typedef struct{ @@ -245,7 +245,7 @@ typedef struct { /** This field is used to manipulate the priority inheritance mutex queue*/ CORE_mutex_order_list queue; #endif - + } CORE_mutex_Control; /** @@ -310,7 +310,7 @@ RTEMS_INLINE_ROUTINE int _CORE_mutex_Seize_interrupt_trylock_body( /** * The default is to favor speed and inlining this definitely saves * a few instructions. This is very important for mutex performance. - * + * * @param[in] _mutex will attempt to lock * @param[in] _level_p is the interrupt level holder */ @@ -349,16 +349,16 @@ void _CORE_mutex_Seize_interrupt_blocking( * * @note If the mutex is called from an interrupt service routine, * with context switching disabled, or before multitasking, - * then a fatal error is generated. + * then a fatal error is generated. * * The logic on this routine is as follows: * * * If incorrect system state - * return an error + * return an error * * If mutex is available without any contention or blocking * obtain it with interrupts disabled and returned * * If the caller is willing to wait - * then they are blocked. + * then they are blocked. */ #define _CORE_mutex_Seize_body( \ diff --git a/cpukit/score/include/rtems/score/corerwlock.h b/cpukit/score/include/rtems/score/corerwlock.h index 6a636c8029..f97e4679b8 100644 --- a/cpukit/score/include/rtems/score/corerwlock.h +++ b/cpukit/score/include/rtems/score/corerwlock.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/corerwlock.h * * This include file contains all the constants and structures associated diff --git a/cpukit/score/include/rtems/score/coresem.h b/cpukit/score/include/rtems/score/coresem.h index 1b91a22cbd..373965f67e 100644 --- a/cpukit/score/include/rtems/score/coresem.h +++ b/cpukit/score/include/rtems/score/coresem.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/coresem.h * * This include file contains all the constants and structures associated diff --git a/cpukit/score/include/rtems/score/corespinlock.h b/cpukit/score/include/rtems/score/corespinlock.h index fa5e851696..907f7bb5b5 100644 --- a/cpukit/score/include/rtems/score/corespinlock.h +++ b/cpukit/score/include/rtems/score/corespinlock.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/corespinlock.h * * This include file contains all the constants and structures associated @@ -50,11 +50,11 @@ typedef enum { */ CORE_SPINLOCK_NOT_HOLDER, /** This status indicates that a thread reached the limit of time it - * was willing to wait on the spin lock. + * was willing to wait on the spin lock. */ CORE_SPINLOCK_TIMEOUT, /** This status indicates that a thread is currently waiting for this - * spin lock. + * spin lock. */ CORE_SPINLOCK_IS_BUSY, /** This status indicates that the spinlock is currently locked and thus @@ -92,7 +92,7 @@ typedef struct { */ typedef struct { /** XXX may not be needed */ - CORE_spinlock_Attributes Attributes; + CORE_spinlock_Attributes Attributes; /** This field is the lock. */ diff --git a/cpukit/score/include/rtems/score/interr.h b/cpukit/score/include/rtems/score/interr.h index 226047934d..eb654d441f 100644 --- a/cpukit/score/include/rtems/score/interr.h +++ b/cpukit/score/include/rtems/score/interr.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/interr.h * * This include file contains constants and prototypes related diff --git a/cpukit/score/include/rtems/score/isr.h b/cpukit/score/include/rtems/score/isr.h index 581c65cdc1..66adbcb943 100644 --- a/cpukit/score/include/rtems/score/isr.h +++ b/cpukit/score/include/rtems/score/isr.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/isr.h * * This include file contains all the constants and structures associated @@ -199,7 +199,7 @@ void _ISR_Dispatch( void ); * Invokes the thread dispatcher or signal extension if necessary. * * It should be called at the end of interrupt processing. The interrupt nest - * level must be zero before calling this routine. + * level must be zero before calling this routine. * * This is a high level replacement of _ISR_Dispatch(). It must be invoked * within an environment such that a call to _Thread_Dispatch() is allowed. diff --git a/cpukit/score/include/rtems/score/mpci.h b/cpukit/score/include/rtems/score/mpci.h index 366e84f289..f763ed89a8 100644 --- a/cpukit/score/include/rtems/score/mpci.h +++ b/cpukit/score/include/rtems/score/mpci.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/mpci.h * * This include file contains all the constants and structures associated @@ -23,7 +23,7 @@ * @defgroup ScoreMPCI MPCI Handler * * The MPCI Handler encapsulates functionality which is related to the - * generation, receipt, and processing of remote operations in a + * generation, receipt, and processing of remote operations in a * multiprocessor system. This handler contains the message passing * support for making remote service calls as well as the server thread * which processes requests from remote nodes. @@ -67,7 +67,7 @@ typedef MPCI_Entry ( *MPCI_initialization_entry )( void ); /** * This type defines the prototype for the get packet entry point - * in an Multiprocessor Communications Interface. The single + * in an Multiprocessor Communications Interface. The single * parameter will point to the packet allocated. */ typedef MPCI_Entry ( *MPCI_get_packet_entry )( @@ -76,7 +76,7 @@ typedef MPCI_Entry ( *MPCI_get_packet_entry )( /** * This type defines the prototype for the return packet entry point - * in an Multiprocessor Communications Interface. The single + * in an Multiprocessor Communications Interface. The single * parameter will point to a packet previously allocated by the * get packet MPCI entry. */ @@ -86,7 +86,7 @@ typedef MPCI_Entry ( *MPCI_return_packet_entry )( /** * This type defines the prototype for send get packet entry point - * in an Multiprocessor Communications Interface. The single + * in an Multiprocessor Communications Interface. The single * parameter will point to a packet previously allocated by the * get packet entry point that has been filled in by the caller. */ @@ -97,7 +97,7 @@ typedef MPCI_Entry ( *MPCI_send_entry )( /** * This type defines the prototype for the receive packet entry point - * in an Multiprocessor Communications Interface. The single + * in an Multiprocessor Communications Interface. The single * parameter will point to a packet allocated and filled in by the * receive packet handler. The caller will block until a packet is * received. @@ -118,7 +118,7 @@ typedef struct { /** This fields contains the timeout for MPCI operations in ticks. */ uint32_t default_timeout; /** This field contains the maximum size of a packet supported by this - * MPCI layer. This size places a limit on the size of a message + * MPCI layer. This size places a limit on the size of a message * which can be transmitted over this interface. **/ size_t maximum_packet_size; @@ -161,7 +161,7 @@ typedef struct { * on all nodes. */ uint32_t maximum_nodes; - /** This field is the maximum number of concurrently existent + /** This field is the maximum number of concurrently existent * globally offered objects. */ uint32_t maximum_global_objects; @@ -221,7 +221,7 @@ void _MPCI_Initialization ( void ); * * @param[in] the_class is the class indicator for packets which will * be processed by @a the_packet_processor method. - * @param[in] the_packet_processor is a pointer to a method which is + * @param[in] the_packet_processor is a pointer to a method which is * invoked when packets with @a the_class are received. */ void _MPCI_Register_packet_processor( @@ -309,7 +309,7 @@ MP_packet_Prefix *_MPCI_Receive_packet ( void ); * @param[in] the_packet is the response packet to be processed. * * @return This method returns a pointer to the thread which was if unblocked - * or NULL if the waiting thread no longer exists. + * or NULL if the waiting thread no longer exists. */ Thread_Control *_MPCI_Process_response ( MP_packet_Prefix *the_packet diff --git a/cpukit/score/include/rtems/score/mppkt.h b/cpukit/score/include/rtems/score/mppkt.h index b194610500..db8e60d0df 100644 --- a/cpukit/score/include/rtems/score/mppkt.h +++ b/cpukit/score/include/rtems/score/mppkt.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/mppkt.h * * This package is the specification for the Packet Handler. diff --git a/cpukit/score/include/rtems/score/object.h b/cpukit/score/include/rtems/score/object.h index c8e3036a7c..c271caf846 100644 --- a/cpukit/score/include/rtems/score/object.h +++ b/cpukit/score/include/rtems/score/object.h @@ -552,7 +552,7 @@ void _Objects_Free( /** * This macro is used to build a thirty-two bit style name from - * four characters. The most significant byte will be the + * four characters. The most significant byte will be the * character @a _C1. * * @param[in] _C1 is the first character of the name @@ -605,7 +605,7 @@ typedef enum { * @param[in] node is the set of nodes to search. * @param[in] id will contain the Id if the search is successful. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a id will contain the Id of * the requested object. @@ -626,7 +626,7 @@ Objects_Name_or_id_lookup_errors _Objects_Name_to_id_u32( * @param[in] name is the name of the object to find. * @param[in] id will contain the Id if the search is successful. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a id will contain the Id of * the requested object. @@ -646,7 +646,7 @@ Objects_Name_or_id_lookup_errors _Objects_Name_to_id_string( * @param[in] id is the Id of the object whose name we are locating. * @param[in] name will contain the name of the object, if found. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a name will contain the name of * the requested object. @@ -672,7 +672,7 @@ Objects_Name_or_id_lookup_errors _Objects_Id_to_name ( * @param[in] id is the Id of the object whose name we are locating. * @param[in] location will contain an indication of success or failure. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a id will contain the Id of * the requested object. @@ -703,7 +703,7 @@ Objects_Control *_Objects_Get ( * @param[in] location will contain an indication of success or failure. * @param[in] level is the interrupt level being turned. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a name will contain the name of * the requested object. @@ -732,7 +732,7 @@ Objects_Control *_Objects_Get_isr_disable( * * @return This method returns a pointer to the object associated with ID. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a id will contain the id of * the requested object. @@ -762,7 +762,7 @@ Objects_Control *_Objects_Get_by_index ( * @param[in] id is the Id of the object whose name we are locating. * @param[in] location will contain an indication of success or failure. * - * @return This method returns one of the values from the + * @return This method returns one of the values from the * @ref Objects_Name_or_id_lookup_errors enumeration to indicate * successful or failure. On success @a id will contain the Id of * the requested object. @@ -786,7 +786,7 @@ Objects_Control *_Objects_Get_no_protection( * @param[in] location_p will contain an indication of success or failure. * @param[in] next_id_p is the Id of the next object we will look at. * - * @return This method returns the pointer to the object located or + * @return This method returns the pointer to the object located or * NULL on error. */ Objects_Control *_Objects_Get_next( diff --git a/cpukit/score/include/rtems/score/objectmp.h b/cpukit/score/include/rtems/score/objectmp.h index aba3a73676..318819ffd8 100644 --- a/cpukit/score/include/rtems/score/objectmp.h +++ b/cpukit/score/include/rtems/score/objectmp.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/objectmp.h * * This include file contains all the constants and structures associated diff --git a/cpukit/score/include/rtems/score/priority.h b/cpukit/score/include/rtems/score/priority.h index 31beb6fc2c..3aba088d06 100644 --- a/cpukit/score/include/rtems/score/priority.h +++ b/cpukit/score/include/rtems/score/priority.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/priority.h * * This include file contains all thread priority manipulation routines. @@ -26,8 +26,8 @@ * This handler encapsulates functionality which is used to manage * thread priorities. At the SuperCore level 256 priority levels * are supported with lower numbers representing logically more important - * threads. The priority level 0 is reserved for internal RTEMS use. - * Typically it is assigned to threads which defer internal RTEMS + * threads. The priority level 0 is reserved for internal RTEMS use. + * Typically it is assigned to threads which defer internal RTEMS * actions from an interrupt to thread level to improve interrupt response. * Priority level 255 is assigned to the IDLE thread and really should not * be used by application threads. The default IDLE thread implementation diff --git a/cpukit/score/include/rtems/score/stack.h b/cpukit/score/include/rtems/score/stack.h index 758ad36c38..8f5a0173f3 100644 --- a/cpukit/score/include/rtems/score/stack.h +++ b/cpukit/score/include/rtems/score/stack.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/stack.h * * This include file contains all information about the thread diff --git a/cpukit/score/include/rtems/score/states.h b/cpukit/score/include/rtems/score/states.h index 305460bd8c..fc56924d8a 100644 --- a/cpukit/score/include/rtems/score/states.h +++ b/cpukit/score/include/rtems/score/states.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/states.h * * This include file contains thread execution state information. @@ -21,7 +21,7 @@ /** * @defgroup ScoreStates Thread States Handler * - * This handler encapsulates functionality which relates to the management of + * This handler encapsulates functionality which relates to the management of * the state bitmap associated with each thread. */ /**@{*/ @@ -97,7 +97,7 @@ typedef uint32_t States_Control; STATES_WAITING_FOR_JOIN_AT_EXIT | \ STATES_WAITING_FOR_SIGNAL | \ STATES_WAITING_FOR_BARRIER | \ - STATES_WAITING_FOR_RWLOCK ) + STATES_WAITING_FOR_RWLOCK ) /** This macro corresponds to a task waiting which is blocked on * a thread queue. */ diff --git a/cpukit/score/include/rtems/score/sysstate.h b/cpukit/score/include/rtems/score/sysstate.h index 52fa1c0b89..bb133b57a3 100644 --- a/cpukit/score/include/rtems/score/sysstate.h +++ b/cpukit/score/include/rtems/score/sysstate.h @@ -1,4 +1,4 @@ -/** +/** * @file * * @ingroup ScoreSysState @@ -50,7 +50,7 @@ typedef enum { SYSTEM_STATE_BEFORE_MULTITASKING, /** - * @brief The system is attempting to initiate multitasking. + * @brief The system is attempting to initiate multitasking. */ SYSTEM_STATE_BEGIN_MULTITASKING, diff --git a/cpukit/score/include/rtems/score/thread.h b/cpukit/score/include/rtems/score/thread.h index ed5b475cd1..9e09efc950 100644 --- a/cpukit/score/include/rtems/score/thread.h +++ b/cpukit/score/include/rtems/score/thread.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/thread.h * * This include file contains all constants and structures associated @@ -92,7 +92,7 @@ typedef void *Thread; /** * @brief Type of the numeric argument of a thread entry function with at - * least one numeric argument. + * least one numeric argument. * * This numeric argument type designates an unsigned integer type with the * property that any valid pointer to void can be converted to this type and @@ -274,13 +274,13 @@ typedef struct { /** This field contains any options in effect on this blocking operation. */ uint32_t option; /** This field will contain the return status from a blocking operation. - * + * * @note The following assumes that all API return codes can be * treated as an uint32_t. */ uint32_t return_code; - /** This field is the chain header for the second through Nth tasks + /** This field is the chain header for the second through Nth tasks * of the same priority blocked waiting on the same object. */ Chain_Control Block2n; @@ -377,7 +377,7 @@ struct Thread_Control_struct { /** This field is true if the thread is offered globally */ bool is_global; #endif - /** This field is is true if the post task context switch should be + /** This field is is true if the post task context switch should be * executed for this thread at the next context switch. */ bool do_post_task_switch_extension; diff --git a/cpukit/score/include/rtems/score/threadmp.h b/cpukit/score/include/rtems/score/threadmp.h index d187f69398..f3a3840f5d 100644 --- a/cpukit/score/include/rtems/score/threadmp.h +++ b/cpukit/score/include/rtems/score/threadmp.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/threadmp.h * * This include file contains the specification for all routines @@ -22,7 +22,7 @@ /** * @defgroup ScoreThreadMP Thread Handler Multiprocessing Support * - * This handler encapsulates functionality which is related to managing + * This handler encapsulates functionality which is related to managing * threads in a multiprocessor system configuration. This handler must * manage proxies which represent remote threads blocking on local * operations. diff --git a/cpukit/score/include/rtems/score/threadq.h b/cpukit/score/include/rtems/score/threadq.h index 5da779983f..7519fdae54 100644 --- a/cpukit/score/include/rtems/score/threadq.h +++ b/cpukit/score/include/rtems/score/threadq.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/threadq.h * * This include file contains all the constants and structures associated @@ -81,7 +81,7 @@ Thread_Control *_Thread_queue_Dequeue( _the_thread_queue, \ _timeout, \ _Thread_queue_Timeout ) - + /** @brief Thread queue Enqueue * @@ -192,7 +192,7 @@ Thread_blocking_operation_States _Thread_queue_Enqueue_priority ( void _Thread_queue_Extract_priority_helper( Thread_queue_Control *the_thread_queue, Thread_Control *the_thread, - bool requeuing + bool requeuing ); /** @@ -273,7 +273,7 @@ void _Thread_queue_Timeout ( /** * @brief Process Thread Queue Timeout * - * This is a shared helper routine which makes it easier to have multiple + * This is a shared helper routine which makes it easier to have multiple * object class specific timeout routines. * * @param[in] the_thread is the thread to extract diff --git a/cpukit/score/include/rtems/score/threadsync.h b/cpukit/score/include/rtems/score/threadsync.h index aa71d5c1a8..9b5e3dee96 100644 --- a/cpukit/score/include/rtems/score/threadsync.h +++ b/cpukit/score/include/rtems/score/threadsync.h @@ -1,8 +1,8 @@ -/** +/** * @file rtems/score/threadsync.h * * This include file contains all constants and structures associated - * with synchronizing a thread blocking operation with potential + * with synchronizing a thread blocking operation with potential * actions in an ISR. */ diff --git a/cpukit/score/include/rtems/score/timespec.h b/cpukit/score/include/rtems/score/timespec.h index d7c543bb3e..9b55b7ed5e 100644 --- a/cpukit/score/include/rtems/score/timespec.h +++ b/cpukit/score/include/rtems/score/timespec.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/timespec.h * * This include file contains helpers for manipulating timespecs. @@ -89,7 +89,7 @@ extern "C" { * * @param[in] time is the timespec instance to validate. * - * @return This method returns true if @a time is valid and + * @return This method returns true if @a time is valid and * false otherwise. */ bool _Timespec_Is_valid( @@ -103,7 +103,7 @@ bool _Timespec_Is_valid( * @param[in] lhs is the left hand side timespec * @param[in] rhs is the right hand side timespec * - * @return This method returns true if @a lhs is less than the @a rhs and + * @return This method returns true if @a lhs is less than the @a rhs and * false otherwise. */ bool _Timespec_Less_than( @@ -118,7 +118,7 @@ bool _Timespec_Less_than( * @param[in] lhs is the left hand side timespec * @param[in] rhs is the right hand side timespec * - * @return This method returns true if @a lhs is greater than the @a rhs and + * @return This method returns true if @a lhs is greater than the @a rhs and * false otherwise. */ bool _Timespec_Greater_than( @@ -133,7 +133,7 @@ bool _Timespec_Greater_than( * @param[in] lhs is the left hand side timespec * @param[in] rhs is the right hand side timespec * - * @return This method returns true if @a lhs is equal to @a rhs and + * @return This method returns true if @a lhs is equal to @a rhs and * false otherwise. */ #define _Timespec_Equal_to( lhs, rhs ) \ @@ -147,7 +147,7 @@ bool _Timespec_Greater_than( * to the first. * * @param[in] time is the base time to be added to - * @param[in] add is the timespec to add to the first argument + * @param[in] add is the timespec to add to the first argument * * @return This method returns the number of seconds @a time increased by. */ @@ -202,7 +202,7 @@ void _Timespec_Subtract( /** @brief Divide Timespec By Integer * * This routine divides a timespec by an integer value. The expected - * use is to assist in benchmark calculations where you typically + * use is to assist in benchmark calculations where you typically * divide a duration by a number of iterations. * * @param[in] time is the total @@ -219,7 +219,7 @@ void _Timespec_Divide_by_integer( /** @brief Divide Timespec * - * This routine divides a timespec by another timespec. The + * This routine divides a timespec by another timespec. The * intended use is for calculating percentages to three decimal points. * * @param[in] lhs is the left hand number diff --git a/cpukit/score/include/rtems/score/timestamp.h b/cpukit/score/include/rtems/score/timestamp.h index d039a195fb..aca7e98663 100644 --- a/cpukit/score/include/rtems/score/timestamp.h +++ b/cpukit/score/include/rtems/score/timestamp.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/timestamp.h * * This include file contains helpers for manipulating timestamps. @@ -48,7 +48,7 @@ extern "C" { * NOTE: Eventually each port should select what it should use!!! * * These control which implementation of SuperCore Timestamp is used. - * + * * if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) * struct timespec is used * else if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_INT64) @@ -63,26 +63,26 @@ extern "C" { * Performance of int64_t versus struct timespec * ============================================= * - * On PowerPC/psim, inlined int64_t saves ~50 instructions on each + * On PowerPC/psim, inlined int64_t saves ~50 instructions on each * _Thread_Dispatch operation which results in a context switch. * This works out to be about 10% faster dispatches and 7.5% faster * blocking semaphore obtains. The following numbers are in instructions * and from tm02 and tm26. * - * timespec int64 inlined int64 + * timespec int64 inlined int64 * dispatch: 446 446 400 * blocking sem obtain: 627 626 581 * * On SPARC/sis, inlined int64_t shows the same percentage gains. * The following numbers are in microseconds and from tm02 and tm26. * - * timespec int64 inlined int64 + * timespec int64 inlined int64 * dispatch: 59 61 53 * blocking sem obtain: 98 100 92 * * Inlining appears to have a tendency to increase the size of * some executables. - * Not inlining reduces the execution improvement but does not seem to + * Not inlining reduces the execution improvement but does not seem to * be an improvement on the PowerPC and SPARC. The struct timespec * and the executables with int64 not inlined are about the same size. * @@ -168,7 +168,7 @@ extern "C" { * * @param[in] _time points to the timestamp instance to validate. * - * @return This method returns true if @a time is valid and + * @return This method returns true if @a time is valid and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) @@ -186,7 +186,7 @@ extern "C" { * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is less than the @a _rhs and + * @return This method returns true if @a _lhs is less than the @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) @@ -204,7 +204,7 @@ extern "C" { * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is greater than the @a _rhs and + * @return This method returns true if @a _lhs is greater than the @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) @@ -222,7 +222,7 @@ extern "C" { * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is equal to @a _rhs and + * @return This method returns true if @a _lhs is equal to @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) @@ -239,7 +239,7 @@ extern "C" { * to the first. * * @param[in] _time points to the base time to be added to - * @param[in] _add points to the timestamp to add to the first argument + * @param[in] _add points to the timestamp to add to the first argument * * @return This method returns the number of seconds @a time increased by. */ @@ -255,7 +255,7 @@ extern "C" { * * This routine adds two timestamps. The second argument is added * to the first. - * + * * @node This routine places a special requirement on the addition * operation. It must return the number of units that the * seconds field changed as the result of the addition. Since this @@ -263,7 +263,7 @@ extern "C" { * it is generally safe to assume that only one second changed. * * @param[in] _time points to the base time to be added to - * @param[in] _add points to the timestamp to add to the first argument + * @param[in] _add points to the timestamp to add to the first argument * * @return This method returns the number of seconds @a time increased by. */ @@ -331,7 +331,7 @@ extern "C" { /** @brief Divide Timestamp By Integer * * This routine divides a timestamp by an integer value. The expected - * use is to assist in benchmark calculations where you typically + * use is to assist in benchmark calculations where you typically * divide a duration by a number of iterations. * * @param[in] _time points to the total @@ -350,7 +350,7 @@ extern "C" { /** @brief Divide Timestamp * - * This routine divides a timestamp by another timestamp. The + * This routine divides a timestamp by another timestamp. The * intended use is for calculating percentages to three decimal points. * * @param[in] _lhs points to the left hand number @@ -410,7 +410,7 @@ extern "C" { #if defined(CPU_RTEMS_SCORE_TIMESTAMP_IS_STRUCT_SPEC) /* in this case we know they are the same type so use simple assignment */ #define _Timestamp_To_timespec( _timestamp, _timespec ) \ - *(_timespec) = *(_timestamp) + *(_timespec) = *(_timestamp) #else #define _Timestamp_To_timespec( _timestamp, _timespec ) \ _Timestamp64_To_timespec( _timestamp, _timespec ) diff --git a/cpukit/score/include/rtems/score/timestamp64.h b/cpukit/score/include/rtems/score/timestamp64.h index 34b83c41cd..47e140fcbb 100644 --- a/cpukit/score/include/rtems/score/timestamp64.h +++ b/cpukit/score/include/rtems/score/timestamp64.h @@ -1,7 +1,7 @@ -/** +/** * @file rtems/score/timestamp64.h * - * This include file contains helpers for manipulating + * This include file contains helpers for manipulating * 64-bit integer timestamps. */ @@ -96,7 +96,7 @@ typedef int64_t Timestamp64_Control; * * @param[in] _time points to the timestamp instance to validate. * - * @return This method returns true if @a time is valid and + * @return This method returns true if @a time is valid and * false otherwise. */ #define _Timestamp64_Is_valid( _time ) \ @@ -109,7 +109,7 @@ typedef int64_t Timestamp64_Control; * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is less than the @a _rhs and + * @return This method returns true if @a _lhs is less than the @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE) @@ -129,7 +129,7 @@ typedef int64_t Timestamp64_Control; * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is greater than the @a _rhs and + * @return This method returns true if @a _lhs is greater than the @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE) @@ -149,7 +149,7 @@ typedef int64_t Timestamp64_Control; * @param[in] _lhs points to the left hand side timestamp * @param[in] _rhs points to the right hand side timestamp * - * @return This method returns true if @a _lhs is equal to @a _rhs and + * @return This method returns true if @a _lhs is equal to @a _rhs and * false otherwise. */ #if defined(CPU_RTEMS_SCORE_TIMESTAMP_INT64_INLINE) @@ -168,7 +168,7 @@ typedef int64_t Timestamp64_Control; * to the first. * * @param[in] _time points to the base time to be added to - * @param[in] _add points to the timestamp to add to the first argument + * @param[in] _add points to the timestamp to add to the first argument * * @return This method returns the number of seconds @a time increased by. */ @@ -186,7 +186,7 @@ typedef int64_t Timestamp64_Control; * * This routine adds two timestamps. The second argument is added * to the first. - * + * * @node This routine places a special requirement on the addition * operation. It must return the number of units that the * seconds field changed as the result of the addition. Since this @@ -194,7 +194,7 @@ typedef int64_t Timestamp64_Control; * it is generally safe to assume that only one second changed. * * @param[in] _time points to the base time to be added to - * @param[in] _add points to the timestamp to add to the first argument + * @param[in] _add points to the timestamp to add to the first argument * * @return This method returns the number of seconds @a time increased by. */ @@ -265,7 +265,7 @@ void _Timestamp64_From_ticks( /** @brief Divide Timestamp By Integer * * This routine divides a timestamp by an integer value. The expected - * use is to assist in benchmark calculations where you typically + * use is to assist in benchmark calculations where you typically * divide a duration by a number of iterations. * * @param[in] _time points to the total @@ -289,7 +289,7 @@ void _Timestamp64_From_ticks( /** @brief Divide Timestamp * - * This routine divides a timestamp by another timestamp. The + * This routine divides a timestamp by another timestamp. The * intended use is for calculating percentages to three decimal points. * * @param[in] _lhs points to the left hand number diff --git a/cpukit/score/include/rtems/score/tod.h b/cpukit/score/include/rtems/score/tod.h index 9d21106984..588e728c61 100644 --- a/cpukit/score/include/rtems/score/tod.h +++ b/cpukit/score/include/rtems/score/tod.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/tod.h * * This include file contains all the constants and structures associated @@ -112,7 +112,7 @@ extern "C" { /** * @defgroup ScoreTOD Time Of Day (TOD) Handler * - * This handler encapsulates functionality used to manage time of day. + * This handler encapsulates functionality used to manage time of day. */ /**@{*/ @@ -158,7 +158,7 @@ void _TOD_Set( /** @brief _TOD_Get * * This routine returns the current time of day with potential accuracy - * to the nanosecond. + * to the nanosecond. * * @param[in] time is a pointer to the time to be returned */ @@ -169,7 +169,7 @@ void _TOD_Get( /** @brief _TOD_Get_uptime * * This routine returns the system uptime with potential accuracy - * to the nanosecond. + * to the nanosecond. * * @param[in] time is a pointer to the uptime to be returned */ @@ -180,7 +180,7 @@ void _TOD_Get_uptime( /** @brief _TOD_Get_uptime_as_timespec * * This routine returns the system uptime with potential accuracy - * to the nanosecond. + * to the nanosecond. * * @param[in] time is a pointer to the uptime to be returned */ diff --git a/cpukit/score/include/rtems/score/tqdata.h b/cpukit/score/include/rtems/score/tqdata.h index 5b7ce98a03..1531f7cbd8 100644 --- a/cpukit/score/include/rtems/score/tqdata.h +++ b/cpukit/score/include/rtems/score/tqdata.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/tqdata.h * * This include file contains all the constants and structures diff --git a/cpukit/score/include/rtems/score/userext.h b/cpukit/score/include/rtems/score/userext.h index 26d06a6e32..863d86ed9a 100644 --- a/cpukit/score/include/rtems/score/userext.h +++ b/cpukit/score/include/rtems/score/userext.h @@ -139,7 +139,7 @@ typedef void( *User_extensions_thread_restart_extension )( * The context switches initiated through _Thread_Start_multitasking() and * _Thread_Stop_multitasking() are not covered by this extension. The * executing thread may run with a minimal setup, for example with a freed task - * stack. + * stack. */ typedef void( *User_extensions_thread_switch_extension )( Thread_Control *, diff --git a/cpukit/score/include/rtems/score/watchdog.h b/cpukit/score/include/rtems/score/watchdog.h index f542a51fae..891b1f756b 100644 --- a/cpukit/score/include/rtems/score/watchdog.h +++ b/cpukit/score/include/rtems/score/watchdog.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/watchdog.h * * This include file contains all the constants and structures associated @@ -58,7 +58,7 @@ typedef uint32_t Watchdog_Interval; typedef uint32_t (*Watchdog_Nanoseconds_since_last_tick_routine)(void); /** @brief Watchdog Service Routine Return Type - * + * * This type defines the return type from a Watchdog Service Routine. */ typedef void Watchdog_Service_routine; @@ -197,7 +197,7 @@ void _Watchdog_Handler_initialization( void ); * * This routine removes @a the_watchdog from the watchdog chain on which * it resides and returns the state @a the_watchdog timer was in. - * + * * @param[in] the_watchdog will be removed * @return the state in which @a the_watchdog was in when removed */ @@ -242,7 +242,7 @@ void _Watchdog_Adjust_to_chain( /** @brief Watchdog Insert * * This routine inserts @a the_watchdog into the @a header watchdog chain - * for a time of @a units. + * for a time of @a units. * * @param[in] header is @a the_watchdog list to insert @a the_watchdog on * @param[in] the_watchdog is the watchdog to insert diff --git a/cpukit/score/include/rtems/score/wkspace.h b/cpukit/score/include/rtems/score/wkspace.h index 58648a750e..c29b2dd4c9 100644 --- a/cpukit/score/include/rtems/score/wkspace.h +++ b/cpukit/score/include/rtems/score/wkspace.h @@ -1,4 +1,4 @@ -/** +/** * @file rtems/score/wkspace.h * * This include file contains information related to the @@ -37,7 +37,7 @@ extern "C" { /** @brief Executive Workspace Control * - * The is the heap control structure that used to manage the + * The is the heap control structure that used to manage the * RTEMS Executive Workspace. */ SCORE_EXTERN Heap_Control _Workspace_Area; /* executive heap header */ |