Keyword index

.libs:

• 2.4 A few remarks on state

acinclude.m4:

• 2.2.1 STARCONF_DEFAULT_PREFIX and STARCONF_DEFAULT_STARLINK
• 4.3.1.2 Distributing a single component

aclocal:

• 2.1 Overview of the Autotools
• 2.1.4 Autoreconf: why you don't need to know about aclocal
• 2.4 A few remarks on state

AM_FLAGS:

• A.17 STAR_DEFAULTS

ATASKs:

• 3.4 Building monoliths

autoconf:

• 2 Tools
• 2.1.4 Autoreconf: why you don't need to know about aclocal
• B The relationship with the GNU autotools

autoconf/macros/AC_CHECK_PROG and STAR_CHECK_PROGS:

• A.14 STAR_CHECK_PROGS

autoconf/macros/AC_CONFIG_FILES:

• 2.1.1 Autoconf

autoconf/macros/AC_DEFINE:

• 2.1.1 Autoconf
• 2.1.1 Autoconf

autoconf/macros/AC_FC_CHECK_HEADERS:

• A.1 AC_FC_CHECK_HEADERS

autoconf/macros/AC_FC_CHECK_INTRINSICS:

• A.2 AC_FC_CHECK_INTRINSICS

autoconf/macros/AC_FC_HAVE_BOZ:

• A.3 AC_FC_HAVE_BOZ

autoconf/macros/AC_FC_HAVE_OLD_TYPELESS_BOZ:

• A.4 AC_FC_HAVE_OLD_TYPELESS_BOZ

autoconf/macros/AC_FC_HAVE_PERCENTLOC:

• A.5 AC_FC_HAVE_PERCENTLOC

autoconf/macros/AC_FC_HAVE_PERCENTVAL:

• A.6 AC_FC_HAVE_PERCENTVAL

autoconf/macros/AC_FC_HAVE_TYPELESS_BOZ:

• A.7 AC_FC_HAVE_TYPELESS_BOZ

autoconf/macros/AC_FC_HAVE_VOLATILE:

• A.8 AC_FC_HAVE_VOLATILE

autoconf/macros/AC_FC_LITERAL_BACKSLASH:

• A.9 AC_FC_LITERAL_BACKSLASH

autoconf/macros/AC_FC_OPEN_SPECIFIERS:

• 2.5 Preprocessable Fortran
• A.10 AC_FC_OPEN_SPECIFIERS

autoconf/macros/AC_FC_RECL_UNIT:

• A.11 AC_FC_RECL_UNIT

autoconf/macros/AC_PROG_FC:

• 2.5 Preprocessable Fortran
• 4.1 Autoconfing a library
• A.12 AC_PROG_FC
• A.13 AC_PROG_FPP

autoconf/macros/AC_PROG_FPP:

• 2.5 Preprocessable Fortran
• A.13 AC_PROG_FPP

autoconf/old versions:

• 4.5.1 Configuring m4

autoconf/overview:

• 2.1.1 Autoconf

autoconf/substitution variables/PACKAGE_VERSION:

• 2.3 Version numbers

autoconf/substitution variables/PACKAGE_VERSION_INTEGER:

• A.17 STAR_DEFAULTS

autoconf/substitution variables/PACKAGE_VERSION_MAJOR:

• A.17 STAR_DEFAULTS

autoconf/substitution variables/PACKAGE_VERSION_MINOR:

• A.17 STAR_DEFAULTS

autoconf/substitution variables/PACKAGE_VERSION_RELEASE:

• A.17 STAR_DEFAULTS

autoheader:

• 2.1 Overview of the Autotools
• 2.1.4 Autoreconf: why you don't need to know about aclocal

automake/overview:

• 2.1.2 Automake

automake/prefixes and primaries:

• 2.1.2 Automake

automake/Starlink changes:

• B The relationship with the GNU autotools

autoreconf:

• 2.1.4 Autoreconf: why you don't need to know about aclocal
• 2.2 Starconf, and the Starlink autoconf macros

autotools:

• 2.1 Overview of the Autotools

