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.

doc/started/.cvsignore

@@ -6,13 +6,14 @@ buildrt.texi
 gdb.texi
 index.html
 intro.texi
+mdate-sh
 nextstep.texi
 nt.texi
 require.texi
 sample.texi
 started
-started-?
 started*.html
+started-?
 started.aux
 started.cp
 started.dvi

doc/started/Makefile.am

@@ -6,67 +6,68 @@
 #  $Id$
 #
 
-AUTOMAKE_OPTIONS = foreign
+AUTOMAKE_OPTIONS = foreign 1.4
 
-PROJECT=started
+PROJECT = started
+EDITION = 1
 
 SUBDIRS = pictures
 
 include $(top_srcdir)/project.am
 
-COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi
-
-GENERATED_FILES= binaries.texi buildc.texi buildrt.texi gdb.texi intro.texi \
+GENERATED_FILES = binaries.texi buildc.texi buildrt.texi gdb.texi intro.texi \
     nt.texi require.texi nextstep.texi sample.texi
 
-FILES= tversions.texi
+COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi
+
+FILES = tversions.texi
 
 info_TEXINFOS = started.texi
 started_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
 
-intro.texi: intro.t tversions.texi
-	$(BMENU) -c -p "Top" \
+$(srcdir)/intro.texi: intro.t tversions.texi
+	$(BMENU2) -c -p "Top" \
 	    -u "Top" \
-	    -n "Requirements" $<
+	    -n "Requirements" < $< > $@
 
-require.texi: require.t tversions.texi
-	$(BMENU) -c -p "GCC Mailing Lists" \
+$(srcdir)/require.texi: require.t tversions.texi
+	$(BMENU2) -c -p "GCC Mailing Lists" \
 	    -u "Top" \
-	    -n "Prebuilt Toolset Executables" $<
+	    -n "Prebuilt Toolset Executables" < $< > $@
 
-binaries.texi: binaries.t tversions.texi
-	$(BMENU) -c -p "GNU makeinfo Version Requirements" \
+$(srcdir)/binaries.texi: binaries.t tversions.texi
+	$(BMENU2) -c -p "GNU makeinfo Version Requirements" \
 	    -u "Top" \
-	    -n "Building the GNU C/C++ Cross Compiler Toolset" $<
+	    -n "Building the GNU C/C++ Cross Compiler Toolset" < $< > $@
 
-buildc.texi: buildc.t tversions.texi
-	$(BMENU) -c -p "Removing RPMs" \
+$(srcdir)/buildc.texi: buildc.t tversions.texi
+	$(BMENU2) -c -p "Removing RPMs" \
 	    -u "Top" \
-	    -n "Building RTEMS" $<
+	    -n "Building RTEMS" < $< > $@
 
-buildrt.texi: buildrt.t tversions.texi
-	$(BMENU) -c -p "Error Messages Indicating Configuration Problems" \
+$(srcdir)/buildrt.texi: buildrt.t tversions.texi
+	$(BMENU2) -c -p "Error Messages Indicating Configuration Problems" \
 	    -u "Top" \
-	    -n "Building the Sample Application" $<
+	    -n "Building the Sample Application" < $< > $@
 
-sample.texi: sample.t tversions.texi
-	$(BMENU) -c -p "Using the RTEMS configure Script Directly" \
+$(srcdir)/sample.texi: sample.t tversions.texi
+	$(BMENU2) -c -p "Using the RTEMS configure Script Directly" \
 	    -u "Top" \
-	    -n "Building the GNU Debugger" $<
+	    -n "Building the GNU Debugger" < $< > $@
 
 gdb.texi: gdb.t tversions.texi
-	$(BMENU) -c -p "More Information on RTEMS Application Makefiles" \
+	$(BMENU2) -c -p "More Information on RTEMS Application Makefiles" \
 	    -u "Top" \
-	    -n "Where To Go From Here" $<
+	    -n "Where To Go From Here" < $< > $@
 
-nextstep.texi: nextstep.t tversions.texi
-	$(BMENU) -c -p "GDB for DINK32" \
+$(srcdir)/nextstep.texi: nextstep.t tversions.texi
+	$(BMENU2) -c -p "GDB for DINK32" \
 	    -u "Top" \
-	    -n "Using MS-Windows as a Development Host" $<
+	    -n "Using MS-Windows as a Development Host" < $< > $@
 
-nt.texi: nt.t tversions.texi
-	$(BMENU) -c -p "Writing an Application" \
+$(srcdir)/nt.texi: nt.t tversions.texi
+	$(BMENU2) -c -p "Writing an Application" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
 EXTRA_DIST = *.t

doc/started/stamp-vti

@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3

doc/started/started.texi

@@ -19,6 +19,7 @@
 @c   Master file for the Getting Started (C) Guide
 @c
 
+@include version.texi
 @include ../common/setup.texi
 
 @c
@@ -26,25 +27,17 @@
 @c
 @include tversions.texi
 
-@ignore
-@ifinfo
-@format
-START-INFO-DIR-ENTRY
-* Getting Started with RTEMS for C/C++ Users (started):
-END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
-@end ignore
+@ifset use-ascii
+@dircategory RTEMS On-Line Manual
+@direntry
+* Getting Started with RTEMS for C/C++ Users: (started).
+@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
@@ -56,9 +49,9 @@ END-INFO-DIR-ENTRY
 @finalout
 
 @title Getting Started with RTEMS for C/C++ Users
-@subtitle Edition @value{edition}, for @value{version}
+@subtitle Edition @value{EDITION}, for @value{VERSION}
 @sp 1
-@subtitle @value{update-month}
+@subtitle @value{UPDATED}
 @author On-Line Applications Research Corporation
 @page
 @include ../common/cpright.texi

doc/started/version.texi

@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3