diff options
author | Shubham Somani <shubhamsomani92@gmail.com> | 2013-10-15 13:14:13 -0400 |
---|---|---|
committer | Gedare Bloom <gedare@rtems.org> | 2013-10-15 13:14:13 -0400 |
commit | e4ced53e683a3ab5f79c5c1016a0b2f7b7df3965 (patch) | |
tree | 1e41e7a94745f28d7edacef99162197f2ab991e9 /doc/user/conf.t | |
parent | Filesystem: PR2146: Documentation (diff) | |
download | rtems-e4ced53e683a3ab5f79c5c1016a0b2f7b7df3965.tar.bz2 |
doc: Document format in conf.t
Diffstat (limited to '')
-rw-r--r-- | doc/user/conf.t | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/doc/user/conf.t b/doc/user/conf.t index 94d523f659..a3f98242c4 100644 --- a/doc/user/conf.t +++ b/doc/user/conf.t @@ -183,6 +183,62 @@ information. However, it is quite easy to use a library and forget to account for its resources. @c +@c === Format to be followed for making changes in this file === +@c +@section Format to be followed for making changes in this file + +@itemize @bullet +@item MACRO NAME +Should be alphanumeric. Can have '_' (underscore). + +@item DATA TYPE +Please refer to all existing formats. + +@item RANGE: +The range depends on the Data Type of the macro. +@itemize @minus +@item If the data type is of type task priority, then its value should +be an integer in the range of 1 to 255. + +@item If the data type is an integer, then it can have numbers, characters +(in case the value is defined using another macro) and arithmetic operations +(+, -, *, /). + +@item If the data type is a function pointer the first character +should be an alphabet or an underscore. The rest of the string +can be alphanumeric. + +@item If the data type is RTEMS Attributes or RTEMS Mode then +the string should be alphanumeric. + +@item If the data type is RTEMS NAME then the value should be +an integer>=0 or RTEMS_BUILD_NAME( 'U', 'I', '1', ' ' ) +@end itemize + +@item DEFAULT VALUE +The default value should be in the following formats- +Please note that the '.' (full stop) is necessary. + +@itemize @minus +@item In case the value is not defined then: + This is not defined by default. + +@item If we know the default value then: + The default value is XXX. + +@item If the default value is BSP Specific then: + This option is BSP specific. +@end itemize + +@item DESCRIPTION +The description of the macro. (No specific format) + +@item NOTES +Any further notes. (No specific format) + +@end itemize + +@c @c === Configuration Example === @c @section Configuration Example |