Patch rtemsdoc-4.5.0-rc-8.diff from Ralf Corsepius <corsepiu@faw.uni-ulm.de>.

Ralf's comments follow:

  Changes:
    * Enhanced versioning:
      - Addition of automake's version.texi support
      - Replacement of rtemsdoc's former versioning support by automake's
        versioning support (Abandoning RTEMS-UPDATE-* etc.)
      - Abandoning setup.texi.in
      - Add EDITION to each documents Makefile.am
      - version.texi support in project.am
      - Addition of maintainer mode (currently only used to prevent incorrectly
        updating timestamps when users touch automake's version.texi timestamp
        files (stamp-vti)).

    * Fixing info dir support
      - Use texinfo's @dircategory and @direntry instead of infos *-DIR-ENTRY
      - $(infodir)/dir is now correctly set up

    * Avoid using temporary files
      - Pipe texts through REPLACE2 into BMENU2 instead of using temporary files.
      - Abandon using bmenu in favor of bmenu2 (bmenu could be removed now)

    * Prepare Makefile.ams for building in a separate buildtree
      - prefix files with $(srcdir) in Makefile.am for files which must be
        generated inside of the source tree

  Notes:
    * rtemsdoc can not yet be build in a separate source-tree, but we
      are very close to it.
    * You as the maintainer of this package now should always use
      --enable-maintainer-mode to configure rtemsdoc.

5 files changed, 61 insertions, 67 deletions

diff --git a/doc/supplements/powerpc/.cvsignore b/doc/supplements/powerpc/.cvsignore
index 555f15eddb..fed36d0ebd 100644
--- a/doc/supplements/powerpc/.cvsignore
+++ b/doc/supplements/powerpc/.cvsignore
@@ -8,6 +8,7 @@ fatalerr.texi
 index.html
 intr.t
 intr.texi
+mdate-sh
 memmodel.texi
 powerpc
 powerpc*.html
diff --git a/doc/supplements/powerpc/Makefile.am b/doc/supplements/powerpc/Makefile.am
index 37b6bc324b..de1b709db0 100644
--- a/doc/supplements/powerpc/Makefile.am
+++ b/doc/supplements/powerpc/Makefile.am
@@ -6,20 +6,20 @@
 #  $Id$
 #
 
-AUTOMAKE_OPTIONS = foreign
+AUTOMAKE_OPTIONS = foreign 1.4
 
-PROJECT=powerpc
+PROJECT = powerpc
+EDITION = 1
 
 include $(top_srcdir)/project.am
 include $(top_srcdir)/supplements/supplement.am
 
-COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi
+GENERATED_FILES = cpumodel.texi callconv.texi memmodel.texi intr.texi \
+    fatalerr.texi bsp.texi cputable.texi timing.texi wksheets.texi \
+    timePSIM.texi timeDMV177.texi
+COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi
 
-GENERATED_FILES=\
-  cpumodel.texi callconv.texi memmodel.texi intr.texi fatalerr.texi \
-  bsp.texi cputable.texi timing.texi wksheets.texi timePSIM.texi timeDMV177.texi
-
-FILES= preface.texi
+FILES = preface.texi
 
 info_TEXINFOS = powerpc.texi
 powerpc_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
@@ -28,63 +28,61 @@ powerpc_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
 #  Chapters which get automatic processing
 #
 
-cpumodel.texi: cpumodel.t
-	$(BMENU) -p "Preface" \
+$(srcdir)/cpumodel.texi: cpumodel.t
+	$(BMENU2) -p "Preface" \
 	    -u "Top" \
-	    -n "Calling Conventions" $<
+	    -n "Calling Conventions" < $< > $@
 
-callconv.texi: callconv.t
-	$(BMENU) -p "CPU Model Dependent Features Low Power Model" \
+$(srcdir)/callconv.texi: callconv.t
+	$(BMENU2) -p "CPU Model Dependent Features Low Power Model" \
 	    -u "Top" \
