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/started/.cvsignore | 3 ++- doc/started/Makefile.am | 65 ++++++++++++++++++++++++------------------------ doc/started/stamp-vti | 3 +++ doc/started/started.texi | 25 +++++++------------ doc/started/version.texi | 3 +++ 5 files changed, 50 insertions(+), 49 deletions(-) create mode 100644 doc/started/stamp-vti create mode 100644 doc/started/version.texi (limited to 'doc/started') diff --git a/doc/started/.cvsignore b/doc/started/.cvsignore index e66b8b82da..5a00f63e33 100644 --- a/doc/started/.cvsignore +++ b/doc/started/.cvsignore @@ -6,13 +6,14 @@ buildrt.texi gdb.texi index.html intro.texi +mdate-sh nextstep.texi nt.texi require.texi sample.texi started -started-? started*.html +started-? started.aux started.cp started.dvi diff --git a/doc/started/Makefile.am b/doc/started/Makefile.am index f9de292656..e1782be731 100644 --- a/doc/started/Makefile.am +++ b/doc/started/Makefile.am @@ -6,67 +6,68 @@ # $Id$ # -AUTOMAKE_OPTIONS = foreign +AUTOMAKE_OPTIONS = foreign 1.4 -PROJECT=started +PROJECT = started +EDITION = 1 SUBDIRS = pictures include $(top_srcdir)/project.am -COMMON_FILES=$(top_srcdir)/common/cpright.texi $(top_builddir)/common/setup.texi - -GENERATED_FILES= binaries.texi buildc.texi buildrt.texi gdb.texi intro.texi \ +GENERATED_FILES = binaries.texi buildc.texi buildrt.texi gdb.texi intro.texi \ nt.texi require.texi nextstep.texi sample.texi -FILES= tversions.texi +COMMON_FILES = $(top_srcdir)/common/setup.texi $(top_srcdir)/common/cpright.texi + +FILES = tversions.texi info_TEXINFOS = started.texi started_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES) -intro.texi: intro.t tversions.texi - $(BMENU) -c -p "Top" \ +$(srcdir)/intro.texi: intro.t tversions.texi + $(BMENU2) -c -p "Top" \ -u "Top" \ - -n "Requirements" $< + -n "Requirements" < $< > $@ -require.texi: require.t tversions.texi - $(BMENU) -c -p "GCC Mailing Lists" \ +$(srcdir)/require.texi: require.t tversions.texi + $(BMENU2) -c -p "GCC Mailing Lists" \ -u "Top" \ - -n "Prebuilt Toolset Executables" $< + -n "Prebuilt Toolset Executables" < $< > $@ -binaries.texi: binaries.t tversions.texi - $(BMENU) -c -p "GNU makeinfo Version Requirements" \ +$(srcdir)/binaries.texi: binaries.t tversions.texi + $(BMENU2) -c -p "GNU makeinfo Version Requirements" \ -u "Top" \ - -n "Building the GNU C/C++ Cross Compiler Toolset" $< + -n "Building the GNU C/C++ Cross Compiler Toolset" < $< > $@ -buildc.texi: buildc.t tversions.texi - $(BMENU) -c -p "Removing RPMs" \ +$(srcdir)/buildc.texi: buildc.t tversions.texi + $(BMENU2) -c -p "Removing RPMs" \ -u "Top" \ - -n "Building RTEMS" $< + -n "Building RTEMS" < $< > $@ -buildrt.texi: buildrt.t tversions.texi - $(BMENU) -c -p "Error Messages Indicating Configuration Problems" \ +$(srcdir)/buildrt.texi: buildrt.t tversions.texi + $(BMENU2) -c -p "Error Messages Indicating Configuration Problems" \ -u "Top" \ - -n "Building the Sample Application" $< + -n "Building the Sample Application" < $< > $@ -sample.texi: sample.t tversions.texi - $(BMENU) -c -p "Using the RTEMS configure Script Directly" \ +$(srcdir)/sample.texi: sample.t tversions.texi + $(BMENU2) -c -p "Using the RTEMS configure Script Directly" \ -u "Top" \ - -n "Building the GNU Debugger" $< + -n "Building the GNU Debugger" < $< > $@ gdb.texi: gdb.t tversions.texi - $(BMENU) -c -p "More Information on RTEMS Application Makefiles" \ + $(BMENU2) -c -p "More Information on RTEMS Application Makefiles" \ -u "Top" \ - -n "Where To Go From Here" $< + -n "Where To Go From Here" < $< > $@ -nextstep.texi: nextstep.t tversions.texi - $(BMENU) -c -p "GDB for DINK32" \ +$(srcdir)/nextstep.texi: nextstep.t tversions.texi + $(BMENU2) -c -p "GDB for DINK32" \ -u "Top" \ - -n "Using MS-Windows as a Development Host" $< + -n "Using MS-Windows as a Development Host" < $< > $@ -nt.texi: nt.t tversions.texi - $(BMENU) -c -p "Writing an Application" \ +$(srcdir)/nt.texi: nt.t tversions.texi + $(BMENU2) -c -p "Writing an Application" \ -u "Top" \ - -n "" $< + -n "" < $< > $@ EXTRA_DIST = *.t diff --git a/doc/started/stamp-vti b/doc/started/stamp-vti new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/started/stamp-vti @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 diff --git a/doc/started/started.texi b/doc/started/started.texi index 6a01aa6757..399949d11f 100644 --- a/doc/started/started.texi +++ b/doc/started/started.texi @@ -19,6 +19,7 @@ @c Master file for the Getting Started (C) Guide @c +@include version.texi @include ../common/setup.texi @c @@ -26,25 +27,17 @@ @c @include tversions.texi -@ignore -@ifinfo -@format -START-INFO-DIR-ENTRY -* Getting Started with RTEMS for C/C++ Users (started): -END-INFO-DIR-ENTRY -@end format -@end ifinfo -@end ignore +@ifset use-ascii +@dircategory RTEMS On-Line Manual +@direntry +* Getting Started with RTEMS for C/C++ Users: (started). +@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 @@ -56,9 +49,9 @@ END-INFO-DIR-ENTRY @finalout @title Getting Started with RTEMS for C/C++ Users -@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/started/version.texi b/doc/started/version.texi new file mode 100644 index 0000000000..27e5ccd0cb --- /dev/null +++ b/doc/started/version.texi @@ -0,0 +1,3 @@ +@set UPDATED 1 June 2000 +@set EDITION 1 +@set VERSION 4.5.0-beta3 -- cgit v1.2.3