summaryrefslogtreecommitdiffstats
path: root/doc/bsp_howto
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2000-06-01 15:29:01 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2000-06-01 15:29:01 +0000
commitfc76a6aa19af9606f260993811ac0dee8ec4e886 (patch)
tree039d079cce65ec28746118f177fc9bea2e737b11 /doc/bsp_howto
parentPatch from Ralf Corsepius <corsepiu@faw.uni-ulm.de>: (diff)
downloadrtems-fc76a6aa19af9606f260993811ac0dee8ec4e886.tar.bz2
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.
Diffstat (limited to '')
-rw-r--r--doc/bsp_howto/.cvsignore1
-rw-r--r--doc/bsp_howto/Makefile.am110
-rw-r--r--doc/bsp_howto/bsp_howto.texi25
-rw-r--r--doc/bsp_howto/stamp-vti3
-rw-r--r--doc/bsp_howto/version.texi3
5 files changed, 71 insertions, 71 deletions
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