autotools/documentation:

• 2.1 Overview of the Autotools

autotools/Starlink changes:

• 2 Tools
• B The relationship with the GNU autotools

bootstrapping:

• 3.2 Bootstrapping and building the entire tree

bootstrapping/buildsupport:

• 3.3 Building a single component
• 3.5 Bootstrapping without building: configuring starconf and the autotools
• 4.3.1.2 Distributing a single component

buildsupport/updating:

• 5.1 General FAQs

BUILT_SOURCES:

• 2.1.2 Automake
• A.22 STAR_MESSGEN

C and Fortran, mixing:

• See also: CNF
• A.18 STAR_INITIALISE_FORTRAN

CNF:

• 4.1 Autoconfing a library
• A.15 STAR_CNF_COMPATIBLE_SYMBOLS

component.xml:

• 2.2 Starconf, and the Starlink autoconf macros

component.xml/format:

• 2.2.4 The format of the component.xml file

component.xml/template:

• 2.2 Starconf, and the Starlink autoconf macros
• 2.2.3 File templates

components:

• 2.2.2 Components

components/building:

• 3.3 Building a single component

components/cfitsio:

• 4.5.2 Configuring CFITSIO

components/m4:

• 4.5.1 Configuring m4

components/tcl:

• 4.5.3 Configuring tcl

config.cache:

• 2.4 A few remarks on state

config.h.in:

• 2.1 Overview of the Autotools
• 2.4 A few remarks on state

config.status:

• 2.4 A few remarks on state

configure/options/--with-starlink:

• 2.1.5 Running ./configure

configure/options/--with-tcl:

• A.24 STAR_PATH_TCLTK

configure/options/--without-stardocs:

• 2.1.5 Running ./configure
• A.20 STAR_LATEX_DOCUMENTATION
• A.29 STAR_XML_DOCUMENTATION

configure/running:

• 2.1.5 Running ./configure

configure.ac:

• 2.1 Overview of the Autotools

configure.ac/and automake:

• 2.1.2 Automake

configure.ac/example:

• 2.1.1 Autoconf

configure.ac/template:

• 2.2.3 File templates

CVS:

• 2.7 CVS
• 4.1 Autoconfing a library

CVS/and file modes:

• 4.1 Autoconfing a library

CVS/and recursion:

• 2.7.2 CVS and recursion -- checking out only a subtree

CVS/repository:

• 2.6 Using the Starlink CVS repository

DATA primary/bin_DATA:

• 2.1.2 Automake

debugging:

• See also: libtool, debugging executables
• 2.1.5 Running ./configure

dependencies:

• 3.2 Bootstrapping and building the entire tree
• 4.1 Autoconfing a library
• A.16 STAR_DECLARE_DEPENDENCIES

dependencies/configure:

• 6.2 Conditionally building components, I

dependencies/updating:

• 4.7 Adding components: the final step
• See also: Makefile.dependencies

directories/special:

• 2.1.2 Automake
• A.30 starxxx_DATA -- special installation directories

distribution:

• 1 Introduction
• 4.3 Distribution of components
• 4.3.1 Making a distribution
• A.26 STAR_PREDIST_SOURCES

distribution/dist prefix:

• 4.3 Distribution of components

distribution/EXTRA_DIST:

• 2.1.2 Automake
• 4.3 Distribution of components

distribution/nodist prefix:

• A.22 STAR_MESSGEN

distribution/setting prefix:

• See also: installation!setting prefix

documentation:

• 4.6 Documentation
• A.20 STAR_LATEX_DOCUMENTATION
• A.29 STAR_XML_DOCUMENTATION
• A.30 starxxx_DATA -- special installation directories

documentation/complicated:

• 4.3 Distribution of components

documentation/docs-only components:

• 4.6.1 Components containing only documentation

documentation/extra HTX files:

• A.20 STAR_LATEX_DOCUMENTATION

environment variables:

• 2.1.5 Running ./configure
• 5.1 General FAQs
• 5.3 State FAQs

environment variables/CC:

• 2.1.5 Running ./configure

