From fc76a6aa19af9606f260993811ac0dee8ec4e886 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Thu, 1 Jun 2000 15:29:01 +0000 Subject: Patch rtemsdoc-4.5.0-rc-8.diff from Ralf Corsepius . 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/posix_users/.cvsignore | 1 + doc/posix_users/Makefile.am | 154 +++++++++++++++++++-------------------- doc/posix_users/posix_users.texi | 26 +++---- doc/posix_users/stamp-vti | 3 + doc/posix_users/version.texi | 3 + 5 files changed, 93 insertions(+), 94 deletions(-) create mode 100644 doc/posix_users/stamp-vti create mode 100644 doc/posix_users/version.texi (limited to 'doc/posix_users') 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 -- cgit v1.2.3