summaryrefslogtreecommitdiffstats
path: root/doc/supplements
diff options
context:
space:
mode:
authorRalf Corsepius <ralf.corsepius@rtems.org>2003-01-25 14:54:27 +0000
committerRalf Corsepius <ralf.corsepius@rtems.org>2003-01-25 14:54:27 +0000
commit80bdcd7cb55f098eebe361ec6ae6c31557d962c3 (patch)
treec6f3443c2a697f97d760f4b06b8e905f958f7196 /doc/supplements
parent2002-01-25 Ralf Corsepius <corsepiu@faw.uni-ulm.de> (diff)
downloadrtems-80bdcd7cb55f098eebe361ec6ae6c31557d962c3.tar.bz2
2003-01-25 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
* Makefile.am: New. * c4x.texi, cpumodel.t, timeBSP.t: Various minor changes to get them building.
Diffstat (limited to 'doc/supplements')
-rw-r--r--doc/supplements/c4x/ChangeLog6
-rw-r--r--doc/supplements/c4x/Makefile.am108
-rw-r--r--doc/supplements/c4x/c4x.texi36
-rw-r--r--doc/supplements/c4x/cpumodel.t2
-rw-r--r--doc/supplements/c4x/timeBSP.t2
5 files changed, 131 insertions, 23 deletions
diff --git a/doc/supplements/c4x/ChangeLog b/doc/supplements/c4x/ChangeLog
index e85b655f5c..ce9d041f64 100644
--- a/doc/supplements/c4x/ChangeLog
+++ b/doc/supplements/c4x/ChangeLog
@@ -1,3 +1,9 @@
+2003-01-25 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
+
+ * Makefile.am: New.
+ * c4x.texi, cpumodel.t, timeBSP.t: Various minor changes to get them
+ building.
+
2003-01-24 Joel Sherrill <joel@OARcorp.com>
* BSP_TIMES, bsp.t, c4x.texi, callconv.t, cpumodel.t, cputable.t,
diff --git a/doc/supplements/c4x/Makefile.am b/doc/supplements/c4x/Makefile.am
new file mode 100644
index 0000000000..769340cffb
--- /dev/null
+++ b/doc/supplements/c4x/Makefile.am
@@ -0,0 +1,108 @@
+#
+# COPYRIGHT (c) 1988-2002.
+# On-Line Applications Research Corporation (OAR).
+# All rights reserved.
+#
+# $Id$
+#
+
+
+PROJECT = c4x
+EDITION = 1
+
+include $(top_srcdir)/project.am
+include $(top_srcdir)/supplements/supplement.am
+
+GENERATED_FILES = cpumodel.texi callconv.texi memmodel.texi intr.texi \
+ fatalerr.texi bsp.texi cputable.texi timing.texi wksheets.texi \
+ timeBSP.texi
+
+COMMON_FILES = $(top_srcdir)/common/setup.texi \
+ $(top_srcdir)/common/cpright.texi
+
+FILES = preface.texi
+
+info_TEXINFOS = c4x.texi
+c4x_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
+
+#
+# Chapters which get automatic processing
+#
+
+cpumodel.texi: cpumodel.t
+ $(BMENU2) -p "Preface" \
+ -u "Top" \
+ -n "Calling Conventions" < $< > $@
+
+callconv.texi: callconv.t
+ $(BMENU2) -p "CPU Model Dependent Features Floating Point Unit" \
+ -u "Top" \
+ -n "Memory Model" < $< > $@
+
+memmodel.texi: memmodel.t
+ $(BMENU2) -p "Calling Conventions User-Provided Routines" \
+ -u "Top" \
+ -n "Interrupt Processing" < $< > $@
+
+# Interrupt Chapter:
+# 1. Replace Times and Sizes
+# 2. Build Node Structure
+intr.texi: intr_NOTIMES.t BSP_TIMES
+ ${REPLACE2} -p $(srcdir)/BSP_TIMES $(srcdir)/intr_NOTIMES.t | \
+ $(BMENU2) -p "Memory Model Large Memory Model" \
+ -u "Top" \
+ -n "Default Fatal Error Processing" > $@
+
+fatalerr.texi: fatalerr.t
+ $(BMENU2) -p "Interrupt Processing Interrupt Stack" \
+ -u "Top" \
+ -n "Board Support Packages" < $< > $@
+
+bsp.texi: bsp.t
+ $(BMENU2) -p "Default Fatal Error Processing Default Fatal Error Handler Operations" \
+ -u "Top" \
+ -n "Processor Dependent Information Table" < $< > $@
+
+cputable.texi: cputable.t
+ $(BMENU2) -p "Board Support Packages Processor Initialization" \
+ -u "Top" \
+ -n "Memory Requirements" < $< > $@
+
+# Worksheets Chapter:
+# 1. Obtain the Shared File
+# 2. Replace Times and Sizes
+# 3. Build Node Structure
+
+wksheets.texi: $(top_srcdir)/common/wksheets.t BSP_TIMES
+ ${REPLACE2} -p $(srcdir)/BSP_TIMES $(top_srcdir)/common/wksheets.t | \
+ $(BMENU2) -p "Processor Dependent Information Table CPU Dependent Information Table" \
+ -u "Top" \
+ -n "Timing Specification" > $@
+
+# Timing Specification Chapter:
+# 1. Copy the Shared File
+# 3. Build Node Structure
+timing.texi: $(top_srcdir)/common/timing.t
+ $(BMENU2) -p "Memory Requirements RTEMS RAM Workspace Worksheet" \
+ -u "Top" \
+ -n "BSP_FOR_TIMES Timing Data" < $< > $@
+
+# Timing Data for BSP BSP_FOR_TIMES Chapter:
+# 1. Copy the Shared File
+# 2. Replace Times and Sizes
+# 3. Build Node Structure
+
+timeBSP.texi: $(top_srcdir)/common/timetbl.t timeBSP.t
+ cat $(srcdir)/timeBSP.t $(top_srcdir)/common/timetbl.t >timeBSP_.t
+ @echo >>timeBSP_.t
+ @echo "@tex" >>timeBSP_.t
+ @echo "\\global\\advance \\smallskipamount by 4pt" >>timeBSP_.t
+ @echo "@end tex" >>timeBSP_.t
+ ${REPLACE2} -p $(srcdir)/BSP_TIMES timeBSP_.t | \
+ $(BMENU2) -p "Timing Specification Terminology" \
+ -u "Top" \
+ -n "Command and Variable Index" > $@
+CLEANFILES += timeBSP_.t
+
+EXTRA_DIST = BSP_TIMES bsp.t callconv.t cpumodel.t cputable.t fatalerr.t \
+ intr_NOTIMES.t memmodel.t timeBSP.t
diff --git a/doc/supplements/c4x/c4x.texi b/doc/supplements/c4x/c4x.texi
index 5fc721a24a..306197fe83 100644
--- a/doc/supplements/c4x/c4x.texi
+++ b/doc/supplements/c4x/c4x.texi
@@ -1,6 +1,7 @@
\input texinfo @c -*-texinfo-*-
@c %**start of header
-@setfilename c_c4x
+@setfilename c4x
+@setcontentsaftertitlepage
@syncodeindex vr fn
@synindex ky cp
@paragraphindent 0
@@ -19,27 +20,20 @@
@c Master file for the TI C3x/C4x Applications Supplement
@c
-@include ../../common/setup.texi
+@include version.texi
+@include common/setup.texi
-@ignore
-@ifinfo
-@format
-START-INFO-DIR-ENTRY
-* RTEMS TI C3x/C4x Applications Supplement (c4x):
-END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
-@end ignore
+@ifset use-ascii
+@dircategory RTEMS Target Supplements
+@direntry
+* RTEMS TI C3x/C4x Applications Supplement: (c4x).
+@end direntry
+@end ifset
@c
@c Title Page Stuff
@c
-@set edition @value{RTEMS-EDITION}
-@set version @value{RTEMS-VERSION}
-@set update-date @value{RTEMS-UPDATE-DATE}
-@set update-month @value{RTEMS-UPDATE-MONTH}
-
@c
@c I don't really like having a short title page. --joel
@c
@@ -51,13 +45,13 @@ END-INFO-DIR-ENTRY
@finalout
@title RTEMS TI C3x/C4x Applications Supplement
-@subtitle Edition @value{edition}, for RTEMS @value{version}
+@subtitle Edition @value{EDITION}, for RTEMS @value{VERSION}
@sp 1
-@subtitle @value{update-month}
+@subtitle @value{UPDATED}
@author On-Line Applications Research Corporation
@page
-@include ../../common/cpright.texi
+@include common/cpright.texi
@end titlepage
@c This prevents a black box from being printed on "overflow" lines.
@@ -76,7 +70,7 @@ END-INFO-DIR-ENTRY
@include timeBSP.texi
@ifinfo
@node Top, Preface, (dir), (dir)
-@top c_c4x
+@top c4x
This is the online version of the RTEMS TI C3x/C4x
Applications Supplement.
@@ -103,7 +97,7 @@ Applications Supplement.
@c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here
@c
-@node Command and Variable Index, Concept Index, BSP_FOR_TIMES Timing Data Context Switch, Top
+@node Command and Variable Index, Concept Index, BSP_FOR_TIMES Timing Data Rate Monotonic Manager, Top
@unnumbered Command and Variable Index
There are currently no Command and Variable Index entries.
diff --git a/doc/supplements/c4x/cpumodel.t b/doc/supplements/c4x/cpumodel.t
index 3a7dbbf694..2aa74314d0 100644
--- a/doc/supplements/c4x/cpumodel.t
+++ b/doc/supplements/c4x/cpumodel.t
@@ -65,7 +65,7 @@ operations may only be performed on a subset of the cpu registers,
these same registers may be used for normal integer operations.
as a result of this, this port of rtems makes no distinction
between integer and floating point contexts. The routine
-@code{_CPU_Context_switch) saves all of the registers that
+@code{_CPU_Context_switch} saves all of the registers that
comprise a task's context. the routines that initialize,
save, and restore floating point contexts are not present
in this port.
diff --git a/doc/supplements/c4x/timeBSP.t b/doc/supplements/c4x/timeBSP.t
index f8cafd5f89..a64dc93ca9 100644
--- a/doc/supplements/c4x/timeBSP.t
+++ b/doc/supplements/c4x/timeBSP.t
@@ -6,7 +6,7 @@
@c $Id$
@c
-@include ../../common/timemac.texi
+@include common/timemac.texi
@tex
\global\advance \smallskipamount by -4pt
@end tex