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/bsp_howto/.cvsignore | 1 + doc/bsp_howto/Makefile.am | 110 +++++++++++++++++++++---------------------- doc/bsp_howto/bsp_howto.texi | 25 ++++------ doc/bsp_howto/stamp-vti | 3 ++ doc/bsp_howto/version.texi | 3 ++ 5 files changed, 71 insertions(+), 71 deletions(-) create mode 100644 doc/bsp_howto/stamp-vti create mode 100644 doc/bsp_howto/version.texi (limited to 'doc/bsp_howto') diff --git a/doc/bsp_howto/.cvsignore b/doc/bsp_howto/.cvsignore index a6c4bb5b8e..071653242c 100644 --- a/doc/bsp_howto/.cvsignore +++ b/doc/bsp_howto/.cvsignore @@ -26,6 +26,7 @@ init.texi intro.texi linkcmds.texi makefiles.texi +mdate-sh network.t network.texi nvmem.texi diff --git a/doc/bsp_howto/Makefile.am b/doc/bsp_howto/Makefile.am index 9074e6eb13..4e067bca39 100644 --- a/doc/bsp_howto/Makefile.am +++ b/doc/bsp_howto/Makefile.am @@ -6,108 +6,108 @@ # $Id$ # -AUTOMAKE_OPTIONS = foreign +AUTOMAKE_OPTIONS = foreign 1.4 -PROJECT=bsp_howto +PROJECT = bsp_howto +EDITION = 1 include $(top_srcdir)/project.am -COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi +GENERATED_FILES = intro.texi target.texi makefiles.texi linkcmds.texi \ + support.texi adaintr.texi init.texi console.texi clock.texi timer.texi \ + rtc.texi nvmem.texi network.texi shmsupp.texi analog.texi discrete.texi -GENERATED_FILES= \ - intro.texi target.texi makefiles.texi linkcmds.texi support.texi \ - adaintr.texi init.texi console.texi clock.texi timer.texi rtc.texi \ - nvmem.texi network.texi shmsupp.texi analog.texi discrete.texi +COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi -FILES= +FILES = info_TEXINFOS = bsp_howto.texi -bsp_howto_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES) +bsp_howto_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES) # # Process Automatically Generated Files # -intro.texi: intro.t - $(BMENU) -p "Top" \ +$(srcdir)/intro.texi: intro.t + $(BMENU2) -p "Top" \ -u "Top" \ - -n "Target Dependent Files" $< + -n "Target Dependent Files" < $< > $@ -target.texi: target.t - $(BMENU) -p "Introduction" \ +$(srcdir)/target.texi: target.t + $(BMENU2) -p "Introduction" \ -u "Top" \ - -n "Makefiles" $< + -n "Makefiles" < $< > $@ -makefiles.texi: makefiles.t - $(BMENU) -p "Target Dependent Files Board Support Package Structure" \ +$(srcdir)/makefiles.texi: makefiles.t + $(BMENU2) -p "Target Dependent Files Board Support Package Structure" \ -u "Top" \ - -n "Linker Script" $< + -n "Linker Script" < $< > $@ -linkcmds.texi: linkcmds.t - $(BMENU) -p "Makefiles Creating a New BSP Make Customization File" \ +$(srcdir)/linkcmds.texi: linkcmds.t + $(BMENU2) -p "Makefiles Creating a New BSP Make Customization File" \ -u "Top" \ - -n "Ada95 Interrupt Support" $< + -n "Ada95 Interrupt Support" < $< > $@ -adaintr.texi: adaintr.t - $(BMENU) -p "Linker Script Initialized Data" \ +$(srcdir)/adaintr.texi: adaintr.t + $(BMENU2) -p "Linker Script Initialized Data" \ -u "Top" \ - -n "Miscellaneous Support Files" $< + -n "Miscellaneous Support Files" < $< > $@ -support.texi: support.t - $(BMENU) -p "Ada95 Interrupt Support Version Requirements" \ +$(srcdir)/support.texi: support.t + $(BMENU2) -p "Ada95 Interrupt Support Version Requirements" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ -init.texi: init.t - $(BMENU) -p "" \ +$(srcdir)/init.texi: init.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ -console.texi: console.t - $(BMENU) -p "" \ +$(srcdir)/console.texi: console.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 "" < $< > $@ -rtc.texi: rtc.t - $(BMENU) -p "" \ +$(srcdir)/rtc.texi: rtc.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ -nvmem.texi: nvmem.t - $(BMENU) -p "" \ +$(srcdir)/nvmem.texi: nvmem.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ # # Grab the chapter on writing a network device driver. # -network.texi: ../networking/driver.t +$(srcdir)/network.texi: ../networking/driver.t $(BMENU2) -p "" \ -u "Top" \ -n "" < $< > $@ -shmsupp.texi: shmsupp.t - $(BMENU) -p "" \ +$(srcdir)/shmsupp.texi: shmsupp.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ -analog.texi: analog.t - $(BMENU) -p "" \ +$(srcdir)/analog.texi: analog.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ -discrete.texi: discrete.t - $(BMENU) -p "" \ +$(srcdir)/discrete.texi: discrete.t + $(BMENU2) -p "" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ EXTRA_DIST = *.t diff --git a/doc/bsp_howto/bsp_howto.texi b/doc/bsp_howto/bsp_howto.texi index 7980143011..37fbb6d068 100644 --- a/doc/bsp_howto/bsp_howto.texi +++ b/doc/bsp_howto/bsp_howto.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 -* BSP and Device Driver Development Guide (bsp_howto): -END-INFO-DIR-ENTRY -@end format -@end ifinfo -@end ignore +@ifset use-ascii +@dircategory RTEMS On-Line Manual +@direntry +* RTEMS BSP-Howto: (bsp_howto). BSP and Device Driver Development Guide. +@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 BSP and Device Driver Development Guide -@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 diff --git a/doc/bsp_howto/stamp-vti b/doc/bsp_howto/stamp-vti new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/bsp_howto/stamp-vti @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 diff --git a/doc/bsp_howto/version.texi b/doc/bsp_howto/version.texi new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/bsp_howto/version.texi @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 -- cgit v1.2.3