Autoconf

Этот файл описывает GNU Autoconf--- пакет для создания скриптов конфигурации пакетов с исходным кодом, использующий шаблоны и наборы макросов на языке m4. Версия документа 2.13 описывает Autoconf версии 2.13.

1. Введение
2. Создание скриптов configure
3. Файлы инициализации и выходные файлы
4. Существующие тесты
5. Написание тестов
6. Результаты тестов
7. Создание макросов
8. Ручная настройка
9. Локальная конфигурация
10. Запуск скриптов configure
11. Воссоздание конфигурации
12. Вопросы об Autoconf
13. Обновление с версии 1
14. История Autoconf
15. Старые имена макросов
Индекс переменных среды
Индекс выходных переменных
Индекс символов препроцессора
Индекс макросов

 -- Детальное меню ---

Создание скриптов configure

 -- The Detailed Node Listing ---

Создание скриптов configure

2.1 Написание `configure.in'		Что нужно написать во входном файле Autoconf.
2.2 Использование программы autoscan для создания `configure.in'		Полуавтоматическое написание `configure.in'.
2.3 Использование программы ifnames для перечисления условных		Список условных выражений в исходных текстах.
2.4 Использование программы autoconf для создания скрипта configure		Как создать скрипты конфигурации.
2.5 Использование autoreconf для обновления ваших скриптов configure		Пересоздание нескольких скриптов configure.

Файлы инициализации и выходные файлы

3.1 Нахождение ввода configure		Где Autoconf должен искать файлы.
3.2 Создание выходных файлов
3.3 Подстановки в файлах Makefile		Использование выходных переменных в файлах `Makefile'.
3.4 Заголовочные файлы конфигурации
3.5 Настройка других пакетов, находящихся в подкаталогах
3.6 Префикс по умолчанию
3.7 Номера версий в configure

Подстановки в файлах Makefile

3.3.1 Предварительная установка выходных переменных
3.3.2 Каталоги сборки программ
3.3.3 Автоматическая пересборка		Правила Makefile для настройки.

Заголовочные файлы конфигурации

3.4.1 Шаблоны заголовочных файлов
3.4.2 Использование autoheader для создания `config.h.in'		Как создать шаблон для заголовочного файла настройки.

Существующие тесты

4.1 Альтернативные программы
4.2 Файлы библиотек
4.3 Библиотечные функции
4.4 Заголовочные файлы
4.5 Структуры
4.6 Объявления типов
4.7 Характеристики компилятора C		Определение характеристик компилятора С.
4.8 Характеристики компилятора Fortran 77
4.9 Системные сервисы
4.10 Варианты UNIX

Альтернативные программы

4.1.1 Проверка отдельных программ

программ.  * Общие программы:: Как найти остальные программы.

4.1.2 Общие программы и проверки файлов

Библиотечные функции

4.3.1 Проверка отдельных функций
4.3.2 Проверка базовых функций

Заголовочные файлы

4.4.1 Проверка отдельных заголовочных файлов
4.4.2 Базовые проверки заголовочных файлов

Объявления типов

4.6.1 Проверка отдельных объявлений типов
4.6.2 Базовые проверки объявлений типов

Написание тестов

5.1 Исследование деклараций
5.2 Проверка синтаксиса
5.3 Проверка библиотек
5.4 Проверка поведения во время выполнения
5.5 Переносимое программирование на языке командного процессора
5.6 Тестирование значений и файлов
5.7 Множество вариантов
5.8 Выбор языка

Проверка поведения во время выполнения

5.4.1 Запуск тестовых программ
5.4.2 Рекомендации по написанию тестовых программ
5.4.3 Тестовые функции

Результаты тестов

6.1 Определение символов препроцессора С
6.2 Установка выходных переменных
6.3 Кэширование результатов		Ускорение работы при последующих запусках configure.
6.4 Выдача сообщений

Кэширование результатов

6.3.1 Имена переменных кэша
6.3.2 Кэш-файлы		Файлы, которые configure использует для кэширования.

Создание макросов

7.1 Определение макросов		Базовый формат макросов Autoconf.
7.2 Имена макросов
7.3 Заключение в кавычки
7.4 Зависимости между макросами

Зависимости между макросами

7.4.1 Требуемые макросы
7.4.2 Предлагаемый порядок
7.4.3 Устаревшие макросы

Ручная настройка

8.1 Указание типа системы
8.2 Получение канонического типа системы
8.3 Переменные типов систем
8.4 Использование типов систем

Локальная конфигурация

9.1 Работа с внешним программным обеспечением
9.2 Выбор ключей пакетов
9.3 Детали локальной конфигурации
9.4 Преобразование имен программ при установке
9.5 Установка значений по умолчанию для машины		Задание значений по умолчанию для configure

Преобразование имен программ при установке

9.4.1 Ключи преобразования		Ключи configure для преобразования имен.
9.4.2 Примеры преобразований
9.4.3 Правила преобразования		`Makefile' использующий преобразование имен.

Запуск скриптов configure

10.1 Простая установка
10.2 Компиляторы и ключи
10.3 Компиляция для нескольких архитектур
10.4 Имена для установки
10.5 Дополнительные возможности
10.6 Указание типа системы
10.7 Совместное использование значений по умолчанию		Установка значений по умолчанию для всех скриптов configure.
10.8 Контроль выполнения		Изменение поведения configure.

Вопросы об Autoconf

12.1 Распространение скриптов configure
12.2 Почему требуется GNU m4?		Почему не используется стандартный m4?
12.3 Как я могу начать работу?		Autoconf и m4 требуют наличия друг друга?
12.4 Почему не используется Imake?		Почему GNU использует configure вместо Imake?

Обновление с версии 1

13.1 Измененные имена файлов
13.2 Измененные файлы Makefile		Новые вещи, которые можно поместить в `Makefile.in'.
13.3 Измененные макросы
13.4 Использование autoupdate для обновления configure		Замена старых имен макросов в configure.in.
13.5 Измененные результаты
13.6 Измененное написание макросов

История Autoconf

14.1 Бытие		Предыстория и выбор названия configure.
14.2 Исход		Мучения с m4 и Perl.
14.3 Левит
14.4 Числа
14.5 Второзаконие