Extract GDB version number from main GDB dir Makefile.in.
authorRoland Pesch <pesch@cygnus>
Fri, 20 Sep 1991 22:43:47 +0000 (22:43 +0000)
committerRoland Pesch <pesch@cygnus>
Fri, 20 Sep 1991 22:43:47 +0000 (22:43 +0000)
gdb/doc/Makefile
gdb/doc/interim-gdb.texinfo

index 30bbfaee8bef71a87628ef1c60d60a9d0866ee35..57081d33203e8dd5fb5e2a417bf66ffc458dff08 100755 (executable)
@@ -1,5 +1,6 @@
 ##Copyright (C) 1991 Free Software Foundation, Inc.
 
+# Makefile for GDB documentation.
 # This file is part of GDB.
 
 # This program is free software; you can redistribute it and/or modify
@@ -36,12 +37,12 @@ READLINE_DIR = ${srcdir}/../readline
 
 # Main GDB manual's source files
 SFILES_DOCDIR = \
-       gdb.texinfo pretex.m4 none.m4 all.m4 gdbinv-m.m4 gdbinv-s.m4   
+       gdb.texinfo pretex.m4 none.m4 all.m4 gdbinv-m.m4 gdbinv-s.m4 gdbVN.m4
 
 all: gdb.info gdb.dvi refcard.dvi gdb-internals gdbint.dvi
 
 clean:
-       rm -f gdb.dvi rdl-apps.texi gdb-all* gdb.info* 
+       rm -f gdb.dvi rdl-apps.texi gdb-all* gdb.info* gdbVN.m4
        rm -f gdb-internals gdbint.?? gdbint.???
        rm -f refcard.ps refcard.dvi rcfonts.tex refcard.log *~
 
@@ -65,6 +66,11 @@ rdl-apps.texi: ${READLINE_DIR}/inc-readline.texinfo \
        echo "@include ${READLINE_DIR}/inc-readline.texinfo" >rdl-apps.texi
        echo "@include ${READLINE_DIR}/inc-history.texinfo" >>rdl-apps.texi
 
+# File to record current GDB version number (copied from main dir Makefile.in)
+gdbVN.m4 : ${srcdir}/Makefile.in
+       ( VER=`sed <${srcdir}/Makefile.in -n 's/VERSION = //p'` ;\
+       echo "_define__(<_GDB_VN__>,$$VER)" > gdbVN.m4 )
+
 # GDB MANUAL: texinfo source, created by preprocessing w/m4
 # Be sure to not create a bad gdb-all.texi if ${M4} is missing or aborts...
 gdb-all.texi: ${SFILES_DOCDIR}
index c608acfea78c3d53f0e71ca2748db7f2d6976c0b..fe8263c6aec4ddec6cca3c3ad2eb84d64b7ca4e7 100755 (executable)
@@ -16,13 +16,14 @@ _if__(0)
 THIS IS THE SOURCE PRIOR TO PREPROCESSING.  The full source needs to
 be run through m4 before either tex- or info- formatting: for example,
 _0__
