From e4ced53e683a3ab5f79c5c1016a0b2f7b7df3965 Mon Sep 17 00:00:00 2001 From: Shubham Somani Date: Tue, 15 Oct 2013 13:14:13 -0400 Subject: doc: Document format in conf.t --- doc/user/conf.t | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) (limited to 'doc/user/conf.t') 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 @@ -182,6 +182,62 @@ In general, @code{} is very accurate when given enough 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 -- cgit v1.2.3