~ubuntu-branches/ubuntu/saucy/autoconf/saucy-proposed : revision 16

1

This is autoconf.info, produced by makeinfo version 4.13 from

2

autoconf.texi.

3

4

This manual (4 November 2009) is for GNU Autoconf (version 2.65), a

4

This manual (21 July 2010) is for GNU Autoconf (version 2.67), a

5

package for creating scripts to configure source code packages using

6

templates and an M4 macro package.

7

8

9

2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software

9

2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software

10

Foundation, Inc.

11

12

Permission is granted to copy, distribute and/or modify this

52

Autoconf

53

********

54

55

This manual (4 November 2009) is for GNU Autoconf (version 2.65), a

55

This manual (21 July 2010) is for GNU Autoconf (version 2.67), a

56

package for creating scripts to configure source code packages using

57

templates and an M4 macro package.

58

59

60

2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software

60

2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software

61

Foundation, Inc.

62

63

Permission is granted to copy, distribute and/or modify this

333

* The Make Macro SHELL:: `$(SHELL)' portability issues

334

* Parallel Make:: Parallel `make' quirks

335

* Comments in Make Rules:: Other problems with Make comments

336

* Newlines in Make Rules:: Using literal newlines in rules

336

337

* obj/ and Make:: Don't name a subdirectory `obj'

337

338

* make -k Status:: Exit status of `make -k'

338

339

* VPATH and Make:: `VPATH' woes

544

545

546

Autoconf requires GNU M4 version 1.4.6 or later in order to generate

546

547

the scripts. It uses features that some versions of M4, including GNU

547

M4 1.3, do not have. Autoconf works better with GNU M4 version 1.4.13

548

M4 1.3, do not have. Autoconf works better with GNU M4 version 1.4.14

548

549

or later, though this is not required.

549

550

551

*Note Autoconf 1::, for information about upgrading from version 1.

585

586

set of often-used macros that have already demonstrated their

586

587

usefulness. Nevertheless, if you wish to share your macros, or find

587

588

existing ones, see the Autoconf Macro Archive

588