-    m4 pretex.m4 none.m4 m680x0.m4 gdb.texinfo >gdb-680x0.texinfo
+    m4 pretex.m4 none.m4 all.m4 gdb.texinfo >gdb-all.texinfo
 _1__
 will produce (assuming your path finds either GNU m4 >= 0.84, or SysV
 m4; Berkeley won't do) a file suitable for formatting.  See the text in
 "pretex.m4" for a fuller explanation (and the macro definitions).
 
 _fi__(0)
+_include__(gdbVN.m4)
 @tex
 \def\$#1${{#1}}  % Kluge: collect RCS revision info without $...$
 \xdef\manvers{\$Revision$}  % For use in headers, footers too
@@ -64,10 +65,10 @@ instead of in the original English.
 @c @smallbook
 @setchapternewpage odd
 _if__(_GENERIC__)
-@settitle Using _GDBN__ (v4.0)
+@settitle Using _GDBN__ (<v>_GDB_VN__)
 _fi__(_GENERIC__)
 _if__(!_GENERIC__)
-@settitle Using _GDBN__ v4.0 (_HOST__)
+@settitle Using _GDBN__ <v>_GDB_VN__ (_HOST__)
 _fi__(!_GENERIC__)
 @iftex
 @finalout
@@ -80,8 +81,8 @@ _if__(!_GENERIC__)
 _fi__(!_GENERIC__)
 @sp 1
 @c Maybe crank this up to "Fourth Edition" when released at FSF
-@c @subtitle Third Edition---_GDBN__ version 4.0
-@subtitle _GDBN__ version 4.0
+@c @subtitle Third Edition---_GDBN__ version _GDB_VN__
+@subtitle _GDBN__ version _GDB_VN__
 @subtitle July 1991
 @author{Richard M. Stallman@qquad @hfill Free Software Foundation}
 @author{Roland H. Pesch@qquad @hfill Cygnus Support}
@@ -118,12 +119,12 @@ instead of in the original English.
 
 @node Top, Summary, (dir), (dir)
 @ifinfo
-This file describes version 4.0 of GDB, the GNU symbolic debugger.
+This file describes version _GDB_VN__ of GDB, the GNU symbolic debugger.
 @end ifinfo
 
 @menu
 * Summary::                     Summary of _GDBN__
-* New Features::                New Features in _GDBN__ version 4.0
+* New Features::                New Features in _GDBN__ version _GDB_VN__
 * Sample Session::              A Sample _GDBN__ Session
 * Invocation::                  Getting In and Out of _GDBN__
 * Commands::                    _GDBN__ Commands
@@ -410,7 +411,7 @@ omitted from this list, we would like to add your names!
 
 So that they may not regard their long labor as thankless, we
 particularly thank those who shepherded GDB through major releases: John
-Gilmore (releases 4.1, 4.0); Jim Kingdon (releases 3.9, 3.5, 3.4, 3.3);
+Gilmore (releases _GDB_VN__, 4.0); Jim Kingdon (releases 3.9, 3.5, 3.4, 3.3);
 and Randy Smith (releases 3.2, 3.1, 3.0).  As major maintainer of GDB
 for some period, each contributed significantly to the structure,
 stability, and capabilities of the entire debugger.
@@ -423,7 +424,7 @@ with significant additional contributions from Per Bothner.  James
 Clark wrote the GNU C++ demangler.  Early work on C++ was by Peter
 TerMaat (who also did much general update work leading to release 3.0).
 
-GDB 4.0 uses the BFD subroutine library to examine multiple
+GDB _GDB_VN__ uses the BFD subroutine library to examine multiple
 object-file formats; BFD was a joint project of V. Gumby
 Henkel-Wallace, Rich Pixley, Steve Chamberlain, and John Gilmore.
 
@@ -534,12 +535,12 @@ of your program, and the latter refer to the state of _GDBN__ itself.
 @xref{Renamed Commands}, for details on what commands were renamed.
 
 @item Shared Libraries
-_GDBN__ 4.0 can debug programs and core files that use SunOS shared
+_GDBN__ _GDB_VN__ can debug programs and core files that use SunOS shared
 libraries.  You can load symbols from a shared library with the command
 @code{sharedlibrary} (@pxref{Files}).
 
 @item Reference Card
-_GDBN__ 4.0 has a reference card; @xref{Formatting Manual} for
+_GDBN__ _GDB_VN__ has a reference card; @xref{Formatting Manual} for
 instructions on printing it.
 
 @item Work in Progress
@@ -4313,7 +4314,7 @@ being set automatically by _GDBN__.
 @node Support,  , Checks, Languages
 @section Supported Languages
 
-_GDBN__ 4.0 supports C, C++, and Modula-2.  The syntax for C and C++ is
+_GDBN__ _GDB_VN__ supports C, C++, and Modula-2.  The syntax for C and C++ is
 so closely related that _GDBN__ does not distinguish the two.  Some
 _GDBN__ features may be used in expressions regardless of the language
 you use: the _GDBN__ @code{@@} and @code{::} operators, and the
@@ -7000,37 +7001,37 @@ of preparing _GDBN__ for installation; you can then use @code{make} to
 build the @code{_GDBP__} program.
 
 The _GDBP__ distribution includes all the source code you need for
-_GDBP__ in a single directory @file{gdb-4.0}.  That directory in turn
+_GDBP__ in a single directory @file{gdb-_GDB_VN__}.  That directory in turn
 contains: 
 
 @table @code
-@item gdb-4.0/configure
+@item gdb-_GDB_VN__/configure
 Overall script for configuring _GDBN__ and all its supporting libraries.
 
-@item gdb-4.0/gdb
+@item gdb-_GDB_VN__/gdb
 the source specific to _GDBN__ itself
 
-@item gdb-4.0/bfd
+@item gdb-_GDB_VN__/bfd
 source for the Binary File Descriptor Library
 
-@item gdb-4.0/include
+@item gdb-_GDB_VN__/include
 GNU include files
 
-@item gdb-4.0/libiberty
+@item gdb-_GDB_VN__/libiberty
 source for the @samp{-liberty} free software library
 
-@item gdb-4.0/readline
+@item gdb-_GDB_VN__/readline
 source for the GNU command-line interface
 @end table
 @noindent
 Each of these directories has its own @code{configure} script, which are
-used by the overall @code{configure} script in @file{gdb-4.0}.
+used by the overall @code{configure} script in @file{gdb-_GDB_VN__}.
 
-It is most convenient to run @code{configure} from the @file{gdb-4.0}
+It is most convenient to run @code{configure} from the @file{gdb-_GDB_VN__}
 directory.  The simplest way to configure and build _GDBN__ is the
 following:
 @example
-cd gdb-4.0
+cd gdb-_GDB_VN__
 ./configure @var{host}
 make
 @end example
@@ -7073,7 +7074,7 @@ subdirectories using the @samp{+subdirs} option (abbreviated
 
 @example
 @group
-cd gdb-4.0
+cd gdb-_GDB_VN__
 ./configure +sub sun4
 cd Host-sparc-sun-sunos4/Target-sparc-sun-sunos4
 make
@@ -7104,37 +7105,37 @@ If you have @file{Host-@var{host}/Target-@var{target}} subdirectories,
 run @code{make} in those subdirectories.  
 
 Each @code{configure} and @code{Makefile} under each source directory
-runs recursively, so that typing @code{make} in @file{gdb-4.0} (or in a
-@file{gdb-4.0/Host-@var{host}/Target-@var{target}} subdirectory)
+runs recursively, so that typing @code{make} in @file{gdb-_GDB_VN__} (or in a
+@file{gdb-_GDB_VN__/Host-@var{host}/Target-@var{target}} subdirectory)
 builds all the required libraries, then _GDBN__.@refill
 
-If you run @code{configure} from a directory (such as @file{gdb-4.0}) that
+If you run @code{configure} from a directory (such as @file{gdb-_GDB_VN__}) that
 contains source directories for multiple libraries or programs,
 @code{configure} creates the @file{Host-@var{host}/Target-@var{target}}
 subdirectories in each library or program's source directory.  For
 example, typing:
 @example
-cd gdb-4.0
+cd gdb-_GDB_VN__
 configure sun4 +target=vxworks960
 @end example
 @noindent
 creates the following directories:
 @smallexample
-gdb-4.0/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
-gdb-4.0/bfd/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
-gdb-4.0/gdb/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
-gdb-4.0/libiberty/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
-gdb-4.0/readline/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/bfd/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/gdb/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/libiberty/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/readline/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
 @end smallexample
 @noindent
 The @code{Makefile} in
 @smallexample
-gdb-4.0/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
 @end smallexample
 @noindent
 will @code{cd} to the appropriate lower-level directories, for example:
 @smallexample
-gdb-4.0/bfd/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
+gdb-_GDB_VN__/bfd/Host-sparc-sun-sunos4/Target-i960-wrs-vxworks
 @end smallexample
 @noindent
 building each in turn.
@@ -7166,7 +7167,7 @@ vendor is @samp{sun}, and the operating system is @samp{sunos4}.
 @end iftex
 
 The following table shows all the architectures, hosts, and OS prefixes
-that @code{configure} recognizes in _GDBN__ 4.0.  Entries in the ``OS
+that @code{configure} recognizes in _GDBN__ _GDB_VN__.  Entries in the ``OS
 prefix'' column ending in a @samp{*} may be followed by a release number.
 
 @ifinfo
@@ -7249,7 +7250,7 @@ ARCHITECTURE  VENDOR        OS prefix
 untested. 
 @end quotation
 
-The @code{configure} script accompanying _GDBN__ 4.0 does not provide
+The @code{configure} script accompanying _GDBN__ _GDB_VN__ does not provide
 any query facility to list all supported host and target names or
 aliases.  @code{configure} calls the Bourne shell script
 @code{config.sub} to map abbreviations to full names; you can read the
@@ -7342,8 +7343,8 @@ options that affect _GDBN__ or its supporting libraries.
 @node Formatting Manual,  , configure Options, Installing _GDBN__
 @section Formatting this Manual
 
-The _GDBN__ 4.0 release includes the Info version of this manual already
-formatted: the main Info file is @file{gdb-4.0/gdb/gdb.info}, and it
+The _GDBN__ _GDB_VN__ release includes the Info version of this manual already
+formatted: the main Info file is @file{gdb-_GDB_VN__/gdb/gdb.info}, and it
 refers to subordinate files matching @samp{gdb.info*} in the same
 directory.
 
@@ -7351,7 +7352,7 @@ If you want to make these Info files yourself from the _GDBN__ manual's
 source, you need the GNU @code{makeinfo} program.  Once you have it, you
 can type
 @example
-cd gdb-4.0/gdb
+cd gdb-_GDB_VN__/gdb
 make gdb.info
 @end example
 @noindent
@@ -7365,7 +7366,7 @@ things:
 must be installed on your system and available through your execution
 path.
 @item 
-@file{gdb-4.0/texinfo}: @TeX{} macros defining the GNU
+@file{gdb-_GDB_VN__/texinfo}: @TeX{} macros defining the GNU
 Documentation Format.
 @item
 @emph{A @sc{dvi} output program.}  @TeX{} doesn't actually make marks on
@@ -7377,7 +7378,7 @@ these files; one popular example is @code{dvips}, which can print
 @noindent
 Once you have these things, you can type
 @example
-cd gdb-4.0/gdb
+cd gdb-_GDB_VN__/gdb
 make gdb.dvi
 @end example
 @noindent
@@ -7387,8 +7388,8 @@ method for @TeX{} @sc{dvi} files at your site.
 @cindex _GDBN__ reference card
 @cindex reference card
 You might also want hard copy of the _GDBN__ reference card.  The
-_GDBN__ 4.0 release includes an already-formatted reference card, ready
-for printing on a PostScript printer, as @file{gdb-4.0/gdb/refcard.ps}.
+_GDBN__ _GDB_VN__ release includes an already-formatted reference card, ready
+for printing on a PostScript printer, as @file{gdb-_GDB_VN__/gdb/refcard.ps}.
 It uses the most common PostScript fonts: the Times family, Courier, and
 Symbol.  If you have a PostScript printer you can print the reference
 card by just sending @file{refcard.ps} to the printer.
@@ -7397,7 +7398,7 @@ If you have some other kind of printer, or want to print using Computer
 Modern fonts instead, you can still print the reference card if you have
 @TeX{}.  Format the reference card by typing
 @example
-cd gdb-4.0/gdb
+cd gdb-_GDB_VN__/gdb
 make refcard.dvi
 @end example
 @noindent