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, 49 insertions, 55 deletions

diff --git a/doc/rgdb_specs/.cvsignore b/doc/rgdb_specs/.cvsignore
index a297bb12d8..50de727d64 100644
--- a/doc/rgdb_specs/.cvsignore
+++ b/doc/rgdb_specs/.cvsignore
@@ -8,6 +8,7 @@ index.html
 interfacing.texi
 intro.texi
 layers.pdf
+mdate-sh
 objectives.texi
 process.pdf
 revision.texi
diff --git a/doc/rgdb_specs/Makefile.am b/doc/rgdb_specs/Makefile.am
index d3e678d306..5891ea8625 100644
--- a/doc/rgdb_specs/Makefile.am
+++ b/doc/rgdb_specs/Makefile.am
@@ -6,22 +6,21 @@
 #  $Id$
 #
 
-AUTOMAKE_OPTIONS = foreign
+AUTOMAKE_OPTIONS = foreign 1.4
 
-PROJECT=rgdb_specs
+PROJECT = rgdb_specs
+EDITION = 1
 
 include $(top_srcdir)/project.am
 
-COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi
-
-GENERATED_FILES= \
-    intro.texi revision.texi objectives.texi gdbinternals.texi \
+GENERATED_FILES = intro.texi revision.texi objectives.texi gdbinternals.texi \
     interfacing.texi comm.texi daemon.texi conclusion.texi
+COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi
 
-FILES=
+FILES =
 
 info_TEXINFOS = rgdb_specs.texi
-rgdb_specs_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)   
+rgdb_specs_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
 
 JPEG_FILES = layers.jpg process.jpg seqinit.jpg seqbreak.jpg seqdetach.jpg
 
@@ -35,51 +34,46 @@ endif
 #  Process Automatically Generated Files
 #
 
-intro.texi: intro.t
-	$(BMENU) -c -p "Top" \
+$(srcdir)/intro.texi: intro.t
+	$(BMENU2) -c -p "Top" \
 	    -u "Top" \
-	    -n "Document Revision History" $<
+	    -n "Document Revision History" < $< > $@
 
-revision.texi: revision.t
-	$(BMENU) -c -p "Introduction" \
+$(srcdir)/revision.texi: revision.t
+	$(BMENU2) -c -p "Introduction" \
 	    -u "Top" \
-	    -n "Objectives" $<
+	    -n "Objectives" < $< > $@
 
-objectives.texi: objectives.t
-	$(BMENU) -c -p "Document Revision History" \
+$(srcdir)/objectives.texi: objectives.t
+	$(BMENU2) -c -p "Document Revision History" \
 	    -u "Top" \
-	    -n "A Rapid Tour of GDB Internals" $<
+	    -n "A Rapid Tour of GDB Internals" < $< > $@
 
-gdbinternals.texi: gdbinternals.t
-	$(BMENU) -c -p "Implied Restrictions" \
+$(srcdir)/gdbinternals.texi: gdbinternals.t
+	$(BMENU2) -c -p "Implied Restrictions" \
 	    -u "Top" \
-	    -n "Interfacing GDB with RTEMS as a Target" $<
+	    -n "Interfacing GDB with RTEMS as a Target" < $< > $@
 
-interfacing.texi: interfacing.t
-	$(BMENU) -c -p "A Rapid Tour of GDB Internals" \
+$(srcdir)/interfacing.texi: interfacing.t
+	$(BMENU2) -c -p "A Rapid Tour of GDB Internals" \
 	    -u "Top" \
-	    -n "Communication with GDB" $<
+	    -n "Communication with GDB" < $< > $@
 
-comm.texi: comm.t
-	$(BMENU) -c -p "Interfacing GDB with RTEMS as a Target" \
+$(srcdir)/comm.texi: comm.t
+	$(BMENU2) -c -p "Interfacing GDB with RTEMS as a Target" \
 	    -u "Top" \
-	    -n "RTEMS Debugger Server Daemon" $<
+	    -n "RTEMS Debugger Server Daemon" < $< > $@
 
-daemon.texi: daemon.t
-	$(BMENU) -c -p "Communication with GDB" \
+$(srcdir)/daemon.texi: daemon.t
+	$(BMENU2) -c -p "Communication with GDB" \
 	    -u "Top" \
-	    -n "Conclusion" $<
+	    -n "Conclusion" < $< > $@
 
-conclusion.texi: conclusion.t
-	$(BMENU) -c -p "Output of a Debug Session with the Prototype" \
+$(srcdir)/conclusion.texi: conclusion.t
+	$(BMENU2) -c -p "Output of a Debug Session with the Prototype" \
 	    -u "Top" \
-	    -n "" $<
-
-noinst_DATA = \
-layers.eps \
-process.eps \
-seqdetach.eps \
-seqbreak.eps \
-seqinit.eps
+	    -n "" < $< > $@
+
+noinst_DATA = layers.eps process.eps seqdetach.eps seqbreak.eps seqinit.eps
 
 EXTRA_DIST = *.t $(noinst_DATA) $(JPEG_FILES)
diff --git a/doc/rgdb_specs/rgdb_specs.texi b/doc/rgdb_specs/rgdb_specs.texi
index 143eafeae9..bae96eb392 100644
--- a/doc/rgdb_specs/rgdb_specs.texi
+++ b/doc/rgdb_specs/rgdb_specs.texi
@@ -19,27 +19,20 @@
 @c   Master file for the Getting Started (C) Guide
 @c
 
+@include version.texi
 @include ../common/setup.texi
 
-@ignore
-@ifinfo
-@format
-START-INFO-DIR-ENTRY
-* RTEMS Remote Debugger Server Specifications (rgdb_specs):
-END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
-@end ignore
+@ifset use-ascii
+@dircategory RTEMS On-Line Manual
+@direntry
+* RTEMS Remote Debugger Server Specifications: (rgdb_specs).
+@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 Remote Debugger Server Specifications
-@subtitle Edition @value{edition}, for @value{version}
+@subtitle Edition @value{EDITION}, for @value{VERSION}
 @sp 1
-@subtitle @value{update-month}
+@subtitle @value{UPDATED}
 @author Emmanuel Raguet and Eric Valette, Canon Research Centre
 @author On-Line Applications Research Corporation
 @page
diff --git a/doc/rgdb_specs/stamp-vti b/doc/rgdb_specs/stamp-vti
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/rgdb_specs/stamp-vti
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3
diff --git a/doc/rgdb_specs/version.texi b/doc/rgdb_specs/version.texi
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/rgdb_specs/version.texi
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3