-	    -n "Memory Model" $<
+	    -n "Memory Model" < $< > $@
 
-memmodel.texi: memmodel.t
-	$(BMENU) -p "Calling Conventions User-Provided Routines" \
+$(srcdir)/memmodel.texi: memmodel.t
+	$(BMENU2) -p "Calling Conventions User-Provided Routines" \
 	    -u "Top" \
-	    -n "Interrupt Processing" $<
+	    -n "Interrupt Processing" < $< > $@
 
 # Interrupt Chapter:
 #  1.  Replace Times and Sizes
 #  2.  Build Node Structure
-intr.texi: intr_NOTIMES.t PSIM_TIMES
-	${REPLACE2} -p $(srcdir)/PSIM_TIMES $(srcdir)/intr_NOTIMES.t intr.t
-	$(BMENU) -p "Memory Model Flat Memory Model" \
+$(srcdir)/intr.texi: intr_NOTIMES.t PSIM_TIMES
+	${REPLACE2} -p $(srcdir)/PSIM_TIMES $(srcdir)/intr_NOTIMES.t  | \
+	$(BMENU2) -p "Memory Model Flat Memory Model" \
 	    -u "Top" \
-	    -n "Default Fatal Error Processing" intr.t
-CLEANFILES += intr.t
+	    -n "Default Fatal Error Processing" > $@
 
-fatalerr.texi: fatalerr.t
-	$(BMENU) -p "Interrupt Processing Interrupt Stack" \
+$(srcdir)/fatalerr.texi: fatalerr.t
+	$(BMENU2) -p "Interrupt Processing Interrupt Stack" \
 	    -u "Top" \
-	    -n "Board Support Packages" $<
+	    -n "Board Support Packages" < $< > $@
 
-bsp.texi: bsp.t
-	$(BMENU) -p "Default Fatal Error Processing Default Fatal Error Handler Operations" \
+$(srcdir)/bsp.texi: bsp.t
+	$(BMENU2) -p "Default Fatal Error Processing Default Fatal Error Handler Operations" \
 	    -u "Top" \
-	    -n "Processor Dependent Information Table" $<
+	    -n "Processor Dependent Information Table" < $< > $@
 
-cputable.texi: cputable.t
-	$(BMENU) -p "Board Support Packages Processor Initialization" \
+$(srcdir)/cputable.texi: cputable.t
+	$(BMENU2) -p "Board Support Packages Processor Initialization" \
 	    -u "Top" \
-	    -n "Memory Requirements" $<
+	    -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 PSIM_TIMES
+$(srcdir)/wksheets.texi: $(top_srcdir)/common/wksheets.t PSIM_TIMES
 	${REPLACE2} -p $(srcdir)/PSIM_TIMES \
-          $(top_srcdir)/common/wksheets.t wksheets.t
-	$(BMENU) -p "Processor Dependent Information Table CPU Dependent Information Table" \
+          $(top_srcdir)/common/wksheets.t | \
+	$(BMENU2) -p "Processor Dependent Information Table CPU Dependent Information Table" \
 	    -u "Top" \
-	    -n "Timing Specification" wksheets.t
-CLEANFILES += wksheets.t
+	    -n "Timing Specification" > $@
 
 # Timing Specification Chapter:
 #  1.  Copy the Shared File
 #  3.  Build Node Structure
-timing.texi: $(top_srcdir)/common/timing.t
+$(srcdir)/timing.texi: $(top_srcdir)/common/timing.t
 	$(BMENU2) -p "Memory Requirements RTEMS RAM Workspace Worksheet" \
             -u "Top" \
             -n "PSIM Timing Data" < $< > $@
@@ -94,37 +92,33 @@ timing.texi: $(top_srcdir)/common/timing.t
 #  2.  Replace Times and Sizes
 #  3.  Build Node Structure
 
