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, 93 insertions, 94 deletions

diff --git a/doc/posix_users/.cvsignore b/doc/posix_users/.cvsignore
index 97a26fc9a5..30562b3c02 100644
--- a/doc/posix_users/.cvsignore
+++ b/doc/posix_users/.cvsignore
@@ -11,6 +11,7 @@ io.texi
 key.texi
 libc.texi
 libm.texi
+mdate-sh
 memorymgmt.texi
 message.texi
 mutex.texi
diff --git a/doc/posix_users/Makefile.am b/doc/posix_users/Makefile.am
index c20c8bbbdf..71b8bfa3d4 100644
--- a/doc/posix_users/Makefile.am
+++ b/doc/posix_users/Makefile.am
@@ -6,136 +6,134 @@
 #  $Id$
 #
 
-AUTOMAKE_OPTIONS = foreign
+AUTOMAKE_OPTIONS = foreign 1.4
 
-PROJECT=posix_users
+PROJECT = posix_users
+EDITION = 1
 
 include $(top_srcdir)/project.am
 
-COMMON_FILES=$(top_srcdir)/common/cpright.texi
+GENERATED_FILES = cancel.texi clock.texi cond.texi cspecific.texi \
+    device.texi files.texi io.texi key.texi memorymgmt.texi message.texi \
+    mutex.texi procenv.texi process.texi sched.texi semaphores.texi \
+    signal.texi status.texi systemdb.texi thread.texi timer.texi libc.texi \
+    libm.texi
 
-GENERATED_FILES= \
-   cancel.texi clock.texi cond.texi \
-   cspecific.texi device.texi files.texi \
-   io.texi key.texi memorymgmt.texi message.texi mutex.texi procenv.texi \
-   process.texi sched.texi semaphores.texi signal.texi status.texi \
-   systemdb.texi thread.texi timer.texi libc.texi libm.texi
-
-FILES= preface.texi
+COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi
 
+FILES = preface.texi
 info_TEXINFOS = posix_users.texi
 posix_users_TEXINFOS = $(FILES) $(GENERATED_FILES)
 
-process.texi: process.t
-	 $(BMENU) -p "" \
+$(srcdir)/process.texi: process.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-procenv.texi: procenv.t
-	 $(BMENU) -p "" \
+$(srcdir)/procenv.texi: procenv.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-files.texi: files.t
-	 $(BMENU) -p "" \
+$(srcdir)/files.texi: files.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-thread.texi: thread.t
-	 $(BMENU) -p "" \
+$(srcdir)/thread.texi: thread.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-signal.texi: signal.t
-	 $(BMENU) -p "" \
+$(srcdir)/signal.texi: signal.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-mutex.texi: mutex.t
-	 $(BMENU) -p "" \
+$(srcdir)/mutex.texi: mutex.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-cond.texi: cond.t
-	 $(BMENU) -p "" \
+$(srcdir)/cond.texi: cond.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-key.texi: key.t
-	 $(BMENU) -p "" \
+$(srcdir)/key.texi: key.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-clock.texi: clock.t
-	 $(BMENU) -p "" \
+$(srcdir)/clock.texi: clock.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-timer.texi: timer.t
-	 $(BMENU) -p "" \
+$(srcdir)/timer.texi: timer.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-sched.texi: sched.t
-	 $(BMENU) -p "" \
+$(srcdir)/sched.texi: sched.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-io.texi: io.t
-	 $(BMENU) -p "" \
+$(srcdir)/io.texi: io.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-device.texi: device.t
-	 $(BMENU) -p "" \
+$(srcdir)/device.texi: device.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-cspecific.texi: cspecific.t
-	 $(BMENU) -p "" \
+$(srcdir)/cspecific.texi: cspecific.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-semaphores.texi: semaphores.t
-	 $(BMENU) -p "" \
+$(srcdir)/semaphores.texi: semaphores.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-memorymgmt.texi: memorymgmt.t
-	 $(BMENU) -p "" \
+$(srcdir)/memorymgmt.texi: memorymgmt.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-message.texi: message.t
-	 $(BMENU) -p "" \
+$(srcdir)/message.texi: message.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-cancel.texi: cancel.t
-	 $(BMENU) -p "" \
+$(srcdir)/cancel.texi: cancel.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-systemdb.texi: systemdb.t
-	 $(BMENU) -p "" \
+$(srcdir)/systemdb.texi: systemdb.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-status.texi: status.t
-	 $(BMENU) -p "" \
+$(srcdir)/status.texi: status.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
-libc.texi: libc.t
-	 $(BMENU) -p "" \
+$(srcdir)/libc.texi: libc.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
-
+	    -n "" < $< > $@
 
-libm.texi: libm.t
-	 $(BMENU) -p "" \
+$(srcdir)/libm.texi: libm.t
+	 $(BMENU2) -p "" \
 	    -u "Top" \
-	    -n "" $<
+	    -n "" < $< > $@
 
 noinst_SCRIPTS = gen_size_report
 EXTRA_DIST = *.t gen_size_report
diff --git a/doc/posix_users/posix_users.texi b/doc/posix_users/posix_users.texi
index e4adc8adcc..c6ba0bda41 100644
--- a/doc/posix_users/posix_users.texi
+++ b/doc/posix_users/posix_users.texi
@@ -25,17 +25,16 @@
 @c  2.  Why does paragraphindent show up in HTML?
 @c
 
+@include version.texi
 @include ../common/setup.texi
 
-@ignore
-@ifinfo
-@format
-START-INFO-DIR-ENTRY
-* RTEMS Posix API User's Guide: (posix_users).   Posix API User's Guide Plan
-END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
-@end ignore
+@ifset use-ascii
+@dircategory RTEMS On-Line Manual
+@direntry
+* RTEMS Posix API User's Guide: (posix_users).
+                                       Posix API User's Guide Plan
+@end direntry
+@end ifset
 
 @c variable substitution info:
 @c
@@ -57,11 +56,6 @@ END-INFO-DIR-ENTRY
 @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
@@ -73,9 +67,9 @@ END-INFO-DIR-ENTRY
 @finalout
 
 @title RTEMS POSIX API User's Guide
-@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/posix_users/stamp-vti b/doc/posix_users/stamp-vti
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/posix_users/stamp-vti
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3
diff --git a/doc/posix_users/version.texi b/doc/posix_users/version.texi
new file mode 100644
index 0000000000..27e5ccd0cb
--- /dev/null
+++ b/doc/posix_users/version.texi
@@ -0,0 +1,3 @@
+@set UPDATED 1 June 2000
+@set EDITION 1
+@set VERSION 4.5.0-beta3