change log for rtems (2011-05-18)

[rtems-vc at rtems.org]

 *joel*:
2011-05-18	Joel Sherrill <joel.sherrill at oarcorp.com>

	* user/conf.t: Slight rework to deemphasize not using confdefs.h

M  1.308  doc/ChangeLog
M   1.69  doc/user/conf.t

diff -u rtems/doc/ChangeLog:1.307 rtems/doc/ChangeLog:1.308
--- rtems/doc/ChangeLog:1.307	Thu May 12 11:26:51 2011
+++ rtems/doc/ChangeLog	Wed May 18 18:00:49 2011
@@ -1,3 +1,7 @@
+2011-05-18	Joel Sherrill <joel.sherrill at oarcorp.com>
+
+	* user/conf.t: Slight rework to deemphasize not using confdefs.h
+
 2011-05-12	Joel Sherrill <joel.sherrilL at OARcorp.com>
 
 	* index.html.in, common/opengroup_manpage_acknowledgement.texi,

diff -u rtems/doc/user/conf.t:1.68 rtems/doc/user/conf.t:1.69
--- rtems/doc/user/conf.t:1.68	Wed Mar 16 11:39:16 2011
+++ rtems/doc/user/conf.t	Wed May 18 18:00:50 2011
@@ -1,4 +1,4 @@
- at c  COPYRIGHT (c) 1988-2008.
+ at c  COPYRIGHT (c) 1988-2011.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -855,7 +855,16 @@
 
 @end itemize
 
- at section Configuration Table
+ at section Configuration Data Structures
+
+It is recommended that applications be configured using
+ at code{rtems/confdefs.h} as it is simpler and insulates applications from
+changes in the underlying data structures.  However, it is sometimes
+important to understand the data structures that are automatically filled
+in by the configuration parametes.  This section describes the primary
+configuration data structures.
+
+ at subsection Configuration Table
 
 @cindex Configuration Table
 @cindex RTEMS Configuration Table
@@ -1104,7 +1113,7 @@
 
 @end table
 
- at section RTEMS API Configuration Table
+ at subsection RTEMS API Configuration Table
 
 @cindex RTEMS API Configuration Table
 
@@ -1261,7 +1270,7 @@
 
 @end table
 
- at section POSIX API Configuration Table
+ at subsection POSIX API Configuration Table
 
 @cindex POSIX API Configuration Table
 
@@ -1443,7 +1452,7 @@
 
 @end table
 
- at section CPU Dependent Information Table
+ at subsection CPU Dependent Information Table
 
 @cindex CPU Dependent Information Table
 
@@ -1458,7 +1467,7 @@
 The @code{rtems/confdefs.h} mechanism does not support generating this
 table.  It is normally filled in by the Board Support Package.
 
- at section Initialization Task Table
+ at subsection Initialization Task Table
 
 @cindex Initialization Tasks Table
 
@@ -1538,7 +1547,7 @@
 @};
 @end example
 
- at section Driver Address Table
+ at subsection Driver Address Table
 
 @cindex Device Driver Table
 
@@ -1607,7 +1616,7 @@
 operation of device drivers is provided in the I/O Manager
 chapter.
 
- at section User Extensions Table
+ at subsection User Extensions Table
 
 @cindex User Extensions Table
 
@@ -1751,7 +1760,7 @@
 More information regarding the user extensions is
 provided in the User Extensions chapter.
 
- at section Multiprocessor Configuration Table
+ at subsection Multiprocessor Configuration Table
 
 @cindex Multiprocessor Configuration Table
 
@@ -1862,7 +1871,7 @@
 
 @end table
 
- at section Multiprocessor Communications Interface Table
+ at subsection Multiprocessor Communications Interface Table
 
 @cindex  Multiprocessor Communications Interface Table
 
@@ -1932,7 +1941,7 @@
 More information regarding the required functionality of these
 entry points is provided in the Multiprocessor chapter.
 
- at section Determining Memory Requirements
+ at subsection Determining Memory Requirements
 
 Since memory is a critical resource in many real-time
 embedded systems, the RTEMS Classic API was specifically designed to allow
@@ -2000,7 +2009,7 @@
 letter to avoid any naming conflicts.  All RTEMS directive names
 should be treated as reserved words.
 
- at section Sizing the RTEMS RAM Workspace
+ at subsection Sizing the RTEMS RAM Workspace
 
 The RTEMS RAM Workspace is a user-specified block of
 memory reserved for use by RTEMS.  The application should NOT



--

Generated by Deluxe Loginfo [http://www.codewiz.org/projects/index.html#loginfo] 2.122 by Bernardo Innocenti <bernie at develer.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/vc/attachments/20110518/d9c88367/attachment-0001.html>