environment variables/CFLAGS:

• 2.1.5 Running ./configure

environment variables/FC:

• 2.1.5 Running ./configure

environment variables/STARCONF_DEFAULT_PREFIX:

• 2.2.1 STARCONF_DEFAULT_PREFIX and STARCONF_DEFAULT_STARLINK
• 3.2 Bootstrapping and building the entire tree

environment variables/STARCONF_DEFAULT_STARLINK:

• 2.2.1 STARCONF_DEFAULT_PREFIX and STARCONF_DEFAULT_STARLINK
• A.17 STAR_DEFAULTS

environment variables/STARLINK:

• 2.1.5 Running ./configure
• 2.2.1 STARCONF_DEFAULT_PREFIX and STARCONF_DEFAULT_STARLINK

environment variables/warnings:

• 2.1.5 Running ./configure

example files:

• A.30 starxxx_DATA -- special installation directories

flags, compiler and linker:

• 2.3 Version numbers
• 6.4 Manipulating compiler and linker flags

flags, compiler and linker/AM_ flags:

• 6.4 Manipulating compiler and linker flags

flags, compiler and linker/STAR_ flags:

• 6.4 Manipulating compiler and linker flags

Fortran:

• 2.5 Preprocessable Fortran
• A.13 AC_PROG_FPP

Fortran/fpp (Sun Fortran preprocessor):

• 2.5 Preprocessable Fortran

Fortran/intrinsics and external functions:

• A.2 AC_FC_CHECK_INTRINSICS

help files:

• A.30 starxxx_DATA -- special installation directories

include_MESSAGES:

• A.22 STAR_MESSGEN

installation:

• 5.2 Installation FAQs
• A.30 starxxx_DATA -- special installation directories

installation/manifest:

• See also: manifests

installation/nobase prefix:

• 4.3 Distribution of components
• 4.5.2 Configuring CFITSIO
• 5.2 Installation FAQs

installation/noinst prefix:

• 4.3 Distribution of components
• A.22 STAR_MESSGEN

installation/setting prefix:

• 2.2.1 STARCONF_DEFAULT_PREFIX and STARCONF_DEFAULT_STARLINK
• 5.2 Installation FAQs

installation/special:

• A.27 STAR_SPECIAL_INSTALL_COMMAND

libtool:

• 2.1.3 Libtool
• B The relationship with the GNU autotools

libtool/debugging executables:

• 2.1.3 Libtool

libtoolize:

• 2.1.4 Autoreconf: why you don't need to know about aclocal

link scripts:

• B The relationship with the GNU autotools

m4:

• 2.1.1.1 M4 syntax and traps

make targets:

