From 80bdcd7cb55f098eebe361ec6ae6c31557d962c3 Mon Sep 17 00:00:00 2001 From: Ralf Corsepius Date: Sat, 25 Jan 2003 14:54:27 +0000 Subject: 2003-01-25 Ralf Corsepius * Makefile.am: New. * c4x.texi, cpumodel.t, timeBSP.t: Various minor changes to get them building. --- doc/supplements/c4x/ChangeLog | 6 +++ doc/supplements/c4x/Makefile.am | 108 ++++++++++++++++++++++++++++++++++++++++ doc/supplements/c4x/c4x.texi | 36 ++++++-------- doc/supplements/c4x/cpumodel.t | 2 +- doc/supplements/c4x/timeBSP.t | 2 +- 5 files changed, 131 insertions(+), 23 deletions(-) create mode 100644 doc/supplements/c4x/Makefile.am (limited to 'doc/supplements') 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 + + * Makefile.am: New. + * c4x.texi, cpumodel.t, timeBSP.t: Various minor changes to get them + building. + 2003-01-24 Joel Sherrill * 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 -- cgit v1.2.3