(http://autoconf-archive.cryp.to/), which is kindly run by Peter Simons

589

<simons@cryp.to>.

589

(http://www.gnu.org/software/autoconf-archive/), which is kindly run by

590

Peter Simons <simons@cryp.to>.

590

591

592

593

File: autoconf.info, Node: The GNU Build System, Next: Making configure Scripts, Prev: Introduction, Up: Top

791

792

`autoconf' and `autoheader' also read the installed Autoconf macro

792

793

files (by reading `autoconf.m4').

793

794

Files used in preparing a software package for distribution:

795

Files used in preparing a software package for distribution, when using

796

just Autoconf:

795

797

your source files --> [autoscan*] --> [configure.scan] --> configure.ac

796

798

797

799

configure.ac --.

800

802

| `-----> [autoheader*] --> [config.h.in]

801

803

[acsite.m4] ---'

802

804

803

Makefile.in -------------------------------> Makefile.in

805

Makefile.in

806

807

Additionally, if you use Automake, the following additional productions

808

come into play:

809

810

[acinclude.m4] --.

811

|

812

[local macros] --+--> aclocal* --> aclocal.m4

813

|

814

configure.ac ----'

815

816

configure.ac --.

817

+--> automake* --> Makefile.in

818

Makefile.am ---'

804

819

805

820

Files used in configuring a software package:

806

821

.-------------> [config.cache]

911

926

quotation.

912

927

913

928

When calling macros that take arguments, there must not be any white

914

space between the macro name and the open parenthesis. Arguments should

915

be enclosed within the M4 quote characters `[' and `]', and be

916

separated by commas. Any leading blanks or newlines in arguments are

917

ignored, unless they are quoted. You should always quote an argument

918

that might contain a macro name, comma, parenthesis, or a leading blank

919

or newline. This rule applies recursively for every macro call,

920

including macros called from other macros.

929

space between the macro name and the open parenthesis.

930

931

AC_INIT ([oops], [1.0]) # incorrect

932

AC_INIT([hello], [1.0]) # good

933

934

Arguments should be enclosed within the quote characters `[' and

935

`]', and be separated by commas. Any leading blanks or newlines in

936

arguments are ignored, unless they are quoted. You should always quote

937

an argument that might contain a macro name, comma, parenthesis, or a

938

leading blank or newline. This rule applies recursively for every macro

939

call, including macros called from other macros. For more details on

940

quoting rules, see *note Programming in M4::.

921

941

922

942

For instance:

923

943

924

944

AC_CHECK_HEADER([stdio.h],

925

945

[AC_DEFINE([HAVE_STDIO_H], [1],

926

946

[Define to 1 if you have <stdio.h>.])],

927

[AC_MSG_ERROR([Sorry, can't do anything for you])])

947

[AC_MSG_ERROR([sorry, can't do anything for you])])

928

948

929

949

is quoted properly. You may safely simplify its quotation to:

930

950

931

951

AC_CHECK_HEADER([stdio.h],

932

952

[AC_DEFINE([HAVE_STDIO_H], 1,

933

953

[Define to 1 if you have <stdio.h>.])],

934

[AC_MSG_ERROR([Sorry, can't do anything for you])])

954

[AC_MSG_ERROR([sorry, can't do anything for you])])

935

955

936

956

because `1' cannot contain a macro call. Here, the argument of

937

957

`AC_MSG_ERROR' must be quoted; otherwise, its comma would be

947

967

AC_CHECK_HEADER(stdio.h,

948

968

[AC_DEFINE(HAVE_STDIO_H, 1,

949

969

[Define to 1 if you have <stdio.h>.])],

950

[AC_MSG_ERROR([Sorry, can't do anything for you])])

970

[AC_MSG_ERROR([sorry, can't do anything for you])])

951

971

952

972

This is safe, so long as you adopt good naming conventions and do not

953

973

define macros with names like `HAVE_STDIO_H', `stdio', or `h'. Though

960

980

AC_CHECK_HEADER(stdio.h,

961

981

AC_DEFINE(HAVE_STDIO_H, 1,

962

982

Define to 1 if you have <stdio.h>.),

963

AC_MSG_ERROR([Sorry, can't do anything for you]))

983

AC_MSG_ERROR([sorry, can't do anything for you]))

964

984

965

985

In other cases, you may have to use text that also resembles a macro

966

986

call. You must quote that text even when it is not passed as a macro

1515

1535

and underscores are changed to `-'. If provided, URL should be

1516

1536

the home page for the package.

1517

1537

1518

It is preferable that the arguments of `AC_INIT' be static, i.e.,

1519

there should not be any shell computation, but they can be

1520

computed by M4.

1538

The arguments of `AC_INIT' must be static, i.e., there should not

1539

be any shell computation, quotes, or newlines, but they can be

1540

computed by M4. This is because the package information strings

1541

are expanded at M4 time into several contexts, and must give the

1542

same text at shell time whether used in single-quoted strings,

1543

double-quoted strings, quoted here-documents, or unquoted

1544

here-documents. It is permissible to use `m4_esyscmd' or

1545

`m4_esyscmd_s' for computing a version string that changes with

1546

every commit to a version control system (in fact, Autoconf does

1547

just that, for all builds of the development tree made between

1548

releases).

1521

1549

1522

1550

The following M4 macros (e.g., `AC_PACKAGE_NAME'), output variables

1523

1551

(e.g., `PACKAGE_NAME'), and preprocessor symbols (e.g.,

1568

1596

earlier than VERSION, print an error message to the standard error

1569

1597

output and exit with failure (exit status is 63). For example:

1570

1598

1571

AC_PREREQ([2.65])

1599

AC_PREREQ([2.67])

1572

1600

1573

1601

This macro may be used before `AC_INIT'.

1574

1602

1577

1605

version of Autoconf that is currently parsing the input file, in a

1578

1606

format suitable for `m4_version_compare' (*note

1579

1607

m4_version_compare::); in other words, for this release of

1580

Autoconf, its value is `2.65'. One potential use of this macro is

1608

Autoconf, its value is `2.67'. One potential use of this macro is

1581

1609

for writing conditional fallbacks based on when a feature was

1582

1610

added to Autoconf, rather than using `AC_PREREQ' to require the

1583

1611

newer version of Autoconf. However, remember that the Autoconf

1971

1999

to test for C features.

1972

2000

1973

2001

If a compiler option affects only the behavior of the preprocessor

1974

(e.g., `-D NAME'), it should be put into `CPPFLAGS' instead. If

1975

it affects only the linker (e.g., `-L DIRECTORY'), it should be

1976

put into `LDFLAGS' instead. If it affects only the compiler

1977

proper, `CFLAGS' is the natural home for it. If an option affects

2002

(e.g., `-DNAME'), it should be put into `CPPFLAGS' instead. If it

2003

affects only the linker (e.g., `-LDIRECTORY'), it should be put

2004

into `LDFLAGS' instead. If it affects only the compiler proper,

2005

`CFLAGS' is the natural home for it. If an option affects

1978

2006

multiple phases of the compiler, though, matters get tricky. One

1979

2007

approach to put such options directly into `CC', e.g., `CC='gcc

1980

2008

-m64''. Another is to put them into both `CPPFLAGS' and

2179

2207

2180

2208

-- Variable: exec_prefix

2181

2209

The installation prefix for architecture-dependent files. By

2182

default it's the same as PREFIX. You should avoid installing

2183

anything directly to EXEC_PREFIX. However, the default value for

2210

default it's the same as `prefix'. You should avoid installing

2211

anything directly to `exec_prefix'. However, the default value for

2184

2212

directories containing architecture-dependent files should be

2185

relative to EXEC_PREFIX.

2213

relative to `exec_prefix'.

2186

2214

2187

2215

-- Variable: htmldir

2188

2216

The directory for installing HTML documentation.

2217

2245

The directory for installing PDF documentation.

2218

2246

2219

2247

-- Variable: prefix

2220

The common installation prefix for all files. If EXEC_PREFIX is

2221

defined to a different value, PREFIX is used only for

2248

The common installation prefix for all files. If `exec_prefix' is

2249

defined to a different value, `prefix' is used only for

2222

2250

architecture-independent files.

2223

2251

2224

2252

-- Variable: psdir

2917

2945

literal, i.e., please do not use:

2918

2946

2919

2947

if test "x$package_foo_enabled" = xyes; then

2920

$my_subdirs="$my_subdirs foo"

2948

my_subdirs="$my_subdirs foo"

2921

2949

fi

2922

2950

AC_CONFIG_SUBDIRS([$my_subdirs])

2923

2951

2929

2957

AC_CONFIG_SUBDIRS([foo])

2930

2958

fi

2931

2959

2932

If a given DIR is not found, an error is reported: if the

2933

subdirectory is optional, write:

2960

If a given DIR is not found at `configure' run time, a warning is

2961

reported; if the subdirectory is optional, write:

2934

2962

2935

2963

if test -d "$srcdir/foo"; then

2936

2964

AC_CONFIG_SUBDIRS([foo])

3620

3648

`AC_LINK_IFELSE([AC_LANG_CALL([], [FUNCTION])])' first with no

3621

3649

libraries, then for each library listed in SEARCH-LIBS.

3622

3650

3623

Add `-lLIBRARY' to `LIBS' for the first library found to contain

3624

FUNCTION, and run ACTION-IF-FOUND. If the function is not found,

3625

run ACTION-IF-NOT-FOUND.

3651

Prepend `-lLIBRARY' to `LIBS' for the first library found to

3652

contain FUNCTION, and run ACTION-IF-FOUND. If the function is not

3653

found, run ACTION-IF-NOT-FOUND.

3626

3654

3627

3655

If linking with LIBRARY results in unresolved symbols that would

3628

3656

be resolved by linking with additional libraries, give those

3634

3662

The result of this test is cached in the `ac_cv_search_FUNCTION'

3635

3663

variable as `none required' if FUNCTION is already available, as

3636

3664

`no' if no library containing FUNCTION was found, otherwise as the

3637

`-lLIBRARY' option that needs to be added to `LIBS'.

3665

`-lLIBRARY' option that needs to be prepended to `LIBS'.

3638

3666

3639

3667

3640

3668

File: autoconf.info, Node: Library Functions, Next: Header Files, Prev: Libraries, Up: Existing Tests

4955

4983

This macro actually tests whether SYMBOL is defined as a macro or

4956

4984

can be used as an r-value, not whether it is really declared,

4957

4985

because it is much safer to avoid introducing extra declarations

4958

when they are not needed.

4986

when they are not needed. In order to facilitate use of C++ and

4987

overloaded function declarations, it is possible to specify

4988

function argument types in parentheses for types which can be

4989

zero-initialized:

4990

4991

AC_CHECK_DECL([basename(char *)])

4959

4992

4960

4993

This macro caches its result in the `ac_cv_have_decl_SYMBOL'

4961

4994

variable, with characters not suitable for a variable name mapped

4963

4996

4964

4997

-- Macro: AC_CHECK_DECLS (SYMBOLS, [ACTION-IF-FOUND],

4965

4998

[ACTION-IF-NOT-FOUND], [INCLUDES = `AC_INCLUDES_DEFAULT'])

4966

For each of the SYMBOLS (_comma_-separated list), define

4999

For each of the SYMBOLS (_comma_-separated list with optional

5000

function argument types for C++ overloads), define

4967

5001

`HAVE_DECL_SYMBOL' (in all capitals) to `1' if SYMBOL is declared,

4968

5002

otherwise to `0'. If ACTION-IF-NOT-FOUND is given, it is

4969

5003

additional shell code to execute when one of the function

4978

5012

AC_CHECK_DECLS([strlen])

4979

5013

AC_CHECK_DECLS([malloc, realloc, calloc, free])

4980

5014

AC_CHECK_DECLS([j0], [], [], [[#include <math.h>]])

5015

AC_CHECK_DECLS([[basename(char *)], [dirname(char *)]])

4981

5016

4982

5017

Unlike the other `AC_CHECK_*S' macros, when a SYMBOL is not

4983

5018

declared, `HAVE_DECL_SYMBOL' is defined to `0' instead of leaving

5096

5131

Default Includes::).

5097

5132

5098

5133

AC_CHECK_MEMBER([struct passwd.pw_gecos], [],

5099

[AC_MSG_ERROR([We need `passwd.pw_gecos'!])],

5134

[AC_MSG_ERROR([we need `passwd.pw_gecos'])],

5100

5135

[[#include <pwd.h>]])

5101

5136

5102

5137

You can use this macro for submembers:

5597

5632

If using the GNU C compiler, set shell variable `GCC' to `yes'.

5598

5633

If output variable `CFLAGS' was not already set, set it to `-g

5599

5634

-O2' for the GNU C compiler (`-O2' on systems where GCC does not

5600

accept `-g'), or `-g' for other compilers.

5635

accept `-g'), or `-g' for other compilers. If your package does

5636

not like this default, then it is acceptable to insert the line `:

5637

${CFLAGS=""}' after `AC_INIT' and before `AC_PROG_CC' to select an

5638

empty default instead.

5601

5639

5602

5640

Many Autoconf macros use a compiler, and thus call

5603

5641

`AC_REQUIRE([AC_PROG_CC])' to ensure that the compiler has been

5904

5942

If using the GNU C++ compiler, set shell variable `GXX' to `yes'.

5905

5943

If output variable `CXXFLAGS' was not already set, set it to `-g

5906

5944

-O2' for the GNU C++ compiler (`-O2' on systems where G++ does not

5907

accept `-g'), or `-g' for other compilers.

5945

accept `-g'), or `-g' for other compilers. If your package does

5946

not like this default, then it is acceptable to insert the line `:

5947

${CXXFLAGS=""}' after `AC_INIT' and before `AC_PROG_CXX' to select

5948

an empty default instead.

5949

5908

5950

5909

5951

-- Macro: AC_PROG_CXXCPP

5910

5952

Set output variable `CXXCPP' to a command that runs the C++

6042

6084

programs that can (or must) compile under the newer Fortran standards,

6043

6085

and have output variables like `FC', `FCFLAGS', and `FCLIBS'.

6044

6086

6045

Except for two new macros `AC_FC_SRCEXT' and `AC_FC_FREEFORM' (see

6046

below), the `FC' and `F77' macros behave almost identically, and so

6047

they are documented together in this section.

6087

Except for the macros `AC_FC_SRCEXT', `AC_FC_FREEFORM',

6088

`AC_FC_FIXEDFORM', and `AC_FC_LINE_LENGTH' (see below), the `FC' and

6089

`F77' macros behave almost identically, and so they are documented

6090

together in this section.

6048

6091

6049

6092

-- Macro: AC_PROG_F77 ([COMPILER-SEARCH-LIST])

6050

6093

Determine a Fortran 77 compiler to use. If `F77' is not already

6132

6175

6133

6176

The macros `AC_F77_DUMMY_MAIN' and `AC_FC_DUMMY_MAIN' or

6134

6177

`AC_F77_MAIN' and `AC_FC_MAIN' are probably also necessary to link

6135

C/C++ with Fortran; see below.

6178

C/C++ with Fortran; see below. Further, it is highly recommended

6179

that you use `AC_CONFIG_HEADERS' (*note Configuration Headers::)

6180

because the complex defines that the function wrapper macros create

6181

may not work with C/C++ compiler drivers.

6136

6182

6137

6183

-- Macro: AC_F77_DUMMY_MAIN ([ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])

6138

6184

-- Macro: AC_FC_DUMMY_MAIN ([ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])

6168

6214

# ifdef __cplusplus

6169

6215

extern "C"

6170

6216

# endif

6171

int F77_DUMMY_MAIN() { return 1; }

6217

int F77_DUMMY_MAIN () { return 1; }

6172

6218

#endif

6173

6219

6174

6220

(Replace `F77' with `FC' for Fortran instead of Fortran 77.)

6196

6242

#ifdef __cplusplus

6197

6243

extern "C"

6198

6244

#endif

6199

int F77_MAIN(int argc, char *argv[]);

6245

int F77_MAIN (int argc, char *argv[]);

6200

6246

6201

6247

(Again, replace `F77' with `FC' for Fortran instead of Fortran 77.)

6202

6248

6230

6276

#ifdef __cplusplus

6231

6277

extern "C" /* prevent C++ name mangling */

6232

6278

#endif

6233

void FOOBAR_F77(double *x, double *y);

6279

void FOOBAR_F77 (double *x, double *y);

6234

6280

6235

6281

Note that we pass both the lowercase and uppercase versions of the

6236

6282

function name to `F77_FUNC' so that it can select the right one.

6320

6366

extension, since many compilers interpret this extension as

6321

6367

indicating fixed-format source unless an additional flag is

6322

6368

supplied. If you specify a different extension with

6323

`AC_FC_SRCEXT', such as `.f90' or `.f95', then `AC_FC_FREEFORM'

6324

ordinarily succeeds without modifying `FCFLAGS'.

6369

`AC_FC_SRCEXT', such as `.f90', then `AC_FC_FREEFORM' ordinarily

6370

succeeds without modifying `FCFLAGS'. For extensions which the

6371

compiler does not know about, the flag set by the `AC_FC_SRCEXT'

6372

macro might let the compiler assume Fortran 77 by default, however.

6325

6373

6326

6374

If `AC_FC_FREEFORM' succeeds in compiling free-form source, it

6327

6375

calls ACTION-IF-SUCCESS (defaults to nothing). If it fails, it

6328

6376

calls ACTION-IF-FAILURE (defaults to exiting with an error

6329

6377

message).

6330

6378

6379

-- Macro: AC_FC_FIXEDFORM ([ACTION-IF-SUCCESS], [ACTION-IF-FAILURE])

6380

The `AC_FC_FIXEDFORM' tries to ensure that the Fortran compiler

6381

(`$FC') allows the old fixed-format source code (as opposed to

6382

free-format style). If necessary, it may add some additional

6383

flags to `FCFLAGS'.

6384

6385

This macro is needed for some compilers alias names like `xlf95'

6386

which assume free-form source code by default, and in case you

6387

want to use fixed-form source with an extension like `.f90' which

6388

many compilers interpret as free-form by default. If you specify

6389

a different extension with `AC_FC_SRCEXT', such as `.f', then

6390

`AC_FC_FIXEDFORM' ordinarily succeeds without modifying `FCFLAGS'.

6391

6392

If `AC_FC_FIXEDFORM' succeeds in compiling fixed-form source, it

6393

calls ACTION-IF-SUCCESS (defaults to nothing). If it fails, it

6394

calls ACTION-IF-FAILURE (defaults to exiting with an error

6395

message).

6396

6397

-- Macro: AC_FC_LINE_LENGTH ([LENGTH], [ACTION-IF-SUCCESS],

6398

[ACTION-IF-FAILURE])

6399

The `AC_FC_LINE_LENGTH' macro tries to ensure that the Fortran

6400

compiler (`$FC') accepts long source code lines. The LENGTH

6401

argument may be given as 80, 132, or unlimited, and defaults to

6402

132. Note that line lengths above 254 columns are not portable,

6403

and some compilers do not accept more than 132 columns at least

6404

for fixed format source. If necessary, it may add some additional

6405

flags to `FCFLAGS'.

6406

6407

If `AC_FC_LINE_LENGTH' succeeds in compiling fixed-form source, it

6408

calls ACTION-IF-SUCCESS (defaults to nothing). If it fails, it

6409

calls ACTION-IF-FAILURE (defaults to exiting with an error

6410

message).

6411

6331

6412

6332

6413

File: autoconf.info, Node: System Services, Next: Posix Variants, Prev: Compilers and Preprocessors, Up: Existing Tests

6333

6414

6541

6622

into which every built Erlang library should be installed in a

6542

6623

separate subdirectory. If this variable is not set in the

6543

6624

environment when `configure' runs, its default value is

6544

`$ERLANG_LIB_DIR', which value is set by the

6545

`AC_ERLANG_SUBST_LIB_DIR' macro.

6625

`${libdir}/erlang/lib'.

6546

6626

6547

6627

-- Macro: AC_ERLANG_SUBST_INSTALL_LIB_SUBDIR (LIBRARY, VERSION)

6548

6628

Set the `ERLANG_INSTALL_LIB_DIR_LIBRARY' output variable to the

6811

6891

-- Macro: AC_LANG_CONFTEST (SOURCE)

6812

6892

Save the SOURCE text in the current test source file:

6813

6893

`conftest.EXTENSION' where the EXTENSION depends on the current

6814

language.

6894

language. As of Autoconf 2.63b, the source file also contains the

6895

results of all of the `AC_DEFINE' performed so far.

6815

6896

6816

6897

Note that the SOURCE is evaluated exactly once, like regular

6817

6898

Autoconf macro arguments, and therefore (i) you may pass a macro

6823

6904

6824

6905

For instance executing (observe the double quotation!):

6825

6906

6826

AC_INIT([Hello], [1.0], [bug-hello@example.org])

6907

AC_INIT([Hello], [1.0], [bug-hello@example.org], [],

6908

[http://www.example.org/])

6827

6909

AC_DEFINE([HELLO_WORLD], ["Hello, World\n"],

6828

6910

[Greetings string.])

6829

AC_LANG(C)

6911

AC_LANG([C])

6830

6912

AC_LANG_CONFTEST(

6831

6913

[AC_LANG_SOURCE([[const char hw[] = "Hello, World\n";]])])

6832

gcc -E -dD -o - conftest.c

6914

gcc -E -dD conftest.c

6833

6915

6834

results in:

6916

on a system with `gcc' installed, results in:

6835

6917

6836

6918

...

6837

6919

# 1 "conftest.c"

6841

6923

#define PACKAGE_VERSION "1.0"

6842

6924

#define PACKAGE_STRING "Hello 1.0"

6843

6925

#define PACKAGE_BUGREPORT "bug-hello@example.org"

6926

#define PACKAGE_URL "http://www.example.org/"

6844

6927

#define HELLO_WORLD "Hello, World\n"

6845

6928

6846

6929

const char hw[] = "Hello, World\n";

6856

6939

6857

6940

For instance:

6858

6941

6859

AC_INIT([Hello], [1.0], [bug-hello@example.org])

6942

AC_INIT([Hello], [1.0], [bug-hello@example.org], [],

6943

[http://www.example.org/])

6860

6944

AC_DEFINE([HELLO_WORLD], ["Hello, World\n"],

6861

6945

[Greetings string.])

6862

6946

AC_LANG_CONFTEST(

6863

6947

[AC_LANG_PROGRAM([[const char hw[] = "Hello, World\n";]],

6864

6948

[[fputs (hw, stdout);]])])

6865

gcc -E -dD -o - conftest.c

6949

gcc -E -dD conftest.c

6866

6950

6867

results in:

6951

on a system with `gcc' installed, results in:

6868

6952

6869

6953

...

6870

6954

# 1 "conftest.c"

6874

6958

#define PACKAGE_VERSION "1.0"

6875

6959

#define PACKAGE_STRING "Hello 1.0"

6876

6960

#define PACKAGE_BUGREPORT "bug-hello@example.org"

6961

#define PACKAGE_URL "http://www.example.org/"

6877

6962

#define HELLO_WORLD "Hello, World\n"

6878

6963

6879

6964

const char hw[] = "Hello, World\n";

6964

7049

etc. are not valid options to many C preprocessors.

6965

7050

6966

7051

It is customary to report unexpected failures with

6967

`AC_MSG_FAILURE'.

7052

`AC_MSG_FAILURE'. If needed, ACTION-IF-TRUE can further access

7053

the preprocessed output in the file `conftest.i'.

6968

7054

6969

7055

For instance:

6970

7056

7035

7121

It is customary to report unexpected failures with

7036

7122

`AC_MSG_FAILURE'. This macro does not try to link; use

7037

7123

`AC_LINK_IFELSE' if you need to do that (*note Running the

7038

Linker::).

7124

Linker::). If needed, ACTION-IF-TRUE can further access the

7125

just-compiled object file `conftest.$OBJEXT'.

7039

7126

7040

7127

This macro uses `AC_REQUIRE' for the compiler associated with the

7041

7128

current language, which means that if the compiler has not yet been

7076

7163

Run the compiler (and compilation flags) and the linker of the

7077

7164

current language (*note Language Choice::) on the INPUT, run the

7078

7165

shell commands ACTION-IF-TRUE on success, ACTION-IF-FALSE

7079

otherwise. The INPUT can be made by `AC_LANG_PROGRAM' and friends.

7166

otherwise. The INPUT can be made by `AC_LANG_PROGRAM' and

7167

friends. If needed, ACTION-IF-TRUE can further access the

7168

just-linked program file `conftest$EXEEXT'.

7080

7169

7081

7170

`LDFLAGS' and `LIBS' are used for linking, in addition to the

7082

7171

current compilation flags.

7701

7790

A cache file is a shell script that caches the results of configure

7702

7791

tests run on one system so they can be shared between configure scripts

7703

7792

and configure runs. It is not useful on other systems. If its contents

7704

are invalid for some reason, the user may delete or edit it.

7793

are invalid for some reason, the user may delete or edit it, or override

7794

documented cache variables on the `configure' command line.

7705

7795

7706

7796

By default, `configure' uses no cache file, to avoid problems caused

7707

7797

by accidental use of stale cache files.

7905

7995

To fully understand where proper quotation is important, you first need

7906

7996

to know what the special characters are in Autoconf: `#' introduces a

7907

7997

comment inside which no macro expansion is performed, `,' separates

7908

arguments, `[' and `]' are the quotes themselves, `(' and `)' (which M4

7909

tries to match by pairs), and finally `$' inside a macro definition.

7998

arguments, `[' and `]' are the quotes themselves(1), `(' and `)' (which

7999

M4 tries to match by pairs), and finally `$' inside a macro definition.

7910

8000

7911

8001

In order to understand the delicate case of macro calls, we first

7912

8002

have to present some obvious failures. Below they are "obvious-ified",

7936

8026

[array]

7937

8027

=>array

7938

8028

7939

How can you correctly output the intended results(1)?

8029

How can you correctly output the intended results(2)?

7940

8030

7941

8031

---------- Footnotes ----------

7942

8032

7943

(1) Using `defn'.

8033

(1) By itself, M4 uses ``' and `''; it is the M4sugar layer that

8034

sets up the preferred quotes of `[' and `]'.

8035

8036

(2) Using `defn'.

7944

8037

7945

8038

7946

8039

File: autoconf.info, Node: One Macro Call, Next: Quoting and Parameters, Prev: Active Characters, Up: M4 Quotation

8973

9066

primitive, `m4_divert' behaves like:

8974

9067

m4_divert_pop()m4_divert_push([DIVERSION])

8975

9068

*Note Diversion support::, for more details about the use of the

8976

diversion stack.

9069

diversion stack. In particular, this implies that DIVERSION

9070

should be a named diversion rather than a raw number. But be

9071

aware that it is seldom necessary to explicitly change the

9072

diversion stack, and that when done incorrectly, it can lead to

9073

syntactically invalid scripts.

8977

9074

8978

9075

-- Macro: m4_dumpdef (NAME...)

8979

9076

-- Macro: m4_dumpdefs (NAME...)

9044

9141

Also, since the M4sugar diversion stack prefers named diversions,

9045

9142

the use of `m4_undivert' to include files is risky. *Note

9046

9143

Diversion support::, for more details about the use of the

9047

diversion stack.

9144

diversion stack. But be aware that it is seldom necessary to

9145

explicitly change the diversion stack, and that when done

9146

incorrectly, it can lead to syntactically invalid scripts.

9048

9147

9049

9148

-- Macro: m4_wrap (TEXT)

9050

9149

-- Macro: m4_wrap_lifo (TEXT)

9115

9214

8.3.3 Diversion support

9116

9215

-----------------------

9117

9216

9118

M4sugar makes heavy use of diversions, because it is often the case that

9119

text that must appear early in the output is not discovered until late

9120

in the input. Additionally, some of the topological sorting algorithms

9121

used in resolving macro dependencies use diversions. However, most

9122

macros should not need to change diversions directly, but rather rely on

9123

higher-level M4sugar macros to manage diversions transparently.

9217

M4sugar makes heavy use of diversions under the hood, because it is

9218

often the case that text that must appear early in the output is not

9219

discovered until late in the input. Additionally, some of the

9220

topological sorting algorithms used in resolving macro dependencies use

9221

diversions. However, most macros should not need to change diversions

9222

directly, but rather rely on higher-level M4sugar macros to manage

9223

diversions transparently. If you change diversions improperly, you

9224

risk generating a syntactically invalid script, because an incorrect

9225

diversion will violate assumptions made by many macros about whether

9226

prerequisite text has been previously output. In short, if you

9227

manually change the diversion, you should not expect any macros

9228

provided by the Autoconf package to work until you have restored the

9229

diversion stack back to its original state.

9124

9230

9125

9231

In the rare case that it is necessary to write a macro that

9126

9232

explicitly outputs text to a different diversion, it is important to be

9148

9254

9149

9255

To make diversion management easier, M4sugar uses the concept of

9150

9256

named diversions. Rather than using diversion numbers directly, it is

9151

nicer to associate a name with each diversion; the diversion number

9257

nicer to associate a name with each diversion. The diversion number

9152

9258

associated with a particular diversion name is an implementation

9153

detail, so you should only use diversion names. In general, you should

9154

not output text to a named diversion until after calling the

9155

appropriate initialization routine for your language (`m4_init',

9156

`AS_INIT', `AT_INIT', ...), although there are some exceptions

9157

documented below.

9259

detail, and a syntax warning is issued if a diversion number is used

9260

instead of a name. In general, you should not output text to a named

9261

diversion until after calling the appropriate initialization routine

9262

for your language (`m4_init', `AS_INIT', `AT_INIT', ...), although

9263

there are some exceptions documented below.

9158

9264

9159

9265

M4sugar defines two named diversions.

9160

9266

`KILL'

9200

9306

can be used to set up state that is required across all tests.

9201

9307

This diversion will work even before `AT_INIT'.

9202

9308

9203

For now, the named diversions of Autoconf and Autoheader, and the

9204

remaining diversions of Autotest, are not documented. In other words,

9205

intentionally outputting text into an undocumented diversion is subject

9206

to breakage in a future release of Autoconf.

9309

Autoconf inherits diversions from M4sh, and adds the following named

9310

diversions which developers can utilize.

9311

`DEFAULTS'

9312

This diversion contains shell variable assignments to set defaults

9313

that must be in place before arguments are parsed. This diversion

9314

is placed early enough in `configure' that it is unsafe to expand

9315

any autoconf macros into this diversion.

9316

9317

`HELP_ENABLE'

9318

If `AC_PRESERVE_HELP_ORDER' was used, then text placed in this

9319

diversion will be included as part of a quoted here-doc providing

9320

all of the `--help' output of `configure' related to options

9321

created by `AC_ARG_WITH' and `AC_ARG_ENABLE'.

9322

9323

`INIT_PREPARE'

9324

This diversion occurs after all command line options have been

9325

parsed, but prior to the main body of the `configure' script. This

9326

diversion is the last chance to insert shell code such as variable

9327

assignments or shell function declarations that will used by the

9328

expansion of other macros.

9329

9330

For now, the remaining named diversions of Autoconf, Autoheader, and

9331

Autotest are not documented. In other words, intentionally outputting

9332

text into an undocumented diversion is subject to breakage in a future

9333

release of Autoconf.

9207

9334

9208

9335

-- Macro: m4_cleardivert (DIVERSION...)

9209

9336

Permanently discard any text that has been diverted into DIVERSION.

9231

9358

m4_divert_push([DIVERSION])CONTENT

9232

9359

m4_divert_pop([DIVERSION])dnl

9233

9360

9361

One use of `m4_divert_text' is to develop two related macros, where

9362

macro `MY_A' does the work, but adjusts what work is performed

9363

based on whether the optional macro `MY_B' has also been expanded.

9364

Of course, it is possible to use `AC_BEFORE' within `MY_A' to

9365

require that `MY_B' occurs first, if it occurs at all. But this

9366

imposes an ordering restriction on the user; it would be nicer if

9367

macros `MY_A' and `MY_B' can be invoked in either order. The trick

9368

is to let `MY_B' leave a breadcrumb in an early diversion, which

9369

`MY_A' can then use to determine whether `MY_B' has been expanded.

9370

9371

AC_DEFUN([MY_A],

9372

[# various actions

9373

if test -n "$b_was_used"; then

9374

# extra action

9375

fi])

9376

AC_DEFUN([MY_B],

9377

[AC_REQUIRE([MY_A])dnl

9378

m4_divert_text([INIT_PREPARE], [b_was_used=true])])

9379

9380

9234

9381

-- Macro: m4_init

9235

9382

Initialize the M4sugar environment, setting up the default named

9236

9383

diversion to be `KILL'.

9363

9510

exist, in order to make it easier to select the correct logical

9364

9511

sense when using only two parameters. Note that this is more

9365

9512

efficient than the equivalent behavior of:

9366

m4_ifval(m4_normalize([COND]), IF-TEXT, IF-COND)

9513

m4_ifval(m4_normalize([COND]), IF-TEXT, IF-BLANK)

9367

9514

9368

9515

-- Macro: m4_ifndef (MACRO, IF-NOT-DEFINED, [IF-DEFINED])

9369

9516

This is shorthand for:

9999

10146

Backslash-escape all characters in STRING that are active in

10000

10147

regexps.

10001

10148

10002

-- Macro: m4_split (STRING, [REGEXP = `[t ]+'])

10149

-- Macro: m4_split (STRING, [REGEXP = `[\t ]+'])

10003

10150

Split STRING into an M4 list of elements quoted by `[' and `]',

10004

10151

while keeping white space at the beginning and at the end. If

10005

10152

REGEXP is given, use it instead of `[\t ]+' for splitting. If

10016

10163

10017

10164

-- Macro: m4_text_box (MESSAGE, [FRAME = `-'])

10018

10165

Add a text box around MESSAGE, using FRAME as the border character

10019

above and below the message. The frame correctly accounts for the

10020

subsequent expansion of MESSAGE. For example:

10166

above and below the message. The FRAME argument must be a single

10167

byte, and does not support quadrigraphs. The frame correctly

10168

accounts for the subsequent expansion of MESSAGE. For example:

10021

10169

m4_define([macro], [abc])dnl

10022

10170

m4_text_box([macro])

10023

10171

=>## --- ##

10489

10637

M4sh provides portable alternatives for some common shell constructs

10490

10638

that unfortunately are not portable in practice.

10491

10639

10640

-- Macro: AS_BOX (TEXT, [CHAR = `-'])

10641

Expand into shell code that will output TEXT surrounded by a box

10642

with CHAR in the top and bottom border. TEXT should not contain a

10643

newline, but may contain shell expansions valid for unquoted

10644

here-documents. CHAR defaults to `-', but can be any character

10645

except `/', `'', `"', `\', `&', or ``'. This is useful for

10646

outputting a comment box into log files to separate distinct

10647

phases of script operation.

10648

10492

10649

-- Macro: AS_CASE (WORD, [PATTERN1], [IF-MATCHED1], ..., [DEFAULT])

10493

10650

Expand into a shell `case' statement, where WORD is matched

10494

10651

against one or more patterns. IF-MATCHED is run if the

10520

10677

contains "\". Redirections can be placed outside the macro

10521

10678

invocation.

10522

10679

10523

-- Macro: AS_ESCAPE (STRING, [CHARS = ``"$'])

10680

-- Macro: AS_ESCAPE (STRING, [CHARS = ``\"$'])

10524

10681

Expands to STRING, with any characters in CHARS escaped with a

10525

10682

backslash (`\'). CHARS should be at most four bytes long, and

10526

10683

only contain characters from the set ``\"$'; however, characters

10610

10767

echo "[#]define AS_TR_CPP([HAVE_$type]) 1"

10611

10768

10612

10769

-- Macro: AS_TR_SH (EXPRESSION)

10613

Transform EXPRESSION into a valid shell variable name. For

10614

example:

10770

Transform EXPRESSION into shell code that generates a valid shell

10771

variable name. The result is literal when possible at m4 time,

10772

but must be used with `eval' if EXPRESSION causes shell

10773

indirections. For example:

10615

10774

10616

10775

# This outputs "Have it!".

10617

10776

header="sys/some file.h"

10618

AS_TR_SH([HAVE_$header])=yes

10777

eval AS_TR_SH([HAVE_$header])=yes

10619

10778

if test "x$HAVE_sys_some_file_h" = xyes; then echo "Have it!"; fi

10620

10779

10621

10780

-- Macro: AS_SET_CATFILE (VAR, DIR, FILE)

10622

Set the shell variable VAR to DIR/FILE, but optimizing the common

10623

cases (DIR or FILE is `.', FILE is absolute, etc.).

10781

Set the polymorphic shell variable VAR to DIR/FILE, but optimizing

10782

the common cases (DIR or FILE is `.', FILE is absolute, etc.).

10624

10783

10625

10784

-- Macro: AS_UNSET (VAR)

10626

10785

Unsets the shell variable VAR, working around bugs in older shells

10653

10812

undefined if expansion of an indirect variable does not result in a

10654

10813

literal variable name.

10655

10814

10656

-- Macro: AS_LITERAL_IF (EXPRESSION, [IF-LITERAL], [IF-NOT])

10815

-- Macro: AS_LITERAL_IF (EXPRESSION, [IF-LITERAL], [IF-NOT],

10816

[IF-SIMPLE-REF = `IF-NOT'])

10817

-- Macro: AS_LITERAL_WORD_IF (EXPRESSION, [IF-LITERAL], [IF-NOT],

10818

[IF-SIMPLE-REF = `IF-NOT'])

10657

10819

If the expansion of EXPRESSION is definitely a shell literal,

10658

10820

expand IF-LITERAL. If the expansion of EXPRESSION looks like it

10659

10821

might contain shell indirections (such as `$var' or ``expr`'),

10660

then IF-NOT is expanded. In order to reduce the time spent

10661

deciding whether an expression is literal, the implementation is

10662

somewhat conservative (for example, `'[$]'' is a single-quoted

10663

shell literal, but causes IF-NOT to be expanded). While this

10664

macro is often used for recognizing shell variable names, it can

10665

also be used in other contexts.

10822

then IF-NOT is expanded. Sometimes, it is possible to output

10823

optimized code if EXPRESSION consists only of shell variable

10824

expansions (such as `${var}'), in which case IF-SIMPLE-REF can be

10825

provided; but defaulting to IF-NOT should always be safe.

10826

`AS_LITERAL_WORD_IF' only expands IF-LITERAL if EXPRESSION looks

10827

like a single shell word, containing no whitespace; while

10828

`AS_LITERAL_IF' allows whitespace in EXPRESSION.

10829

10830

In order to reduce the time spent recognizing whether an

10831

EXPRESSION qualifies as a literal or a simple indirection, the

10832

implementation is somewhat conservative: EXPRESSION must be a

10833

single shell word (possibly after stripping whitespace),

10834

consisting only of bytes that would have the same meaning whether

10835

unquoted or enclosed in double quotes (for example, `a.b' results

10836

in IF-LITERAL, even though it is not a valid shell variable name;

10837

while both `'a'' and `[$]' result in IF-NOT, because they behave

10838

differently than `"'a'"' and `"[$]"'). This macro can be used in

10839

contexts for recognizing portable file names (such as in the

10840

implementation of `AC_LIBSOURCE'), or coupled with some

10841

transliterations for forming valid variable names (such as in the

10842

implementation of `AS_TR_SH', which uses an additional

10843

`m4_translit' to convert `.' to `_').

10844

10845

This example shows how to read the contents of the shell variable

10846

`bar', exercising all three arguments to `AS_LITERAL_IF'. It

10847

results in a script that will output the line `hello' three times.

10666

10848

10667

10849

AC_DEFUN([MY_ACTION],

10668

10850

[AS_LITERAL_IF([$1],

10669

[echo "$1"],

10670

[AS_VAR_COPY([tmp], [$1])

10671

echo "$tmp"])])

10851

[echo "$$1"],

10852

[AS_VAR_COPY([tmp], [$1])

10853

echo "$tmp"],

10854

[eval 'echo "$'"$1"\"])])

10855

foo=bar bar=hello

10856

MY_ACTION([bar])

10857

MY_ACTION([`echo bar`])

10858

MY_ACTION([$foo])

10672

10859

10673

10860

-- Macro: AS_VAR_APPEND (VAR, TEXT)

10674

10861

Emit shell code to append the shell expansion of TEXT to the end

10754

10941

10755

10942

m4_define([MY_CHECK_HEADER],

10756

10943

[AS_VAR_PUSHDEF([my_Header], [ac_cv_header_$1])dnl

10757

AS_VAR_IF([my_Header], [yes], [echo "header $1 available"])dnl

10944

AS_VAR_IF([my_Header], [yes], [echo "header $1 detected"])dnl

10758

10945

AS_VAR_POPDEF([my_Header])dnl

10759

10946

])

10760

10947

MY_CHECK_HEADER([stdint.h])

11463

11650

11464

11651

The Autoconf macros follow a strict coding style. You are encouraged to

11465

11652

follow this style, especially if you intend to distribute your macro,

11466

either by contributing it to Autoconf itself or the Autoconf archive

11467

(http://www.nongnu.org/autoconf-archive), or by other means.

11653

either by contributing it to Autoconf itself or the Autoconf Macro

11654

Archive (http://www.gnu.org/software/autoconf-archive/), or by other

11655

means.

11468

11656

11469

11657

The first requirement is to pay great attention to the quotation.

11470

11658

For more details, see *note Autoconf Language::, and *note M4

11812

12000

compatibility by running `set -o posix'. Unfortunately, with

11813

12001

`pdksh' 5.2.14 (the latest stable version as of January 2007)

11814

12002

Posix mode is buggy and causes `pdksh' to depart from Posix in at

11815

least one respect:

11816

11817

$ echo "`echo \"hello\"`"

11818

hello

11819

$ set -o posix

11820

$ echo "`echo \"hello\"`"

11821

"hello"

11822

11823

The last line of output contains spurious quotes. This is yet

11824

another reason why portable shell code should not contain

11825

`"`...\"...\"...`"' constructs (*note Shell Substitutions::).

12003

least one respect, see *note Shell Substitutions::.

11826

12004

11827

12005

Zsh

11828

12006

To detect whether you are running `zsh', test whether

11903

12081

was expanded before in a conditional path, and the condition turned out

11904

12082

to be false at runtime, and we end up not executing the macro at all.

11905

12083

12084

Be careful with the use of `<<-' to unindent here-documents. The

12085

behavior is only portable for stripping leading <TAB>s, and things can

12086

silently break if an overzealous editor converts to using leading

12087

spaces (not all shells are nice enough to warn about unterminated

12088

here-documents).

12089

12090

$ printf 'cat <<-x\n\t1\n\t 2\n\tx\n' | bash && echo done

12091

1

12092

2

12093

done

12094

$ printf 'cat <<-x\n 1\n 2\n x\n' | bash-3.2 && echo done

12095

1

12096

2

12097

x

12098

done

12099

11906

12100

11907

12101

File: autoconf.info, Node: File Descriptors, Next: File System Conventions, Prev: Here-Documents, Up: Portable Shell

11908

12102

11947

12141

/zorglub` 2>/dev/null' expect the error message to escape, while `: `cd

11948

12142

/zorglub 2>/dev/null`' works properly.

11949

12143

12144

On the other hand, some shells, such as Solaris or FreeBSD

12145

`/bin/sh', warn about missing programs before performing redirections.

12146

Therefore, to silently check whether a program exists, it is necessary

12147

to perform redirections on a subshell:

12148

12149

$ /bin/sh -c 'nosuch 2>/dev/null'

12150

nosuch: not found

12151

$ /bin/sh -c '(nosuch) 2>/dev/null'

12152

$ bash -c 'nosuch 2>/dev/null'

12153

12154

FreeBSD 6.2 sh may mix the trace output lines from the statements in

12155

a shell pipeline.

12156

11950

12157

It is worth noting that Zsh (but not Ash nor Bash) makes it possible

11951

12158

in assignments though: `foo=`cd /zorglub` 2>/dev/null'.

11952

12159

12018

12225

Within the process which runs the `descrips' script, file descriptor 5

12019

12226

is closed.

12020

12227

12021

Don't rely on redirection to a closed file descriptor to cause an

12228

Don't rely on duplicating a closed file descriptor to cause an

12022

12229

error. With Solaris `/bin/sh', when the redirection fails, the output

12023

12230

goes to the original file descriptor.

12024

12231

12029

12236

hi

12030

12237

0

12031

12238

12239

Fortunately, an attempt to close an already closed file descriptor

12240

will portably succeed. Likewise, it is safe to use either style of

12241

`N<&-' or `N>&-' for closing a file descriptor, even if it doesn't

12242

match the read/write mode that the file descriptor was opened with.

12243

12032

12244

DOS variants cannot rename or remove open files, such as in `mv foo

12033

12245

bar >foo' or `rm foo >foo', even though this is perfectly portable

12034

12246

among Posix hosts.

12219

12431

12220

12432

and in fact it is even _more_ portable: in the first case of the first

12221

12433

attempt, the computation of `top_srcdir' is not portable, since not all

12222

shells properly understand `"`..."..."...`"'. Worse yet, not all

12223

shells understand `"`...\"...\"...`"' the same way. There is just no

12224

portable way to use double-quoted strings inside double-quoted

12225

back-quoted expressions (pfew!).

12434

shells properly understand `"`..."..."...`"', for example Solaris 10

12435

ksh:

12436

12437

$ foo="`echo " bar" | sed 's, ,,'`"

12438

ksh: : cannot execute

12439

ksh: bar | sed 's, ,,': cannot execute

12440

12441

Posix does not specify behavior for this sequence. On the other hand,

12442

behavior for `"`...\"...\"...`"' is specified by Posix, but in

12443

practice, not all shells understand it the same way: pdksh 5.2.14

12444

prints spurious quotes when in Posix mode:

12445

12446

$ echo "`echo \"hello\"`"

12447

hello

12448

$ set -o posix

12449

$ echo "`echo \"hello\"`"

12450

"hello"

12451

12452

There is just no portable way to use double-quoted strings inside

12453

double-quoted back-quoted expressions (pfew!).

12226

12454

12227

12455

`$@'

12228

12456

One of the most famous shell-portability issues is related to

12747

12975

note that traditional shells, but also bash-2.04, fail to adhere

12748

12976

to this and join with a space anyway.

12749

12977

12978

M4sh guarantees that `IFS' will have the default value at the

12979

beginning of a script, and many macros within autoconf rely on this

12980

setting. It is okay to use blocks of shell code that temporarily

12981

change the value of `IFS' in order to split on another character,

12982

but remember to restore it before expanding further macros.

12983

12984

Unsetting `IFS' instead of resetting it to the default sequence is

12985

not suggested, since code that tries to save and restore the

12986

variable's value will incorrectly reset it to an empty value, thus

12987

disabling field splitting:

12988

12989

unset IFS

12990

# default separators used for field splitting

12991

12992

save_IFS=$IFS

12993

IFS=:

12994

# ...

12995

IFS=$save_IFS

12996

# no field splitting performed

12997

12750

12998

`LANG'

12751

12999

`LC_ALL'

12752

13000

`LC_COLLATE'

13454

13702

performs word splitting on `${1+"$@"}'; see *note Shell

13455

13703

Substitutions::, item `$@', for more.

13456

13704

13705

In Solaris `/bin/sh', when the list of arguments of a `for' loop

13706

starts with _unquoted_ tokens looking like variable assignments,

13707

the loop is not executed on those tokens:

13708

13709

$ /bin/sh -c 'for v in a=b c=d x e=f; do echo $v; done'

13710

x

13711

e=f

13712

13713

Thankfully, quoting the assignment-like tokens, or starting the

13714

list with other tokens (including unquoted variable expansion that

13715

results in an assignment-like result), avoids the problem, so it

13716

is easy to work around:

13717

13718

$ /bin/sh -c 'for v in "a=b"; do echo $v; done'

13719

a=b

13720

$ /bin/sh -c 'x=a=b; for v in $x c=d; do echo $v; done'

13721

a=b

13722

c=d

13723

13457

13724

`if'

13458

13725

Using `!' is not portable. Instead of:

13459

13726

13614

13881

Rules::).

13615

13882

13616

13883

Even relatively-recent versions of the BSD shell (e.g., OpenBSD

13617

3.4) wrongly exit with `-e' if a command within `&&' fails inside

13618

a compound statement. For example:

13884

3.4) wrongly exit with `-e' if the last command within a compound

13885

statement fails and is guarded by an `&&' only. For example:

13619

13886

13620

13887

#! /bin/sh

13621

13888

set -e

13624

13891

echo one

13625

13892

if :; then

13626

13893

test -n "$foo" && exit 1

13894

echo two

13895

test -n "$foo" && exit 1

13627

13896

fi

13628

echo two

13897

echo three

13629

13898

13630

does not print `two'. One workaround is to use `if test -n

13631

"$foo"; then exit 1; fi' rather than `test -n "$foo" && exit 1'.

13632

Another possibility is to warn BSD users not to use `sh -e'.

13899

does not print `three'. One workaround is to change the last

13900

instance of `test -n "$foo" && exit 1' to be `if test -n "$foo";

13901

then exit 1; fi' instead. Another possibility is to warn BSD

13902

users not to use `sh -e'.

13633

13903

13634

13904

When `set -e' is in effect, a failed command substitution in

13635

13905

Solaris `/bin/sh' cannot be ignored, even with `||'.

13636

13906

13637

$ /bin/sh -c 'set -d; foo=`false` || echo foo; echo bar'

13638

$ bash -c 'set -d; foo=`false` || echo foo; echo bar'

13907

$ /bin/sh -c 'set -e; foo=`false` || echo foo; echo bar'

13908

$ bash -c 'set -e; foo=`false` || echo foo; echo bar'

13639

13909

foo

13640

13910

bar

13641

13911

13912

Moreover, a command substitution, successful or not, causes this

13913

shell to exit from a failing outer command even in presence of an

13914

`&&' list:

13915

13916

$ bash -c 'set -e; false `true` && echo notreached; echo ok'

13917

ok

13918

$ sh -c 'set -e; false `true` && echo notreached; echo ok'

13919

$

13920

13642

13921

Portable scripts should not use `set -e' if `trap' is used to

13643

13922

install an exit handler. This is because Tru64/OSF 5.1 `sh'

13644

13923

sometimes enters the trap handler with the exit status of the

14327

14606

work around these problems, invoke `AC_PROG_FGREP' and then use

14328

14607

`$FGREP'.

14329

14608

14609

Tru64/OSF 5.1 `fgrep' does not match an empty pattern.

14610

14330

14611

`find'

14331

14612

The option `-maxdepth' seems to be GNU specific. Tru64 v5.1,

14332

14613

NetBSD 1.5 and Solaris `find' commands do not understand it.

14359

14640

`/dev/null'. Check the exit status of `grep' to determine whether

14360

14641

it found a match.

14361

14642

14643

The QNX4 implementation fails to count lines with `grep -c '$'',

14644

but works with `grep -c '^''. Other alternatives for counting

14645

lines are to use `sed -n '$='' or `wc -l'.

14646

14362

14647

Some traditional `grep' implementations do not work on long input

14363

14648

lines. On AIX the default `grep' silently truncates long lines on

14364

14649

the input before matching.

14665

14950

or `#', so you should use semicolon only with simple scripts that

14666

14951

do not use these verbs.

14667

14952

14668

Commands inside { } brackets are further restricted. Posix says

14669

that they cannot be preceded by addresses, `!', or `;', and that

14670

each command must be followed immediately by a newline, without any

14671

intervening blanks or semicolons. The closing bracket must be

14672

alone on a line, other than white space preceding or following it.

14953

Posix up to the 2008 revision requires the argument of the `-e'

14954

option to be a syntactically complete script. GNU `sed' allows to

14955

pass multiple script fragments, each as argument of a separate

14956

`-e' option, that are then combined, with newlines between the

14957

fragments, and a future Posix revision may allow this as well.

14958

This approach is not portable with script fragments ending in

14959

backslash; for example, the `sed' programs on Solaris 10, HP-UX

14960

11, and AIX don't allow splitting in this case:

14961

14962

$ echo a | sed -n -e 'i\

14963

0'

14964

0

14965

$ echo a | sed -n -e 'i\' -e 0

14966

Unrecognized command: 0

14967

14968

In practice, however, this technique of joining fragments through

14969

`-e' works for multiple `sed' functions within `{' and `}', even

14970

if that is not specified by Posix:

14971

14972

$ echo a | sed -n -e '/a/{' -e s/a/b/ -e p -e '}'

14973

b

14974

14975

Commands inside { } brackets are further restricted. Posix 2008

14976

says that they cannot be preceded by addresses, `!', or `;', and

14977

that each command must be followed immediately by a newline,

14978

without any intervening blanks or semicolons. The closing bracket

14979

must be alone on a line, other than white space preceding or

14980

following it. However, a future version of Posix may standardize

14981

the use of addresses within brackets.

14673

14982

14674

14983

Contrary to yet another urban legend, you may portably use `&' in

14675

14984

the replacement part of the `s' command to mean "what was

14822

15131

`tr'

14823

15132

Not all versions of `tr' handle all backslash character escapes.

14824

15133

For example, Solaris 10 `/usr/ucb/tr' falls over, even though

14825

Solaris contains more modern `tr' in other locations. Therefore,

14826

it is more portable to use octal escapes, even though this ties

14827

the result to ASCII, when using `tr' to delete newlines or

14828

carriage returns.

15134

Solaris contains more modern `tr' in other locations. Using octal

15135

escapes is more portable for carriage returns, since `\015' is the

15136

same for both ASCII and EBCDIC, and since use of literal carriage

15137

returns in scripts causes a number of other problems. But for

15138

other characters, like newline, using octal escapes ties the

15139

operation to ASCII, so it is better to use literal characters.

14829

15140

14830

15141

$ { echo moon; echo light; } | /usr/ucb/tr -d '\n' ; echo

14831

15142

moo

14834

15145

moonlight

14835

15146

$ { echo moon; echo light; } | /usr/ucb/tr -d '\012' ; echo

14836

15147

moonlight

15148

$ nl='

15149

'; { echo moon; echo light; } | /usr/ucb/tr -d "$nl" ; echo

15150

moonlight

14837

15151

14838

15152

Not all versions of `tr' recognize ranges of characters: at least

14839

15153

Solaris `/usr/bin/tr' still fails to do so. But you can use

14844

15158

$ echo "Hazy Fantazy" | LC_ALL=C /usr/xpg4/bin/tr a-z A-Z

14845

15159

HAZY FANTAZY

14846

15160

15161

When providing two arguments, be sure the second string is at

15162

least as long as the first.

15163

15164

$ echo abc | /usr/xpg4/bin/tr bc d

15165

adc

15166

$ echo abc | coreutils/tr bc d

15167

add

15168

14847

15169

Posix requires `tr' to operate on binary files. But at least

14848

Solaris `/usr/ucb/tr' and `/usr/bin/tr' still fail to handle `\0'

14849

as the octal escape for `NUL'; these programs always discard all

14850

`NUL' bytes from the input. On Solaris, when using `tr' to

15170

Solaris `/usr/ucb/tr' and `/usr/bin/tr' silently discard `NUL' in

15171

the input prior to doing any translation. When using `tr' to

14851

15172

process a binary file that may contain `NUL' bytes, it is

14852

15173

necessary to use `/usr/xpg4/bin/tr' instead, or `/usr/xpg6/bin/tr'

14853

15174

if that is available.

14854

15175

14855

$ printf 'a\0b\n' | /usr/ucb/tr '\0' '~' | wc -c

14856

3

14857

$ printf 'a\0b\n' | /usr/xpg4/bin/tr '\0' '~' | wc -c

14858

4

14859

$ printf 'a\0b\n' | /usr/ucb/tr x x | wc -c

14860

3

14861

$ printf 'a\0b\n' | /usr/xpg4/bin/tr x x | wc -c

14862

4

15176

$ printf 'a\0b' | /usr/ucb/tr x x | od -An -tx1

15177

61 62

15178

$ printf 'a\0b' | /usr/bin/tr x x | od -An -tx1

15179

61 62

15180

$ printf 'a\0b' | /usr/xpg4/bin/tr x x | od -An -tx1

15181

61 00 62

15182

15183

Solaris `/usr/ucb/tr' additionally fails to handle `\0' as the

15184

octal escape for `NUL'.

15185

15186

$ printf 'abc' | /usr/ucb/tr 'bc' '\0d' | od -An -tx1

15187

61 62 63

15188

$ printf 'abc' | /usr/bin/tr 'bc' '\0d' | od -An -tx1

15189

61 00 64

15190

$ printf 'abc' | /usr/xpg4/bin/tr 'bc' '\0d' | od -An -tx1

15191

61 00 64

14863

15192

14864

15193

14865

15194

14885

15214

* The Make Macro SHELL:: `$(SHELL)' portability issues

14886

15215

* Parallel Make:: Parallel `make' quirks

14887

15216

* Comments in Make Rules:: Other problems with Make comments

15217

* Newlines in Make Rules:: Using literal newlines in rules

14888

15218

* obj/ and Make:: Don't name a subdirectory `obj'

14889

15219

* make -k Status:: Exit status of `make -k'

14890

15220

* VPATH and Make:: `VPATH' woes

15066

15396

environment contains some other macros usually defined by the makefile.

15067

15397

(See also the note about `make -e' and `SHELL' below.)

15068

15398

15069

Another way to propagate overrides to submakes is to do it manually,

15070

from your makefile:

15399

If you can foresee all macros that a user might want to override,

15400

then you can propagate them to submakes manually, from your makefile:

15071

15401

15072

15402

foo = foo

15073

15403

one:

15076

15406

two:

15077

15407

@echo $(foo)

15078

15408

15079

You need to foresee all macros that a user might want to override if

15080

you do that.

15081

15082

Makefiles generated by `automake' expand `$(AM_MAKEFLAGS)' on the

15083

command line of submakes, which can be used for propagated overrides

15409

Another way to propagate a variable to submakes in a portable way is

15410

to expand an extra variable in every invocation of `$(MAKE)' within

15411

your makefile:

15412

15413

foo = foo

15414

one:

15415

@echo $(foo)

15416

$(MAKE) $(SUBMAKEFLAGS) two

15417

two:

15418

@echo $(foo)

15419

15420

Users must be aware that this technique is in use to take advantage

15421

of it, e.g. with `make foo=bar SUBMAKEFLAGS='foo=bar'', but it allows

15422

any macro to be overridden. Makefiles generated by `automake' use this

15423

technique, expanding `$(AM_MAKEFLAGS)' on the command lines of submakes

15084

15424

(*note Automake: (automake)Subdirectories.).

15085

15425

15086

15426

15231

15571

all if the command is deemed safe to be executed directly.

15232

15572

15233

15573

15234

File: autoconf.info, Node: Comments in Make Rules, Next: obj/ and Make, Prev: Parallel Make, Up: Portable Make

15574

File: autoconf.info, Node: Comments in Make Rules, Next: Newlines in Make Rules, Prev: Parallel Make, Up: Portable Make

15235

15575

15236

15576

12.11 Comments in Make Rules

15237

15577

============================

15246

15586

all:

15247

15587

# foo

15248

15588

15249

15250

File: autoconf.info, Node: obj/ and Make, Next: make -k Status, Prev: Comments in Make Rules, Up: Portable Make

15251

15252

12.12 The `obj/' Subdirectory and Make

15589

As a workaround, you can use the `:' no-op command with a string

15590

argument that gets ignored:

15591

15592

all:

15593

: "foo"

15594

15595

15596

File: autoconf.info, Node: Newlines in Make Rules, Next: obj/ and Make, Prev: Comments in Make Rules, Up: Portable Make

15597

15598

12.12 Newlines in Make Rules

15599

============================

15600

15601

In shell scripts, newlines can be used inside string literals. But in

15602

the shell statements of `Makefile' rules, this is not possible: A

15603

newline not preceded by a backslash is a separator between shell

15604

statements. Whereas a newline that is preceded by a backslash becomes

15605

part of the shell statement according to POSIX, but gets replaced,

15606

together with the backslash that precedes it, by a space in GNU `make'

15607

3.80 and older. So, how can a newline be used in a string literal?

15608

15609

The trick is to set up a shell variable that contains a newline:

15610

15611

nlinit=`echo 'nl="'; echo '"'`; eval "$$nlinit"

15612

15613

For example, in order to create a multiline `sed' expression that

15614

inserts a blank line after every line of a file, this code can be used:

15615

15616

nlinit=`echo 'nl="'; echo '"'`; eval "$$nlinit"; \

15617

sed -e "s/\$$/\\$${nl}/" < input > output

15618

15619

15620

File: autoconf.info, Node: obj/ and Make, Next: make -k Status, Prev: Newlines in Make Rules, Up: Portable Make

15621

15622

12.13 The `obj/' Subdirectory and Make

15253

15623

======================================

15254

15624

15255

15625

Never name one of your subdirectories `obj/' if you don't like

15274

15644

15275

15645

File: autoconf.info, Node: make -k Status, Next: VPATH and Make, Prev: obj/ and Make, Up: Portable Make

15276

15646

15277

12.13 Exit Status of `make -k'

15647

12.14 Exit Status of `make -k'

15278

15648

==============================

15279

15649

15280

15650

Do not rely on the exit status of `make -k'. Some implementations

15296

15666

15297

15667

File: autoconf.info, Node: VPATH and Make, Next: Single Suffix Rules, Prev: make -k Status, Up: Portable Make

15298

15668

15299

12.14 `VPATH' and Make

15669

12.15 `VPATH' and Make

15300

15670

======================

15301

15671

15302

15672

Posix does not specify the semantics of `VPATH'. Typically, `make'

15326

15696

15327

15697

File: autoconf.info, Node: Variables listed in VPATH, Next: VPATH and Double-colon, Up: VPATH and Make

15328

15698

15329

12.14.1 Variables listed in `VPATH'

15699

12.15.1 Variables listed in `VPATH'

15330

15700

-----------------------------------

15331

15701

15332

15702

Do not set `VPATH' to the value of another variable, for example `VPATH

15342

15712

15343

15713

File: autoconf.info, Node: VPATH and Double-colon, Next: $< in Explicit Rules, Prev: Variables listed in VPATH, Up: VPATH and Make

15344

15714

15345

12.14.2 `VPATH' and Double-colon Rules

15715

12.15.2 `VPATH' and Double-colon Rules

15346

15716

--------------------------------------

15347

15717

15348

15718

With ancient versions of Sun `make', any assignment to `VPATH' causes

15352

15722

15353

15723

File: autoconf.info, Node: $< in Explicit Rules, Next: Automatic Rule Rewriting, Prev: VPATH and Double-colon, Up: VPATH and Make

15354

15724

15355

12.14.3 `$<' Not Supported in Explicit Rules

15725

12.15.3 `$<' Not Supported in Explicit Rules

15356

15726

--------------------------------------------

15357

15727

15358

15728

Using `$<' in explicit rules is not portable. The prerequisite file

15363

15733

15364

15734

File: autoconf.info, Node: Automatic Rule Rewriting, Next: Tru64 Directory Magic, Prev: $< in Explicit Rules, Up: VPATH and Make

15365

15735

15366

12.14.4 Automatic Rule Rewriting

15736

12.15.4 Automatic Rule Rewriting

15367

15737

--------------------------------

15368

15738

15369

15739

Some `make' implementations, such as Solaris and Tru64, search for

15540

15910

15541

15911

File: autoconf.info, Node: Tru64 Directory Magic, Next: Make Target Lookup, Prev: Automatic Rule Rewriting, Up: VPATH and Make

15542

15912

15543

12.14.5 Tru64 `make' Creates Prerequisite Directories Magically

15913

12.15.5 Tru64 `make' Creates Prerequisite Directories Magically

15544

15914

---------------------------------------------------------------

15545

15915

15546

15916

When a prerequisite is a subdirectory of `VPATH', Tru64 `make' creates

15569

15939

15570

15940

File: autoconf.info, Node: Make Target Lookup, Prev: Tru64 Directory Magic, Up: VPATH and Make

15571

15941

15572

12.14.6 Make Target Lookup

15942

12.15.6 Make Target Lookup

15573

15943

--------------------------

15574

15944

15575

15945

GNU `make' uses a complex algorithm to decide when it should use files

15704

16074

15705

16075

File: autoconf.info, Node: Single Suffix Rules, Next: Timestamps and Make, Prev: VPATH and Make, Up: Portable Make

15706

16076

15707

12.15 Single Suffix Rules and Separated Dependencies

16077

12.16 Single Suffix Rules and Separated Dependencies

15708

16078

====================================================

15709

16079

15710

16080

A "Single Suffix Rule" is basically a usual suffix (inference) rule

15758

16128

15759

16129

File: autoconf.info, Node: Timestamps and Make, Prev: Single Suffix Rules, Up: Portable Make

15760

16130

15761

12.16 Timestamp Resolution and Make

16131

12.17 Timestamp Resolution and Make

15762

16132

===================================

15763

16133

15764

16134

Traditionally, file timestamps had 1-second resolution, and `make' used

16686

17056

neither option was given, run shell commands ACTION-IF-NOT-GIVEN.

16687

17057

The name PACKAGE indicates another software package that this

16688

17058

program should work with. It should consist only of alphanumeric

16689

characters, dashes, and dots.

17059

characters, dashes, plus signs, and dots.

16690

17060

16691

17061

The option's argument is available to the shell commands

16692

17062

ACTION-IF-GIVEN in the shell variable `withval', which is actually

16817

17187

`--disable-FEATURE', run shell commands ACTION-IF-GIVEN. If

16818

17188

neither option was given, run shell commands ACTION-IF-NOT-GIVEN.

16819

17189

The name FEATURE indicates an optional user-level facility. It

16820

should consist only of alphanumeric characters, dashes, and dots.

17190

should consist only of alphanumeric characters, dashes, plus

17191

signs, and dots.

16821

17192

16822

17193

The option's argument is available to the shell commands

16823

17194

ACTION-IF-GIVEN in the shell variable `enableval', which is

17089

17460

site- and system-wide initialization files.

17090

17461

17091

17462

If the environment variable `CONFIG_SITE' is set, `configure' uses

17092

its value as the name of a shell script to read. Otherwise, it reads

17093

the shell script `PREFIX/share/config.site' if it exists, then

17094

`PREFIX/etc/config.site' if it exists. Thus, settings in

17095

machine-specific files override those in machine-independent ones in

17096

case of conflict.

17463

its value as the name of a shell script to read; it is recommended that

17464

this be an absolute file name. Otherwise, it reads the shell script

17465

`PREFIX/share/config.site' if it exists, then `PREFIX/etc/config.site'

17466

if it exists. Thus, settings in machine-specific files override those

17467

in machine-independent ones in case of conflict.

17097

17468

17098

17469

Site files can be arbitrary shell scripts, but only certain kinds of

17099

17470

code are really appropriate to be in them. Because `configure' reads

19100

19471

19101

19472

Since Autoconf 2.50, internal codes uses `AC_PREPROC_IFELSE',

19102

19473

`AC_COMPILE_IFELSE', `AC_LINK_IFELSE', and `AC_RUN_IFELSE' on one hand

19103

and `AC_LANG_SOURCES', and `AC_LANG_PROGRAM' on the other hand instead

19474

and `AC_LANG_SOURCE', and `AC_LANG_PROGRAM' on the other hand instead

19104

19475

of the deprecated `AC_TRY_CPP', `AC_TRY_COMPILE', `AC_TRY_LINK', and

19105

19476

`AC_TRY_RUN'. The motivations where:

19106

19477

- a more consistent interface: `AC_TRY_COMPILE' etc. were double

19213

19584

19214

19585

Generating testing or validation suites using Autotest is rather easy.

19215

19586

The whole validation suite is held in a file to be processed through

19216

`autom4te', itself using GNU M4 under the scene, to produce a

19587

`autom4te', itself using GNU M4 under the hood, to produce a

19217

19588

stand-alone Bourne shell script which then gets distributed. Neither

19218

19589

`autom4te' nor GNU M4 are needed at the installer's end.

19219

19590

19295

19666

\

19296

19667

`--> [atlocal]

19297

19668

19298

Files created during the test suite execution:

19669

Files created during test suite execution:

19299

19670

19300

19671

atconfig -->. .--> testsuite.log

19301

19672

\ /

19341

19712

simpler to run both the test suite and the programs on HOST, but

19342

19713

then, from the point of view of the test suite, there remains a

19343

19714

single environment, HOST = BUILD. The log contains relevant

19344

information on the state of the build machine, including some

19715

information on the state of the BUILD machine, including some

19345

19716

important environment variables.

19346

19717

19347

19718

tested programs

19401

19772

The COPYRIGHT-NOTICE shows up in both the head of `testsuite' and

19402

19773

in `testsuite --version'.

19403

19774

19775

-- Macro: AT_ARG_OPTION (OPTIONS, HELP-TEXT, [ACTION-IF-GIVEN],

19776

[ACTION-IF-NOT-GIVEN])

19777

Accept options from the space-separated list OPTIONS, a list that

19778

has leading dashes removed from the options. Long options will be

19779

prefixed with `--', single-character options with `-'. The first

19780

word in this list is the primary OPTION, any others are assumed to

19781

be short-hand aliases. The variable associated with it is

19782

`at_arg_OPTION', with any dashes in OPTION replaced with

19783

underscores.

19784

19785

If the user passes `--OPTION' to the `testsuite', the variable

19786

will be set to `:'. If the user does not pass the option, or

19787

passes `--no-OPTION', then the variable will be set to `false'.

19788

19789

ACTION-IF-GIVEN is run each time the option is encountered; here,

19790

the variable `at_optarg' will be set to `:' or `false' as

19791

appropriate. `at_optarg' is actually just a copy of

19792

`at_arg_OPTION'.

19793

19794

ACTION-IF-NOT-GIVEN will be run once after option parsing is

19795

complete and if no option from OPTIONS was used.

19796

19797

HELP-TEXT is added to the end of the list of options shown in

19798

`testsuite --help' (*note AS_HELP_STRING::).

19799

19800

It it recommended that you use a package-specific prefix to OPTIONS

19801

names in order to avoid clashes with future Autotest built-in

19802

options.

19803

19804

-- Macro: AT_ARG_OPTION_ARG (OPTIONS, HELP-TEXT, [ACTION-IF-GIVEN],

19805

[ACTION-IF-NOT-GIVEN])

19806

Accept options with arguments from the space-separated list

19807

OPTIONS, a list that has leading dashes removed from the options.

19808

Long options will be prefixed with `--', single-character options

19809

with `-'. The first word in this list is the primary OPTION, any

19810

others are assumed to be short-hand aliases. The variable

19811

associated with it is `at_arg_OPTION', with any dashes in OPTION

19812

replaced with underscores.

19813

19814

If the user passes `--OPTION=ARG' or `--OPTION ARG' to the

19815

`testsuite', the variable will be set to `ARG'.

19816

19817

ACTION-IF-GIVEN is run each time the option is encountered; here,

19818

the variable `at_optarg' will be set to `ARG'. `at_optarg' is

19819

actually just a copy of `at_arg_OPTION'.

19820

19821

ACTION-IF-NOT-GIVEN will be run once after option parsing is

19822

complete and if no option from OPTIONS was used.

19823

19824

HELP-TEXT is added to the end of the list of options shown in

19825

`testsuite --help' (*note AS_HELP_STRING::).

19826

19827

It it recommended that you use a package-specific prefix to OPTIONS

19828

names in order to avoid clashes with future Autotest built-in

19829

options.

19830

19831

-- Macro: AT_COLOR_TESTS

19832

Enable colored test results by default when the output is

19833

connected to a terminal.

19834

19404

19835

-- Macro: AT_TESTED (EXECUTABLES)

19405

19836

Log the file name and answer to `--version' of each program in

19406

19837

space-separated list EXECUTABLES. Several invocations register

19407

19838

new executables, in other words, don't fear registering one program

19408

19839

several times.

19409

19840

19410

Autotest test suites rely on `PATH' to find the tested program.

19411

This avoids the need to generate absolute names of the various tools,

19412

and makes it possible to test installed programs. Therefore, knowing

19413

which programs are being exercised is crucial to understanding problems

19414

in the test suite itself, or its occasional misuses. It is a good idea

19415

to also subscribe foreign programs you depend upon, to avoid

19416

incompatible diagnostics.

19841

Autotest test suites rely on `PATH' to find the tested program.

19842

This avoids the need to generate absolute names of the various

19843

tools, and makes it possible to test installed programs.

19844

Therefore, knowing which programs are being exercised is crucial

19845

to understanding problems in the test suite itself, or its

19846

occasional misuses. It is a good idea to also subscribe foreign

19847

programs you depend upon, to avoid incompatible diagnostics.

19417

19848

19418

19849

19419

19850

-- Macro: AT_BANNER (TEST-CATEGORY-NAME)

19440

19871

suite. For instance, if some of your test groups exercise some

19441

19872

`foo' feature, then using `AT_KEYWORDS(foo)' lets you run

19442

19873

`./testsuite -k foo' to run exclusively these test groups. The

19443

TITLE of the test group is automatically recorded to `AT_KEYWORDS'.

19874

TEST-GROUP-NAME of the test group is automatically recorded to

19875

`AT_KEYWORDS'.

19444

19876

19445

19877

Several invocations within a test group accumulate new keywords.

19446

19878

In other words, don't fear registering the same keyword several

19527

19959

literals in the following table, then the test treats the output

19528

19960

according to the rules of that literal. Otherwise, the value of

19529

19961

the parameter is treated as text that must exactly match the

19530

output given by COMMANDS on standard out and standard error

19962

output given by COMMANDS on standard output and standard error

19531

19963

(including an empty parameter for no output); any differences are

19532

19964

captured in the testsuite log and the test is failed (unless an

19533

19965

unexpected exit status of 77 skipped the test instead). The

19640

20072

19.3 Running `testsuite' Scripts

19641

20073

================================

19642

20074

19643

Autotest test suites support the following arguments:

20075

Autotest test suites support the following options:

19644

20076

19645

20077

`--help'

19646

20078

`-h'

19685

20117

possible keywords.

19686

20118

19687

20119

19688

By default all tests are performed (or described with `--list') in

19689

the default environment first silently, then verbosely, but the

19690

environment, set of tests, and verbosity level can be tuned:

20120

By default all tests are performed (or described with `--list')

20121

silently in the default environment, but the environment, set of tests,

20122

and verbosity level can be tuned:

19691

20123

19692

20124

`VARIABLE=VALUE'

19693

20125

Set the environment VARIABLE to VALUE. Use this rather than

19734

20166

19735

20167

`--errexit'

19736

20168

`-e'

19737

If any test fails, immediately abort testing. It implies

20169

If any test fails, immediately abort testing. This implies

19738

20170

`--debug': post test group clean up, and top-level logging are

19739

20171

inhibited. This option is meant for the full test suite, it is

19740

20172

not really useful for generated debugging scripts. If the

19746

20178

Force more verbosity in the detailed output of what is being done.

19747

20179

This is the default for debugging scripts.

19748

20180

20181

`--color'

20182

`--color[=never|auto|always]'

20183

Enable colored test results. Without an argument, or with

20184

`always', test results will be colored. With `never', color mode

20185

is turned off. Otherwise, if either the macro `AT_COLOR_TESTS' is

20186

used by the testsuite author, or the argument `auto' is given,

20187

then test results are colored if standard output is connected to a

20188

terminal.

20189

19749

20190

`--debug'

19750

20191

`-d'

19751

Do not remove the files after a test group was performed --but

19752

they are still removed _before_, therefore using this option is

19753

sane when running several test groups. Create debugging scripts.

19754

Do not overwrite the top-level log (in order to preserve

19755

supposedly existing full log file). This is the default for

19756

debugging scripts, but it can also be useful to debug the

19757

testsuite itself.

20192

Do not remove the files after a test group was performed--but they

20193

are still removed _before_, therefore using this option is sane

20194

when running several test groups. Create debugging scripts. Do

20195

not overwrite the top-level log (in order to preserve a supposedly

20196

existing full log file). This is the default for debugging

20197

scripts, but it can also be useful to debug the testsuite itself.

20198

20199

`--recheck'

20200

Add to the selection all test groups that failed or passed

20201

unexpectedly during the last non-debugging test run.

19758

20202

19759

20203

`--trace'

19760

20204

`-x'

19761

20205

Trigger shell tracing of the test groups.

19762

20206

20207

Besides these options accepted by every Autotest testsuite, the

20208

testsuite author might have added package-specific options via the

20209

`AT_ARG_OPTION' and `AT_ARG_OPTION_ARG' macros (*note Writing

20210

Testsuites::); refer to `testsuite --help' and the package

20211

documentation for details.

20212

19763

20213

19764

20214

File: autoconf.info, Node: Making testsuite Scripts, Prev: testsuite Invocation, Up: Using Autotest

19765

20215

19808

20258

:;{ \

19809

20259

echo '# Signature of the current package.' && \

19810

20260

echo 'm4_define([AT_PACKAGE_NAME],' && \

19811

echo ' [@PACKAGE_NAME@])' && \

20261

echo ' [$(PACKAGE_NAME)])' && \

19812

20262

echo 'm4_define([AT_PACKAGE_TARNAME],' && \

19813

echo ' [@PACKAGE_TARNAME@])' && \

20263

echo ' [$(PACKAGE_TARNAME)])' && \

19814

20264

echo 'm4_define([AT_PACKAGE_VERSION],' && \

19815

echo ' [@PACKAGE_VERSION@])' && \

20265

echo ' [$(PACKAGE_VERSION)])' && \

19816

20266

echo 'm4_define([AT_PACKAGE_STRING],' && \

19817

echo ' [@PACKAGE_STRING@])' && \

20267

echo ' [$(PACKAGE_STRING)])' && \

19818

20268

echo 'm4_define([AT_PACKAGE_BUGREPORT],' && \

19819

echo ' [@PACKAGE_BUGREPORT@])'; \

20269

echo ' [$(PACKAGE_BUGREPORT)])'; \

19820

20270

echo 'm4_define([AT_PACKAGE_URL],' && \

19821

echo ' [@PACKAGE_URL@])'; \

20271

echo ' [$(PACKAGE_URL)])'; \

19822

20272

} >'$(srcdir)/package.m4'

19823

20273

19824

20274

EXTRA_DIST = testsuite.at $(srcdir)/package.m4 $(TESTSUITE) atlocal.in

19855

20305

following:

19856

20306

19857

20307

subdir = tests

20308

PACKAGE_NAME = @PACKAGE_NAME@

20309

PACKAGE_TARNAME = @PACKAGE_TARNAME@

20310

PACKAGE_VERSION = @PACKAGE_VERSION@

20311

PACKAGE_STRING = @PACKAGE_STRING@

20312

PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@

20313

PACKAGE_URL = @PACKAGE_URL@

19858

20314

19859

20315

atconfig: $(top_builddir)/config.status

19860

20316

cd $(top_builddir) && \

19866

20322

19867

20323

and manage to have `$(EXTRA_DIST)' distributed. You will also want to

19868

20324

distribute the file `build-aux/missing' from the Automake project; a

19869

copy of this file resides in the Autoconf source.

20325

copy of this file resides in the Autoconf source tree.

19870

20326

19871

20327

With all this in place, and if you have not initialized

19872

20328

`TESTSUITEFLAGS' within your makefile, you can fine-tune test suite

20101

20557

- Use `AC_DEFINE' but have `configure' compute the literal value of

20102

20558

`datadir' and others. Many people have wrapped macros to automate

20103

20559

this task; for an example, see the macro `AC_DEFINE_DIR' from the

20104

Autoconf Macro Archive (http://autoconf-archive.cryp.to/).

20560

Autoconf Macro Archive

20561

(http://www.gnu.org/software/autoconf-archive/).

20105

20562

20106

20563

This solution does not conform to the GNU Coding Standards.

20107

20564

20436

20893

precise semantics of undocumented variables are often

20437

20894

internal details, subject to change.

20438

20895

20896

* Alternatively, `configure' may produce invalid results because of

20897

uncaught programming errors, in your package or in an upstream

20898

library package. For example, when `AC_CHECK_LIB' fails to find a

20899

library with a specified function, always check `config.log'. This

20900

will reveal the exact error that produced the failing result: the

20901

library linked by `AC_CHECK_LIB' probably has a fatal bug.

20902

20439

20903

Conversely, as macro author, you can make it easier for users of your

20440

20904

macro:

20441

20905

21209

21673

* CONFIG_SITE: Site Defaults. (line 10)

21210

21674

* CONFIG_STATUS: config.status Invocation.

21211

21675

(line 111)

21212

* CPP: C Compiler. (line 110)

21676

* CPP: C Compiler. (line 113)

21213

21677

* CPPFLAGS: Preset Output Variables.

21214

21678

(line 72)

21215

21679

* CXX: C++ Compiler. (line 7)

21216

* CXXCPP: C++ Compiler. (line 31)

21217

* CXXFLAGS <1>: Preset Output Variables.

21680

* CXXCPP: C++ Compiler. (line 35)

21681

* CXXFLAGS <1>: C++ Compiler. (line 7)

21682

* CXXFLAGS: Preset Output Variables.

21218

21683

(line 94)

21219

* CXXFLAGS: C++ Compiler. (line 7)

21220

21684

* CYGWIN: Obsolete Macros. (line 124)

21221

21685

* DUALCASE: Special Shell Variables.

21222

21686

(line 74)

21226

21690

(line 29)

21227

21691

* ERLC: Erlang Compiler and Interpreter.

21228

21692

(line 10)

21229

* ERLCFLAGS <1>: Preset Output Variables.

21693

* ERLCFLAGS <1>: Erlang Compiler and Interpreter.

21694

(line 10)

21695

* ERLCFLAGS: Preset Output Variables.

21230

21696

(line 120)

21231

* ERLCFLAGS: Erlang Compiler and Interpreter.

21232

(line 10)

21233

* F77: Fortran Compiler. (line 18)

21234

* FC: Fortran Compiler. (line 39)

21235

* FCFLAGS <1>: Preset Output Variables.

21697

* F77: Fortran Compiler. (line 19)

21698

* FC: Fortran Compiler. (line 40)

21699

* FCFLAGS <1>: Fortran Compiler. (line 40)

21700

* FCFLAGS: Preset Output Variables.

21236

21701

(line 126)

21237

* FCFLAGS: Fortran Compiler. (line 39)

21238

* FFLAGS <1>: Fortran Compiler. (line 18)

21702

* FFLAGS <1>: Fortran Compiler. (line 19)

21239

21703

* FFLAGS: Preset Output Variables.

21240

21704

(line 133)

21241

21705

* FPATH: Special Shell Variables.

21245

21709

* IFS: Special Shell Variables.

21246

21710

(line 116)

21247

21711

* LANG: Special Shell Variables.

21248

(line 140)

21712

(line 160)

21249

21713

* LANGUAGE: Special Shell Variables.

21250

(line 147)

21714

(line 167)

21251

21715

* LC_ADDRESS: Special Shell Variables.

21252

(line 157)

21253

* LC_ALL <1>: Initialization Macros.

21716

(line 177)

21717

* LC_ALL <1>: Special Shell Variables.

21718

(line 160)

21719

* LC_ALL: Initialization Macros.

21254

21720

(line 14)

21255

* LC_ALL: Special Shell Variables.

21256

(line 140)

21257

21721

* LC_COLLATE: Special Shell Variables.

21258

(line 140)

21722

(line 160)

21259

21723

* LC_CTYPE: Special Shell Variables.

21260

(line 140)

21724

(line 160)

21261

21725

* LC_IDENTIFICATION: Special Shell Variables.

21262

(line 157)

21726

(line 177)

21263

21727

* LC_MEASUREMENT: Special Shell Variables.

21264

(line 157)

21728

(line 177)

21265

21729

* LC_MESSAGES: Special Shell Variables.

21266

(line 140)

21730

(line 160)

21267

21731

* LC_MONETARY: Special Shell Variables.

21268

(line 140)

21732

(line 160)

21269

21733

* LC_NAME: Special Shell Variables.

21270

(line 157)

21734

(line 177)

21271

21735

* LC_NUMERIC: Special Shell Variables.

21272

(line 140)

21736

(line 160)

21273

21737

* LC_PAPER: Special Shell Variables.

21274

(line 157)

21738

(line 177)

21275

21739

* LC_TELEPHONE: Special Shell Variables.

21276

(line 157)

21740

(line 177)

21277

21741

* LC_TIME: Special Shell Variables.

21278

(line 140)

21742

(line 160)

21279

21743

* LDFLAGS: Preset Output Variables.

21280

21744

(line 140)

21281

21745

* LIBS: Preset Output Variables.

21282

21746

(line 154)

21283

* LINENO <1>: Initialization Macros.

21747

* LINENO <1>: Special Shell Variables.

21748

(line 182)

21749

* LINENO: Initialization Macros.

21284

21750

(line 67)

21285

* LINENO: Special Shell Variables.

21286

(line 162)

21287

21751

* M4: autom4te Invocation. (line 10)

21288

21752

* MAIL: Special Shell Variables.

21289

21753

(line 84)

21290

21754

* MAILPATH: Special Shell Variables.

21291

21755

(line 84)

21292

21756

* NULLCMD: Special Shell Variables.

21293

(line 291)

21757

(line 311)

21294

21758

* OBJC: Objective C Compiler.

21295

21759

(line 7)

21296

21760

* OBJCFLAGS <1>: Objective C Compiler.

21308

21772

* OBJCXXFLAGS: Preset Output Variables.

21309

21773

(line 166)

21310

21774

* PATH_SEPARATOR: Special Shell Variables.

21311

(line 298)

21775

(line 318)

21312

21776

* PS1: Special Shell Variables.

21313

21777

(line 84)

21314

21778

* PS2: Special Shell Variables.

21316

21780

* PS4: Special Shell Variables.

21317

21781

(line 84)

21318

21782

* PWD: Special Shell Variables.

21319

(line 307)

21783

(line 327)

21320

21784

* RANDOM: Special Shell Variables.

21321

(line 316)

21785

(line 336)

21322

21786

* SHELL: Initialization Macros.

21323

21787

(line 14)

21324

21788

* SIMPLE_BACKUP_SUFFIX: autoupdate Invocation.

21325

21789

(line 16)

21326

21790

* status: Special Shell Variables.

21327

(line 324)

21328

* WARNINGS <1>: autoconf Invocation. (line 62)

21329

* WARNINGS <2>: autom4te Invocation. (line 58)

21330

* WARNINGS <3>: autoheader Invocation.

21791

(line 344)

21792

* WARNINGS <1>: autom4te Invocation. (line 58)

21793

* WARNINGS <2>: autoheader Invocation.

21331

21794

(line 83)

21332

* WARNINGS: autoreconf Invocation.

21795

* WARNINGS <3>: autoreconf Invocation.

21333

21796

(line 97)

21797

* WARNINGS: autoconf Invocation. (line 62)

21334

21798

* XMKMF: System Services. (line 10)

21335

21799

* YACC: Particular Programs. (line 197)

21336

21800

* YFLAGS: Particular Programs. (line 197)

21369

21833

* build_vendor: Canonicalizing. (line 26)

21370

21834

* builddir: Preset Output Variables.

21371

21835

(line 170)

21372

* CC <1>: C Compiler. (line 61)

21373

* CC <2>: System Services. (line 49)

21374

* CC: C Compiler. (line 358)

21836

* CC <1>: System Services. (line 49)

21837

* CC: C Compiler. (line 61)

21375

21838

* CFLAGS <1>: C Compiler. (line 61)

21376

21839

* CFLAGS: Preset Output Variables.

21377

21840

(line 23)

21378

21841

* configure_input: Preset Output Variables.

21379

21842

(line 58)

21380

* CPP: C Compiler. (line 123)

21843

* CPP: C Compiler. (line 113)

21381

21844

* CPPFLAGS: Preset Output Variables.

21382

21845

(line 72)

21383

21846

* cross_compiling: Runtime. (line 58)

21384

21847

* CXX: C++ Compiler. (line 7)

21385

* CXXCPP: C++ Compiler. (line 31)

21848

* CXXCPP: C++ Compiler. (line 35)

21386

21849

* CXXFLAGS <1>: C++ Compiler. (line 7)

21387

21850

* CXXFLAGS: Preset Output Variables.

21388

21851

(line 94)

21404

21867

(line 108)

21405

21868

* EGREP: Particular Programs. (line 26)

21406

21869

* ERL <1>: Running the Compiler.

21407

(line 29)

21408

* ERL <2>: Erlang Compiler and Interpreter.

21409

(line 29)

21410

* ERL: Language Choice. (line 40)

21870

(line 30)

21871

* ERL <2>: Language Choice. (line 40)

21872

* ERL: Erlang Compiler and Interpreter.

21873

(line 29)

21411

21874

* ERLANG_ERTS_VER: Erlang Libraries. (line 12)

21412

* ERLANG_INSTALL_LIB_DIR <1>: Installation Directory Variables.

21875

* ERLANG_INSTALL_LIB_DIR <1>: Erlang Libraries. (line 86)

21876

* ERLANG_INSTALL_LIB_DIR: Installation Directory Variables.

21413

21877

(line 201)

21414

* ERLANG_INSTALL_LIB_DIR: Erlang Libraries. (line 86)

21415

* ERLANG_INSTALL_LIB_DIR_LIBRARY <1>: Installation Directory Variables.

21878

* ERLANG_INSTALL_LIB_DIR_LIBRARY <1>: Erlang Libraries. (line 93)

21879

* ERLANG_INSTALL_LIB_DIR_LIBRARY: Installation Directory Variables.

21416

21880

(line 206)

21417

* ERLANG_INSTALL_LIB_DIR_LIBRARY: Erlang Libraries. (line 94)

21418

21881

* ERLANG_LIB_DIR: Erlang Libraries. (line 28)

21419

21882

* ERLANG_LIB_DIR_LIBRARY: Erlang Libraries. (line 36)

21420

21883

* ERLANG_LIB_VER_LIBRARY: Erlang Libraries. (line 36)

21421

21884

* ERLANG_ROOT_DIR: Erlang Libraries. (line 22)

21422

* ERLC <1>: Erlang Compiler and Interpreter.

21423

(line 10)

21424

* ERLC: Language Choice. (line 40)

21425

* ERLCFLAGS <1>: Erlang Compiler and Interpreter.

21426

(line 10)

21427

* ERLCFLAGS <2>: Preset Output Variables.

21885

* ERLC <1>: Language Choice. (line 40)

21886

* ERLC: Erlang Compiler and Interpreter.

21887

(line 10)

21888

* ERLCFLAGS <1>: Language Choice. (line 40)

21889

* ERLCFLAGS <2>: Erlang Compiler and Interpreter.

21890

(line 10)

21891

* ERLCFLAGS: Preset Output Variables.

21428

21892

(line 120)

21429

* ERLCFLAGS: Language Choice. (line 40)

21430

21893

* exec_prefix: Installation Directory Variables.

21431

21894

(line 33)

21432

21895

* EXEEXT <1>: Obsolete Macros. (line 178)

21433

21896

* EXEEXT: Compilers and Preprocessors.

21434

21897

(line 6)

21435

* F77: Fortran Compiler. (line 18)

21436

* FC: Fortran Compiler. (line 39)

21437

* FCFLAGS <1>: Preset Output Variables.

21898

* F77: Fortran Compiler. (line 19)

21899

* FC: Fortran Compiler. (line 40)

21900

* FCFLAGS <1>: Fortran Compiler. (line 40)

21901

* FCFLAGS: Preset Output Variables.

21438

21902

(line 126)

21439

* FCFLAGS: Fortran Compiler. (line 39)

21440

* FCLIBS: Fortran Compiler. (line 79)

21441

* FFLAGS <1>: Preset Output Variables.

21903

* FCLIBS: Fortran Compiler. (line 80)

21904

* FFLAGS <1>: Fortran Compiler. (line 19)

21905

* FFLAGS: Preset Output Variables.

21442

21906

(line 133)

21443

* FFLAGS: Fortran Compiler. (line 18)

21444

21907

* FGREP: Particular Programs. (line 33)

21445

* FLIBS: Fortran Compiler. (line 79)

21908

* FLIBS: Fortran Compiler. (line 80)

21446

21909

* GETGROUPS_LIBS: Particular Functions.

21447

21910

(line 138)

21448

21911

* GETLOADAVG_LIBS: Particular Functions.

21476

21939

(line 52)

21477

21940

* LIBOBJDIR: AC_LIBOBJ vs LIBOBJS.

21478

21941

(line 35)

21479

* LIBOBJS <1>: Generic Functions. (line 56)

21480

* LIBOBJS <2>: Particular Functions.

21942

* LIBOBJS <1>: Particular Structures.

21943

(line 26)

21944

* LIBOBJS <2>: Generic Functions. (line 56)

21945

* LIBOBJS: Particular Functions.

21481

21946

(line 144)

21482

* LIBOBJS <3>: Particular Structures.

21483

(line 26)

21484

* LIBOBJS <4>: Particular Functions.

21485

(line 279)

21486

* LIBOBJS: Generic Functions. (line 117)

21487

* LIBS <1>: Preset Output Variables.

21947

* LIBS <1>: Obsolete Macros. (line 295)

21948

* LIBS: Preset Output Variables.

21488

21949

(line 154)

21489

* LIBS: Obsolete Macros. (line 295)

21490

21950

* LN_S: Particular Programs. (line 165)

21491

21951

* localedir: Installation Directory Variables.

21492

21952

(line 55)

21509

21969

(line 7)

21510

21970

* OBJCXXCPP: Objective C++ Compiler.

21511

21971

(line 27)

21512

* OBJCXXFLAGS <1>: Preset Output Variables.

21972

* OBJCXXFLAGS <1>: Objective C++ Compiler.

21973

(line 7)

21974

* OBJCXXFLAGS: Preset Output Variables.

21513

21975

(line 166)

21514

* OBJCXXFLAGS: Objective C++ Compiler.

21515

(line 7)

21516

21976

* OBJEXT <1>: Obsolete Macros. (line 384)

21517

21977

* OBJEXT: Compilers and Preprocessors.

21518

21978

(line 11)

21527

21987

* OPENMP_FFLAGS: Generic Compiler Characteristics.

21528

21988

(line 64)

21529

21989

* PACKAGE_BUGREPORT: Initializing configure.

21530

(line 49)

21990

(line 57)

21531

21991

* PACKAGE_NAME: Initializing configure.

21532

(line 37)

21992

(line 45)

21533

21993

* PACKAGE_STRING: Initializing configure.

21534

(line 46)

21994

(line 54)

21535

21995

* PACKAGE_TARNAME: Initializing configure.

21536

(line 40)

21996

(line 48)

21537

21997

* PACKAGE_URL: Initializing configure.

21538

(line 52)

21998

(line 60)

21539

21999

* PACKAGE_VERSION: Initializing configure.

21540

(line 43)

22000

(line 51)

21541

22001

* pdfdir: Installation Directory Variables.

21542

22002

(line 69)

21543

22003

* POW_LIB: Particular Functions.

21589

22049

[index]

21590

22050

* Menu:

21591

22051

21592

* __CHAR_UNSIGNED__: C Compiler. (line 288)

22052

* __CHAR_UNSIGNED__: C Compiler. (line 291)

21593

22053

* __EXTENSIONS__: Posix Variants. (line 10)

21594

* __PROTOTYPES: C Compiler. (line 348)

21595

* _ALL_SOURCE <1>: Posix Variants. (line 10)

21596

* _ALL_SOURCE: Obsolete Macros. (line 20)

22054

* __PROTOTYPES: C Compiler. (line 351)

22055

* _ALL_SOURCE <1>: Obsolete Macros. (line 20)

22056

* _ALL_SOURCE: Posix Variants. (line 10)

21597

22057

* _FILE_OFFSET_BITS: System Services. (line 49)

21598

22058

* _GNU_SOURCE <1>: Obsolete Macros. (line 234)

21599

22059

* _GNU_SOURCE: Posix Variants. (line 10)

21600

22060

* _LARGE_FILES: System Services. (line 49)

21601

22061

* _LARGEFILE_SOURCE: Particular Functions.

21602

22062

(line 130)

21603

* _MINIX <1>: Posix Variants. (line 10)

21604

* _MINIX: Obsolete Macros. (line 371)

22063

* _MINIX <1>: Obsolete Macros. (line 371)

22064

* _MINIX: Posix Variants. (line 10)

21605

22065

* _OPENMP: Generic Compiler Characteristics.

21606

22066

(line 64)

21607

22067

* _POSIX_1_SOURCE <1>: Obsolete Macros. (line 371)

21608

22068

* _POSIX_1_SOURCE: Posix Variants. (line 10)

21609

22069

* _POSIX_PTHREAD_SEMANTICS: Posix Variants. (line 10)

21610

* _POSIX_SOURCE <1>: Posix Variants. (line 10)

21611

* _POSIX_SOURCE: Obsolete Macros. (line 371)

22070

* _POSIX_SOURCE <1>: Obsolete Macros. (line 371)

22071

* _POSIX_SOURCE: Posix Variants. (line 10)

21612

22072

* _POSIX_VERSION: Particular Headers. (line 213)

21613

22073

* _TANDEM_SOURCE: Posix Variants. (line 10)

21614

22074

* ALIGNOF_TYPE: Generic Compiler Characteristics.

21619

22079

(line 144)

21620

22080

* CLOSEDIR_VOID: Particular Functions.

21621

22081

(line 60)

21622

* const: C Compiler. (line 214)

21623

* CXX_NO_MINUS_C_MINUS_O: C++ Compiler. (line 44)

22082

* const: C Compiler. (line 217)

22083

* CXX_NO_MINUS_C_MINUS_O: C++ Compiler. (line 48)

21624

22084

* DGUX: Particular Functions.

21625

22085

(line 144)

21626

22086

* DIRENT: Obsolete Macros. (line 158)

21627

* F77_DUMMY_MAIN: Fortran Compiler. (line 107)

21628

* F77_FUNC: Fortran Compiler. (line 173)

21629

* F77_FUNC_: Fortran Compiler. (line 173)

21630

* F77_MAIN: Fortran Compiler. (line 150)

21631

* F77_NO_MINUS_C_MINUS_O: Fortran Compiler. (line 66)

21632

* FC_FUNC: Fortran Compiler. (line 173)

21633

* FC_FUNC_: Fortran Compiler. (line 173)

21634

* FC_MAIN: Fortran Compiler. (line 150)

21635

* FC_NO_MINUS_C_MINUS_O: Fortran Compiler. (line 66)

21636

* FLEXIBLE_ARRAY_MEMBER: C Compiler. (line 312)

22087

* F77_DUMMY_MAIN: Fortran Compiler. (line 111)

22088

* F77_FUNC: Fortran Compiler. (line 177)

22089

* F77_FUNC_: Fortran Compiler. (line 177)

22090

* F77_MAIN: Fortran Compiler. (line 154)

22091

* F77_NO_MINUS_C_MINUS_O: Fortran Compiler. (line 67)

22092

* FC_FUNC: Fortran Compiler. (line 177)

22093

* FC_FUNC_: Fortran Compiler. (line 177)

22094

* FC_MAIN: Fortran Compiler. (line 154)

22095

* FC_NO_MINUS_C_MINUS_O: Fortran Compiler. (line 67)

22096

* FLEXIBLE_ARRAY_MEMBER: C Compiler. (line 315)

21637

22097

* GETGROUPS_T: Particular Types. (line 14)

21638

22098

* GETLOADAVG_PRIVILEGED: Particular Functions.

21639

22099

(line 144)

21645

22105

* HAVE_AGGREGATE_MEMBER: Generic Structures. (line 29)

21646

22106

* HAVE_ALLOCA_H: Particular Functions.

21647

22107

(line 10)

21648

* HAVE_C_BACKSLASH_A: C Compiler. (line 173)

21649

* HAVE_C_VARARRAYS: C Compiler. (line 336)

22108

* HAVE_C_BACKSLASH_A: C Compiler. (line 176)

22109

* HAVE_C_VARARRAYS: C Compiler. (line 339)

21650

22110

* HAVE_CHOWN: Particular Functions.

21651

22111

(line 54)

21652

22112

* HAVE_CONFIG_H: Configuration Headers.

21654

22114

* HAVE_DECL_STRERROR_R: Particular Functions.

21655

22115

(line 365)

21656

22116

* HAVE_DECL_SYMBOL: Generic Declarations.

21657

(line 29)

22117

(line 34)

21658

22118

* HAVE_DECL_TZNAME: Particular Structures.

21659

22119

(line 43)

21660

22120

* HAVE_DIRENT_H: Particular Headers. (line 15)

21674

22134

* HAVE_INT8_T: Particular Types. (line 21)

21675

22135

* HAVE_INTMAX_T: Particular Types. (line 49)

21676

22136

* HAVE_INTPTR_T: Particular Types. (line 54)

21677

* HAVE_LONG_DOUBLE <1>: Particular Types. (line 59)

21678

* HAVE_LONG_DOUBLE: Obsolete Macros. (line 33)

22137

* HAVE_LONG_DOUBLE <1>: Obsolete Macros. (line 33)

22138

* HAVE_LONG_DOUBLE: Particular Types. (line 59)

21679

22139

* HAVE_LONG_DOUBLE_WIDER: Particular Types. (line 70)

21680

22140

* HAVE_LONG_FILE_NAMES: System Services. (line 71)

21681

22141

* HAVE_LONG_LONG_INT: Particular Types. (line 78)

21709

22169

(line 365)

21710

22170

* HAVE_STRFTIME: Particular Functions.

21711

22171

(line 378)

21712

* HAVE_STRINGIZE: C Compiler. (line 302)

22172

* HAVE_STRINGIZE: C Compiler. (line 305)

21713

22173

* HAVE_STRNLEN: Particular Functions.

21714

22174

(line 400)

21715

22175

* HAVE_STRTOLD: Particular Functions.

21730

22190

* HAVE_TM_ZONE: Particular Structures.

21731

22191

(line 43)

21732

22192

* HAVE_TYPE: Generic Types. (line 28)

21733

* HAVE_TYPEOF: C Compiler. (line 342)

22193

* HAVE_TYPEOF: C Compiler. (line 345)

21734

22194

* HAVE_TZNAME: Particular Structures.

21735

22195

(line 43)

21736

22196

* HAVE_UINT16_T: Particular Types. (line 138)

21751

22211

(line 108)

21752

22212

* HAVE_WORKING_VFORK: Particular Functions.

21753

22213

(line 108)

21754

* inline: C Compiler. (line 283)

22214

* inline: C Compiler. (line 286)

21755

22215

* int16_t: Particular Types. (line 40)

21756

22216

* int32_t: Particular Types. (line 43)

21757

22217

* int64_t: Particular Types. (line 46)

21775

22235

(line 144)

21776

22236

* NLIST_NAME_UNION: Particular Functions.

21777

22237

(line 144)

21778

* NO_MINUS_C_MINUS_O: C Compiler. (line 99)

22238

* NO_MINUS_C_MINUS_O: C Compiler. (line 102)

21779

22239

* off_t: Particular Types. (line 102)

21780

22240

* PACKAGE_BUGREPORT: Initializing configure.

21781

(line 49)

22241

(line 57)

21782

22242

* PACKAGE_NAME: Initializing configure.

21783

(line 37)

22243

(line 45)

21784

22244

* PACKAGE_STRING: Initializing configure.

21785

(line 46)

22245

(line 54)

21786

22246

* PACKAGE_TARNAME: Initializing configure.

21787

(line 40)

22247

(line 48)

21788

22248

* PACKAGE_URL: Initializing configure.

21789

(line 52)

22249

(line 60)

21790

22250

* PACKAGE_VERSION: Initializing configure.

21791

(line 43)

21792

* PARAMS: C Compiler. (line 348)

22251

(line 51)

22252

* PARAMS: C Compiler. (line 351)

21793

22253

* pid_t: Particular Types. (line 108)

21794

* PROTOTYPES: C Compiler. (line 348)

22254

* PROTOTYPES: C Compiler. (line 351)

21795

22255

* realloc: Particular Functions.

21796

22256

(line 303)

21797

* restrict: C Compiler. (line 244)

22257

* restrict: C Compiler. (line 247)

21798

22258

* RETSIGTYPE: Obsolete Macros. (line 662)

21799

22259

* SELECT_TYPE_ARG1: Particular Functions.

21800

22260

(line 314)

21821

22281

* TIME_WITH_SYS_TIME: Particular Headers. (line 229)

21822

22282

* TM_IN_SYS_TIME: Particular Structures.

21823

22283

(line 35)

21824

* typeof: C Compiler. (line 342)

22284

* typeof: C Compiler. (line 345)

21825

22285

* uid_t: Particular Types. (line 126)

21826

22286

* uint16_t: Particular Types. (line 138)

21827

22287

* uint32_t: Particular Types. (line 141)

21834

22294

* UMAX4_3: Particular Functions.

21835

22295

(line 144)

21836

22296

* USG: Obsolete Macros. (line 685)

21837

* VARIABLE: Defining Symbols. (line 74)

22297

* VARIABLE: Defining Symbols. (line 32)

21838

22298

* vfork: Particular Functions.

21839

22299

(line 108)

21840

* volatile: C Compiler. (line 262)

21841

* WORDS_BIGENDIAN: C Compiler. (line 181)

22300

* volatile: C Compiler. (line 265)

22301

* WORDS_BIGENDIAN: C Compiler. (line 184)

21842

22302

* X_DISPLAY_MISSING: System Services. (line 30)

21843

22303

* YYTEXT_POINTER: Particular Programs. (line 111)

21844

22304

21857

22317

21858

22318

* ac_cv_alignof_TYPE-OR-EXPR: Generic Compiler Characteristics.

21859

22319

(line 30)

21860

* ac_cv_c_const: C Compiler. (line 214)

22320

* ac_cv_c_const: C Compiler. (line 217)

21861

22321

* ac_cv_c_int16_t: Particular Types. (line 40)

21862

22322

* ac_cv_c_int32_t: Particular Types. (line 43)

21863

22323

* ac_cv_c_int64_t: Particular Types. (line 46)

21864

22324

* ac_cv_c_int8_t: Particular Types. (line 21)

21865

* ac_cv_c_restrict: C Compiler. (line 244)

22325

* ac_cv_c_restrict: C Compiler. (line 247)

21866

22326

* ac_cv_c_uint16_t: Particular Types. (line 138)

21867

22327

* ac_cv_c_uint32_t: Particular Types. (line 141)

21868

22328

* ac_cv_c_uint64_t: Particular Types. (line 144)

21918

22378

* ac_cv_func_working_mktime: Particular Functions.

21919

22379

(line 279)

21920

22380

* ac_cv_have_decl_SYMBOL: Generic Declarations.

21921

(line 29)

22381

(line 11)

21922

22382

* ac_cv_header_HEADER-FILE: Generic Headers. (line 13)

21923

22383

* ac_cv_header_stdbool_h: Particular Headers. (line 91)

21924

22384

* ac_cv_header_stdc: Particular Headers. (line 120)

21933

22393

* ac_cv_path_install: Particular Programs. (line 40)

21934

22394

* ac_cv_path_mkdir: Particular Programs. (line 77)

21935

22395

* ac_cv_path_SED: Particular Programs. (line 188)

21936

* ac_cv_path_VARIABLE: Generic Programs. (line 123)

22396

* ac_cv_path_VARIABLE: Generic Programs. (line 108)

21937

22397

* ac_cv_prog_AWK: Particular Programs. (line 10)

21938

* ac_cv_prog_cc_c89: C Compiler. (line 144)

21939

* ac_cv_prog_cc_c99: C Compiler. (line 158)

21940

* ac_cv_prog_cc_COMPILER_c_o: C Compiler. (line 99)

21941

* ac_cv_prog_cc_stdc: C Compiler. (line 134)

22398

* ac_cv_prog_cc_c89: C Compiler. (line 61)

22399

* ac_cv_prog_cc_c99: C Compiler. (line 161)

22400

* ac_cv_prog_cc_COMPILER_c_o: C Compiler. (line 102)

22401

* ac_cv_prog_cc_stdc: C Compiler. (line 137)

21942

22402

* ac_cv_prog_EGREP: Particular Programs. (line 26)

21943

22403

* ac_cv_prog_FGREP: Particular Programs. (line 33)

21944

22404

* ac_cv_prog_GREP: Particular Programs. (line 17)

21945

22405

* ac_cv_prog_LEX: Particular Programs. (line 111)

21946

* ac_cv_prog_VARIABLE: Generic Programs. (line 36)

22406

* ac_cv_prog_VARIABLE: Generic Programs. (line 24)

21947

22407

* ac_cv_prog_YACC: Particular Programs. (line 197)

21948

22408

* ac_cv_search_FUNCTION: Libraries. (line 52)

21949

22409

* ac_cv_search_getmntent: Particular Functions.

21988

22448

* AC_ARG_WITH: External Software. (line 36)

21989

22449

* AC_AUTOCONF_VERSION: Versioning. (line 21)

21990

22450

* AC_BEFORE: Suggested Ordering. (line 28)

21991

* AC_C_BACKSLASH_A: C Compiler. (line 173)

21992

* AC_C_BIGENDIAN: C Compiler. (line 181)

21993

* AC_C_CHAR_UNSIGNED: C Compiler. (line 288)

21994

* AC_C_CONST: C Compiler. (line 214)

22451

* AC_C_BACKSLASH_A: C Compiler. (line 176)

22452

* AC_C_BIGENDIAN: C Compiler. (line 184)

22453

* AC_C_CHAR_UNSIGNED: C Compiler. (line 291)

22454

* AC_C_CONST: C Compiler. (line 217)

21995

22455

* AC_C_CROSS: Obsolete Macros. (line 30)

21996

* AC_C_FLEXIBLE_ARRAY_MEMBER: C Compiler. (line 312)

21997

* AC_C_INLINE: C Compiler. (line 283)

22456

* AC_C_FLEXIBLE_ARRAY_MEMBER: C Compiler. (line 315)

22457

* AC_C_INLINE: C Compiler. (line 286)

21998

22458

* AC_C_LONG_DOUBLE: Obsolete Macros. (line 33)

21999

* AC_C_PROTOTYPES: C Compiler. (line 348)

22000

* AC_C_RESTRICT: C Compiler. (line 244)

22001

* AC_C_STRINGIZE: C Compiler. (line 302)

22002

* AC_C_TYPEOF: C Compiler. (line 342)

22003

* AC_C_VARARRAYS: C Compiler. (line 336)

22004

* AC_C_VOLATILE: C Compiler. (line 262)

22459

* AC_C_PROTOTYPES: C Compiler. (line 351)

22460

* AC_C_RESTRICT: C Compiler. (line 247)

22461

* AC_C_STRINGIZE: C Compiler. (line 305)

22462

* AC_C_TYPEOF: C Compiler. (line 345)

22463

* AC_C_VARARRAYS: C Compiler. (line 339)

22464

* AC_C_VOLATILE: C Compiler. (line 265)

22005

22465

* AC_CACHE_CHECK: Caching Results. (line 30)

22006

22466

* AC_CACHE_LOAD: Cache Checkpointing. (line 13)

22007

22467

* AC_CACHE_SAVE: Cache Checkpointing. (line 17)

22016

22476

* AC_CHECK_DECL: Generic Declarations.

22017

22477

(line 11)

22018

22478

* AC_CHECK_DECLS: Generic Declarations.

22019

(line 29)

22479

(line 34)

22020

22480

* AC_CHECK_DECLS_ONCE: Generic Declarations.

22021

(line 72)

22481

(line 79)

22022

22482

* AC_CHECK_FILE: Files. (line 13)

22023

22483

* AC_CHECK_FILES: Files. (line 21)

22024

22484

* AC_CHECK_FUNC: Generic Functions. (line 15)

22083

22543

* AC_DISABLE_OPTION_CHECKING: Option Checking. (line 28)

22084

22544

* AC_DYNIX_SEQ: Obsolete Macros. (line 170)

22085

22545

* AC_EGREP_CPP: Running the Preprocessor.

22086

(line 73)

22546

(line 74)

22087

22547

* AC_EGREP_HEADER: Running the Preprocessor.

22088

(line 66)

22548

(line 67)

22089

22549

* AC_EMXOS2: Obsolete Macros. (line 183)

22090

22550

* AC_ENABLE: Obsolete Macros. (line 189)

22091

22551

* AC_ERLANG_CHECK_LIB: Erlang Libraries. (line 36)

22101

22561

* AC_ERLANG_SUBST_INSTALL_LIB_DIR <1>: Erlang Libraries. (line 86)

22102

22562

* AC_ERLANG_SUBST_INSTALL_LIB_DIR: Installation Directory Variables.

22103

22563

(line 201)

22104

* AC_ERLANG_SUBST_INSTALL_LIB_SUBDIR <1>: Installation Directory Variables.

22564

* AC_ERLANG_SUBST_INSTALL_LIB_SUBDIR <1>: Erlang Libraries. (line 93)

22565

* AC_ERLANG_SUBST_INSTALL_LIB_SUBDIR: Installation Directory Variables.

22105

22566

(line 206)

22106

* AC_ERLANG_SUBST_INSTALL_LIB_SUBDIR: Erlang Libraries. (line 94)

22107

22567

* AC_ERLANG_SUBST_LIB_DIR: Erlang Libraries. (line 28)

22108

22568

* AC_ERLANG_SUBST_ROOT_DIR: Erlang Libraries. (line 22)

22109

22569

* AC_ERROR: Obsolete Macros. (line 193)

22110

22570

* AC_EXEEXT: Obsolete Macros. (line 178)

22111

* AC_F77_DUMMY_MAIN: Fortran Compiler. (line 107)

22112

* AC_F77_FUNC: Fortran Compiler. (line 233)

22113

* AC_F77_LIBRARY_LDFLAGS: Fortran Compiler. (line 79)

22114

* AC_F77_MAIN: Fortran Compiler. (line 150)

22115

* AC_F77_WRAPPERS: Fortran Compiler. (line 173)

22571

* AC_F77_DUMMY_MAIN: Fortran Compiler. (line 111)

22572

* AC_F77_FUNC: Fortran Compiler. (line 237)

22573

* AC_F77_LIBRARY_LDFLAGS: Fortran Compiler. (line 80)

22574

* AC_F77_MAIN: Fortran Compiler. (line 154)

22575

* AC_F77_WRAPPERS: Fortran Compiler. (line 177)

22116

22576

* AC_FATAL: Reporting Messages. (line 34)

22117

* AC_FC_FREEFORM: Fortran Compiler. (line 282)

22118

* AC_FC_FUNC: Fortran Compiler. (line 233)

22119

* AC_FC_LIBRARY_LDFLAGS: Fortran Compiler. (line 79)

22120

* AC_FC_MAIN: Fortran Compiler. (line 150)

22121

* AC_FC_SRCEXT: Fortran Compiler. (line 243)

22122

* AC_FC_WRAPPERS: Fortran Compiler. (line 173)

22577

* AC_FC_FIXEDFORM: Fortran Compiler. (line 306)

22578

* AC_FC_FREEFORM: Fortran Compiler. (line 286)

22579

* AC_FC_FUNC: Fortran Compiler. (line 237)

22580

* AC_FC_LIBRARY_LDFLAGS: Fortran Compiler. (line 80)

22581

* AC_FC_LINE_LENGTH: Fortran Compiler. (line 325)

22582

* AC_FC_MAIN: Fortran Compiler. (line 154)

22583

* AC_FC_SRCEXT: Fortran Compiler. (line 247)

22584

* AC_FC_WRAPPERS: Fortran Compiler. (line 177)

22123

22585

* AC_FIND_X: Obsolete Macros. (line 196)

22124

22586

* AC_FIND_XTRA: Obsolete Macros. (line 199)

22125

22587

* AC_FOREACH: Obsolete Macros. (line 202)

22212

22674

* AC_HEADER_TIOCGWINSZ: Particular Headers. (line 255)

22213

22675

* AC_HELP_STRING: Obsolete Macros. (line 261)

22214

22676

* AC_INCLUDES_DEFAULT: Default Includes. (line 29)

22215

* AC_INIT <1>: Initializing configure.

22677

* AC_INIT <1>: Obsolete Macros. (line 264)

22678

* AC_INIT: Initializing configure.

22216

22679

(line 14)

22217

* AC_INIT: Obsolete Macros. (line 264)

22218

22680

* AC_INLINE: Obsolete Macros. (line 272)

22219

22681

* AC_INT_16_BITS: Obsolete Macros. (line 275)

22220

22682

* AC_IRIX_SUN: Obsolete Macros. (line 279)

22221

22683

* AC_ISC_POSIX: Obsolete Macros. (line 295)

22222

22684

* AC_LANG_ASSERT: Language Choice. (line 75)

22223

22685

* AC_LANG_C: Obsolete Macros. (line 302)

22224

* AC_LANG_CALL: Generating Sources. (line 115)

22686

* AC_LANG_CALL: Generating Sources. (line 120)

22225

22687

* AC_LANG_CONFTEST: Generating Sources. (line 12)

22226

22688

* AC_LANG_CPLUSPLUS: Obsolete Macros. (line 305)

22227

22689

* AC_LANG_FORTRAN77: Obsolete Macros. (line 308)

22228

* AC_LANG_FUNC_LINK_TRY: Generating Sources. (line 127)

22690

* AC_LANG_FUNC_LINK_TRY: Generating Sources. (line 132)

22229

22691

* AC_LANG_POP: Language Choice. (line 62)

22230

* AC_LANG_PROGRAM: Generating Sources. (line 53)

22692

* AC_LANG_PROGRAM: Generating Sources. (line 56)

22231

22693

* AC_LANG_PUSH: Language Choice. (line 57)

22232

22694

* AC_LANG_RESTORE: Obsolete Macros. (line 311)

22233

22695

* AC_LANG_SAVE: Obsolete Macros. (line 317)

22234

* AC_LANG_SOURCE: Generating Sources. (line 21)

22696

* AC_LANG_SOURCE: Generating Sources. (line 22)

22235

22697

* AC_LANG_WERROR: Generic Compiler Characteristics.

22236

22698

(line 54)

22237

22699

* AC_LIBOBJ: Generic Functions. (line 56)

22261

22723

* AC_OFF_T: Obsolete Macros. (line 405)

22262

22724

* AC_OPENMP: Generic Compiler Characteristics.

22263

22725

(line 64)

22264

* AC_OUTPUT <1>: Output. (line 13)

22265

* AC_OUTPUT: Obsolete Macros. (line 408)

22726

* AC_OUTPUT <1>: Obsolete Macros. (line 408)

22727

* AC_OUTPUT: Output. (line 13)

22266

22728

* AC_OUTPUT_COMMANDS: Obsolete Macros. (line 420)

22267

22729

* AC_PACKAGE_BUGREPORT: Initializing configure.

22268

(line 49)

22730

(line 57)

22269

22731

* AC_PACKAGE_NAME: Initializing configure.

22270

(line 37)

22732

(line 45)

22271

22733

* AC_PACKAGE_STRING: Initializing configure.

22272

(line 46)

22734

(line 54)

22273

22735

* AC_PACKAGE_TARNAME: Initializing configure.

22274

(line 40)

22736

(line 48)

22275

22737

* AC_PACKAGE_URL: Initializing configure.

22276

(line 52)

22738

(line 60)

22277

22739

* AC_PACKAGE_VERSION: Initializing configure.

22278

(line 43)

22740

(line 51)

22279

22741

* AC_PATH_PROG: Generic Programs. (line 108)

22280

22742

* AC_PATH_PROGS: Generic Programs. (line 115)

22281

22743

* AC_PATH_PROGS_FEATURE_CHECK: Generic Programs. (line 123)

22293

22755

* AC_PRESERVE_HELP_ORDER: Help Formatting. (line 20)

22294

22756

* AC_PROG_AWK: Particular Programs. (line 10)

22295

22757

* AC_PROG_CC: C Compiler. (line 61)

22296

* AC_PROG_CC_C89: C Compiler. (line 144)

22297

* AC_PROG_CC_C99: C Compiler. (line 158)

22298

* AC_PROG_CC_C_O: C Compiler. (line 99)

22299

* AC_PROG_CC_STDC: C Compiler. (line 134)

22300

* AC_PROG_CPP: C Compiler. (line 110)

22301

* AC_PROG_CPP_WERROR: C Compiler. (line 123)

22758

* AC_PROG_CC_C89: C Compiler. (line 147)

22759

* AC_PROG_CC_C99: C Compiler. (line 161)

22760

* AC_PROG_CC_C_O: C Compiler. (line 102)

22761

* AC_PROG_CC_STDC: C Compiler. (line 137)

22762

* AC_PROG_CPP: C Compiler. (line 113)

22763

* AC_PROG_CPP_WERROR: C Compiler. (line 126)

22302

22764

* AC_PROG_CXX: C++ Compiler. (line 7)

22303

* AC_PROG_CXX_C_O: C++ Compiler. (line 44)

22304

* AC_PROG_CXXCPP: C++ Compiler. (line 31)

22765

* AC_PROG_CXX_C_O: C++ Compiler. (line 48)

22766

* AC_PROG_CXXCPP: C++ Compiler. (line 35)

22305

22767

* AC_PROG_EGREP: Particular Programs. (line 26)

22306

* AC_PROG_F77: Fortran Compiler. (line 18)

22307

* AC_PROG_F77_C_O: Fortran Compiler. (line 66)

22308

* AC_PROG_FC: Fortran Compiler. (line 39)

22309

* AC_PROG_FC_C_O: Fortran Compiler. (line 66)

22768

* AC_PROG_F77: Fortran Compiler. (line 19)

22769

* AC_PROG_F77_C_O: Fortran Compiler. (line 67)

22770

* AC_PROG_FC: Fortran Compiler. (line 40)

22771

* AC_PROG_FC_C_O: Fortran Compiler. (line 67)

22310

22772

* AC_PROG_FGREP: Particular Programs. (line 33)

22311

* AC_PROG_GCC_TRADITIONAL: C Compiler. (line 358)

22773

* AC_PROG_GCC_TRADITIONAL: C Compiler. (line 361)

22312

22774

* AC_PROG_GREP: Particular Programs. (line 17)

22313

22775

* AC_PROG_INSTALL: Particular Programs. (line 40)

22314

22776

* AC_PROG_LEX: Particular Programs. (line 111)

22454

22916

* __oline__: Redefined M4 Macros. (line 69)

22455

22917

* AS_BOURNE_COMPATIBLE: Initialization Macros.

22456

22918

(line 7)

22919

* AS_BOX: Common Shell Constructs.

22920

(line 10)

22457

22921

* AS_CASE: Common Shell Constructs.

22458

(line 10)

22922

(line 19)

22459

22923

* AS_DIRNAME: Common Shell Constructs.

22460

(line 17)

22924

(line 26)

22461

22925

* AS_ECHO: Common Shell Constructs.

22462

(line 25)

22926

(line 34)

22463

22927

* AS_ECHO_N: Common Shell Constructs.

22464

(line 33)

22928

(line 42)

22465

22929

* AS_ESCAPE: Common Shell Constructs.

22466

(line 41)

22930

(line 50)

22467

22931

* AS_EXIT: Common Shell Constructs.

22468

(line 81)

22932

(line 90)

22469

22933

* AS_HELP_STRING: Pretty Help Strings. (line 15)

22470

22934

* AS_IF: Common Shell Constructs.

22471

(line 87)

22935

(line 96)

22472

22936

* AS_INIT: Initialization Macros.

22473

22937

(line 14)

22474

22938

* AS_INIT_GENERATED: Initialization Macros.

22476

22940

* AS_LINENO_PREPARE: Initialization Macros.

22477

22941

(line 67)

22478

22942

* AS_LITERAL_IF: Polymorphic Variables.

22479

(line 18)

22943

(line 21)

22944

* AS_LITERAL_WORD_IF: Polymorphic Variables.

22945

(line 21)

22480

22946

* AS_ME_PREPARE: Initialization Macros.

22481

22947

(line 72)

22482

22948

* AS_MESSAGE_FD: File Descriptor Macros.

22484

22950

* AS_MESSAGE_LOG_FD: File Descriptor Macros.

22485

22951

(line 29)

22486

22952

* AS_MKDIR_P: Common Shell Constructs.

22487

(line 101)

22953

(line 110)

22488

22954

* AS_ORIGINAL_STDIN_FD: File Descriptor Macros.

22489

22955

(line 39)

22490

22956

* AS_SET_CATFILE: Common Shell Constructs.

22491

(line 139)

22957

(line 150)

22492

22958

* AS_SET_STATUS: Common Shell Constructs.

22493

(line 113)

22959

(line 122)

22494

22960

* AS_SHELL_SANITIZE: Initialization Macros.

22495

22961

(line 77)

22496

22962

* AS_TR_CPP: Common Shell Constructs.

22497

(line 121)

22963

(line 130)

22498

22964

* AS_TR_SH: Common Shell Constructs.

22499

(line 130)

22965

(line 139)

22500

22966

* AS_UNSET: Common Shell Constructs.

22501

(line 143)

22967

(line 154)

22502

22968

* AS_VAR_APPEND: Polymorphic Variables.

22503

(line 35)

22969

(line 63)

22504

22970

* AS_VAR_ARITH: Polymorphic Variables.

22505

(line 57)

22971

(line 85)

22506

22972

* AS_VAR_COPY: Polymorphic Variables.

22507

(line 75)

22973

(line 103)

22508

22974

* AS_VAR_IF: Polymorphic Variables.

22509

(line 94)

22975

(line 122)

22510

22976

* AS_VAR_POPDEF: Polymorphic Variables.

22511

(line 102)

22977

(line 130)

22512

22978

* AS_VAR_PUSHDEF: Polymorphic Variables.

22513

(line 102)

22979

(line 130)

22514

22980

* AS_VAR_SET: Polymorphic Variables.

22515

(line 144)

22981

(line 172)

22516

22982

* AS_VAR_SET_IF: Polymorphic Variables.

22517

(line 154)

22983

(line 182)

22518

22984

* AS_VAR_TEST_SET: Polymorphic Variables.

22519

(line 159)

22985

(line 187)

22520

22986

* AS_VERSION_COMPARE: Common Shell Constructs.

22521

(line 149)

22987

(line 160)

22522

22988

* dnl: Redefined M4 Macros. (line 76)

22523

22989

* m4_append: Text processing Macros.

22524

22990

(line 16)

22546

23012

(line 80)

22547

23013

* m4_chomp_all: Text processing Macros.

22548

23014

(line 80)

22549

* m4_cleardivert: Diversion support. (line 97)

23015

* m4_cleardivert: Diversion support. (line 125)

22550

23016

* m4_cmp: Number processing Macros.

22551

23017

(line 11)

22552

23018

* m4_combine: Text processing Macros.

22571

23037

* m4_define: Redefined M4 Macros. (line 6)

22572

23038

* m4_defn: Redefined M4 Macros. (line 111)

22573

23039

* m4_divert: Redefined M4 Macros. (line 119)

22574

* m4_divert_once: Diversion support. (line 100)

22575

* m4_divert_pop: Diversion support. (line 105)

22576

* m4_divert_push: Diversion support. (line 111)

22577

* m4_divert_text: Diversion support. (line 117)

23040

* m4_divert_once: Diversion support. (line 128)

23041

* m4_divert_pop: Diversion support. (line 133)

23042

* m4_divert_push: Diversion support. (line 139)

23043

* m4_divert_text: Diversion support. (line 145)

22578

23044

* m4_divnum: Redefined M4 Macros. (line 6)

22579

23045

* m4_do: Evaluation Macros. (line 45)

22580

23046

* m4_dquote: Evaluation Macros. (line 65)

22581

23047

* m4_dquote_elt: Evaluation Macros. (line 70)

22582

* m4_dumpdef: Redefined M4 Macros. (line 127)

22583

* m4_dumpdefs: Redefined M4 Macros. (line 127)

23048

* m4_dumpdef: Redefined M4 Macros. (line 131)

23049

* m4_dumpdefs: Redefined M4 Macros. (line 131)

22584

23050

* m4_echo: Evaluation Macros. (line 75)

22585

23051

* m4_errprint: Redefined M4 Macros. (line 6)

22586

23052

* m4_errprintn: Diagnostic Macros. (line 16)

22587

23053

* m4_escape: Text processing Macros.

22588

23054

(line 108)

22589

23055

* m4_esyscmd: Redefined M4 Macros. (line 6)

22590

* m4_esyscmd_s: Redefined M4 Macros. (line 144)

23056

* m4_esyscmd_s: Redefined M4 Macros. (line 148)

22591

23057

* m4_eval: Redefined M4 Macros. (line 6)

22592

* m4_exit: Redefined M4 Macros. (line 150)

23058

* m4_exit: Redefined M4 Macros. (line 154)

22593

23059

* m4_expand: Evaluation Macros. (line 79)

22594

23060

* m4_fatal: Diagnostic Macros. (line 20)

22595

23061

* m4_flatten: Text processing Macros.

22598

23064

* m4_foreach: Looping constructs. (line 69)

22599

23065

* m4_foreach_w: Looping constructs. (line 83)

22600

23066

* m4_format: Redefined M4 Macros. (line 6)

22601

* m4_if: Redefined M4 Macros. (line 156)

23067

* m4_if: Redefined M4 Macros. (line 160)

22602

23068

* m4_ifblank: Conditional constructs.

22603

23069

(line 123)

22604

23070

* m4_ifdef: Redefined M4 Macros. (line 6)

22613

23079

* m4_ifvaln: Conditional constructs.

22614

23080

(line 146)

22615

23081

* m4_ignore: Evaluation Macros. (line 129)

22616

* m4_include: Redefined M4 Macros. (line 163)

23082

* m4_include: Redefined M4 Macros. (line 167)

22617

23083

* m4_incr: Redefined M4 Macros. (line 6)

22618

23084

* m4_index: Redefined M4 Macros. (line 6)

22619

23085

* m4_indir: Redefined M4 Macros. (line 6)

22620

* m4_init: Diversion support. (line 123)

23086

* m4_init: Diversion support. (line 171)

22621

23087

* m4_join: Text processing Macros.

22622

23088

(line 119)

22623

23089

* m4_joinall: Text processing Macros.

22627

23093

(line 16)

22628

23094

* m4_location: Diagnostic Macros. (line 24)

22629

23095

* m4_make_list: Evaluation Macros. (line 142)

22630

* m4_maketemp: Redefined M4 Macros. (line 167)

23096

* m4_maketemp: Redefined M4 Macros. (line 171)

22631

23097

* m4_map: Looping constructs. (line 93)

22632

23098

* m4_map_args: Looping constructs. (line 130)

22633

23099

* m4_map_args_pair: Looping constructs. (line 166)

22640

23106

(line 38)

22641

23107

* m4_min: Number processing Macros.

22642

23108

(line 42)

22643

* m4_mkstemp: Redefined M4 Macros. (line 167)

23109

* m4_mkstemp: Redefined M4 Macros. (line 171)

22644

23110

* m4_n: Conditional constructs.

22645

23111

(line 150)

22646

23112

* m4_newline: Text processing Macros.

22649

23115

(line 140)

22650

23116

* m4_pattern_allow: Forbidden Patterns. (line 30)

22651

23117

* m4_pattern_forbid: Forbidden Patterns. (line 17)

22652

* m4_popdef: Redefined M4 Macros. (line 178)

23118

* m4_popdef: Redefined M4 Macros. (line 182)

22653

23119

* m4_pushdef: Redefined M4 Macros. (line 6)

22654

23120

* m4_quote: Evaluation Macros. (line 161)

22655

23121

* m4_re_escape: Text processing Macros.

22697

23163

* m4_shiftn: Looping constructs. (line 199)

22698

23164

* m4_sign: Number processing Macros.

22699

23165

(line 46)

22700

* m4_sinclude: Redefined M4 Macros. (line 163)

23166

* m4_sinclude: Redefined M4 Macros. (line 167)

22701

23167

* m4_split: Text processing Macros.

22702

23168

(line 152)

22703

23169

* m4_stack_foreach: Looping constructs. (line 208)

22712

23178

* m4_text_box: Text processing Macros.

22713

23179

(line 167)

22714

23180

* m4_text_wrap: Text processing Macros.

22715

(line 181)

23181

(line 182)

22716

23182

* m4_tolower: Text processing Macros.

22717

(line 212)

23183

(line 213)

22718

23184

* m4_toupper: Text processing Macros.

22719

(line 212)

23185

(line 213)

22720

23186

* m4_traceoff: Redefined M4 Macros. (line 6)

22721

23187

* m4_traceon: Redefined M4 Macros. (line 6)

22722

23188

* m4_translit: Redefined M4 Macros. (line 6)

22723

* m4_undefine: Redefined M4 Macros. (line 182)

22724

* m4_undivert: Redefined M4 Macros. (line 190)

23189

* m4_undefine: Redefined M4 Macros. (line 186)

23190

* m4_undivert: Redefined M4 Macros. (line 194)

22725

23191

* m4_unquote: Evaluation Macros. (line 176)

22726

23192

* m4_version_compare: Number processing Macros.

22727

23193

(line 50)

22728

23194

* m4_version_prereq: Number processing Macros.

22729

23195

(line 90)

22730

23196

* m4_warn: Diagnostic Macros. (line 28)

22731

* m4_wrap: Redefined M4 Macros. (line 198)

22732

* m4_wrap_lifo: Redefined M4 Macros. (line 198)

23197

* m4_wrap: Redefined M4 Macros. (line 204)

23198

* m4_wrap_lifo: Redefined M4 Macros. (line 204)

22733

23199

22734

23200

22735

23201

File: autoconf.info, Node: Autotest Macro Index, Next: Program & Function Index, Prev: M4 Macro Index, Up: Indices

22742

23208

[index]

22743

23209

* Menu:

22744

23210

22745

* AT_BANNER: Writing Testsuites. (line 64)

22746

* AT_CAPTURE_FILE: Writing Testsuites. (line 94)

22747

* AT_CHECK: Writing Testsuites. (line 151)

22748

* AT_CHECK_EUNIT: Writing Testsuites. (line 238)

22749

* AT_CHECK_UNQUOTED: Writing Testsuites. (line 151)

22750

* AT_CLEANUP: Writing Testsuites. (line 137)

23211

* AT_ARG_OPTION: Writing Testsuites. (line 50)

23212

* AT_ARG_OPTION_ARG: Writing Testsuites. (line 79)

23213

* AT_BANNER: Writing Testsuites. (line 124)

23214

* AT_CAPTURE_FILE: Writing Testsuites. (line 155)

23215

* AT_CHECK: Writing Testsuites. (line 212)

23216

* AT_CHECK_EUNIT: Writing Testsuites. (line 299)

23217

* AT_CHECK_UNQUOTED: Writing Testsuites. (line 212)

23218

* AT_CLEANUP: Writing Testsuites. (line 198)

23219

* AT_COLOR_TESTS: Writing Testsuites. (line 105)

22751

23220

* AT_COPYRIGHT: Writing Testsuites. (line 41)

22752

* AT_DATA: Writing Testsuites. (line 141)

22753

* AT_FAIL_IF: Writing Testsuites. (line 99)

23221

* AT_DATA: Writing Testsuites. (line 202)

23222

* AT_FAIL_IF: Writing Testsuites. (line 160)

22754

23223

* AT_INIT: Writing Testsuites. (line 31)

22755

* AT_KEYWORDS: Writing Testsuites. (line 82)

23224

* AT_KEYWORDS: Writing Testsuites. (line 142)

22756

23225

* AT_PACKAGE_BUGREPORT: Making testsuite Scripts.

22757

23226

(line 12)

22758

23227

* AT_PACKAGE_NAME: Making testsuite Scripts.

22765

23234

(line 12)

22766

23235

* AT_PACKAGE_VERSION: Making testsuite Scripts.

22767

23236

(line 12)

22768

* AT_SETUP: Writing Testsuites. (line 74)

22769

* AT_SKIP_IF: Writing Testsuites. (line 114)

22770

* AT_TESTED: Writing Testsuites. (line 49)

22771

* AT_XFAIL_IF: Writing Testsuites. (line 129)

23237

* AT_SETUP: Writing Testsuites. (line 134)

23238

* AT_SKIP_IF: Writing Testsuites. (line 175)

23239

* AT_TESTED: Writing Testsuites. (line 109)

23240

* AT_XFAIL_IF: Writing Testsuites. (line 190)

22772

23241

22773

23242

22774

23243

File: autoconf.info, Node: Program & Function Index, Next: Concept Index, Prev: Autotest Macro Index, Up: Indices

22847

23316

* export: Limitations of Builtins.

22848

23317

(line 370)

22849

23318

* expr: Limitations of Usual Tools.

22850

(line 335)

23319

(line 302)

22851

23320

* expr (|): Limitations of Usual Tools.

22852

23321

(line 316)

22853

23322

* false: Limitations of Builtins.

22855

23324

* fgrep: Limitations of Usual Tools.

22856

23325

(line 425)

22857

23326

* find: Limitations of Usual Tools.

22858

(line 432)

23327

(line 434)

22859

23328

* float.h: Particular Headers. (line 120)

22860

23329

* fnmatch: Particular Functions.

22861

23330

(line 82)

22882

23351

* getpgrp: Particular Functions.

22883

23352

(line 188)

22884

23353

* grep: Limitations of Usual Tools.

22885

(line 446)

23354

(line 448)

22886

23355

* if: Limitations of Builtins.

22887

(line 436)

23356

(line 455)

22888

23357

* inttypes.h <1>: Particular Types. (line 6)

22889

23358

* inttypes.h: Header Portability. (line 16)

22890

23359

* isinf: Function Portability.

22892

23361

* isnan: Function Portability.

22893

23362

(line 27)

22894

23363

* join: Limitations of Usual Tools.

22895

(line 510)

23364

(line 516)

22896

23365

* ksh: Shellology. (line 57)

22897

23366

* ksh88: Shellology. (line 57)

22898

23367

* ksh93: Shellology. (line 57)

22899

23368

* linux/irda.h: Header Portability. (line 23)

22900

23369

* linux/random.h: Header Portability. (line 26)

22901

23370

* ln: Limitations of Usual Tools.

22902

(line 523)

23371

(line 529)

22903

23372

* ls: Limitations of Usual Tools.

22904

(line 535)

23373

(line 541)

22905

23374

* lstat: Particular Functions.

22906

23375

(line 211)

22907

23376

* make: Portable Make. (line 6)

22908

* malloc <1>: Function Portability.

23377

* malloc <1>: Particular Functions.

23378

(line 227)

23379

* malloc: Function Portability.

22909

23380

(line 77)

22910

* malloc: Particular Functions.

22911

(line 227)

22912

23381

* mbrtowc: Particular Functions.

22913

23382

(line 259)

22914

23383

* memcmp: Particular Functions.

22915

23384

(line 266)

22916

23385

* mkdir: Limitations of Usual Tools.

22917

(line 557)

23386

(line 563)

22918

23387

* mkfifo: Limitations of Usual Tools.

22919

(line 591)

23388

(line 597)

22920

23389

* mknod: Limitations of Usual Tools.

22921

(line 591)

23390

(line 597)

22922

23391

* mktemp: Limitations of Usual Tools.

22923

(line 601)

23392

(line 607)

22924

23393

* mktime: Particular Functions.

22925

23394

(line 279)

22926

23395

* mmap: Particular Functions.

22927

23396

(line 288)

22928

23397

* mv: Limitations of Usual Tools.

22929

(line 625)

23398

(line 631)

22930

23399

* ndir.h: Particular Headers. (line 15)

22931

23400

* net/if.h: Header Portability. (line 29)

22932

23401

* netinet/if_ether.h: Header Portability. (line 49)

22933

23402

* nlist.h: Particular Functions.

22934

23403

(line 161)

22935

23404

* od: Limitations of Usual Tools.

22936

(line 657)

23405

(line 663)

22937

23406

* pdksh: Shellology. (line 77)

22938

23407

* printf: Limitations of Builtins.

22939

(line 475)

23408

(line 494)

22940

23409

* putenv: Function Portability.

22941

23410

(line 84)

22942

23411

* pwd: Limitations of Builtins.

22943

(line 502)

23412

(line 521)

22944

23413

* read: Limitations of Builtins.

22945

(line 533)

22946

* realloc <1>: Function Portability.

23414

(line 552)

23415

* realloc <1>: Particular Functions.

23416

(line 303)

23417

* realloc: Function Portability.

22947

23418

(line 100)

22948

* realloc: Particular Functions.

22949

(line 303)

22950

23419

* resolv.h: Particular Headers. (line 63)

22951

23420

* rm: Limitations of Usual Tools.

22952

(line 666)

23421

(line 672)

22953

23422

* rmdir: Limitations of Usual Tools.

22954

(line 683)

23423

(line 689)

22955

23424

* sed: Limitations of Usual Tools.

22956

(line 687)

23425

(line 693)

22957

23426

* sed (t): Limitations of Usual Tools.

22958

(line 835)

23427

(line 865)

22959

23428

* select: Particular Functions.

22960

23429

(line 314)

22961

23430

* set: Limitations of Builtins.

22962

(line 537)

23431

(line 556)

22963

23432

* setpgrp: Particular Functions.

22964

23433

(line 325)

22965

23434

* setvbuf: Obsolete Macros. (line 208)

22966

23435

* shift: Limitations of Builtins.

22967

(line 659)

23436

(line 690)

22968

23437

* sigaction: Function Portability.

22969

23438

(line 105)

22970

23439

* signal: Function Portability.

22971

23440

(line 105)

22972

23441

* signal.h: Obsolete Macros. (line 662)

22973

23442

* sleep: Limitations of Usual Tools.

22974

(line 895)

23443

(line 925)

22975

23444

* snprintf: Function Portability.

22976

23445

(line 119)

22977

23446

* sort: Limitations of Usual Tools.

22978

(line 901)

23447

(line 931)

22979

23448

* source: Limitations of Builtins.

22980

(line 667)

23449

(line 698)

22981

23450

* sprintf: Function Portability.

22982

23451

(line 130)

22983

23452

* sscanf: Function Portability.

22988

23457

* stdbool.h: Particular Headers. (line 91)

22989

23458

* stdint.h <1>: Particular Types. (line 6)

22990

23459

* stdint.h: Header Portability. (line 16)

22991

* stdlib.h <1>: Particular Headers. (line 120)

22992

* stdlib.h <2>: Header Portability. (line 72)

22993

* stdlib.h: Particular Types. (line 6)

23460

* stdlib.h <1>: Particular Types. (line 6)

23461

* stdlib.h <2>: Particular Headers. (line 120)

23462

* stdlib.h: Header Portability. (line 72)

22994

23463

* strcoll: Particular Functions.

22995

23464

(line 356)

22996

23465

* strerror_r <1>: Particular Functions.

23018

23487

* sys/socket.h: Header Portability. (line 82)

23019

23488

* sys/stat.h: Particular Headers. (line 82)

23020

23489

* sys/sysmacros.h: Particular Headers. (line 58)

23021

* sys/time.h <1>: Particular Headers. (line 229)

23022

* sys/time.h: Particular Structures.

23490

* sys/time.h <1>: Particular Structures.

23023

23491

(line 35)

23492

* sys/time.h: Particular Headers. (line 229)

23024

23493

* sys/types.h: Particular Types. (line 6)

23025

23494

* sys/ucred.h: Header Portability. (line 85)

23026

23495

* sys/wait.h: Particular Headers. (line 189)

23028

23497

(line 165)

23029

23498

* system.h: Particular Headers. (line 91)

23030

23499

* tar: Limitations of Usual Tools.

23031

(line 906)

23500

(line 936)

23032

23501

* termios.h: Particular Headers. (line 255)

23033

23502

* test: Limitations of Builtins.

23034

(line 671)

23503

(line 702)

23035

23504

* time.h <1>: Particular Structures.

23036

23505

(line 35)

23037

23506

* time.h: Particular Headers. (line 229)

23038

23507

* touch: Limitations of Usual Tools.

23039

(line 911)

23508

(line 941)

23040

23509

* tr: Limitations of Usual Tools.

23041

(line 924)

23510

(line 954)

23042

23511

* trap: Limitations of Builtins.

23043

(line 765)

23512

(line 796)

23044

23513

* true: Limitations of Builtins.

23045

(line 839)

23514

(line 870)

23046

23515

* unistd.h: Particular Headers. (line 213)

23047

23516

* unlink: Function Portability.

23048

23517

(line 169)

23049

23518

* unset: Limitations of Builtins.

23050

(line 850)

23519

(line 881)

23051

23520

* unsetenv: Function Portability.

23052

23521

(line 175)

23053

23522

* utime: Particular Functions.

23069

23538

* vsprintf: Function Portability.

23070

23539

(line 130)

23071

23540

* wait: Limitations of Builtins.

23072

(line 875)

23541

(line 906)

23073

23542

* wait3: Obsolete Macros. (line 216)

23074

23543

* wchar.h: Particular Types. (line 88)

23075

23544

* X11/extensions/scrnsaver.h: Header Portability. (line 88)

23088

23557

[index]

23089

23558

* Menu:

23090

23559

23091

* "$@": Shell Substitutions. (line 31)

23092

* $((EXPRESSION)): Shell Substitutions. (line 263)

23093

* $(COMMANDS): Shell Substitutions. (line 230)

23560

* "$@": Shell Substitutions. (line 47)

23561

* $((EXPRESSION)): Shell Substitutions. (line 279)

23562

* $(COMMANDS): Shell Substitutions. (line 246)

23094

23563

* $<, explicit rules, and VPATH: $< in Explicit Rules.

23095

23564

(line 6)

23096

* ${#VAR}: Shell Substitutions. (line 176)

23097

* ${VAR##WORD}: Shell Substitutions. (line 176)

23098

* ${VAR#WORD}: Shell Substitutions. (line 176)

23099

* ${VAR%%WORD}: Shell Substitutions. (line 176)

23100

* ${VAR%WORD}: Shell Substitutions. (line 176)

23101

* ${VAR=EXPANDED-VALUE}: Shell Substitutions. (line 126)

23102

* ${VAR=LITERAL}: Shell Substitutions. (line 96)

23565

* ${#VAR}: Shell Substitutions. (line 192)

23566

* ${VAR##WORD}: Shell Substitutions. (line 192)

23567

* ${VAR#WORD}: Shell Substitutions. (line 192)

23568

* ${VAR%%WORD}: Shell Substitutions. (line 192)

23569

* ${VAR%WORD}: Shell Substitutions. (line 192)

23570

* ${VAR=EXPANDED-VALUE}: Shell Substitutions. (line 142)

23571

* ${VAR=LITERAL}: Shell Substitutions. (line 112)

23103

23572

* 64-bit libraries: Site Defaults. (line 97)

23104

23573

* @&t@: Quadrigraphs. (line 6)

23105

23574

* @S|@: Quadrigraphs. (line 6)

23106

* ^ quoting: Shell Substitutions. (line 303)

23575

* ^ quoting: Shell Substitutions. (line 319)

23107

23576

* _m4_divert_diversion: New Macros. (line 6)

23108

* `COMMANDS`: Shell Substitutions. (line 184)

23577

* `COMMANDS`: Shell Substitutions. (line 200)

23109

23578

* absolute file names, detect: File System Conventions.

23110

23579

(line 52)

23111

23580

* acconfig.h: acconfig Header. (line 6)

23113

23582

(line 6)

23114

23583

* Ash: Shellology. (line 16)

23115

23584

* autoconf: autoconf Invocation. (line 6)

23116

* Autoconf upgrading <1>: Autoconf 1. (line 6)

23117

* Autoconf upgrading: Autoconf 2.13. (line 6)

23585

* Autoconf upgrading <1>: Autoconf 2.13. (line 6)

23586

* Autoconf upgrading: Autoconf 1. (line 6)

23118

23587

* Autoconf version: Versioning. (line 6)

23119

23588

* autoheader: autoheader Invocation.

23120

23589

(line 6)

23158

23627

(line 25)

23159

23628

* Canonical system type: Canonicalizing. (line 6)

23160

23629

* carriage return, deleting: Limitations of Usual Tools.

23161

(line 924)

23630

(line 954)

23162

23631

* changequote: Changequote is Evil. (line 6)

23163

23632

* Coding style: Coding Style. (line 6)

23164

* Command Substitution: Shell Substitutions. (line 184)

23633

* Command Substitution: Shell Substitutions. (line 200)

23165

23634

* Commands for configuration: Configuration Commands.

23166

23635

(line 6)

23167

23636

* Comments in Makefile rules: Comments in Make Rules.

23170

23639

* Compilers: Compilers and Preprocessors.

23171

23640

(line 6)

23172

23641

* composing variable names: Polymorphic Variables.

23173

(line 102)

23642

(line 130)

23174

23643

* config.h: Configuration Headers.

23175

23644

(line 6)

23176

23645

* config.h.bot: acconfig Header. (line 6)

23190

23659

(line 6)

23191

23660

* Configuration Header Template: Header Templates. (line 6)

23192

23661

* Configuration links: Configuration Links. (line 6)

23193

* configure <1>: Making configure Scripts.

23662

* configure <1>: Running configure Scripts.

23194

23663

(line 6)

23195

* configure: Running configure Scripts.

23664

* configure: Making configure Scripts.

23196

23665

(line 6)

23197

23666

* Configure subdirectories: Subdirectories. (line 6)

23198

23667

* configure.ac: Making configure Scripts.

23203

23672

* Copyright Notice: Notices. (line 10)

23204

23673

* Creating configuration files: Configuration Files. (line 6)

23205

23674

* Creating temporary files: Limitations of Usual Tools.

23206

(line 601)

23675

(line 607)

23207

23676

* Cross compilation: Hosts and Cross-Compilation.

23208

23677

(line 6)

23209

23678

* Darwin: Systemology. (line 23)

23216

23685

* Declaration, checking: Declarations. (line 6)

23217

23686

* Default includes: Default Includes. (line 6)

23218

23687

* deleting carriage return: Limitations of Usual Tools.

23219

(line 924)

23688

(line 954)

23220

23689

* Dependencies between macros: Dependencies Between Macros.

23221

23690

(line 6)

23222

23691

* Descriptors: File Descriptors. (line 6)

23227

23696

(line 6)

23228

23697

* division, integer: Signed Integer Division.

23229

23698

(line 6)

23230

* dnl <1>: Coding Style. (line 41)

23699

* dnl <1>: Coding Style. (line 42)

23231

23700

* dnl: Macro Definitions. (line 51)

23232

23701

* double-colon rules and VPATH: VPATH and Double-colon.

23233

23702

(line 6)

23234

* Endianness: C Compiler. (line 181)

23703

* Endianness: C Compiler. (line 184)

23235

23704

* Erlang: Erlang Compiler and Interpreter.

23236

23705

(line 6)

23237

23706

* Erlang, Library, checking: Erlang Libraries. (line 6)

23243

23712

* External software: External Software. (line 6)

23244

23713

* F77: Fortran Compiler. (line 6)

23245

23714

* FHS: Site Defaults. (line 83)

23715

* File descriptors: File Descriptors. (line 6)

23246

23716

* file descriptors: File Descriptor Macros.

23247

23717

(line 6)

23248

* File descriptors: File Descriptors. (line 6)

23249

23718

* File system conventions: File System Conventions.

23250

23719

(line 6)

23251

23720

* File, checking: Files. (line 6)

23278

23747

* Installation directories: Installation Directory Variables.

23279

23748

(line 6)

23280

23749

* Instantiation: Output. (line 13)

23281

* integer overflow <1>: Signed Overflow Examples.

23282

(line 6)

23283

* integer overflow <2>: Integer Overflow Basics.

23284

(line 6)

23285

* integer overflow <3>: Signed Overflow Advice.

23750

* integer overflow <1>: Signed Overflow Advice.

23751

(line 6)

23752

* integer overflow <2>: Signed Overflow Examples.

23753

(line 6)

23754

* integer overflow <3>: Integer Overflow Basics.

23286

23755

(line 6)

23287

23756

* integer overflow: Integer Overflow. (line 6)

23288

23757

* Introduction: Introduction. (line 6)

23303

23772

* Links: Configuration Links. (line 12)

23304

23773

* Links for configuration: Configuration Links. (line 6)

23305

23774

* Listing directories: Limitations of Usual Tools.

23306

(line 535)

23775

(line 541)

23307

23776

* loop induction: Optimization and Wraparound.

23308

23777

(line 6)

23309

23778

* low-level output: File Descriptor Macros.

23327

23796

(line 6)

23328

23797

* Makefile rules and comments: Comments in Make Rules.

23329

23798

(line 6)

23799

* Makefile rules and newlines: Newlines in Make Rules.

23800

(line 6)

23330

23801

* Makefile substitutions: Makefile Substitutions.

23331

23802

(line 6)

23332

23803

* MAKEFLAGS and make: The Make Macro MAKEFLAGS.

23333

23804

(line 6)

23334

23805

* Making directories: Limitations of Usual Tools.

23335

(line 557)

23806

(line 563)

23336

23807

* Messages, from autoconf: Reporting Messages. (line 6)

23337

23808

* Messages, from configure: Printing Messages. (line 6)

23338

23809

* Messages, from M4sugar: Diagnostic Macros. (line 6)

23339

23810

* Moving open files: Limitations of Usual Tools.

23340

(line 625)

23811

(line 631)

23812

* newline, deleting: Limitations of Usual Tools.

23813

(line 954)

23814

* Newlines in Makefile rules: Newlines in Make Rules.

23815

(line 6)

23341

23816

* Notices in configure: Notices. (line 6)

23342

23817

* null pointers: Null Pointers. (line 6)

23343

23818

* obj/, subdirectory: obj/ and Make. (line 6)

23346

23821

* obstack: Particular Functions.

23347

23822

(line 296)

23348

23823

* One-shot macros: One-Shot Macros. (line 6)

23824

* Options, Package: Option Checking. (line 6)

23349

23825

* Options, package: Package Options. (line 6)

23350

* Options, Package: Option Checking. (line 6)

23351

23826

* Ordering macros: Suggested Ordering. (line 6)

23352

23827

* Output variables <1>: Setting Output Variables.

23353

23828

(line 6)

23358

23833

* output, low-level: File Descriptor Macros.

23359

23834

(line 6)

23360

23835

* Outputting files: Output. (line 6)

23361

* overflow, signed integer <1>: Integer Overflow. (line 6)

23836

* overflow, signed integer <1>: Signed Overflow Advice.

23837

(line 6)

23362

23838

* overflow, signed integer <2>: Signed Overflow Examples.

23363

23839

(line 6)

23364

* overflow, signed integer <3>: Signed Overflow Advice.

23365

(line 6)

23366

* overflow, signed integer: Integer Overflow Basics.

23367

(line 6)

23840

* overflow, signed integer <3>: Integer Overflow Basics.

23841

(line 6)

23842

* overflow, signed integer: Integer Overflow. (line 6)

23368

23843

* Package options: Package Options. (line 6)

23369

23844

* package.m4: Making testsuite Scripts.

23370

23845

(line 12)

23381

23856

* Portability of headers: Header Portability. (line 6)

23382

23857

* Portable C and C++ programming: Portable C and C++. (line 6)

23383

23858

* Portable shell programming: Portable Shell. (line 6)

23384

* positional parameters: Shell Substitutions. (line 82)

23859

* positional parameters: Shell Substitutions. (line 98)

23385

23860

* Posix termios headers: System Services. (line 75)

23386

23861

* Precious Variable: Setting Output Variables.

23387

23862

(line 65)

23398

23873

(line 6)

23399

23874

* QNX 4.25: Systemology. (line 37)

23400

23875

* quadrigraphs: Quadrigraphs. (line 6)

23401

* quotation <1>: Autoconf Language. (line 6)

23402

* quotation: M4 Quotation. (line 6)

23876

* quotation <1>: M4 Quotation. (line 6)

23877

* quotation: Autoconf Language. (line 6)

23403

23878

* Remaking automatically: Automatic Remaking. (line 6)

23404

23879

* Revision: Notices. (line 18)

23405

23880

* Rule, Single Suffix Inference: Single Suffix Rules. (line 6)

23406

23881

* Separated Dependencies: Single Suffix Rules. (line 9)

23407

23882

* set -b: Limitations of Builtins.

23408

(line 634)

23883

(line 665)

23409

23884

* set -e: Limitations of Builtins.

23410

(line 562)

23885

(line 581)

23411

23886

* set -m: Limitations of Builtins.

23412

(line 634)

23887

(line 665)

23413

23888

* Set manipulation: Set manipulation Macros.

23414

23889

(line 6)

23415

23890

* SHELL and make: The Make Macro SHELL.

23430

23905

* Shellology: Shellology. (line 6)

23431

23906

* signed integer overflow <1>: Signed Overflow Advice.

23432

23907

(line 6)

23433

* signed integer overflow <2>: Integer Overflow Basics.

23434

(line 6)

23435

* signed integer overflow <3>: Integer Overflow. (line 6)

23436

* signed integer overflow: Signed Overflow Examples.

23437

(line 6)

23908

* signed integer overflow <2>: Signed Overflow Examples.

23909

(line 6)

23910

* signed integer overflow <3>: Integer Overflow Basics.

23911

(line 6)

23912

* signed integer overflow: Integer Overflow. (line 6)

23438

23913

* Single Suffix Inference Rule: Single Suffix Rules. (line 6)

23439

23914

* Site defaults: Site Defaults. (line 6)

23440

23915

* Site details: Site Details. (line 6)

23448

23923

* Substitutions in makefiles: Makefile Substitutions.

23449

23924

(line 6)

23450

23925

* Symbolic links: Limitations of Usual Tools.

23451

(line 523)

23452

* System type <1>: Specifying Target Triplets.

23926

(line 529)

23927

* System type <1>: Canonicalizing. (line 6)

23928

* System type: Specifying Target Triplets.

23453

23929

(line 6)

23454

* System type: Canonicalizing. (line 6)

23455

23930

* Systemology: Systemology. (line 6)

23456

23931

* Target triplet: Specifying Target Triplets.

23457

23932

(line 6)

23460

23935

* testsuite <1>: testsuite Invocation.

23461

23936

(line 6)

23462

23937

* testsuite: testsuite Scripts. (line 6)

23463

* timestamp resolution <1>: Limitations of Usual Tools.

23938

* timestamp resolution <1>: Timestamps and Make. (line 6)

23939

* timestamp resolution: Limitations of Usual Tools.

23464

23940

(line 217)

23465

* timestamp resolution: Timestamps and Make. (line 6)

23466

23941

* Transforming program names: Transforming Names. (line 6)

23467

23942

* Tru64: Systemology. (line 44)

23468

23943

* Types: Types. (line 6)

23478

23953

* variable name indirection: Polymorphic Variables.

23479

23954

(line 6)

23480

23955

* variable names, composing: Polymorphic Variables.

23481

(line 102)

23956

(line 130)

23482

23957

* Variable, Precious: Setting Output Variables.

23483

23958

(line 65)

23484

23959

* variables and VPATH: Variables listed in VPATH.

23498

23973

* VPATH, explicit rules, and $<: $< in Explicit Rules.

23499

23974

(line 6)

23500

23975

* VPATH, resolving target pathnames: Make Target Lookup. (line 6)

23501

* wraparound arithmetic <1>: Signed Overflow Examples.

23502

(line 6)

23503

* wraparound arithmetic <2>: Integer Overflow. (line 6)

23504

* wraparound arithmetic <3>: Signed Overflow Advice.

23505

(line 6)

23506

* wraparound arithmetic: Integer Overflow Basics.

23507

(line 6)

23976

* wraparound arithmetic <1>: Signed Overflow Advice.

23977

(line 6)

23978

* wraparound arithmetic <2>: Signed Overflow Examples.

23979

(line 6)

23980

* wraparound arithmetic <3>: Integer Overflow Basics.

23981

(line 6)

23982

* wraparound arithmetic: Integer Overflow. (line 6)

23508

23983

* X Window System: System Services. (line 10)

23509

* Zsh: Shellology. (line 97)

23984

* Zsh: Shellology. (line 87)

23510

23985

23511

23986

23512

23987

23513

23988

Tag Table:

23514

Node: Top2289

23515

Node: Introduction21223

23516

Node: The GNU Build System27725

23517

Node: Automake28704

23518

Node: Gnulib30653

23519

Node: Libtool31962

23520

Node: Pointers33384

23521

Ref: Pointers-Footnote-134685

23522

Node: Making configure Scripts34845

23523

Node: Writing Autoconf Input37880

23524

Node: Shell Script Compiler39343

23525

Node: Autoconf Language41704

23526

Node: Autoconf Input Layout48433

23527

Node: autoscan Invocation49841

23528

Node: ifnames Invocation52397

23529

Node: autoconf Invocation53597

23530

Node: autoreconf Invocation58882

23531

Node: Setup63631

23532

Node: Initializing configure64953

23533

Ref: AC_INIT65458

23534

Node: Versioning67736

23535

Node: Notices69597

23536

Node: Input70772

23537

Ref: AC_CONFIG_SRCDIR70913

23538

Node: Output73860

23539

Ref: AC_OUTPUT74295

23540

Ref: AC_PROG_MAKE_SET75913

23541

Node: Configuration Actions76338

23542

Node: Configuration Files81626

23543

Ref: AC_CONFIG_FILES81887

23544

Node: Makefile Substitutions83106

23545

Node: Preset Output Variables84848

23546

Node: Installation Directory Variables94218

23547

Node: Changed Directory Variables102056

23548

Node: Build Directories104650

23549

Node: Automatic Remaking106505

23550

Node: Configuration Headers108673

23551

Node: Header Templates111975

23552

Node: autoheader Invocation114710

23553

Node: Autoheader Macros118352

23554

Node: Configuration Commands120617

23555

Ref: AC_CONFIG_COMMANDS121129

23556

Node: Configuration Links122414

23557

Ref: AC_CONFIG_LINKS122865

23558

Node: Subdirectories123838

23559

Node: Default Prefix126294

23560

Ref: AC_PREFIX_PROGRAM127185

23561

Node: Existing Tests127716

23562

Node: Common Behavior129518

23563

Node: Standard Symbols130157

23564

Node: Default Includes130738

23565

Node: Alternative Programs132992

23566

Node: Particular Programs133678

23567

Ref: AC_PROG_LEX139299

23568

Ref: AC_PROG_LN_S141910

23569

Node: Generic Programs143527

23570

Ref: AC_CHECK_PROG144498

23571

Ref: AC_CHECK_PROGS145224

23572

Ref: AC_PATH_PROG149224

23573

Ref: AC_PATH_PROGS149598

23574

Node: Files152676

23575

Node: Libraries153876

23576

Ref: AC_CHECK_LIB154113

23577

Ref: AC_SEARCH_LIBS156372

23578

Node: Library Functions157548

23579

Node: Function Portability158171

23580

Node: Particular Functions167398

23581

Ref: AC_FUNC_ALLOCA167729

23582

Ref: AC_FUNC_CLOSEDIR_VOID169868

23583

Ref: AC_FUNC_FORK171730

23584

Ref: AC_FUNC_GETLOADAVG173534

23585

Ref: AC_FUNC_GETMNTENT175099

23586

Ref: AC_FUNC_MMAP179076

23587

Ref: AC_FUNC_STRCOLL181931

23588

Ref: AC_FUNC_STRFTIME182906

23589

Ref: AC_FUNC_UTIME_NULL184066

23590

Ref: AC_FUNC_VPRINTF184414

23591

Node: Generic Functions185630

23592

Ref: AC_CHECK_FUNC186156

23593

Ref: AC_CHECK_FUNCS186785

23594

Node: Header Files191411

23595

Node: Header Portability192044

23596

Node: Particular Headers194913

23597

Ref: AC_HEADER_DIRENT195461

23598

Ref: AC_HEADER_MAJOR196991

23599

Ref: AC_HEADER_STAT197775

23600

Ref: AC_HEADER_STDC199031

23601

Ref: AC_HEADER_TIME203770

23602

Node: Generic Headers205157

23603

Ref: AC_CHECK_HEADER205557

23604

Ref: AC_CHECK_HEADERS207430

23605

Node: Declarations209995

23606

Node: Particular Declarations210591

23607

Node: Generic Declarations210815

23608

Ref: AC_CHECK_DECLS211961

23609

Node: Structures214360

23610

Node: Particular Structures214975

23611

Ref: AC_STRUCT_ST_BLOCKS216044

23612

Ref: AC_STRUCT_TIMEZONE216740

23613

Node: Generic Structures217069

23614

Ref: AC_CHECK_MEMBERS218061

23615

Node: Types218894

23616

Node: Particular Types219414

23617

Ref: AC_TYPE_GETGROUPS219857

23618

Ref: AC_TYPE_MODE_T222893

23619

Ref: AC_TYPE_OFF_T223076

23620

Ref: AC_TYPE_PID_T223256

23621

Ref: AC_TYPE_SIZE_T223436

23622

Ref: AC_TYPE_UID_T223805

23623

Node: Generic Types225450

23624

Node: Compilers and Preprocessors227605

23625

Node: Specific Compiler Characteristics228838

23626

Node: Generic Compiler Characteristics229943

23627

Ref: AC_CHECK_SIZEOF230183

23628

Node: C Compiler234779

23629

Ref: AC_PROG_CC_C_O239036

23630

Ref: AC_C_BIGENDIAN242844

23631

Ref: AC_C_CONST244685

23632

Ref: AC_C_INLINE248003

23633

Ref: AC_C_CHAR_UNSIGNED248226

23634

Ref: AC_PROG_GCC_TRADITIONAL250848

23635

Node: C++ Compiler251260

23636

Node: Objective C Compiler253459

23637

Node: Objective C++ Compiler254833

23638

Node: Erlang Compiler and Interpreter256283

23639

Node: Fortran Compiler258328

23640

Node: System Services272803

23641

Ref: AC_PATH_X273048

23642

Ref: AC_PATH_XTRA274041

23643

Ref: AC_SYS_INTERPRETER274618

23644

Ref: AC_SYS_LONG_FILE_NAMES276030

23645

Node: Posix Variants276407

23646

Ref: AC_USE_SYSTEM_EXTENSIONS276707

23647

Node: Erlang Libraries277783

23648

Node: Writing Tests282780

23649

Node: Language Choice284804

23650

Ref: AC_LANG285301

23651

Ref: AC_LANG_PUSH286960

23652

Ref: Language Choice-Footnote-1288833

23653

Node: Writing Test Programs288989

23654

Node: Guidelines289567

23655

Node: Test Functions291827

23656

Node: Generating Sources293225

23657

Node: Running the Preprocessor297904

23658

Ref: AC_PREPROC_IFELSE298631

23659

Ref: AC_EGREP_HEADER300460

23660

Ref: AC_EGREP_CPP300789

23661

Node: Running the Compiler301214

23662

Node: Running the Linker302868

23663

Ref: AC_LINK_IFELSE304008

23664

Node: Runtime304780

23665

Ref: AC_RUN_IFELSE305555

23666

Node: Systemology309560

23667

Node: Multiple Cases311909

23668

Node: Results313610

23669

Node: Defining Symbols314429

23670

Node: Setting Output Variables319320

23671

Node: Special Chars in Variables325211

23672

Node: Caching Results326471

23673

Node: Cache Variable Names330189

23674

Node: Cache Files331840

23675

Node: Cache Checkpointing333818

23676

Node: Printing Messages335192

23677

Ref: AC_MSG_RESULT336706

23678

Ref: AC_MSG_NOTICE337213

23679

Ref: AC_MSG_ERROR337577

23680

Ref: AC_MSG_WARN338410

23681

Node: Programming in M4338833

23682

Node: M4 Quotation339638

23683

Node: Active Characters340607

23684

Ref: Active Characters-Footnote-1341994

23685

Node: One Macro Call342016

23686

Node: Quoting and Parameters343572

23687

Node: Quotation and Nested Macros345908

23688

Node: Changequote is Evil348918

23689

Node: Quadrigraphs351448

23690

Node: Balancing Parentheses354130

23691

Node: Quotation Rule Of Thumb358224

23692

Node: Using autom4te361122

23693

Ref: Using autom4te-Footnote-1361773

23694

Node: autom4te Invocation361822

23695

Node: Customizing autom4te370324

23696

Node: Programming in M4sugar371605

23697

Node: Redefined M4 Macros372786

23698

Node: Diagnostic Macros380664

23699

Ref: m4_fatal381417

23700

Ref: m4_warn381656

23701

Node: Diversion support382424

23702

Node: Conditional constructs387867

23703

Node: Looping constructs394567

23704

Ref: m4_foreach_w398179

23705

Node: Evaluation Macros405531

23706

Node: Text processing Macros414220

23707

Node: Number processing Macros423846

23708

Ref: m4_version_compare425798

23709

Node: Set manipulation Macros428105

23710

Node: Forbidden Patterns437221

23711

Node: Debugging via autom4te438712

23712

Node: Programming in M4sh440531

23713

Node: Common Shell Constructs441904

23714

Node: Polymorphic Variables449003

23715

Node: Initialization Macros457024

23716

Node: File Descriptor Macros461257

23717

Ref: AS_MESSAGE_LOG_FD462409

23718

Node: Writing Autoconf Macros463911

23719

Node: Macro Definitions464716

23720

Node: Macro Names468395

23721

Node: Reporting Messages472156

23722

Node: Dependencies Between Macros474000

23723

Node: Prerequisite Macros474695

23724

Node: Suggested Ordering480770

23725

Node: One-Shot Macros482313

23726

Node: Obsoleting Macros483666

23727

Ref: AU_DEFUN484420

23728

Node: Coding Style485449

23729

Node: Portable Shell493243

23730

Node: Shellology497424

23731

Node: Here-Documents501889

23732

Node: File Descriptors504532

23733

Node: File System Conventions509133

23734

Node: Shell Pattern Matching514946

23735

Node: Shell Substitutions515510

23736

Node: Assignments526235

23737

Node: Parentheses528124

23738

Node: Slashes528954

23739

Node: Special Shell Variables529806

23740

Node: Shell Functions541584

23741

Node: Limitations of Builtins544561

23742

Ref: case548583

23743

Ref: echo553140

23744

Ref: export560114

23745

Ref: if562369

23746

Ref: set566036

23747

Ref: trap575360

23748

Ref: unset578917

23749

Node: Limitations of Usual Tools579868

23750

Ref: grep597698

23751

Ref: mkdir602949

23752

Ref: sed608613

23753

Ref: touch617562

23754

Node: Portable Make619908

23755

Node: $< in Ordinary Make Rules621294

23756

Node: Failure in Make Rules621760

23757

Node: Special Chars in Names622788

23758

Node: Backslash-Newline-Newline623762

23759

Node: Backslash-Newline Comments624389

23760

Node: Long Lines in Makefiles625280

23761

Node: Macros and Submakes625656

23762

Node: The Make Macro MAKEFLAGS627950

23763

Node: The Make Macro SHELL628835

23764

Node: Parallel Make631334

23765

Ref: Parallel Make-Footnote-1632971

23766

Node: Comments in Make Rules633101

23767

Node: obj/ and Make633580

23768

Node: make -k Status634219

23769

Node: VPATH and Make634841

23770

Node: Variables listed in VPATH636165

23771

Node: VPATH and Double-colon636704

23772

Node: $< in Explicit Rules637110

23773

Node: Automatic Rule Rewriting637577

23774

Node: Tru64 Directory Magic643506

23775

Node: Make Target Lookup644332

23776

Node: Single Suffix Rules648774

23777

Node: Timestamps and Make650120

23778

Node: Portable C and C++651340

23779

Node: Varieties of Unportability652981

23780

Node: Integer Overflow655078

23781

Node: Integer Overflow Basics656095

23782

Node: Signed Overflow Examples657843

23783

Node: Optimization and Wraparound661345

23784

Node: Signed Overflow Advice664307

23785

Node: Signed Integer Division666981

23786

Node: Preprocessor Arithmetic667592

23787

Node: Null Pointers668341

23788

Node: Buffer Overruns668975

23789

Node: Volatile Objects671764

23790

Node: Floating Point Portability677442

23791

Node: Exiting Portably677949

23792

Node: Manual Configuration679425

23793

Node: Specifying Target Triplets680258

23794

Ref: Specifying Names680431

23795

Node: Canonicalizing683125

23796

Node: Using System Type685392

23797

Node: Site Configuration688196

23798

Node: Help Formatting689168

23799

Node: External Software690112

23800

Ref: AC_ARG_WITH691658

23801

Node: Package Options695971

23802

Ref: AC_ARG_ENABLE697426

23803

Node: Pretty Help Strings698570

23804

Ref: AS_HELP_STRING699156

23805

Node: Option Checking701497

23806

Node: Site Details703225

23807

Node: Transforming Names704454

23808

Node: Transformation Options705536

23809

Node: Transformation Examples706013

23810

Node: Transformation Rules707734

23811

Node: Site Defaults709280

23812

Node: Running configure Scripts714567

23813

Node: Basic Installation715632

23814

Node: Compilers and Options719729

23815

Node: Multiple Architectures720383

23816

Node: Installation Names721963

23817

Node: Optional Features724858

23818

Node: Particular Systems726212

23819

Node: System Type727425

23820

Node: Sharing Defaults728753

23821

Node: Defining Variables729391

23822

Node: configure Invocation730283

23823

Node: config.status Invocation731989

23824

Ref: CONFIG_SHELL735736

23825

Node: Obsolete Constructs737129

23826

Node: Obsolete config.status Use738092

23827

Node: acconfig Header739870

23828

Node: autoupdate Invocation741892

23829

Node: Obsolete Macros743758

23830

Ref: AC_FUNC_SETVBUF_REVERSED751400

23831

Ref: AC_TYPE_SIGNAL767927

23832

Node: Autoconf 1770906

23833

Node: Changed File Names771972

23834

Node: Changed Makefiles772722

23835

Node: Changed Macros773810

23836

Node: Changed Results775064

23837

Node: Changed Macro Writing777188

23838

Node: Autoconf 2.13778468

23839

Node: Changed Quotation779676

23840

Node: New Macros781594

23841

Node: Hosts and Cross-Compilation783389

23842

Node: AC_LIBOBJ vs LIBOBJS787688

23843

Node: AC_ACT_IFELSE vs AC_TRY_ACT789303

23844

Ref: AC_FOO_IFELSE vs AC_TRY_FOO789492

23845

Node: Using Autotest791306

23846

Node: Using an Autotest Test Suite793710

23847

Node: testsuite Scripts794001

23848

Node: Autotest Logs798488

23849

Node: Writing Testsuites800829

23850

Node: testsuite Invocation814910

23851

Node: Making testsuite Scripts819461

23852

Node: FAQ824375

23853

Node: Distributing825235

23854

Node: Why GNU M4826284

23855

Node: Bootstrapping827153

23856

Node: Why Not Imake827763

23857

Node: Defining Directories832508

23858

Node: Autom4te Cache834489

23859

Node: Present But Cannot Be Compiled836327

23860

Node: Expanded Before Required840044

23861

Node: Debugging844943

23862

Node: History849424

23863

Node: Genesis850221

23864

Node: Exodus851399

23865

Node: Leviticus854444

23866

Node: Numbers855972

23867

Node: Deuteronomy857887

23868

Node: GNU Free Documentation License860558

23869

Node: Indices885723

23870

Node: Environment Variable Index886442

23871

Node: Output Variable Index897228

23872

Node: Preprocessor Symbol Index913822

23873

Node: Cache Variable Index932018

23874

Node: Autoconf Macro Index940070

23875

Node: M4 Macro Index973378

23876

Node: Autotest Macro Index993438

23877

Node: Program & Function Index995622

23878

Node: Concept Index1016409

23989

Node: Top2292

23990

Node: Introduction21293

23991

Node: The GNU Build System27808

23992

Node: Automake28787

23993

Node: Gnulib30736

23994

Node: Libtool32045

23995

Node: Pointers33467

23996

Ref: Pointers-Footnote-134768

23997

Node: Making configure Scripts34928

23998

Node: Writing Autoconf Input38277

23999

Node: Shell Script Compiler39740

24000

Node: Autoconf Language42101

24001

Node: Autoconf Input Layout48975

24002

Node: autoscan Invocation50383

24003

Node: ifnames Invocation52939

24004

Node: autoconf Invocation54139

24005

Node: autoreconf Invocation59424

24006

Node: Setup64173

24007

Node: Initializing configure65495

24008

Ref: AC_INIT66000

24009

Node: Versioning68818

24010

Node: Notices70679

24011

Node: Input71854

24012

Ref: AC_CONFIG_SRCDIR71995

24013

Node: Output74942

24014

Ref: AC_OUTPUT75377

24015

Ref: AC_PROG_MAKE_SET76995

24016

Node: Configuration Actions77420

24017

Node: Configuration Files82708

24018

Ref: AC_CONFIG_FILES82969

24019

Node: Makefile Substitutions84188

24020

Node: Preset Output Variables85930

24021

Node: Installation Directory Variables95298

24022

Node: Changed Directory Variables103146

24023

Node: Build Directories105740

24024

Node: Automatic Remaking107595

24025

Node: Configuration Headers109763

24026

Node: Header Templates113065

24027

Node: autoheader Invocation115800

24028

Node: Autoheader Macros119442

24029

Node: Configuration Commands121707

24030

Ref: AC_CONFIG_COMMANDS122219

24031

Node: Configuration Links123504

24032

Ref: AC_CONFIG_LINKS123955

24033

Node: Subdirectories124928

24034

Node: Default Prefix127408

24035

Ref: AC_PREFIX_PROGRAM128299

24036

Node: Existing Tests128830

24037

Node: Common Behavior130632

24038

Node: Standard Symbols131271

24039

Node: Default Includes131852

24040

Node: Alternative Programs134106

24041

Node: Particular Programs134792

24042

Ref: AC_PROG_LEX140413

24043

Ref: AC_PROG_LN_S143024

24044

Node: Generic Programs144641

24045

Ref: AC_CHECK_PROG145612

24046

Ref: AC_CHECK_PROGS146338

24047

Ref: AC_PATH_PROG150338

24048

Ref: AC_PATH_PROGS150712

24049

Node: Files153790

24050

Node: Libraries154990

24051

Ref: AC_CHECK_LIB155227

24052

Ref: AC_SEARCH_LIBS157486

24053

Node: Library Functions158670

24054

Node: Function Portability159293

24055

Node: Particular Functions168520

24056

Ref: AC_FUNC_ALLOCA168851

24057

Ref: AC_FUNC_CLOSEDIR_VOID170990

24058

Ref: AC_FUNC_FORK172852

24059

Ref: AC_FUNC_GETLOADAVG174656

24060

Ref: AC_FUNC_GETMNTENT176221

24061

Ref: AC_FUNC_MMAP180198

24062

Ref: AC_FUNC_STRCOLL183053

24063

Ref: AC_FUNC_STRFTIME184028

24064

Ref: AC_FUNC_UTIME_NULL185188

24065

Ref: AC_FUNC_VPRINTF185536

24066

Node: Generic Functions186752

24067

Ref: AC_CHECK_FUNC187278

24068

Ref: AC_CHECK_FUNCS187907

24069

Node: Header Files192533

24070

Node: Header Portability193166

24071

Node: Particular Headers196035

24072

Ref: AC_HEADER_DIRENT196583

24073

Ref: AC_HEADER_MAJOR198113

24074

Ref: AC_HEADER_STAT198897

24075

Ref: AC_HEADER_STDC200153

24076

Ref: AC_HEADER_TIME204892

24077

Node: Generic Headers206279

24078

Ref: AC_CHECK_HEADER206679

24079

Ref: AC_CHECK_HEADERS208552

24080

Node: Declarations211117

24081

Node: Particular Declarations211713

24082

Node: Generic Declarations211937

24083

Ref: AC_CHECK_DECLS213322

24084

Node: Structures215848

24085

Node: Particular Structures216463

24086

Ref: AC_STRUCT_ST_BLOCKS217532

24087

Ref: AC_STRUCT_TIMEZONE218228

24088

Node: Generic Structures218557

24089

Ref: AC_CHECK_MEMBERS219548

24090

Node: Types220381

24091

Node: Particular Types220901

24092

Ref: AC_TYPE_GETGROUPS221344

24093

Ref: AC_TYPE_MODE_T224380

24094

Ref: AC_TYPE_OFF_T224563

24095

Ref: AC_TYPE_PID_T224743

24096

Ref: AC_TYPE_SIZE_T224923

24097

Ref: AC_TYPE_UID_T225292

24098

Node: Generic Types226937

24099

Node: Compilers and Preprocessors229092

24100

Node: Specific Compiler Characteristics230325

24101

Node: Generic Compiler Characteristics231430

24102

Ref: AC_CHECK_SIZEOF231670

24103

Node: C Compiler236266

24104

Ref: AC_PROG_CC_C_O240717

24105

Ref: AC_C_BIGENDIAN244525

24106

Ref: AC_C_CONST246366

24107

Ref: AC_C_INLINE249684

24108

Ref: AC_C_CHAR_UNSIGNED249907

24109

Ref: AC_PROG_GCC_TRADITIONAL252529

24110

Node: C++ Compiler252941

24111

Node: Objective C Compiler255338

24112

Node: Objective C++ Compiler256712

24113

Node: Erlang Compiler and Interpreter258162

24114

Node: Fortran Compiler260207

24115

Node: System Services276798

24116

Ref: AC_PATH_X277043

24117

Ref: AC_PATH_XTRA278036

24118

Ref: AC_SYS_INTERPRETER278613

24119

Ref: AC_SYS_LONG_FILE_NAMES280025

24120

Node: Posix Variants280402

24121

Ref: AC_USE_SYSTEM_EXTENSIONS280702

24122

Node: Erlang Libraries281778

24123

Node: Writing Tests286716

24124

Node: Language Choice288740

24125

Ref: AC_LANG289237

24126

Ref: AC_LANG_PUSH290896

24127

Ref: Language Choice-Footnote-1292769

24128

Node: Writing Test Programs292925

24129

Node: Guidelines293503

24130

Node: Test Functions295763

24131

Node: Generating Sources297161

24132

Node: Running the Preprocessor302204

24133

Ref: AC_PREPROC_IFELSE302931

24134

Ref: AC_EGREP_HEADER304861

24135

Ref: AC_EGREP_CPP305190

24136

Node: Running the Compiler305615

24137

Node: Running the Linker307370

24138

Ref: AC_LINK_IFELSE308510

24139

Node: Runtime309386

24140

Ref: AC_RUN_IFELSE310161

24141

Node: Systemology314166

24142

Node: Multiple Cases316515

24143

Node: Results318216

24144

Node: Defining Symbols319035

24145

Node: Setting Output Variables323926

24146

Node: Special Chars in Variables329817

24147

Node: Caching Results331077

24148

Node: Cache Variable Names334795

24149

Node: Cache Files336446

24150

Node: Cache Checkpointing338496

24151

Node: Printing Messages339870

24152

Ref: AC_MSG_RESULT341384

24153

Ref: AC_MSG_NOTICE341891

24154

Ref: AC_MSG_ERROR342255

24155

Ref: AC_MSG_WARN343088

24156

Node: Programming in M4343511

24157

Node: M4 Quotation344316

24158

Node: Active Characters345285

24159

Ref: Active Characters-Footnote-1346675

24160

Ref: Active Characters-Footnote-2346789

24161

Node: One Macro Call346811

24162

Node: Quoting and Parameters348367

24163

Node: Quotation and Nested Macros350703

24164

Node: Changequote is Evil353713

24165

Node: Quadrigraphs356243

24166

Node: Balancing Parentheses358925

24167

Node: Quotation Rule Of Thumb363019

24168

Node: Using autom4te365917

24169

Ref: Using autom4te-Footnote-1366568

24170

Node: autom4te Invocation366617

24171

Node: Customizing autom4te375119

24172

Node: Programming in M4sugar376400

24173

Node: Redefined M4 Macros377581

24174

Node: Diagnostic Macros385911

24175

Ref: m4_fatal386664

24176

Ref: m4_warn386903

24177

Node: Diversion support387671

24178

Node: Conditional constructs395457

24179

Node: Looping constructs402158

24180

Ref: m4_foreach_w405770

24181

Node: Evaluation Macros413122

24182

Node: Text processing Macros421811

24183

Node: Number processing Macros431521

24184

Ref: m4_version_compare433473

24185

Node: Set manipulation Macros435780

24186

Node: Forbidden Patterns444896

24187

Node: Debugging via autom4te446387

24188

Node: Programming in M4sh448206

24189

Node: Common Shell Constructs449579

24190

Node: Polymorphic Variables457332

24191

Node: Initialization Macros466859

24192

Node: File Descriptor Macros471092

24193

Ref: AS_MESSAGE_LOG_FD472244

24194

Node: Writing Autoconf Macros473746

24195

Node: Macro Definitions474551

24196

Node: Macro Names478230

24197

Node: Reporting Messages481991

24198

Node: Dependencies Between Macros483835

24199

Node: Prerequisite Macros484530

24200

Node: Suggested Ordering490605

24201

Node: One-Shot Macros492148

24202

Node: Obsoleting Macros493501

24203

Ref: AU_DEFUN494255

24204

Node: Coding Style495284

24205

Node: Portable Shell503091

24206

Node: Shellology507272

24207

Node: Here-Documents511439

24208

Node: File Descriptors514560

24209

Node: File System Conventions519907

24210

Node: Shell Pattern Matching525720

24211

Node: Shell Substitutions526284

24212

Node: Assignments537429

24213

Node: Parentheses539318

24214

Node: Slashes540148

24215

Node: Special Shell Variables541000

24216

Node: Shell Functions553568

24217

Node: Limitations of Builtins556545

24218

Ref: case560567

24219

Ref: echo565124

24220

Ref: export572098

24221

Ref: if575042

24222

Ref: set578709

24223

Ref: trap588477

24224

Ref: unset592034

24225

Node: Limitations of Usual Tools592985

24226

Ref: grep610876

24227

Ref: mkdir616314

24228

Ref: sed621978

24229

Ref: touch631958

24230

Node: Portable Make635054

24231

Node: $< in Ordinary Make Rules636504

24232

Node: Failure in Make Rules636970

24233

Node: Special Chars in Names637998

24234

Node: Backslash-Newline-Newline638972

24235

Node: Backslash-Newline Comments639599

24236

Node: Long Lines in Makefiles640490

24237

Node: Macros and Submakes640866

24238

Node: The Make Macro MAKEFLAGS643553

24239

Node: The Make Macro SHELL644438

24240

Node: Parallel Make646937

24241

Ref: Parallel Make-Footnote-1648574

24242

Node: Comments in Make Rules648704

24243

Node: Newlines in Make Rules649321

24244

Node: obj/ and Make650356

24245

Node: make -k Status650995

24246

Node: VPATH and Make651617

24247

Node: Variables listed in VPATH652941

24248

Node: VPATH and Double-colon653480

24249

Node: $< in Explicit Rules653886

24250

Node: Automatic Rule Rewriting654353

24251

Node: Tru64 Directory Magic660282

24252

Node: Make Target Lookup661108

24253

Node: Single Suffix Rules665550

24254

Node: Timestamps and Make666896

24255

Node: Portable C and C++668116

24256

Node: Varieties of Unportability669757

24257

Node: Integer Overflow671854

24258

Node: Integer Overflow Basics672871

24259

Node: Signed Overflow Examples674619

24260

Node: Optimization and Wraparound678121

24261

Node: Signed Overflow Advice681083

24262

Node: Signed Integer Division683757

24263

Node: Preprocessor Arithmetic684368

24264

Node: Null Pointers685117

24265

Node: Buffer Overruns685751

24266

Node: Volatile Objects688540

24267

Node: Floating Point Portability694218

24268

Node: Exiting Portably694725

24269

Node: Manual Configuration696201

24270

Node: Specifying Target Triplets697034

24271

Ref: Specifying Names697207

24272

Node: Canonicalizing699901

24273

Node: Using System Type702168

24274

Node: Site Configuration704972

24275

Node: Help Formatting705944

24276

Node: External Software706888

24277

Ref: AC_ARG_WITH708434

24278

Node: Package Options712759

24279

Ref: AC_ARG_ENABLE714214

24280

Node: Pretty Help Strings715375

24281

Ref: AS_HELP_STRING715961

24282

Node: Option Checking718302

24283

Node: Site Details720030

24284

Node: Transforming Names721259

24285

Node: Transformation Options722341

24286

Node: Transformation Examples722818

24287

Node: Transformation Rules724539

24288

Node: Site Defaults726085

24289

Node: Running configure Scripts731426

24290

Node: Basic Installation732491

24291

Node: Compilers and Options736588

24292

Node: Multiple Architectures737242

24293

Node: Installation Names738822

24294

Node: Optional Features741717

24295

Node: Particular Systems743071

24296

Node: System Type744284

24297

Node: Sharing Defaults745612

24298

Node: Defining Variables746250

24299

Node: configure Invocation747142

24300

Node: config.status Invocation748848

24301

Ref: CONFIG_SHELL752595

24302

Node: Obsolete Constructs753988

24303

Node: Obsolete config.status Use754951

24304

Node: acconfig Header756729

24305

Node: autoupdate Invocation758751

24306

Node: Obsolete Macros760617

24307

Ref: AC_FUNC_SETVBUF_REVERSED768259

24308

Ref: AC_TYPE_SIGNAL784786

24309

Node: Autoconf 1787765

24310

Node: Changed File Names788831

24311

Node: Changed Makefiles789581

24312

Node: Changed Macros790669

24313

Node: Changed Results791923

24314

Node: Changed Macro Writing794047

24315

Node: Autoconf 2.13795327

24316

Node: Changed Quotation796535

24317

Node: New Macros798453

24318

Node: Hosts and Cross-Compilation800248

24319

Node: AC_LIBOBJ vs LIBOBJS804547

24320

Node: AC_ACT_IFELSE vs AC_TRY_ACT806162

24321

Ref: AC_FOO_IFELSE vs AC_TRY_FOO806351

24322

Node: Using Autotest808164

24323

Node: Using an Autotest Test Suite810568

24324

Node: testsuite Scripts810859

24325

Node: Autotest Logs815341

24326

Node: Writing Testsuites817682

24327

Node: testsuite Invocation834520

24328

Node: Making testsuite Scripts839867

24329

Node: FAQ845026

24330

Node: Distributing845886

24331

Node: Why GNU M4846935

24332

Node: Bootstrapping847804

24333

Node: Why Not Imake848414

24334

Node: Defining Directories853159

24335

Node: Autom4te Cache855158

24336

Node: Present But Cannot Be Compiled856996

24337

Node: Expanded Before Required860713

24338

Node: Debugging865612

24339

Node: History870513

24340

Node: Genesis871310

24341

Node: Exodus872488

24342

Node: Leviticus875533

24343

Node: Numbers877061

24344

Node: Deuteronomy878976

24345

Node: GNU Free Documentation License881647

24346

Node: Indices906812

24347

Node: Environment Variable Index907531

24348

Node: Output Variable Index918317

24349

Node: Preprocessor Symbol Index934629

24350

Node: Cache Variable Index952825

24351

Node: Autoconf Macro Index960877

24352

Node: M4 Macro Index994330

24353

Node: Autotest Macro Index1014666

24354

Node: Program & Function Index1017069

24355

Node: Concept Index1037856

23879

24356

23880

24357

End Tag Table