diff options
author | Joel Sherrill <joel.sherrill@OARcorp.com> | 2006-01-16 15:13:58 +0000 |
---|---|---|
committer | Joel Sherrill <joel.sherrill@OARcorp.com> | 2006-01-16 15:13:58 +0000 |
commit | 6a074363a2657a86b5f1ea0fc1185f68ad9f3c08 (patch) | |
tree | 3785d2da164f2c26988014ad5dbae6e35aa24147 /cpukit/score/include/rtems/score/tod.h | |
parent | 2006-01-16 Joel Sherrill <joel@OARcorp.com> (diff) | |
download | rtems-6a074363a2657a86b5f1ea0fc1185f68ad9f3c08.tar.bz2 |
2006-01-16 Joel Sherrill <joel@OARcorp.com>
Large patch to improve Doxygen output. As a side-effect, grammar and
spelling errors were corrected, spacing errors were address, and some
variable names were improved.
* libmisc/monitor/mon-object.c, libmisc/monitor/monitor.h:
Account for changing OBJECTS_NO_CLASS to OBJECTS_CLASSIC_NO_CLASS.
* score/Doxyfile: Set output directory. Predefine some macro values.
Turn on graphical output.
* score/include/rtems/debug.h, score/include/rtems/seterr.h,
score/include/rtems/system.h, score/include/rtems/score/address.h,
score/include/rtems/score/apiext.h,
score/include/rtems/score/apimutex.h,
score/include/rtems/score/bitfield.h,
score/include/rtems/score/chain.h,
score/include/rtems/score/context.h,
score/include/rtems/score/coremsg.h,
score/include/rtems/score/coremutex.h,
score/include/rtems/score/coresem.h,
score/include/rtems/score/heap.h, score/include/rtems/score/interr.h,
score/include/rtems/score/isr.h, score/include/rtems/score/mpci.h,
score/include/rtems/score/mppkt.h,
score/include/rtems/score/object.h,
score/include/rtems/score/objectmp.h,
score/include/rtems/score/priority.h,
score/include/rtems/score/stack.h,
score/include/rtems/score/states.h,
score/include/rtems/score/sysstate.h,
score/include/rtems/score/thread.h,
score/include/rtems/score/threadmp.h,
score/include/rtems/score/threadq.h, score/include/rtems/score/tod.h,
score/include/rtems/score/tqdata.h,
score/include/rtems/score/userext.h,
score/include/rtems/score/watchdog.h,
score/include/rtems/score/wkspace.h,
score/inline/rtems/score/address.inl,
score/inline/rtems/score/chain.inl,
score/inline/rtems/score/coremutex.inl,
score/inline/rtems/score/coresem.inl,
score/inline/rtems/score/heap.inl,
score/inline/rtems/score/object.inl,
score/inline/rtems/score/stack.inl,
score/inline/rtems/score/thread.inl,
score/inline/rtems/score/tqdata.inl, score/macros/README,
score/src/heap.c, score/src/threadmp.c, score/src/threadready.c,
score/src/threadstartmultitasking.c: Improve generated Doxygen
output. Fix spelling and grammar errors in comments. Correct names of
some variables and propagate changes.
Diffstat (limited to 'cpukit/score/include/rtems/score/tod.h')
-rw-r--r-- | cpukit/score/include/rtems/score/tod.h | 60 |
1 files changed, 33 insertions, 27 deletions
diff --git a/cpukit/score/include/rtems/score/tod.h b/cpukit/score/include/rtems/score/tod.h index 904541f311..af416a529d 100644 --- a/cpukit/score/include/rtems/score/tod.h +++ b/cpukit/score/include/rtems/score/tod.h @@ -6,7 +6,7 @@ */ /* - * COPYRIGHT (c) 1989-2004. + * COPYRIGHT (c) 1989-2006. * On-Line Applications Research Corporation (OAR). * * The license and distribution terms for this file may be @@ -22,7 +22,7 @@ /** * @defgroup ScoreTOD Time Of Day (TOD) Handler * - * This group contains functionality which XXX + * This handler encapsulates functionality used to manage time of day. */ /**@{*/ @@ -39,62 +39,62 @@ extern "C" { /**@{*/ /** - * XXX + * This constant represents the number of seconds in a minute. */ -#define TOD_SECONDS_PER_MINUTE (uint32_t )60 +#define TOD_SECONDS_PER_MINUTE (uint32_t)60 /** - * XXX + * This constant represents the number of minutes per hour. */ -#define TOD_MINUTES_PER_HOUR (uint32_t )60 +#define TOD_MINUTES_PER_HOUR (uint32_t)60 /** - * XXX + * This constant represents the number of months in a year. */ -#define TOD_MONTHS_PER_YEAR (uint32_t )12 +#define TOD_MONTHS_PER_YEAR (uint32_t)12 /** - * XXX + * This constant represents the number of days in a non-leap year. */ -#define TOD_DAYS_PER_YEAR (uint32_t )365 +#define TOD_DAYS_PER_YEAR (uint32_t)365 /** - * XXX + * This constant represents the number of hours per day. */ -#define TOD_HOURS_PER_DAY (uint32_t )24 +#define TOD_HOURS_PER_DAY (uint32_t)24 /** - * XXX + * This constant represents the number of seconds in a day which does + * not include a leap second. */ -#define TOD_SECONDS_PER_DAY (uint32_t ) (TOD_SECONDS_PER_MINUTE * \ +#define TOD_SECONDS_PER_DAY (uint32_t) (TOD_SECONDS_PER_MINUTE * \ TOD_MINUTES_PER_HOUR * \ TOD_HOURS_PER_DAY) - /** - * XXX + * This constant represents the number of seconds in a non-leap year. */ #define TOD_SECONDS_PER_NON_LEAP_YEAR (365 * TOD_SECONDS_PER_DAY) /** - * XXX + * This constant represents the number of seconds in a millisecond. */ -#define TOD_MILLISECONDS_PER_SECOND (uint32_t )1000 +#define TOD_MILLISECONDS_PER_SECOND (uint32_t)1000 /** - * XXX + * This constant represents the number of microseconds in a second. */ -#define TOD_MICROSECONDS_PER_SECOND (uint32_t )1000000 +#define TOD_MICROSECONDS_PER_SECOND (uint32_t)1000000 /** - * XXX + * This constant represents the number of nanoseconds in a second. */ -#define TOD_NANOSECONDS_PER_SECOND (uint32_t )1000000000 +#define TOD_NANOSECONDS_PER_SECOND (uint32_t)1000000000 /** - * XXX + * This constant represents the number of nanoseconds in a second. */ -#define TOD_NANOSECONDS_PER_MICROSECOND (uint32_t )1000 +#define TOD_NANOSECONDS_PER_MICROSECOND (uint32_t)1000 /**@}*/ @@ -204,18 +204,24 @@ const uint16_t _TOD_Days_since_last_leap_year[4] = { 0, 366, 731, 1096 }; #else -/** @brief +/** @brief Convert Month to Julian Days * + * This is a prototype for a table which assists in converting the + * current day into the Julian days since the first of the year. */ extern const uint16_t _TOD_Days_to_date[2][13]; /* Julian days */ -/** @brief +/** @brief Days since Beginning of Last Leap Year * + * This is a prototype for a table which assists in calculating the + * number of days since the beginning of the last leap year. */ extern const uint16_t _TOD_Days_since_last_leap_year[4]; -/** @brief +/** @brief Days Per Month Table * + * This is a prototype for a table which holds the number of days + * per month for a leap year and non-leap year. */ extern const uint32_t _TOD_Days_per_month[2][13]; |