• 4.2 The build system `interface'

make targets/clean:

• 2.4 A few remarks on state
• 5.1 General FAQs

make targets/maintainer-clean:

• 2.4 A few remarks on state

make targets/top-level:

• 3.1 The top-level Makefile

make world:

• 2.4 A few remarks on state
• 3.1 The top-level Makefile
• 5.1 General FAQs

Makefile.am:

• 2.1 Overview of the Autotools
• 2.1.2 Automake

Makefile.am/template:

• 2.2.3 File templates

Makefile.dependencies:

• 2.2.4 The format of the component.xml file
• 2.4 A few remarks on state
• 3.2 Bootstrapping and building the entire tree
• 4.7 Adding components: the final step
• 5.1 General FAQs

manifests:

• 3.1 The top-level Makefile
• A.21 Variable STAR_MANIFEST_DIR

manifests/and third-party code:

• 4.5.1 Configuring m4

manifests/special installation targets:

• 5.2 Installation FAQs

manifests/state:

• 2.4 A few remarks on state

monoliths:

• 3.4 Building monoliths
• A.23 STAR_MONOLITHS

monoliths/and tasks:

• 3.4 Building monoliths

news files:

• A.30 starxxx_DATA -- special installation directories

PATH:

• 3.2 Bootstrapping and building the entire tree

per-package-dirs:

• 2.1.2 Automake
• A.17 STAR_DEFAULTS

pre-distribution files:

• See also: starconf!macros!STAR_PREDIST_SOURCES

shared libraries:

• 2.1.2 Automake

shared libraries/version numbers:

• 2.3 Version numbers

starconf:

• 2 Tools

starconf/location of macros:

• 2.1 Overview of the Autotools

starconf/macros/STAR_CHECK_PROGS:

• A.14 STAR_CHECK_PROGS

starconf/macros/STAR_CNF_COMPATIBLE_SYMBOLS:

• A.15 STAR_CNF_COMPATIBLE_SYMBOLS

starconf/macros/STAR_DECLARE_DEPENDENCIES:

• A.16 STAR_DECLARE_DEPENDENCIES

starconf/macros/STAR_DEFAULTS:

• 2.1.1 Autoconf
• A.17 STAR_DEFAULTS
• A.21 Variable STAR_MANIFEST_DIR

starconf/macros/STAR_FC_LIBRARY_LDFLAGS (obsolete):

• A.31.3 STAR_FC_LIBRARY_LDFLAGS

starconf/macros/STAR_HAVE_FC_OPEN_READONLY (obsolete):

• A.31.4 STAR_HAVE_FC_OPEN_READONLY

starconf/macros/STAR_INITIALISE_FORTRAN:

• A.18 STAR_INITIALISE_FORTRAN

starconf/macros/STAR_LARGEFILE_SUPPORT:

• A.19 STAR_LARGEFILE_SUPPORT

starconf/macros/STAR_LATEX_DOCUMENTATION:

• 4.5.2 Configuring CFITSIO
• A.20 STAR_LATEX_DOCUMENTATION

starconf/macros/STAR_MANIFEST_DIR:

• A.21 Variable STAR_MANIFEST_DIR

starconf/macros/STAR_MESSGEN:

• A.17 STAR_DEFAULTS
• A.22 STAR_MESSGEN

starconf/macros/STAR_MONOLITHS:

• A.23 STAR_MONOLITHS

starconf/macros/STAR_PATH_TCLTK:

• A.24 STAR_PATH_TCLTK

starconf/macros/STAR_PLATFORM_SOURCES:

• A.25 STAR_PLATFORM_SOURCES

starconf/macros/STAR_PREDIST_SOURCES:

• 4.3 Distribution of components
• A.22 STAR_MESSGEN
• A.26 STAR_PREDIST_SOURCES

starconf/macros/STAR_SPECIAL_INSTALL_COMMAND:

• 4.5.3 Configuring tcl
• A.27 STAR_SPECIAL_INSTALL_COMMAND

starconf/macros/STAR_SUPPRESS_BUILD_IF:

• A.28 STAR_SUPPRESS_BUILD_IF

starconf/macros/STAR_XML_DOCUMENTATION:

• A.29 STAR_XML_DOCUMENTATION

starconf/overview:

• 2.2 Starconf, and the Starlink autoconf macros

starconf/state, lack of:

• 2.4 A few remarks on state

starconf/templates:

• 2.2.3 File templates

starconf/variables/starxxx_DATA:

• A.30 starxxx_DATA -- special installation directories

starconf-status:

• 2.2 Starconf, and the Starlink autoconf macros

starconf-validate:

• 2.2 Starconf, and the Starlink autoconf macros
• 2.2 Starconf, and the Starlink autoconf macros
• 4.1 Autoconfing a library

starconf.status:

• 2.2 Starconf, and the Starlink autoconf macros

state:

• 2.4 A few remarks on state
• 5.3 State FAQs

symbolic links:

• 2.1.1 Autoconf

symbolic links/absolute links are bad:

• 4.5.3 Configuring tcl

symbolic links/installing:

• 5.2 Installation FAQs

symbolic links/to monoliths:

• 3.4 Building monoliths

tests:

• 4.4 Regression tests

thirdparty code:

• A.27 STAR_SPECIAL_INSTALL_COMMAND

version numbers:

• 2.1.1 Autoconf
• 2.3 Version numbers
• A.17 STAR_DEFAULTS

version.dat:

• A.17 STAR_DEFAULTS