-timePSIM.texi: $(top_srcdir)/common/timetbl.t timePSIM.t
+$(srcdir)/timePSIM.texi: $(top_srcdir)/common/timetbl.t timePSIM.t
 	cat timePSIM.t $(top_srcdir)/common/timetbl.t   >timePSIM_.t
 	@echo                                               >>timePSIM_.t
 	@echo "@tex"                                        >>timePSIM_.t
 	@echo "\\global\\advance \\smallskipamount by 4pt"  >>timePSIM_.t
 	@echo "@end tex"                                    >>timePSIM_.t
-	${REPLACE2} -p PSIM_TIMES timePSIM_.t timePSIM_.t
-	$(BMENU) -p "Timing Specification Terminology" \
+	${REPLACE2} -p PSIM_TIMES timePSIM_.t | \
+	$(BMENU2) -p "Timing Specification Terminology" \
 	    -u "Top" \
-	    -n "DMV177 Timing Data" timePSIM_.t
-	mv timePSIM_.texi timePSIM.texi
-CLEANFILES += timePSIM_.t timePSIM_.texi
-
+	    -n "DMV177 Timing Data" > $@
+CLEANFILES += timePSIM_.t
 
 # Timing Data for DMV177 BSP Chapter:
 #  1.  Copy the Shared File
 #  2.  Replace Times and Sizes
 #  3.  Build Node Structure
 
-timeDMV177.texi: $(top_srcdir)/common/timetbl.t timeDMV177.t
+$(srcdir)/timeDMV177.texi: $(top_srcdir)/common/timetbl.t timeDMV177.t
 	cat timeDMV177.t $(top_srcdir)/common/timetbl.t   >timeDMV177_.t
 	@echo                                               >>timeDMV177_.t
 	@echo "@tex"                                        >>timeDMV177_.t
 	@echo "\\global\\advance \\smallskipamount by 4pt"  >>timeDMV177_.t
 	@echo "@end tex"                                    >>timeDMV177_.t
-	${REPLACE2} -p DMV177_TIMES timeDMV177_.t timeDMV177_.t
-	$(BMENU) -p "PSIM Timing Data Rate Monotonic Manager" \
+	${REPLACE2} -p DMV177_TIMES timeDMV177_.t | \
+	$(BMENU2) -p "PSIM Timing Data Rate Monotonic Manager" \
 	    -u "Top" \
-	    -n "Command and Variable Index" timeDMV177_.t
-	mv timeDMV177_.texi timeDMV177.texi
-CLEANFILES += timeDMV177_.t timeDMV177_.texi
-
+	    -n "Command and Variable Index" > $@
+CLEANFILES += timeDMV177_.t
 
 EXTRA_DIST = DMV177_TIMES PSIM_TIMES *.t
diff --git a/doc/supplements/powerpc/powerpc.texi b/doc/supplements/powerpc/powerpc.texi
index 2047f421e8..1938d0ca07 100644
--- a/doc/supplements/powerpc/powerpc.texi
+++ b/doc/supplements/powerpc/powerpc.texi
@@ -19,27 +19,20 @@
 @c   Master file for the PowerPC Applications Supplement
 @c
 
+@include version.texi
 @include ../../common/setup.texi
 
-@ignore
-@ifinfo
-@format
-START-INFO-DIR-ENTRY
-* RTEMS PowerPC Applications Supplement (powerpc):
-END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
-@end ignore
+@ifset use-ascii
+@dircategory RTEMS Target Supplements
+@direntry
+* RTEMS PowerPC Applications Supplement: (powerpc).
+@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,9 +44,9 @@ END-INFO-DIR-ENTRY
 @finalout
 
 @title RTEMS PowerPC 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
diff --git a/doc/supplements/powerpc/stamp-vti b/doc/supplements/powerpc/stamp-vti
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/supplements/powerpc/stamp-vti
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3
diff --git a/doc/supplements/powerpc/version.texi b/doc/supplements/powerpc/version.texi
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/supplements/powerpc/version.texi
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3