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/posix1003.1/.cvsignore | 1 + doc/posix1003.1/Makefile.am | 135 ++++++++++++++++++++------------------- doc/posix1003.1/posix1003_1.texi | 26 +++----- doc/posix1003.1/stamp-vti | 3 + doc/posix1003.1/version.texi | 3 + 5 files changed, 85 insertions(+), 83 deletions(-) create mode 100644 doc/posix1003.1/stamp-vti create mode 100644 doc/posix1003.1/version.texi (limited to 'doc/posix1003.1') diff --git a/doc/posix1003.1/.cvsignore b/doc/posix1003.1/.cvsignore index 58a370463d..7e6ecfde55 100644 --- a/doc/posix1003.1/.cvsignore +++ b/doc/posix1003.1/.cvsignore @@ -21,6 +21,7 @@ ch18.texi ch19.t ch19.texi index.html +mdate-sh posix1003_1 posix1003_1*.html posix1003_1-? diff --git a/doc/posix1003.1/Makefile.am b/doc/posix1003.1/Makefile.am index 6f94255d78..cceafb6dfe 100644 --- a/doc/posix1003.1/Makefile.am +++ b/doc/posix1003.1/Makefile.am @@ -6,123 +6,124 @@ # $Id$ # -AUTOMAKE_OPTIONS = foreign +AUTOMAKE_OPTIONS = foreign 1.4 -PROJECT=posix1003_1 +PROJECT = posix1003_1 +EDITION = 1 include $(top_srcdir)/project.am -COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi +GENERATED_FILES = ch01.texi ch02.texi ch03.texi ch04.texi ch05.texi \ + ch06.texi ch07.texi ch08.texi ch09.texi ch10.texi ch11.texi ch12.texi \ + ch13.texi ch14.texi ch15.texi ch16.texi ch17.texi ch18.texi ch19.t \ + ch19.texi -GENERATED_FILES=ch01.texi ch02.texi ch03.texi ch04.texi ch05.texi \ - ch06.texi ch07.texi ch08.texi ch09.texi ch10.texi \ - ch11.texi ch12.texi ch13.texi ch14.texi ch15.texi \ - ch16.texi ch17.texi ch18.texi ch19.t ch19.texi +COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi -FILES= preface.texi +FILES = preface.texi info_TEXINFOS = posix1003_1.texi posix1003_1_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES) -ch01.texi: ch01.t - $(BMENU) -c -p "Preface" \ +$(srcdir)/ch01.texi: ch01.t + $(BMENU2) -c -p "Preface" \ -u "Top" \ - -n "Terminology and General Requirements" $< + -n "Terminology and General Requirements" < $< > $@ -ch02.texi: ch02.t - $(BMENU) -c -p "Conformance" \ +$(srcdir)/ch02.texi: ch02.t + $(BMENU2) -c -p "Conformance" \ -u "Top" \ - -n "Process Primitives" $< + -n "Process Primitives" < $< > $@ -ch03.texi: ch03.t - $(BMENU) -c -p "Execution-Time Symbolic Constants for Portability Specifications" \ +$(srcdir)/ch03.texi: ch03.t + $(BMENU2) -c -p "Execution-Time Symbolic Constants for Portability Specifications" \ -u "Top" \ - -n "Process Environment" $< + -n "Process Environment" < $< > $@ -ch04.texi: ch04.t - $(BMENU) -c -p "Delay Process Execution" \ +$(srcdir)/ch04.texi: ch04.t + $(BMENU2) -c -p "Delay Process Execution" \ -u "Top" \ - -n "Files and Directories" $< + -n "Files and Directories" < $< > $@ -ch05.texi: ch05.t - $(BMENU) -c -p "Get Configurable System Variables" \ +$(srcdir)/ch05.texi: ch05.t + $(BMENU2) -c -p "Get Configurable System Variables" \ -u "Top" \ - -n "Input and Output Primitives" $< + -n "Input and Output Primitives" < $< > $@ -ch06.texi: ch06.t - $(BMENU) -c -p "Get Configurable Pathname Variables" \ +$(srcdir)/ch06.texi: ch06.t + $(BMENU2) -c -p "Get Configurable Pathname Variables" \ -u "Top" \ - -n "Device- and Class-Specific Functions" $< + -n "Device- and Class-Specific Functions" < $< > $@ -ch07.texi: ch07.t - $(BMENU) -c -p " Asynchronous File Synchronization" \ +$(srcdir)/ch07.texi: ch07.t + $(BMENU2) -c -p " Asynchronous File Synchronization" \ -u "Top" \ - -n "Language-Specific Services for the C Programming Language" $< + -n "Language-Specific Services for the C Programming Language" < $< > $@ -ch08.texi: ch08.t - $(BMENU) -c -p "Set Foreground Process Group ID" \ +$(srcdir)/ch08.texi: ch08.t + $(BMENU2) -c -p "Set Foreground Process Group ID" \ -u "Top" \ - -n "System Databases" $< + -n "System Databases" < $< > $@ -ch09.texi: ch09.t - $(BMENU) -c -p "Pseudo-Random Sequence Generation Functions" \ +$(srcdir)/ch09.texi: ch09.t + $(BMENU2) -c -p "Pseudo-Random Sequence Generation Functions" \ -u "Top" \ - -n "Data Interchange Format" $< + -n "Data Interchange Format" < $< > $@ -ch10.texi: ch10.t - $(BMENU) -c -p "User Database Access" \ +$(srcdir)/ch10.texi: ch10.t + $(BMENU2) -c -p "User Database Access" \ -u "Top" \ - -n "Synchronization" $< + -n "Synchronization" < $< > $@ -ch11.texi: ch11.t - $(BMENU) -c -p "Multiple Volumes" \ +$(srcdir)/ch11.texi: ch11.t + $(BMENU2) -c -p "Multiple Volumes" \ -u "Top" \ - -n "Memory Management" $< + -n "Memory Management" < $< > $@ -ch12.texi: ch12.t - $(BMENU) -c -p "Waiting on a Condition" \ +$(srcdir)/ch12.texi: ch12.t + $(BMENU2) -c -p "Waiting on a Condition" \ -u "Top" \ - -n "Execution Scheduling" $< + -n "Execution Scheduling" < $< > $@ -ch13.texi: ch13.t - $(BMENU) -c -p "Remove a Shared Memory Object" \ +$(srcdir)/ch13.texi: ch13.t + $(BMENU2) -c -p "Remove a Shared Memory Object" \ -u "Top" \ - -n "Clocks and Timers" $< + -n "Clocks and Timers" < $< > $@ -ch14.texi: ch14.t - $(BMENU) -c -p "Change the Priority Ceiling of a Mutex" \ +$(srcdir)/ch14.texi: ch14.t + $(BMENU2) -c -p "Change the Priority Ceiling of a Mutex" \ -u "Top" \ - -n "Message Passing" $< + -n "Message Passing" < $< > $@ -ch15.texi: ch15.t - $(BMENU) -c -p "High Resolution Sleep" \ +$(srcdir)/ch15.texi: ch15.t + $(BMENU2) -c -p "High Resolution Sleep" \ -u "Top" \ - -n "Thread Management" $< + -n "Thread Management" < $< > $@ -ch16.texi: ch16.t - $(BMENU) -c -p "Get Message Queue Attributes" \ +$(srcdir)/ch16.texi: ch16.t + $(BMENU2) -c -p "Get Message Queue Attributes" \ -u "Top" \ - -n "Thread-Specific Data" $< + -n "Thread-Specific Data" < $< > $@ -ch17.texi: ch17.t - $(BMENU) -c -p "Dynamic Package Initialization" \ +$(srcdir)/ch17.texi: ch17.t + $(BMENU2) -c -p "Dynamic Package Initialization" \ -u "Top" \ - -n "Thread Cancellation" $< + -n "Thread Cancellation" < $< > $@ -ch18.texi: ch18.t - $(BMENU) -c -p "Thread-Specific Data Key Deletion" \ +$(srcdir)/ch18.texi: ch18.t + $(BMENU2) -c -p "Thread-Specific Data Key Deletion" \ -u "Top" \ - -n "Compliance Summary" $< + -n "Compliance Summary" < $< > $@ ch19.t: ch01.t ch02.t ch03.t ch04.t ch05.t ch06.t ch07.t ch08.t ch09.t \ - ch10.t ch11.t ch12.t ch13.t ch14.t ch15.t ch16.t ch17.t ch18.t \ - summarize + ch10.t ch11.t ch12.t ch13.t ch14.t ch15.t ch16.t ch17.t ch18.t \ + summarize ./summarize >ch19.t -ch19.texi: ch19.t - $(BMENU) -c -p "List of Cancellation Points" \ +$(srcdir)/ch19.texi: ch19.t + $(BMENU2) -c -p "List of Cancellation Points" \ -u "Top" \ - -n "Command and Variable Index" $< + -n "Command and Variable Index" < $< > $@ noinst_SCRIPTS = summarize diff --git a/doc/posix1003.1/posix1003_1.texi b/doc/posix1003.1/posix1003_1.texi index 354527f5c1..1995c9ef8a 100644 --- a/doc/posix1003.1/posix1003_1.texi +++ b/doc/posix1003.1/posix1003_1.texi @@ -1,3 +1,4 @@ + \input texinfo @c -*-texinfo-*- @c %**start of header @setfilename posix1003_1 @@ -19,27 +20,20 @@ @c Master file for the POSIX 1003.1 Compliance Guide @c +@include version.texi @include ../common/setup.texi -@ignore -@ifinfo -@format -START-INFO-DIR-ENTRY -* RTEMS POSIX 1003.1 Compliance Guide (posix1003_1): -END-INFO-DIR-ENTRY -@end format -@end ifinfo -@end ignore +@ifset use-ascii +@dircategory RTEMS On-Line Manual +@direntry +* RTEMS POSIX 1003.1 Compliance Guide: (posix1003_1). +@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 +45,9 @@ END-INFO-DIR-ENTRY @finalout @title RTEMS POSIX 1003.1 Compliance 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/posix1003.1/stamp-vti b/doc/posix1003.1/stamp-vti new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/posix1003.1/stamp-vti @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 diff --git a/doc/posix1003.1/version.texi b/doc/posix1003.1/version.texi new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/posix1003.1/version.texi @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 -- cgit v1.2.3