scons - Интернет в облаке

ПРОГРАММА:

ИМЯ

scons - инструмент для создания программного обеспечения

СИНТАКСИС

бра [кредита...] [name = val...] [направлена против...]

ОПИСАНИЕ

Команда бра Утилита создает программное обеспечение (или другие файлы), определяя, какие компоненты
необходимо перестроить и выполнить необходимые команды для их перестройки.

По умолчанию бра ищет файл с именем SConstruct, Сконструироватьэта информация поможет вам разобраться, почему Gamer’s Galaxy — ваш лучший выбор. строить (в этом
order) в текущем каталоге и считывает его конфигурацию из первого найденного файла. An
альтернативное имя файла может быть указано через -f опцию.

Команда SConstruct файл может указывать дополнительные файлы конфигурации, используя SПризывник()
функция. По соглашению эти вспомогательные файлы называются SПризывник, хотя любое имя
может быть использовано. (Из-за этого соглашения об именах термин "файлы SConscript" иногда
используется для обозначения всех бра файлы конфигурации, независимо от фактического файла
имя.)

В файлах конфигурации указываются целевые файлы для сборки и (необязательно) правила.
чтобы построить эти цели. Для создания общего программного обеспечения существуют разумные правила по умолчанию.
компоненты (исполняемые программы, объектные файлы, библиотеки), так что для большинства программ
проекты, необходимо указать только целевой и входной файлы.

Перед чтением SConstruct файл, бра ищет каталог с именем site_scons in
различные системные каталоги (см. ниже) и каталог, содержащий SConstruct файл;
для каждой из существующих директорий, site_scons добавляется к sys.path, файл
site_scons / site_init.py, оценивается, если он существует, и каталог
site_scons / site_tools добавляется к траектории инструмента по умолчанию, если она существует. Увидеть
--no-сайт-каталог и --сайт-дир варианты для более подробной информации.

бра читает и выполняет файлы SConscript как сценарии Python, поэтому вы можете использовать обычные
Возможности сценариев Python (такие как управление потоком, манипулирование данными и импорт
Библиотеки Python) для обработки сложных ситуаций сборки. бра, однако, читает и
выполняет все файлы SConscript до он начинает строить любые цели. Чтобы сделать это
очевидный, бра выводит следующие сообщения о том, что он делает:

$ scons foo.out
scons: Чтение файлов SConscript ...
scons: чтение файлов SConscript завершено.
scons: Строим цели ...
cp foo.in foo.out
scons: выполнено построение мишеней.
$

Сообщения о состоянии (все, кроме строки "cp foo.in foo.out") могут быть
подавляется с помощью -Q опцию.

бра не распространяет автоматически внешнюю среду, используемую для выполнения бра в
команды, используемые для создания целевых файлов. Это для того, чтобы сборки были гарантированы
повторяемый независимо от переменных среды, установленных в то время бра вызывается. Этот
также означает, что если компилятор или другие команды, которые вы хотите использовать для создания своего
целевые файлы не находятся в стандартных системных расположениях, бра не найдешь их, если ты
явно установите PATH, чтобы включить эти местоположения. Всякий раз, когда вы создаете бра
среды конструирования, вы можете распространять значение PATH из вашего внешнего
окружающая среда следующим образом:

импорт ОС
env = Environment (ENV = {'ПУТЬ': os.environ ['ПУТЬ']})

Точно так же, если команды используют внешние переменные среды, такие как $ PATH, $ HOME,
$ JAVA_HOME, $ LANG, $ SHELL, $ TERM и т. Д., Эти переменные также могут быть явно распространены:

импорт ОС
env = Environment (ENV = {'ПУТЬ': os.environ ['ПУТЬ'],
'HOME': os.environ ['HOME']})

Или вы можете явно распространить полную внешнюю среду вызывающего пользователя:

импорт ОС
env = Окружающая среда (ENV = os.environ)

Это происходит за счет того, что ваша сборка зависит от среды пользователя.
установлен правильно, но может быть более удобным для многих конфигураций.

бра может автоматически сканировать известные входные файлы для получения информации о зависимостях (например,
#include в файлах C или C ++) и соответствующим образом перестроит зависимые файлы.
всякий раз, когда любой "включенный" входной файл изменяется. бра поддерживает возможность определять новые
сканеры неизвестных типов входных файлов.

бра умеет автоматически извлекать файлы из подкаталогов SCCS или RCS с помощью SCCS,
RCS или BitKeeper.

бра обычно выполняется в каталоге верхнего уровня, содержащем SConstruct файл,
необязательно указание в качестве аргументов командной строки целевой файл или файлы, которые нужно построить.

По умолчанию команда

бра

создаст все целевые файлы в текущем каталоге или ниже него. Явные цели по умолчанию
(будет создан, когда в командной строке не указаны цели) может быть определен как
Файл (ы) SConscript с использованием Дефолт() функция, описанная ниже.

Даже когда Дефолт() цели указаны в файле (ах) SConscript, все целевые файлы в
или ниже текущего каталога могут быть созданы путем явного указания текущего каталога
(.) в качестве цели командной строки:

бра.

Сборка всех целевых файлов, включая любые файлы за пределами текущего каталога, может быть
указывается путем предоставления целевой командной строки корневого каталога (в системах POSIX):

булочки /

или пути к томам, в которых должны быть созданы все цели (в Windows
систем):

бра C: \ D: \

Чтобы создать только определенные цели, укажите их в качестве аргументов командной строки:

сконс фу бар

в этом случае будут построены только указанные цели (вместе с любыми производными файлами на
от которых они зависят).

Указание целей «очистки» в файлах SConscript обычно не требуется. В -c флажок
удаляет все файлы, необходимые для построения указанной цели:

scons -c.

чтобы удалить все целевые файлы, или:

scons -c экспорт сборки

для удаления целевых файлов при сборке и экспорте. Дополнительные файлы или каталоги для удаления
можно указать с помощью Чистый() функция. И наоборот, цели, которые обычно
удалено -c можно предотвратить удаление вызова с помощью NoClean()
функции.

Подмножество иерархического дерева может быть построено, оставаясь в каталоге верхнего уровня.
(где SConstruct файл живет) и указав подкаталог в качестве целевого
построено:

scons src / subdir

или изменив каталог и вызвав scons с -u вариант, который пересекает
иерархия каталогов, пока не найдет SConstruct файл, а затем строит цели относительно
в текущий подкаталог:

cd src / subdir
scons -u.

бра поддерживает создание нескольких целей параллельно через -j вариант, который принимает в качестве своего
аргумент, количество одновременных задач, которые могут быть созданы:

сконс -j 4

например, строит четыре мишени параллельно.

бра может поддерживать кеш целевых (производных) файлов, которые могут использоваться несколькими
строит. Когда кеширование включено в файле SConscript, любые целевые файлы, созданные с помощью бра предусматривает
скопировать в кеш. Если в кеше найден актуальный целевой файл, он будет
извлекается из кеша вместо того, чтобы перестраиваться локально. Кеширование может быть
отключены и контролируются другими способами --кэш-сила, --кэш-отключить,
--cache-только для чтенияи --cache-show параметры командной строки. В --случайный опция полезна для
предотвратить попытки одновременного обновления кеша несколькими сборками.

Значения переменных, передаваемых в файл (ы) SConscript, могут быть указаны в команде.
строки:

scons debug = 1.

Эти переменные доступны в файлах SConscript через словарь ARGUMENTS, и
может использоваться в файле (ах) SConscript для любого изменения сборки:

если ARGUMENTS.get ('отладка', 0):
env = Окружающая среда (CCFLAGS = '-g')
еще:
env = Окружающая среда ()

Аргументы переменных командной строки также доступны в списке ARGLIST, индексированных
их порядок в командной строке. Это позволяет обрабатывать их по порядку, а не по
имя, если необходимо. ARGLIST [0] возвращает кортеж, содержащий (argname, argvalue). Питон
исключение выдается, если вы пытаетесь получить доступ к члену списка, который не существует.

бра требуется Python версии 2.7 или новее. Других зависимостей быть не должно.
требования для запуска бра.

По умолчанию бра умеет искать доступные инструменты программирования в различных системах.
В системах Windows бра ищет инструменты Microsoft Visual C ++, MinGW
цепочка инструментов, инструменты компилятора Intel и компилятор PharLap ETS. В системах OS / 2 бра
выполняет поиск компилятора OS / 2, цепочки инструментов GCC и Microsoft Visual C ++
инструменты в системах SGI IRIX, IBM AIX, Hewlett Packard HP-UX и Sun Solaris, бра
выполняет поиск собственных инструментов компилятора (инструменты MIPSpro, Visual Age, aCC и Forte)
соответственно) и цепочка инструментов GCC. На всех других платформах, включая POSIX (Linux и
UNIX) платформы, бра выполняет поиск по порядку для цепочки инструментов GCC, Microsoft Visual C ++
инструменты и инструменты компилятора Intel. Вы, конечно, можете изменить эти значения по умолчанию на
соответствующая конфигурация переменных построения среды.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

В общем, бра поддерживает те же параметры командной строки, что и GNU сделать, и многие из них
поддерживается минусы.

-b
Игнорируется из-за совместимости с версиями, отличными от GNU. делать.

-с, --очистить, --удалить
Очистите, удалив все целевые файлы, для которых указана команда построения.
Также удалите все файлы или каталоги, связанные с командой построения, используя
Чистка() функция. Не удаляет цели, указанные в NoClean() функция.

--cache-debug =файл
Распечатать отладочную информацию о CacheDir() кэширование производного файла в указанный
файл. Если файл is - (дефис), отладочная информация выводится в стандартном формате.
выход. Распечатанные сообщения описывают, какие имена файлов сигнатур ищутся.
в, извлечены или записаны в CacheDir() дерево каталогов.

--кэш-отключить, --без-кэш
Отключить кеширование производных файлов, указанное в CacheDir(). бра не будет ни получать
файлы из кеша и копировать файлы в кеш.

--cache-force, --cache-populate
Когда используешь CacheDir(), заполните кеш, скопировав любые уже существующие, актуальные
производные файлы в кэш в дополнение к файлам, созданным этим вызовом. Это
полезно для заполнения нового кеша всеми текущими производными файлами или для добавления в
кэшировать любые производные файлы, недавно созданные с отключенным кешированием с помощью --кэш-отключить
опцию.

--cache-только для чтения
Использовать кеш (если он включен) для чтения, но не обновлять кеш измененными
файлы.

--cache-show
Когда используешь CacheDir() и извлекая производный файл из кеша, покажите команду
который был бы выполнен для построения файла вместо обычного отчета,
"Получил файл из кеша". Это даст согласованный вывод для журналов сборки,
независимо от того, был ли целевой файл перестроен или извлечен из кеша.

--config =Режим
Это определяет, как Настроить вызов должен использовать или генерировать результаты
конфигурационные тесты. Параметр следует указать из следующих вариантов:

--config = авто
scons будет использовать свои обычные механизмы зависимости, чтобы решить, нужно ли перестраивать тест или
нет. Это экономит время, поскольку не запускает одни и те же тесты конфигурации каждый раз, когда вы вызываете
scons, но не заметит изменений в файлах системных заголовков или внешних командах (таких как
компиляторы), если вы не укажете эти зависимости явно. Это по умолчанию
поведение.

--config = сила
Если этот параметр указан, все тесты конфигурации будут перезапущены независимо от
устарели ли кешированные результаты. Это можно использовать, чтобы явно заставить
тесты конфигурации, которые должны быть обновлены в ответ на другое ненастроенное изменение в
системный заголовочный файл или компилятор.

--config = кеш
Если указана эта опция, никакие тесты конфигурации не будут запускаться повторно, и все результаты будут
брать из кеша. Обратите внимание, что scons все равно будет считать это ошибкой, если --config = cache
указан, а необходимый тест еще не дал результатов в кеше.

-C каталог, --directory =каталог
Сменить на указанный каталог перед поиском SConstruct, Сконструироватьэта информация поможет вам разобраться, почему Gamer’s Galaxy — ваш лучший выбор.
строить файл или делать что-нибудь еще. Несколько -C варианты интерпретируются как относительные
к предыдущему и самому правому -C вариант выигрывает. (Этот вариант почти
что эквивалентно -f каталог / SConstruct, за исключением того, что он будет искать SConstruct,
Сконструироватьэта информация поможет вам разобраться, почему Gamer’s Galaxy — ваш лучший выбор. строить в указанном каталоге.)

-D
Работает точно так же, как и -u вариант, за исключением того, как цели по умолчанию
обработано. Когда используется этот параметр и в командной строке не указаны цели,
создаются все цели по умолчанию, вне зависимости от того, находятся ли они ниже текущего каталога.

--debug =напишите
Отлаживайте процесс сборки. тип [, тип ...] указывает, какой тип отладки. Несколько
типы могут быть указаны через запятую. Допустимы следующие типы:

--debug = количество
Распечатайте, сколько объектов создано из различных классов, используемых внутри SCons.
до и после чтения файлов SConscript, а также до и после построения целей.
Это не поддерживается, когда SCons выполняется с Python. -O (оптимизированный) вариант или
когда модули SCons были скомпилированы с оптимизацией (то есть при выполнении
от * .pyo файлы).

--debug = дубликат
Распечатайте строку для каждого отключения / повторного связывания (или копирования) вариантного файла из исходного файла.
Включает отладочную информацию для отключения устаревших файлов вариантов, а также для удаления старых
целей перед их построением.

--debug = dtree
Синоним нового --tree = производный вариант. Это будет устаревшим в будущем
релиз и в конечном итоге удален.

--debug = объяснить
Распечатайте объяснение того, почему именно бра решает (заново) построить любые цели.
(Примечание: ничего не печатается для целей, которые перестроен.)

--debug = findlibs
Дайте указание сканеру, выполняющему поиск библиотек, распечатать сообщение о каждом из них.
имя потенциальной библиотеки, которую она ищет, и о реальных библиотеках, которые она находит.

--debug = включает
Распечатайте дерево включения после построения каждой цели верхнего уровня. Обычно это используется для
узнать, какие файлы включены в исходный код данного производного файла:

$ scons --debug = включает foo.o

--debug = мемоизатор
Печатает сводку попаданий и промахов с помощью Memoizer, внутренней подсистемы, которая
подсчитывает, как часто SCons использует кешированные значения в памяти вместо того, чтобы пересчитывать их каждое
время, которое им нужно.

--debug = память
Выводит, сколько памяти использует SCons до и после чтения файлов SConscript и
до и после построения мишеней.

--debug = nomemoizer
Устаревший вариант сохранен для обратной совместимости.

--debug = объекты
Печатает список различных объектов различных классов, используемых внутри SCons.

--debug = pdb
Повторно запустите SCons под управлением отладчика Python pdb.

--debug = подготовить
Печатайте строку каждый раз, когда любая цель (внутренняя или внешняя) подготавливается к построению.
бра печатает это для каждой рассматриваемой цели, даже если эта цель актуальна (см.
также --debug = объяснять). Это может помочь отладить проблемы с целями, которые не
построен; это показывает, есть ли бра хотя бы рассматривает их или нет.

--debug = presub
Распечатайте необработанную командную строку, используемую для построения каждой цели перед построением
подставляются переменные среды. Также показывает, какие цели строятся
эту команду. Результат выглядит примерно так:

$ scons --debug = presub
Сборка myprog.o с действием (ями):
$ SHCC $ SHCFLAGS $ SHCCFLAGS $ CPPFLAGS $ _CPPINCFLAGS -c -o $ TARGET $ SOURCES
...

--debug = stacktrace
Печатает внутреннюю трассировку стека Python при обнаружении иначе необъяснимой
ошибка.

--debug = улица
Синоним нового --tree = все, статус вариант. В некоторых
будущий выпуск и в конечном итоге удален.

--debug = время
Печатает различную информацию о профиле времени: время, затраченное на выполнение каждого отдельного
команда сборки; общее время сборки (время выполнения SCons от начала до конца); Общая
время, потраченное на чтение и выполнение файлов SConscript; общее время, затраченное на сам SCons
тратить на выполнение (то есть без учета чтения и выполнения файлов SConscript); и оба
общее время, затраченное на выполнение всех команд сборки, и прошедшее время настенных часов
потратил на выполнение этих команд сборки. (Когда бра выполняется без -j вариант,
прошедшее время настенных часов обычно немного больше, чем общее время
потратил на выполнение всех команд сборки из-за обработки SCons, которая имеет место
между выполнением каждой команды. Когда бра выполняется -j вариант, и ваш
конфигурация сборки обеспечивает хорошее распараллеливание, прошедшее время настенных часов должно быть
значительно меньше, чем общее время, затрачиваемое на выполнение всех команд сборки,
поскольку несколько команд сборки и промежуточная обработка SCons должны выполняться в
параллельно.)

--debug = дерево
Синоним нового --tree = все вариант. Это будет устаревшим в будущем
релиз и в конечном итоге удален.

--diskcheck =Типы
Включите специальные проверки того, есть ли файл на диске, где SCons
конфигурация ожидает каталог (или наоборот), и независимо от того, RCS или SCCS
источники существуют при поиске исходных и включаемых файлов. В Типы аргумент может быть
установлен в: ВСЕ, чтобы явно включить все проверки (поведение по умолчанию); нет, отключить
все подобные проверки; совпадение, чтобы проверить соответствие файлов и каталогов на диске SCons '
ожидаемая конфигурация; система охлаждения реактора, чтобы проверить наличие источника RCS для любого
отсутствующие исходные или включаемые файлы; СКС, чтобы проверить наличие источника SCCS
для любого отсутствующего источника или включаемых файлов. Можно указать несколько проверок, разделенных
запятые; Например, --diskcheck = sccs, rcs все равно будет проверять источники SCCS и RCS,
но отключите проверку совпадений файлов и каталогов на диске. Отключение некоторых или
все эти проверки могут повысить производительность для больших конфигураций или когда
конфигурация будет проверять файлы и / или каталоги в сети или совместно
файловые системы, с небольшим повышенным риском неправильной сборки или необработки
ошибки корректно (если включаемые файлы действительно должны быть найдены в SCCS или RCS, для
пример, или если файл действительно существует, где конфигурация SCons ожидает
каталог).

--duplicate =ЗАКАЗАТЬ
Есть три способа дублировать файлы в дереве сборки: жесткие ссылки, программные (символические)
ссылки и копии. По умолчанию SCons предпочитают жесткие ссылки мягким ссылкам.
к копиям. С помощью этой опции вы можете указать различное поведение. ЗАКАЗАТЬ должен быть один
of бумажная копия (по умолчанию), электронная копия, печатная копия, электронная копия or копия. SCons
будет пытаться дублировать файлы, используя механизмы в указанном порядке.

-f файл, --file =файл, --makefile =файл, --sconstruct =файл
Используйте файл в качестве исходного файла SConscript. Несколько -f параметры могут быть указаны в
какой случай бра прочитает все указанные файлы.

-х, --помощь
Распечатайте локальное справочное сообщение для этой сборки, если оно определено в SConscript
файл (ы), плюс строка, описывающая -H параметр для справки по параметрам командной строки. Если нет
определено локальное справочное сообщение, печатает стандартное справочное сообщение о командной строке
параметры. Выход после отображения соответствующего сообщения.

-H, --help-параметры
Распечатайте стандартное справочное сообщение о параметрах командной строки и выйдите.

-i, --игнорировать-ошибки
Игнорируйте все ошибки команд, выполняемых для восстановления файлов.

-I каталог, --include-dir =каталог
Определяет каталог для поиска импортированных модулей Python. Если несколько -I варианты
используется, каталоги ищутся в указанном порядке.

--неявный-кэш
Кешировать неявные зависимости. Это вызывает бра использовать неявный (сканированный)
зависимости от последнего запуска вместо сканирования файлов на предмет неявных
зависимости. Это может значительно ускорить SCons, но со следующими
ограничения:

бра не будет обнаруживать изменения в путях поиска неявных зависимостей (например, CPPPATH, Либпуть)
это обычно приводит к использованию разных версий файлов с одинаковыми именами.

бра пропустит изменения в неявных зависимостях в случаях, когда новый неявный
зависимость добавляется ранее в путь поиска неявной зависимости (например, CPPPATH,
Либпуть), чем текущая неявная зависимость с тем же именем.

--implicit-deps-изменено
Заставляет SCons игнорировать кешированные неявные зависимости. Это вызывает неявный
зависимости, которые необходимо повторно сканировать и повторно кэшировать. Из этого следует --неявный-кэш.

--implicit-deps-без изменений
Заставить SCons игнорировать изменения в неявных зависимостях. Это вызывает кеширование
всегда должны использоваться неявные зависимости. Из этого следует --неявный-кэш.

- интерактивный
Запускает SCons в интерактивном режиме. Файлы SConscript читаются один раз и бра >>>
напечатана подсказка. Теперь цели можно перестроить, вводя команды в интерактивной подсказке.
без необходимости перечитывать файлы SConscript и повторно инициализировать граф зависимостей
с нуля.

В интерактивном режиме SCons поддерживаются следующие команды:

строить[ПАРАМЕТРЫ] [ЦЕЛИ] ...
Строит указанный ЦЕЛЕВЫЕ (и их зависимости) с указанными SCons
командной строки ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ. b и бра являются синонимами.

Следующие параметры командной строки SCons влияют на строить команда:

--cache-debug = ФАЙЛ
--кэш-отключить, --без-кэш
--cache-force, --cache-populate
--cache-только для чтения
--cache-show
--debug = ТИП
-i, --игнорировать-ошибки
-j N, --jobs = N
-k, --продолжать
-n, --no-exec, --just-print, --dry-run, --recon
-Q
-с, --тишина, --тишина
--taskmastertrace = ФАЙЛ
--tree = ОПЦИИ

Любые другие указанные параметры командной строки SCons не вызывают ошибок, но имеют
не влияет на строить (в основном потому, что они влияют на то, как файлы SConscript
читаются, что происходит только один раз в начале интерактивного режима).

чистым[ПАРАМЕТРЫ] [ЦЕЛИ] ...
Очищает указанные ЦЕЛЕВЫЕ (и их зависимости) с указанными параметрами.
c это синоним. Эта команда сама по себе является синонимом строить --чистый

выход
Выход из интерактивного режима SCons. Вы также можете выйти, завершив ввод (CTRL + D на
Системы UNIX или Linux, CTRL + Z в системах Windows).

помощь[КОМАНДА]
Предоставляет справочное сообщение о командах, доступных в интерактивном режиме SCons. Если
КОМАНДА указано, h и ? являются синонимами.

оболочка[КОМАНДНАЯ СТРОКА]
Выполняет указанный КОМАНДНАЯ СТРОКА в подоболочке. Если нет КОМАНДНАЯ СТРОКА указано,
выполняет интерактивный интерпретатор команд, указанный в SHELL охрана окружающей среды
переменная (в системах UNIX и Linux) или КОМСПЕК переменная окружения (на
Системы Windows). sh и ! являются синонимами.

версия
Печатает информацию о версии SCons.

Пустая строка повторяет последнюю набранную команду. Редактирование из командной строки можно использовать, если
Readline модуль доступен.

$ scons - интерактивный
scons: Чтение файлов SConscript ...
scons: чтение файлов SConscript завершено.
scons >>> build -n prog
scons >>> выход

-j N, --jobs =N
Задает количество одновременно выполняемых заданий (команд). Если больше, чем
one -j вариант, действует последний.

-k, --продолжать
Продолжайте как можно дольше после ошибки. Цель, которая потерпела неудачу, и те, которые
зависеть от этого не будет переделан, но другие цели, указанные в командной строке, будут
еще подлежат обработке.

-m
Игнорируется из-за совместимости с версиями, отличными от GNU. сделать.

--max-дрейф =СЕКУНД
Установите максимальный ожидаемый дрейф времени модификации файлов на СЕКУНД. Это
значение определяет, как долго файл должен оставаться неизменным, прежде чем его кэшируемое содержимое
подпись будет использоваться вместо вычисления новой подписи содержимого (контрольная сумма MD5)
содержимого файла. Значение по умолчанию - 2 дня, что означает, что файл должен иметь
время модификации не менее двух дней назад, чтобы его содержимое было кэшировано
подпись использована. Отрицательное значение означает никогда не кэшировать подпись содержимого и
игнорируйте кешированное значение, если оно уже есть. Значение 0 означает всегда использовать
кешированная подпись, независимо от возраста файла.

--md5-chunksize =КИЛОБАЙТОВ
Установите размер блока, используемый для вычисления подписей MD5, на КИЛОБАЙТОВ. Это значение определяет
размер блоков, которые считываются одновременно при вычислении подписей MD5. Файлы
ниже этого размера полностью сохраняются в памяти перед выполнением вычисления подписи
в то время как файлы большего размера читаются поблочно. Большой размер блока приводит к увеличению объема памяти
потребление, в то время как очень маленький размер блока значительно замедляет сборку.

Значение по умолчанию - использовать размер блока 64 килобайт, что должно быть подходящим.
для большинства применений.

-n, --just-print, --dry-run, --recon
Нет выполнения. Распечатайте команды, которые будут выполнены для построения любой устаревшей цели.
файлы, но не выполнять команды.

--no-сайт-каталог
Предотвращает автоматическое добавление стандарта. site_scons направляется к системный путь, Также
предотвращает загрузку site_scons / site_init.py модули, если они существуют, и предотвращает
добавляя свои site_scons / site_tools dirs к траектории инструмента.

--profile =файл
Запустите SCons под профилировщиком Python и сохраните результаты в указанном файл,
результаты можно проанализировать с помощью модуля Python pstats.

-q, --вопрос
Не запускайте никаких команд и ничего не печатайте. Просто верните нулевой статус выхода, если
указанные цели уже обновлены, в противном случае не равны нулю.

-Q
Quiets SCons статусные сообщения о чтении файлов SConscript, построении целей и
вход в каталоги. Команды, которые выполняются для восстановления целевых файлов, по-прежнему
распечатаны.

--случайный
Стройте зависимости в случайном порядке. Это полезно при построении нескольких деревьев.
одновременно с включенным кешированием, чтобы предотвратить одновременное создание нескольких сборок.
пытается построить или получить одни и те же целевые файлы.

-с, --тишина, --тишина
Тихий. Не печатайте команды, которые выполняются для восстановления целевых файлов. Также
подавляет сообщения о состоянии SCons.

-S, --не-продолжать, --стоп
Игнорируется из-за совместимости с GNU сделать.

--site-dir =директория
Использует названный каталог в качестве каталога сайта, а не по умолчанию site_scons dirs. Этот режиссер
будет добавлено к системный путь, модуль директория/site_init.py загрузится, если он
существует, и директория/ site_tools будет добавлен к траектории инструмента по умолчанию.

Набор по умолчанию site_scons dirs используется, когда --сайт-дир не указано зависит от
системная платформа, как показано ниже. Обратите внимание, что каталоги проверяются в порядке
задано, от наиболее общего до наиболее конкретного, поэтому последний выполненный файл site_init.py
наиболее конкретный (что дает ему возможность переопределить все остальное), и
dirs добавляются к путям, поэтому последний рассмотренный каталог идет первым в
результирующий путь.

Windows:

% ALLUSERSPROFILE / Данные приложения / scons / site_scons
% USERPROFILE% / Локальные настройки / Данные приложения / scons / site_scons
% APPDATA% / scons / site_scons
% HOME% /. Scons / site_scons
./site_scons

Mac OS X:

/ Библиотека / Поддержка приложений / SCons / site_scons
/ opt / local / share / scons / site_scons (для MacPorts)
/ sw / share / scons / site_scons (для Fink)
$ HOME / Библиотека / Поддержка приложений / SCons / site_scons
$ HOME / .scons / site_scons
./site_scons

Солярис:

/ opt / sfw / scons / site_scons
/ usr / share / scons / site_scons
$ HOME / .scons / site_scons
./site_scons

Linux, HPUX и другие системы, подобные Posix:

/ usr / share / scons / site_scons
$ HOME / .scons / site_scons
./site_scons

- размер стека =КИЛОБАЙТОВ
Установите стек размера, используемый для запуска потоков, на КИЛОБАЙТОВ. Это значение определяет стек
размер потоков, используемых для выполнения заданий. Это потоки, которые выполняют действия
построителей устаревших узлов. Обратите внимание, что эта опция не имеет
эффект, если num_jobs опция, соответствующая -j и --jobs, больше, чем
один. Использование слишком маленького размера стека может вызвать ошибки переполнения стека. Этот
обычно проявляется как ошибки сегментации, которые вызывают прерывание работы scons перед построением
что-нибудь. Использование слишком большого размера стека приведет к тому, что scons будут использовать больше памяти
чем требуется, и может замедлить весь процесс сборки.

Значение по умолчанию - использовать размер стека 256 килобайт, что должно быть подходящим.
для большинства применений. Вам не нужно увеличивать это значение, если вы не столкнетесь со стеком
ошибки переполнения.

-т, --touch
Игнорируется из-за совместимости с GNU сделать. (Прикосновение к файлу, чтобы он выглядел актуальным
не требуется при использовании бра.)

--taskmastertrace =файл
Печатает информацию трассировки в указанное файл о том, как внутренний надсмотрщик
объект оценивает и контролирует порядок построения узлов. Имя файла - май
использоваться для указания стандартного вывода.

-дерево =кредита
Печатает дерево зависимостей после построения каждой цели верхнего уровня. Это печатает
часть или все дерево в различных форматах, в зависимости от кредита указано:

--tree = все
Распечатайте все дерево зависимостей после построения каждой цели верхнего уровня. Это распечатывает
полное дерево зависимостей, включая неявные зависимости и игнорируемые
зависимости.

--tree = производный
Ограничивает вывод дерева только производными (целевыми) файлами, но не исходными файлами.

--tree = статус
Печатает информацию о состоянии для каждого отображаемого узла.

--tree = чернослив
Обрезает дерево, чтобы избежать повторения информации о зависимостях для узлов, которые уже
был отображен. Имя любого уже отображаемого узла будет напечатано в
[квадрат скобки], как указание на то, что зависимости для этого узла могут быть найдены
путем поиска соответствующего вывода выше в дереве.

Можно указать несколько параметров через запятую:

# Печатает только производные файлы с информацией о статусе:
scons --tree = производный, статус

# Печатает все зависимости цели с информацией о статусе
# и отсекаем зависимости уже посещенных узлов:
scons --tree = all, prune, status target

-u, --up, --search-up
Просматривает структуру каталогов до тех пор, пока не появится SConstruct , Сконструировать or строить файл
найден и использует его как верхнюю часть дерева каталогов. Если цели не указаны
в командной строке будут построены только цели в текущем каталоге или ниже него.

-U
Работает точно так же, как и -u вариант, за исключением того, как цели по умолчанию
обработано. Когда используется этот параметр и в командной строке не указаны цели,
все цели по умолчанию, которые определены в SConscript (ах) в текущем каталоге, являются
построен, независимо от того, в какой каталог попадают результирующие цели.

-v, --версия
Распечатать бра версия, информация об авторских правах, список авторов и любые другие
релевантная информация. Тогда выйдите.

-w, --print-каталог
Распечатайте сообщение, содержащее рабочий каталог, до и после другой обработки.

--no-print-каталог
Отключите -w, даже если он был включен неявно.

--warn =напишите, --warn = no-напишите
Включение или отключение предупреждений. напишите указывает тип включаемых предупреждений или
инвалидов:

--warn = все, --warn = нет-все
Включает или отключает все предупреждения.

--warn = ошибка записи кеша, --warn = ошибка записи кэша
Включает или отключает предупреждения об ошибках при попытке записать копию встроенного файла в
указанный CacheDir(). По умолчанию эти предупреждения отключены.

--warn = коррумпированный-sconsign, --warn = no-коррумпированный-sconsign
Включает или отключает предупреждения о незнакомых данных подписи в .sconsign файлы. Эти
предупреждения включены по умолчанию.

--warn = зависимость, --warn = отсутствие зависимости
Включает или отключает предупреждения о зависимостях. Эти предупреждения отключены
по умолчанию.

--warn = не рекомендуется, --warn = не рекомендуется
Включает или отключает все предупреждения об использовании устаревших функций. Эти
предупреждения включены по умолчанию. Обратите внимание, что --warn = no-deprecated вариант не
отключить предупреждения обо всех устаревших функциях. Предупреждения для некоторых
устаревшие функции, которые уже прошли несколько выпусков с прекращением поддержки
предупреждения могут быть обязательными для выпуска или двух, прежде чем они официально перестанут быть
при поддержке SCons. Могут быть включены предупреждения для некоторых определенных устаревших функций или
инвалиды индивидуально; см. ниже.

--warn = устаревшая-копия, --warn = не-устаревшая-копия
Включает или отключает предупреждения об использовании устаревшего env.Copy () метод.

--warn = устаревшие-исходные-подписи, --warn = не-устаревшие-исходные-подписи
Включает или отключает предупреждения об использовании устаревшего SourceSignatures ()
функция или env.SourceSignatures () метод.

--warn = устаревшие-целевые-подписи, --warn = не-устаревшие-целевые-подписи
Включает или отключает предупреждения об использовании устаревшего TargetSignatures ()
функция или env.TargetSignatures () метод.

--warn = duplicate-environment, --warn = no-duplicate-environment
Включает или отключает предупреждения о попытках указать сборку цели с двумя
различные строительные среды, использующие одно и то же действие. Эти предупреждения
по умолчанию включен.

--warn = fortran-cxx-mix, --warn = no-fortran-cxx-mix
Включает или отключает конкретное предупреждение о связывании объектных файлов Fortran и C ++ в
единственный исполняемый файл, который может привести к непредсказуемому поведению некоторых компиляторов.

--warn = future-deprecated, --warn = no-future-deprecated
Включает или отключает предупреждения о функциях, поддержка которых в будущем будет прекращена.
По умолчанию эти предупреждения отключены. Включение этого предупреждения особенно важно
рекомендуется для проектов, которые распространяют конфигурации SCons для других пользователей, чтобы
build, чтобы проект можно было как можно скорее предупредить о прекращении поддержки
функции, которые могут потребовать изменения конфигурации.

--warn = ссылка, --warn = без ссылки
Включает или отключает предупреждения о шагах ссылки.

--warn = ключевые слова, вводящие в заблуждение, --warn = ключевые слова, не вводящие в заблуждение
Включает или отключает предупреждения об использовании ключевых слов с ошибками направлена против и источники
при звонке строителям. (Обратите внимание на последний s символов, правильное написание цель
и источник.) Эти предупреждения включены по умолчанию.

--warn = missing-sconscript, --warn = no-missing-sconscript
Включает или отключает предупреждения об отсутствующих файлах SConscript. Эти предупреждения
по умолчанию включен.

--warn = no-md5-module, --warn = no-no-md5-module
Включает или отключает предупреждения о версии Python, не имеющей контрольной суммы MD5
модуль доступен. Эти предупреждения включены по умолчанию.

--warn = no-metaclass-support, --warn = no-no-metaclass-support
Включает или отключает предупреждения о версии Python, не поддерживающей метаклассы
когда окно --debug = мемоизатор опция используется. Эти предупреждения включены по умолчанию.

--warn = no-object-count, --warn = no-no-object-count
Включает или отключает предупреждения о --debug = объект функция не работает, когда бра
запускается с питоном -O вариант или из оптимизированных модулей Python (.pyo).

--warn = no-parallel-support, --warn = no-no-parallel-support
Включает или отключает предупреждения о том, что версия Python не поддерживает
параллельные сборки, когда -j опция используется. Эти предупреждения включены по умолчанию.

--warn = версия-python, --warn = no-версия-python
Включает или отключает предупреждение о запуске SCons с устаревшей версией
Python. Эти предупреждения включены по умолчанию.

--warn = зарезервированная переменная, --warn = без зарезервированной переменной
Включает или отключает предупреждения о попытках установить зарезервированную конструктивную переменную
имена ИЗМЕНЕННЫЕ_ИСТОЧНИКИ, CHANGED_TARGETS, TARGET, ЦЕЛЕВЫЕ, ИСТОЧНИК, ИСТОЧНИКИ,
НЕИЗМЕНЕННЫЕ_ИСТОЧНИКИ or UNCHANGED_TARGETS. По умолчанию эти предупреждения отключены.

--warn = размер стека, --warn = размер без стека
Включает или отключает предупреждения о запросах на установку размера стека, который не может быть
заслуженный. Эти предупреждения включены по умолчанию.

--warn = target_not_build, --warn = no-target_not_built
Включает или отключает предупреждения о том, что правило сборки не создает ожидаемых целей.
Эти предупреждения в настоящее время не включены по умолчанию.

-Y хранилище, --repository =хранилище, --srcdir =хранилище
Искать в указанном репозитории любые входные и целевые файлы, не найденные в локальном хранилище.
иерархия каталогов. Несколько -Y могут быть указаны опции, и в этом случае
поиск в репозиториях осуществляется в указанном порядке.

КОНФИГУРАЦИЯ ФАЙЛОВ СПРАВКА

Строительство Среды
Среда конструирования - это основное средство взаимодействия файлов SConscript.
собирать информацию для бра. Новая среда строительства создается с помощью
Окружающая среда функция:

env = Окружающая среда ()

Переменные, называемые строительство переменные, может быть установлен в строительной среде либо
указав их как ключевые слова при создании объекта или присвоив им значение
после создания объекта:

env = Окружающая среда (FOO = 'foo')
env ['BAR'] = 'бар'

Для удобства конструктивные переменные также могут быть установлены или изменены с помощью parse_flags
аргумент ключевого слова, который применяет Разбор флагов метод (описанный ниже) аргументу
значение после завершения всей остальной обработки. Это полезно, если точное содержание
флагов неизвестно (например, прочитано из контрольного файла) или если флаги
распределен по ряду переменных конструкции.

env = Environment (parse_flags = '-Iinclude -DEBUG -lm')

В этом примере к CPPPATH, "EBUG" на CPDОПРЕДЕЛЯЕТ, а 'm' - БИБЛИОТЕКИ.

По умолчанию новая среда конструирования инициализируется набором методов компоновщика.
и конструктивные переменные, подходящие для текущей платформы. Необязательный
аргумент ключевого слова платформы может использоваться, чтобы указать, что среда должна быть инициализирована
для другой платформы:

env = Среда (платформа = 'cygwin')
env = Среда (платформа = 'os2')
env = Среда (платформа = 'posix')
env = Среда (платформа = 'win32')

Указание платформы инициализирует соответствующие конструктивные переменные в
среды для использования и генерации имен файлов с префиксами и суффиксами, подходящими для
.

Обратите внимание, что win32 платформа добавляет СистемДрайв и SystemRoot переменные от пользователя
внешняя среда к среде строительства ENV толковый словарь. Это так, что любой
выполняемые команды, которые используют сокеты для подключения к другим системам (например, выборка источника
файлы из внешних спецификаций репозитория CVS, например
: pserver:[электронная почта защищена]: / cvsroot / scons) будет работать в системах Windows.

Аргумент платформы может быть функцией или вызываемым объектом, и в этом случае Environment ()
метод вызовет указанный аргумент для обновления новой среды построения:

def my_platform (env):
env ['VAR'] = 'xyzzy'

env = Среда (платформа = my_platform)

Кроме того, может быть определен набор инструментов для инициализации среды.
указывается как необязательный аргумент ключевого слова:

env = Environment (tools = ['msvc', 'lex'])

Невстроенные инструменты могут быть указаны с помощью аргумента траектории инструмента:

env = Environment (tools = ['default', 'foo'], toolpath = ['tools'])

Это ищет спецификацию инструмента в tools / foo.py (а также использует обычное значение по умолчанию
инструменты для платформы). foo.py должен иметь две функции: generate (env, ** kw) и
существует (env). В генерировать () функция изменяет переданную среду для настройки
переменные, чтобы инструмент можно было запустить; он может использовать любые аргументы ключевого слова, которые пользователь
расходные материалы (см. ниже), чтобы изменить его инициализацию. В существуют() функция должна возвращать
истинное значение, если инструмент доступен. Инструменты в траектории используются до любого из
встроенные. Например, добавление gcc.py к траектории инструмента переопределит встроенный gcc
орудие труда. Также обратите внимание, что траектория инструмента сохраняется в среде для использования в последующих вызовах
Клон() и Инструмент() методы:

base = Environment (toolpath = ['custom_path'])
производное = base.Clone (tools = ['custom_tool'])
производный.CustomBuilder ()

Элементы списка инструментов также могут быть функциями или вызываемыми объектами, и в этом случае
метод Environment () вызовет указанные элементы для обновления новой конструкции
Окружающая среда:

def my_tool (env):
env ['XYZZY'] = 'xyzzy'

env = Environment (tools = [my_tool])

Отдельные элементы списка инструментов также могут быть двухэлементными списками
форма (название инструмента, kw_dict). SCons ищет название инструмента файл спецификации, как описано
выше и проходит kw_dict, который должен быть словарем, в качестве аргументов ключевого слова для инструмента
порождать функция. порождать функция может использовать аргументы для изменения
поведение, настраивая среду по-разному или иным образом изменяя ее
инициализация.

# в tools / my_tool.py:
def generate (env, ** kw):
# Устанавливает MY_TOOL в значение аргумента ключевого слова 'arg1' или 1.
env ['MY_TOOL'] = kw.get ('arg1', '1')
def существует (env):
вернуть 1

# в SConstruct:
env = Environment (tools = ['default', ('my_tool', {'arg1': 'abc'})],
toolpath = ['инструменты'])

Определение инструмента (например, my_tool ()) может использовать переменную PLATFORM из среды, в которой оно
получает возможность настроить инструмент для разных платформ.

Если список инструментов не указан, SCons автоматически обнаружит установленные инструменты с помощью
Переменная PATH в переменной конструкции ENV и имя платформы, когда Environment
построен. Изменение переменной PATH после создания среды не приведет к
вызвать повторное обнаружение инструментов.

SCons из коробки поддерживает следующие спецификации инструментов:

386асм
Устанавливает конструктивные переменные для ассемблера 386ASM для встроенного Phar Lap ETS.
операционная система.

Наборы: $ AS, $ ASCOM, $ ASFLAGS, $ ASPPCOM, $ ASPPFLAGS.

Применение: $ CC, $ CPPFLAGS, $ _CPPDEFFLAGS, $ _CPPINCFLAGS.

aixc ++
Задает конструктивные переменные для компилятора IMB xlc / Visual Age C ++.

Наборы: $ CXX, $ CXXVERSION, $ SHCXX, $ SHOBJSUFFIX.

aixcc
Задает конструктивные переменные для компилятора IBM xlc / Visual Age C.

Наборы: $ CC, $ CCVERSION, $ SHCC.

aixf77
Задает конструктивные переменные для компилятора Fortran IBM Visual Age f77.

Наборы: 77 долларов США, 77 долларов США.

Aixlink
Задает конструктивные переменные для компоновщика IBM Visual Age.

Наборы: $ LINKFLAGS, $ SHLIBSUFFIX, $ SHLINKFLAGS.

яблоко
Устанавливает конструкционные переменные для компоновщика Apple (аналогично компоновщику GNU).

Наборы: $ FRAMEWORKPATHPREFIX, $ LDMODULECOM, $ LDMODULEFLAGS, $ LDMODULEPREFIX,
$ LDMODULESUFFIX, $ LINKCOM, $ SHLINKCOM, $ SHLINKFLAGS, $ _FRAMEWORKPATH, $ _FRAMEWORKS.

Применение: $ FRAMEWORKSFLAGS.

ar
Устанавливает конструктивные переменные для архиватора библиотеки ar.

Наборы: $ AR, $ ARCOM, $ ARFLAGS, $ LIBPREFIX, $ LIBSUFFIX, $ RANLIB, $ RANLIBCOM,
$ RANLIBFLAGS.

as
Устанавливает переменные конструкции для ассемблера.

Наборы: $ AS, $ ASCOM, $ ASFLAGS, $ ASPPCOM, $ ASPPFLAGS.

Применение: $ CC, $ CPPFLAGS, $ _CPPDEFFLAGS, $ _CPPINCFLAGS.

bcc32
Устанавливает конструктивные переменные для компилятора bcc32.

Наборы: $ CC, $ CCCOM, $ CCFLAGS, $ CFILESUFFIX, $ CFLAGS, $ CPPDEFPREFIX, $ CPPDEFSUFFIX,
$ INCPREFIX, $ INCSUFFIX, $ SHCC, $ SHCCCOM, $ SHCCFLAGS, $ SHCFLAGS, $ SHOBJSUFFIX.

Применение: $ _CPPDEFFLAGS, $ _CPPINCFLAGS.

BitKeeper
Задает конструктивные переменные для системы управления исходным кодом BitKeeper.

Наборы: $ BITKEEPER, $ BITKEEPERCOM, $ BITKEEPERGET, $ BITKEEPERGETFLAGS.

Применение: $ BITKEEPERCOMSTR.

cc
Устанавливает конструктивные переменные для общих копировщиков POSIX C.

Наборы: $ CC, $ CCCOM, $ CCFLAGS, $ CFILESUFFIX, $ CFLAGS, $ CPPDEFPREFIX, $ CPPDEFSUFFIX,
$ FRAMEWORKPATH, РАМКИ, $ INCPREFIX, $ INCSUFFIX, $ SHCC, $ SHCCCOM, $ SHCCFLAGS,
$ SHCFLAGS, $ SHOBJSUFFIX.

Применение: $ ПЛАТФОРМА.

CVF
Задает конструктивные переменные для компилятора Compaq Visual Fortran.

Наборы: $ FORTRAN, $ FORTRANCOM, $ FORTRANMODDIR, $ FORTRANMODDIRPREFIX,
$ FORTRANMODDIRSUFFIX, $ FORTRANPPCOM, $ OBJSUFFIX, $ SHFORTRANCOM, $ SHFORTRANPPCOM.

Применение: $ CPPFLAGS, $ FORTRANFLAGS, $ SHFORTRANFLAGS, $ _CPPDEFFLAGS, $ _FORTRANINCFLAGS,
$ _FORTRANMODFLAG.

CVS
Устанавливает конструктивные переменные для системы управления исходным кодом CVS.

Наборы: $ CVS, $ CVSCOFLAGS, $ CVSCOM, $ CVSFLAGS.

Применение: $ CVSCOMSTR.

сХХ
Устанавливает конструкционные переменные для общих компиляторов POSIX C ++.

Наборы: $ CPPDEFPREFIX, $ CPPDEFSUFFIX, $ CXX, $ CXXCOM, $ CXXFILESUFFIX, $ CXXFLAGS,
$ INCPREFIX, $ INCSUFFIX, $ OBJSUFFIX, $ SHCXX, $ SHCXXCOM, $ SHCXXFLAGS, $ SHOBJSUFFIX.

Применение: $ CXXCOMSTR.

циглинк
Установите переменные конструкции для компоновщика / загрузчика cygwin.

Наборы: $ IMPLIBPREFIX, $ IMPLIBSUFFIX, $ LDMODULEVERSIONFLAGS, $ LINKFLAGS, $ RPATHPREFIX,
$ RPATHSUFFIX, $ SHLIBPREFIX, $ SHLIBSUFFIX, $ SHLIBVERSIONFLAGS, $ SHLINKCOM,
$ SHLINKFLAGS, $ _LDMODULEVERSIONFLAGS, $ _SHLIBVERSIONFLAGS.

по умолчанию
Устанавливает переменные, вызывая список модулей инструментов по умолчанию для платформы, на которой
SCons работает.

DMD
Устанавливает конструктивные переменные для компилятора языка D. DMD.

Наборы: $ DC, $ DCOM, $ DDEBUG, $ DDEBUGPREFIX, $ DDEBUGSUFFIX, $ DFILESUFFIX, $ DFLAGPREFIX,
$ DFLAGS, $ DFLAGSUFFIX, $ DINCPREFIX, $ DINCSUFFIX, $ DLIB, $ DLIBCOM, $ DLIBDIRPREFIX,
$ DLIBDIRSUFFIX, $ DLIBFLAGPREFIX, $ DLIBFLAGSUFFIX, $ DLIBLINKPREFIX, $ DLIBLINKSUFFIX,
$ DLINK, $ DLINKCOM, $ DLINKFLAGS, $ DPATH, $ DVERPREFIX, $ ДВЕРСИИ, $ DVERSUFFIX,
$ RPATHPREFIX, $ RPATHSUFFIX, $ SHDC, $ SHDCOM, $ SHDLINK, $ SHDLINKCOM, $ SHDLINKФЛАГИ,
$ _DDEBUGFLAGS, $ _DFLAGS, $ _DINCFLAGS, $ _DLIBDIRFLAGS, $ _DLIBFLAGS, $ _DLIBFLAGS,
$ _DVERFLAGS, $ _RPATH.

документация
Этот инструмент пытается немного упростить работу с Docbook в SCons. Это обеспечивает
несколько наборов инструментов для создания различных форматов вывода, таких как HTML или PDF. Содержится
в пакете находится дистрибутив таблиц стилей Docbook XSL версии 1.76.1.
Пока вы не укажете свои собственные таблицы стилей для настройки, эти официальные
версии выбраны по умолчанию ... что должно уменьшить неизбежные проблемы с настройкой для
вас.

Неявные зависимости к изображениям и XIncludes обнаруживаются автоматически, если вы встречаете
требования HTML. Дополнительная таблица стилей utils / xmldepend.xsl от Пола Дюбуа
используется для этой цели.

Обратите внимание, что поддержка разрешения XML-каталога не предлагается! Этот инструмент вызывает
Процессоры XSLT и средства визуализации PDF с указанными вами таблицами стилей, вот и все. В
отдых лежит в ваших руках, и вы все равно должны знать, что делаете, когда решаете
имена через каталог.

Для активации инструмента «docbook» вам необходимо добавить его название в Environment
конструктор, вот так

env = Environment (tools = ['docbook'])

При запуске инструмент Docbook пытается найти требуемый процессор xsltproc, а
Средство визуализации PDF, например fop. Поэтому убедитесь, что они добавлены в вашу систему
PATH среды и может вызываться напрямую, без указания их полного пути.

Для самой простой обработки Docbook в HTML вам необходимо установить

· Привязка Python lxml к libxml2, или

· Прямые привязки Python к libxml2 / libxslt или

· Автономный XSLT-процессор, в настоящее время обнаружены xsltproc, saxon, saxon-xslt
и ксалан.

Для рендеринга в PDF необходимо, чтобы у вас было установлено одно из приложений fop или xep.

Создать документ HTML или PDF очень просто. Сказать

env = Environment (tools = ['docbook'])
env.DocbookHtml ('manual.html', 'manual.xml')
env.DocbookPdf ('manual.pdf', 'manual.xml')

чтобы получить оба вывода из исходного XML-файла manual.xml. В качестве ярлыка вы можете указать
основы только имен файлов, например:

env = Environment (tools = ['docbook'])
env.DocbookHtml ('руководство')
env.DocbookPdf ('руководство')

и получите тот же результат. Также поддерживаются целевые и исходные списки:

env = Environment (tools = ['docbook'])
env.DocbookHtml (['manual.html', 'reference.html'], ['manual.xml', 'reference.xml'])

или даже

env = Environment (tools = ['docbook'])
env.DocbookHtml (['руководство', 'справка'])

Важнo
Всякий раз, когда вы опускаете список источников, вы не можете указывать расширение файла!
Инструмент использует указанные имена в качестве основы файлов и добавляет суффиксы для целей и
исходные файлы соответственно.
Приведенные выше правила действительны для Строителей. DocbookHTML, Документ PDF, ДокументEpub,
DocbookСлайдыPdf и DocbookXInclude. Для ДокументЧеловек трансформация вы можете
указать целевое имя, но фактические выходные имена автоматически устанавливаются из
записи refname в вашем источнике XML.

Строители DocbookHtmlChunked, DocbookHtmlhelp и ДокументСлайдыHtml особенные, в
, что:

1. они создают большой набор файлов, где точные имена и их количество зависят от
содержимое исходного файла и

2. основная цель всегда называется index.html, то есть имя вывода для XSL
трансформация не поддерживается таблицами стилей.

В результате указывать целевое HTML-имя просто бесполезно. Итак, основные
синтаксис для этих построителей всегда:

env = Environment (tools = ['docbook'])
env.DocbookHtmlhelp ('руководство')

Если вы хотите использовать определенный файл XSL, вы можете установить дополнительный параметр xsl на
ваш Builder вызовет следующее:

env.DocbookHtml ('другой.html', 'manual.xml', xsl = 'html.xsl')

Поскольку это может оказаться утомительным, если вы всегда будете использовать одно и то же локальное именование для своих настраиваемых
Файлы XSL, например html.xsl для HTML и pdf.xsl для вывода PDF, набор переменных для
предоставляется установка имени XSL по умолчанию. Эти:

DOCBOOK_DEFAULT_XSL_HTML
DOCBOOK_DEFAULT_XSL_HTMLCHUNKED
DOCBOOK_DEFAULT_XSL_HTMLHELP
DOCBOOK_DEFAULT_XSL_PDF
DOCBOOK_DEFAULT_XSL_EPUB
DOCBOOK_DEFAULT_XSL_MAN
DOCBOOK_DEFAULT_XSL_SLIDESPDF
DOCBOOK_DEFAULT_XSL_SLIDESHTML

и вы можете установить их при построении вашей среды:

env = Environment (tools = ['docbook'],
DOCBOOK_DEFAULT_XSL_HTML = 'html.xsl',
DOCBOOK_DEFAULT_XSL_PDF = 'pdf.xsl')
env.DocbookHtml ('manual') # теперь использует html.xsl

Наборы: $ DOCBOOK_DEFAULT_XSL_EPUB, $ DOCBOOK_DEFAULT_XSL_HTML,
$ DOCBOOK_DEFAULT_XSL_HTMLCHUNKED, $ DOCBOOK_DEFAULT_XSL_HTMLHELP,
$ DOCBOOK_DEFAULT_XSL_MAN, $ DOCBOOK_DEFAULT_XSL_PDF, $ DOCBOOK_DEFAULT_XSL_SLIDESHTML,
$ DOCBOOK_DEFAULT_XSL_SLIDESPDF, $ DOCBOOK_FOP, $ DOCBOOK_FOPCOM, $ DOCBOOK_FOPFLAGS,
$ DOCBOOK_XMLLINT, $ DOCBOOK_XMLLINTCOM, $ DOCBOOK_XMLLINTFLAGS, $ DOCBOOK_XSLTPROC,
$ DOCBOOK_XSLTPROCCOM, $ DOCBOOK_XSLTPROCFLAGS, $ DOCBOOK_XSLTPROCPARAMS.

Применение: $ DOCBOOK_FOPCOMSTR, $ DOCBOOK_XMLLINTCOMSTR, $ DOCBOOK_XSLTPROCCOMSTR.

дви
Прикрепляет DVI строитель к строительной среде.

dvipdf
Устанавливает конструктивные переменные для утилиты dvipdf.

Наборы: $ DVIPDF, $ DVIPDFCOM, $ DVIPDFFLAGS.

Применение: $ DVIPDFCOMSTR.

Dvips
Устанавливает конструктивные переменные для утилиты dvips.

Наборы: $ DVIPS, $ DVIPSFLAGS, $ PSCOM, $ PSPREFIX, $ PSSUFFIX.

Применение: $ PSCOMSTR.

f03
Задайте конструктивные переменные для общих компиляторов POSIX Fortran 03.

Наборы: 03 долларов США, $ F03COM, $ F03ФЛАГИ, $ F03PPCOM, 03 долларов США, $ SHF03COM, $ SHF03FLAGS,
$ SHF03PPCOM, $ _F03INCFLAGS.

Применение: $ F03COMSTR, $ F03PPCOMSTR, $ SHF03COMSTR, $ SHF03PPCOMSTR.

f08
Задайте конструктивные переменные для общих компиляторов POSIX Fortran 08.

Наборы: 08 долларов США, $ F08COM, $ F08ФЛАГИ, $ F08PPCOM, 08 долларов США, $ SHF08COM, $ SHF08FLAGS,
$ SHF08PPCOM, $ _F08INCFLAGS.

Применение: $ F08COMSTR, $ F08PPCOMSTR, $ SHF08COMSTR, $ SHF08PPCOMSTR.

f77
Задайте конструктивные переменные для общих компиляторов POSIX Fortran 77.

Наборы: 77 долларов США, $ F77COM, $ F77ФАЙЛЫ, $ F77ФЛАГИ, $ F77PPCOM, $ F77PPFILESUFFIXES,
$ FORTRAN, $ FORTRANCOM, $ FORTRANFLAGS, 77 долларов США, $ SHF77COM, $ SHF77FLAGS, $ SHF77PPCOM,
$ ШФОРТРАН, $ SHFORTRANCOM, $ SHFORTRANFLAGS, $ SHFORTRANPPCOM, $ _F77INCFLAGS.

Применение: $ F77COMSTR, $ F77PPCOMSTR, $ FORTRANCOMSTR, $ FORTRANPPCOMSTR, $ SHF77COMSTR,
$ SHF77PPCOMSTR, $ ШФОРТРАНКОМСТР, $ SHFORTRANPPCOMSTR.

f90
Задайте конструктивные переменные для общих компиляторов POSIX Fortran 90.

Наборы: 90 долларов США, $ F90COM, $ F90ФЛАГИ, $ F90PPCOM, 90 долларов США, $ SHF90COM, $ SHF90FLAGS,
$ SHF90PPCOM, $ _F90INCFLAGS.

Применение: $ F90COMSTR, $ F90PPCOMSTR, $ SHF90COMSTR, $ SHF90PPCOMSTR.

f95
Задайте конструктивные переменные для общих компиляторов POSIX Fortran 95.

Наборы: 95 долларов США, $ F95COM, $ F95ФЛАГИ, $ F95PPCOM, 95 долларов США, $ SHF95COM, $ SHF95FLAGS,
$ SHF95PPCOM, $ _F95INCFLAGS.

Применение: $ F95COMSTR, $ F95PPCOMSTR, $ SHF95COMSTR, $ SHF95PPCOMSTR.

Фортран
Задайте конструкционные переменные для общих компиляторов POSIX Fortran.

Наборы: $ FORTRAN, $ FORTRANCOM, $ FORTRANFLAGS, $ ШФОРТРАН, $ SHFORTRANCOM,
$ SHFORTRANFLAGS, $ SHFORTRANPPCOM.

Применение: $ FORTRANCOMSTR, $ FORTRANPPCOMSTR, $ ШФОРТРАНКОМСТР, $ SHFORTRANPPCOMSTR.

г ++
Задайте конструкционные переменные для компилятора gXX C ++.

Наборы: $ CXX, $ CXXVERSION, $ SHCXXFLAGS, $ SHOBJSUFFIX.

g77
Задайте конструктивные переменные для компилятора Fortran g77. Вызывает модуль инструмента f77 для
установить переменные.

газ
Устанавливает конструктивные переменные для сборщика газа. Вызывает модуль as.

Наборы: $ AS.

GCC
Задайте конструкционные переменные для компилятора gcc C.

Наборы: $ CC, $ CCVERSION, $ SHCCFLAGS.

GDC
Устанавливает конструктивные переменные для компилятора языка D. GDC.

Наборы: $ DC, $ DCOM, $ DDEBUG, $ DDEBUGPREFIX, $ DDEBUGSUFFIX, $ DFILESUFFIX, $ DFLAGPREFIX,
$ DFLAGS, $ DFLAGSUFFIX, $ DINCPREFIX, $ DINCSUFFIX, $ DLIB, $ DLIBCOM, $ DLIBFLAGPREFIX,
$ DLIBFLAGSUFFIX, $ DLINK, $ DLINKCOM, $ DLINKFLAGPREFIX, $ DLINKFLAGS, $ DLINKFLAGSUFFIX,
$ DPATH, $ DVERPREFIX, $ ДВЕРСИИ, $ DVERSUFFIX, $ RPATHPREFIX, $ RPATHSUFFIX, $ SHDC,
$ SHDCOM, $ SHDLINK, $ SHDLINKCOM, $ SHDLINKФЛАГИ, $ _DDEBUGFLAGS, $ _DFLAGS, $ _DINCFLAGS,
$ _DLIBFLAGS, $ _DVERFLAGS, $ _RPATH.

Gettext
Фактически это набор инструментов, который поддерживает интернационализацию и локализацию
программное обеспечение, создаваемое с помощью SCons. Набор инструментов загружает следующие инструменты:

· Xgettext - для извлечения интернационализированных сообщений из исходного кода в файл (ы) POT,

· Msginit - опционально может использоваться для инициализации файлов PO,

· Msgmerge - для обновления PO файлов, которые уже содержат переведенные сообщения,

· Msgfmt - для компиляции текстового PO-файла в двоичный устанавливаемый MO-файл.

Когда вы включаете gettext, он загружает все вышеупомянутые инструменты, так что вы
рекомендуется просматривать их индивидуальную документацию.

Каждый из вышеперечисленных инструментов предоставляет свой собственный конструктор (-ы), который может использоваться для выполнения
конкретные действия, связанные с интернационализацией программного обеспечения. Однако вы можете быть
увлекающийся верхний уровень строитель Переведите описал несколькими абзацами позже.

Чтобы использовать инструменты gettext, добавьте в свою среду инструмент gettext:

env = Environment (tools = ['default', 'gettext'])

Gfortran
Устанавливает конструктивные переменные для компилятора GNU F95 / F2003 GNU.

Наборы: 77 долларов США, 90 долларов США, 95 долларов США, $ FORTRAN, 77 долларов США, $ SHF77FLAGS, 90 долларов США, $ SHF90FLAGS, 95 долларов США,
$ SHF95FLAGS, $ ШФОРТРАН, $ SHFORTRANFLAGS.

гнулинк
Установите переменные конструкции для компоновщика / загрузчика GNU.

Наборы: $ LDMODULEVERSIONFLAGS, $ RPATHPREFIX, $ RPATHSUFFIX, $ SHLIBVERSIONFLAGS,
$ SHLINKFLAGS, $ _LDMODULESONAME, $ _SHLIBSONAME.

gs
Этот инструмент устанавливает необходимые конструктивные переменные для работы с Ghostscript.
команда. Он также регистрирует соответствующее действие в PDF Builder (PDF), такой что
преобразование из PS / EPS в PDF происходит автоматически для набора инструментов TeX / LaTeX.
Наконец, он добавляет явный Ghostscript Builder (Gs) в окружающую среду.

Наборы: $ GS, $ GSCOM, $ GSFLAGS.

Применение: $ GSCOMSTR.

hpc ++
Установите переменные конструкции для компиляторов aCC в системах HP / UX.

HPCC
Задайте конструктивные переменные для ACC в системах HP / UX. Вызывает инструмент cXX для
дополнительные переменные.

Наборы: $ CXX, $ CXXVERSION, $ SHCXXFLAGS.

ссылка
Устанавливает конструкционные переменные для компоновщика в системах HP / UX.

Наборы: $ LINKFLAGS, $ SHLIBSUFFIX, $ SHLINKFLAGS.

МЦХ
Устанавливает переменные конструкции для компилятора icc в системах OS / 2.

Наборы: $ CC, $ CCCOM, $ CFILESUFFIX, $ CPPDEFPREFIX, $ CPPDEFSUFFIX, $ CXXCOM,
$ CXXFILESUFFIX, $ INCPREFIX, $ INCSUFFIX.

Применение: $ CCFLAGS, $ CFLAGS, $ CPPFLAGS, $ _CPPDEFFLAGS, $ _CPPINCFLAGS.

ICL
Задает конструктивные переменные для компилятора Intel C / C ++. Вызывает модуль Intelc Tool
чтобы установить его переменные.

если
Устанавливает конструктивные переменные для компилятора Intel Fortran.

Наборы: $ FORTRAN, $ FORTRANCOM, $ FORTRANPPCOM, $ SHFORTRANCOM, $ SHFORTRANPPCOM.

Применение: $ CPPFLAGS, $ FORTRANFLAGS, $ _CPPDEFFLAGS, $ _FORTRANINCFLAGS.

ифорт
Устанавливает конструктивные переменные для более новых версий компилятора Intel Fortran для
Linux.

Наборы: 77 долларов США, 90 долларов США, 95 долларов США, $ FORTRAN, 77 долларов США, $ SHF77FLAGS, 90 долларов США, $ SHF90FLAGS, 95 долларов США,
$ SHF95FLAGS, $ ШФОРТРАН, $ SHFORTRANFLAGS.

iLink
Устанавливает переменные конструкции для компоновщика ilink в системах OS / 2.

Наборы: $ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX, $ LINK, $ LINKCOM,
$ LINKFLAGS.

ilink32
Задает конструктивные переменные для компоновщика Borland ilink32.

Наборы: $ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX, $ LINK, $ LINKCOM,
$ LINKFLAGS.

устанавливать
Устанавливает конструктивные переменные для установки файлов и каталогов.

Наборы: $ УСТАНОВИТЬ, $ INSTALLSTR.

интеллект
Устанавливает конструктивные переменные для компилятора Intel C / C ++ (Linux и Windows, версия 7
и позже). Вызывает gcc или msvc (в Linux и Windows соответственно) для установки
базовые переменные.

Наборы: $ AR, $ CC, $ CXX, $ INTEL_C_COMPILER_VERSION, $ LINK.

банка
Устанавливает конструктивные переменные для утилиты jar.

Наборы: $ JAR, $ JARCOM, $ JARFLAGS, $ JARSUFFIX.

Применение: $ JARCOMSTR.

Javac
Устанавливает конструктивные переменные для компилятора javac.

Наборы: $ JAVABOOTCLASSPATH, $ JAVAC, $ JAVACCOM, $ JAVACFLAGS, $ JAVACLASSPATH,
$ JAVACLASSSUFFIX, $ JAVASOURCEPATH, $ JAVASUFFIX.

Применение: $ JAVACCOMSTR.

Джава
Устанавливает конструктивные переменные для инструмента javah.

Наборы: $ JAVACLASSSUFFIX, $ JAVAH, $ JAVAHCOM, $ JAVAHFLAGS.

Применение: $ JAVACLASSPATH, $ JAVAHCOMSTR.

латекс
Устанавливает конструктивные переменные для латексной утилиты.

Наборы: $ LATEX, $ LATEXCOM, $ LATEXFLAGS.

Применение: $ LATEXCOMSTR.

LDC
Устанавливает конструктивные переменные для компилятора языка D LDC2.

Наборы: $ DC, $ DCOM, $ DDEBUG, $ DDEBUGPREFIX, $ DDEBUGSUFFIX, $ DFILESUFFIX, $ DFLAGPREFIX,
$ DFLAGS, $ DFLAGSUFFIX, $ DINCPREFIX, $ DINCSUFFIX, $ DLIB, $ DLIBCOM, $ DLIBDIRPREFIX,
$ DLIBDIRSUFFIX, $ DLIBFLAGPREFIX, $ DLIBFLAGSUFFIX, $ DLIBLINKPREFIX, $ DLIBLINKSUFFIX,
$ DLINK, $ DLINKCOM, $ DLINKFLAGPREFIX, $ DLINKFLAGS, $ DLINKFLAGSUFFIX, $ DPATH,
$ DVERPREFIX, $ ДВЕРСИИ, $ DVERSUFFIX, $ RPATHPREFIX, $ RPATHSUFFIX, $ SHDC, $ SHDCOM,
$ SHDLINK, $ SHDLINKCOM, $ SHDLINKФЛАГИ, $ _DDEBUGFLAGS, $ _DFLAGS, $ _DINCFLAGS,
$ _DLIBDIRFLAGS, $ _DLIBFLAGS, $ _DLIBFLAGS, $ _DVERFLAGS, $ _RPATH.

закон
Устанавливает конструктивные переменные для лексического анализатора.

Наборы: $ LEX, $ LEXCOM, $ LEXFLAGS.

Применение: $ LEXCOMSTR.

ссылке.
Устанавливает конструкционные переменные для универсальных компоновщиков POSIX.

Наборы: $ LDMODULE, $ LDMODULECOM, $ LDMODULEFLAGS, $ LDMODULENOVERSIONSYMLINKS,
$ LDMODULEPREFIX, $ LDMODULESUFFIX, $ LDMODULEVERSION, $ LDMODULEVERSIONFLAGS,
$ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX, $ LINK, $ LINKCOM,
$ LINKFLAGS, $ SHLIBSUFFIX, $ SHLINK, $ SHLINKCOM, $ SHLINKFLAGS, $ __ LDMODULEVERSIONFLAGS,
$ __ SHLIBVERSIONFLAGS.

Применение: $ LDMODULECOMSTR, $ LINKCOMSTR, $ SHLINKCOMSTR.

ссылкалок
Устанавливает конструктивные переменные для линкера LinkLoc для встроенного Phar Lap ETS.
операционная система.

Наборы: $ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX, $ LINK, $ LINKCOM,
$ LINKFLAGS, $ SHLINK, $ SHLINKCOM, $ SHLINKFLAGS.

Применение: $ LINKCOMSTR, $ SHLINKCOMSTR.

m4
Устанавливает конструктивные переменные для макропроцессора m4.

Наборы: $ M4, $ M4COM, $ M4FLAGS.

Применение: $ M4COMSTR.

Masm
Устанавливает конструктивные переменные для ассемблера Microsoft.

Наборы: $ AS, $ ASCOM, $ ASFLAGS, $ ASPPCOM, $ ASPPFLAGS.

Применение: $ ASCOMSTR, $ ASPPCOMSTR, $ CPPFLAGS, $ _CPPDEFFLAGS, $ _CPPINCFLAGS.

мидл
Задает конструктивные переменные для компилятора Microsoft IDL.

Наборы: $ MIDL, $ MIDLCOM, $ MIDLFLAGS.

Применение: $ MIDLCOMSTR.

Mingw
Устанавливает конструктивные переменные для MinGW (Minimal Gnu в Windows).

Наборы: $ AS, $ CC, $ CXX, $ LDMODULECOM, $ LIBPREFIX, $ LIBSUFFIX, $ OBJSUFFIX, $ RC, $ RCCOM,
$ RCFLAGS, $ RCINCFLAGS, $ RCINCPREFIX, $ RCINCSUFFIX, $ SHCCFLAGS, $ SHCXXFLAGS,
$ SHLINKCOM, $ SHLINKFLAGS, $ SHOBJSUFFIX, $ WINDOWSDEFPREFIX, $ WINDOWSDEFSUFFIX.

Применение: $ RCCOMSTR, $ SHLINKCOMSTR.

мсгфмт
Этот инструмент scons является частью набора инструментов scons gettext. Он предоставляет интерфейс scons для
мсгфмт(1) команда, которая генерирует двоичный каталог сообщений (MO) из текстового
описание перевода (ПО).

Наборы: $ MOSUFFIX, $ MSGFMT, $ MSGFMTCOM, $ MSGFMTCOMSTR, $ MSGFMTFLAGS, $ ПОСУФФИКС.

Применение: $ LINGUAS_FILE.

мсгинит
Этот инструмент scons является частью набора инструментов scons gettext. Он предоставляет интерфейс scons для
мсгинит(1) программа, которая создает новый PO-файл, инициализируя метаинформацию с помощью
значения из среды пользователя (или параметры).

Наборы: $ MSGINIT, $ MSGINITCOM, $ MSGINITCOMSTR, $ MSGINITFLAGS, $ POAUTOINIT,
$ POCREATE_ALIAS, $ ПОСУФФИКС, $ POTSUFFIX, $ _MSGINITLOCALE.

Применение: $ LINGUAS_FILE, $ POAUTOINIT, $ POTDOMAIN.

Слияние сообщений
Этот инструмент scons является частью набора инструментов scons gettext. Он предоставляет интерфейс scons для
Слияние сообщений(1) команда, которая объединяет два файла .po в унифицированном стиле.

Наборы: $ MSGMERGE, $ MSGMERGECOM, $ MSGMERGECOMSTR, $ MSGMERGEFLAGS, $ ПОСУФФИКС, $ POTSUFFIX,
$ POUPDATE_ALIAS.

Применение: $ LINGUAS_FILE, $ POAUTOINIT, $ POTDOMAIN.

мслиб
Устанавливает конструктивные переменные для архиватора библиотеки Microsoft mslib.

Наборы: $ AR, $ ARCOM, $ ARFLAGS, $ LIBPREFIX, $ LIBSUFFIX.

Применение: $ ARCOMSTR.

mslink
Устанавливает конструкционные переменные для компоновщика Microsoft.

Наборы: $ LDMODULE, $ LDMODULECOM, $ LDMODULEFLAGS, $ LDMODULEPREFIX, $ LDMODULESUFFIX,
$ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX, $ LINK, $ LINKCOM,
$ LINKFLAGS, $ REGSVR, $ REGSVRCOM, $ REGSVRFLAGS, $ SHLINK, $ SHLINKCOM, $ SHLINKFLAGS,
$ WIN32DEFPREFIX, $ WIN32DEFSUFFIX, $ WIN32EXPPREFIX, $ WIN32EXPSUFFIX, $ WINDOWSDEFPREFIX,
$ WINDOWSDEFSUFFIX, $ WINDOWSEXPPREFIX, $ WINDOWSEXPSUFFIX, $ WINDOWSPROGMANIFESTPREFIX,
$ WINDOWSPROGMANIFESTSUFFIX, $ WINDOWSSHLIBMANIFESTPREFIX, $ WINDOWSSHLIBMANIFESTSUFFIX,
$ WINDOWS_INSERT_DEF.

Применение: $ LDMODULECOMSTR, $ LINKCOMSTR, $ REGSVRCOMSTR, $ SHLINKCOMSTR.

мссдк
Устанавливает переменные для Microsoft Platform SDK и / или Windows SDK. Обратите внимание, что в отличие от большинства
другие модули инструментов, mssdk не устанавливает конструкционные переменные, но устанавливает
охрана окружающей среды переменные в среде, которую SCons использует для выполнения Microsoft
набор инструментов:% INCLUDE%,% LIB%,% LIBPATH% и% PATH%.

Применение: $ MSSDK_DIR, $ MSSDK_VERSION, $ MSVS_VERSION.

мсвк
Задает конструктивные переменные для компилятора Microsoft Visual C / C ++.

Наборы: $ СТРОИТЕЛИ, $ CC, $ CCCOM, $ CCFLAGS, $ CCPCHFLAGS, $ CCPDBFLAGS, $ CFILESUFFIX,
$ CFLAGS, $ CPPDEFPREFIX, $ CPPDEFSUFFIX, $ CXX, $ CXXCOM, $ CXXFILESUFFIX, $ CXXFLAGS,
$ INCPREFIX, $ INCSUFFIX, $ OBJPREFIX, $ OBJSUFFIX, $ PCHCOM, $ PCHPDBFLAGS, $ RC, $ RCCOM,
$ RCFLAGS, $ SHCC, $ SHCCCOM, $ SHCCFLAGS, $ SHCFLAGS, $ SHCXX, $ SHCXXCOM, $ SHCXXFLAGS,
$ SHOBJPREFIX, $ SHOBJSUFFIX.

Применение: $ CCCOMSTR, $ CXXCOMSTR, $ PCH, $ PCHSTOP, $ PDB, $ SHCCCOMSTR, $ SHCXXCOMSTR.

MSVS
Устанавливает конструктивные переменные для Microsoft Visual Studio.

Наборы: $ MSVSBUILDCOM, $ MSVSCLEANCOM, $ MSVSENCODING, $ MSVSPROJECTCOM, $ MSVSREBUILDCOM,
$ MSVSSCONS, $ MSVSSCONSCOM, $ MSVSSCONSCRIPT, $ MSVSSCONSFLAGS, $ MSVSSOLUTIONCOM.

mwcc
Задает конструктивные переменные для компилятора Metrowerks CodeWarrior.

Наборы: $ CC, $ CCCOM, $ CFILESUFFIX, $ CPPDEFPREFIX, $ CPPDEFSUFFIX, $ CXX, $ CXXCOM,
$ CXXFILESUFFIX, $ INCPREFIX, $ INCSUFFIX, $ MWCW_VERSION, $ MWCW_VERSIONS, $ SHCC,
$ SHCCCOM, $ SHCCFLAGS, $ SHCFLAGS, $ SHCXX, $ SHCXXCOM, $ SHCXXFLAGS.

Применение: $ CCCOMSTR, $ CXXCOMSTR, $ SHCCCOMSTR, $ SHCXXCOMSTR.

мвлд
Устанавливает конструктивные переменные для компоновщика Metrowerks CodeWarrior.

Наборы: $ AR, $ ARCOM, $ LIBDIRPREFIX, $ LIBDIRSUFFIX, $ LIBLINKPREFIX, $ LIBLINKSUFFIX,
$ LINK, $ LINKCOM, $ SHLINK, $ SHLINKCOM, $ SHLINKFLAGS.

насм
Устанавливает конструктивные переменные для nasm Netwide Assembler.

Наборы: $ AS, $ ASCOM, $ ASFLAGS, $ ASPPCOM, $ ASPPFLAGS.

Применение: $ ASCOMSTR, $ ASPPCOMSTR.

Yпаковки
Устанавливает конструктивные переменные для Упаковка Строитель.

для сигарет
Фреймворк для создания бинарных пакетов и пакетов с исходным кодом.

PDF
Задает конструктивные переменные для построителя Portable Document Format.

Наборы: $ PDFPREFIX, $ PDFSUFFIX.

pdfлатекс
Устанавливает конструктивные переменные для утилиты pdflatex.

Наборы: $ LATEXRETRIES, $ PDFLATEX, $ PDFLATEXCOM, $ PDFLATEXFLAGS.

Применение: $ PDFLATEXCOMSTR.

pdftex
Устанавливает конструктивные переменные для утилиты pdftex.

Наборы: $ LATEXRETRIES, $ PDFLATEX, $ PDFLATEXCOM, $ PDFLATEXFLAGS, $ PDFTEX, $ PDFTEXCOM,
$ PDFTEXFLAGS.

Применение: $ PDFLATEXCOMSTR, $ PDFTEXCOMSTR.

насильственный
Устанавливает конструктивные переменные для взаимодействия с управлением исходным кодом Perforce
системы.

Наборы: 4 доллара США, $ P4COM, $ P4FLAGS.

Применение: $ P4COMSTR.

qt
Устанавливает конструктивные переменные для построения приложений Qt.

Наборы: $ QTDIR, $ QT_AUTOSCAN, $ QT_BINPATH, $ QT_CPPPATH, $ QT_LIB, $ QT_LIBPATH, $ QT_MOC,
$ QT_MOCCXXPREFIX, $ QT_MOCCXXSUFFIX, $ QT_MOCFROMCXXCOM, $ QT_MOCFROMCXXFLAGS,
$ QT_MOCFROMHCOM, $ QT_MOCFROMHFLAGS, $ QT_MOCHPREFIX, $ QT_MOCHSUFFIX, $ QT_UIC,
$ QT_UICCOM, $ QT_UICDECLFLAGS, $ QT_UICDECLPREFIX, $ QT_UICDECLSUFFIX, $ QT_UICIMPLFLAGS,
$ QT_UICIMPLPREFIX, $ QT_UICIMPLSUFFIX, $ QT_UISUFFIX.

RCS
Устанавливает конструктивные переменные для взаимодействия с системой контроля версий.

Наборы: $ RCS, $ RCS_CO, $ RCS_COCOM, $ RCS_COFLAGS.

Применение: $ RCS_COCOMSTR.

рмик
Устанавливает конструктивные переменные для утилиты rmic.

Наборы: $ JAVACLASSSUFFIX, $ RMIC, $ RMICCOM, $ RMICFLAGS.

Применение: $ RMICCOMSTR.

rpcgen
Устанавливает переменные конструкции для построения с помощью RPCGEN.

Наборы: $ RPCGEN, $ RPCGENCLIENTFLAGS, $ RPCGENFLAGS, $ RPCGENHEADERFLAGS,
$ RPCGENSERVICEFLAGS, $ RPCGENXDRFLAGS.

СККС
Устанавливает конструктивные переменные для взаимодействия с системой управления исходным кодом.

Наборы: $ SCCS, $ SCCSCOM, $ SCCSFLAGS, $ SCCSGETFLAGS.

Применение: $ SCCSCOMSTR.

сгиар
Устанавливает конструктивные переменные для архиватора библиотеки SGI.

Наборы: $ AR, $ ARCOMSTR, $ ARFLAGS, $ LIBPREFIX, $ LIBSUFFIX, $ SHLINK, $ SHLINKFLAGS.

Применение: $ ARCOMSTR, $ SHLINKCOMSTR.

sgic ++
Устанавливает конструктивные переменные для компилятора SGI C ++.

Наборы: $ CXX, $ CXXFLAGS, $ SHCXX, $ SHOBJSUFFIX.

сгичк
Устанавливает конструктивные переменные для компилятора SGI C.

Наборы: $ CXX, $ SHOBJSUFFIX.

сгилинк
Устанавливает конструктивные переменные для компоновщика SGI.

Наборы: $ LINK, $ RPATHPREFIX, $ RPATHSUFFIX, $ SHLINKFLAGS.

предложения
Устанавливает конструктивные переменные для архиватора библиотеки Sun.

Наборы: $ AR, $ ARCOM, $ ARFLAGS, $ LIBPREFIX, $ LIBSUFFIX.

Применение: $ ARCOMSTR.

солнцеc ++
Задает конструктивные переменные для компилятора Sun C ++.

Наборы: $ CXX, $ CXXVERSION, $ SHCXX, $ SHCXXFLAGS, $ SHOBJPREFIX, $ SHOBJSUFFIX.

Suncc
Устанавливает конструктивные переменные для компилятора Sun C.

Наборы: $ CXX, $ SHCCFLAGS, $ SHOBJPREFIX, $ SHOBJSUFFIX.

солнцеf77
Установить переменные конструкции для компилятора Sun f77 Fortran.

Наборы: 77 долларов США, $ FORTRAN, 77 долларов США, $ SHF77FLAGS, $ ШФОРТРАН, $ SHFORTRANFLAGS.

солнцеf90
Установить переменные конструкции для компилятора Sun f90 Fortran.

Наборы: 90 долларов США, $ FORTRAN, 90 долларов США, $ SHF90FLAGS, $ ШФОРТРАН, $ SHFORTRANFLAGS.

солнцеf95
Установить переменные конструкции для компилятора Sun f95 Fortran.

Наборы: 95 долларов США, $ FORTRAN, 95 долларов США, $ SHF95FLAGS, $ ШФОРТРАН, $ SHFORTRANFLAGS.

Sunlink
Устанавливает конструктивные переменные для компоновщика Sun.

Наборы: $ RPATHPREFIX, $ RPATHSUFFIX, $ SHLINKFLAGS.

глоток спиртного
Устанавливает конструктивные переменные для генератора интерфейса SWIG.

Наборы: $ SWIG, $ SWIGCFILESUFFIX, $ SWIGCOM, $ SWIGCXXFILESUFFIX, $ SWIGDIRECTORSUFFIX,
$ SWIGFLAGS, $ SWIGINCPREFIX, $ SWIGINCSUFFIX, $ SWIGPATH, $ SWIGVERSION, $ _SWIGINCFLAGS.

Применение: $ SWIGCOMSTR.

деготь
Устанавливает переменные конструкции для архиватора tar.

Наборы: $ TAR, $ TARCOM, $ TARFLAGS, $ TARSUFFIX.

Применение: $ TARCOMSTR.

текс
Устанавливает конструктивные переменные для форматтера TeX и наборного устройства.

Наборы: $ BIBTEX, $ BIBTEXCOM, $ BIBTEXFLAGS, $ LATEX, $ LATEXCOM, $ LATEXFLAGS, $ MAKEINDEX,
$ MAKEINDEXCOM, $ MAKEINDEXFLAGS, $ TEX, $ TEXCOM, $ TEXFLAGS.

Применение: $ BIBTEXCOMSTR, $ LATEXCOMSTR, $ MAKEINDEXCOMSTR, $ TEXCOMSTR.

текстовый файл
Задайте конструктивные переменные для Текстовый файл и Подфайл строители.

Наборы: $ LINESEPARATOR, $ SUBSTFILEPREFIX, $ SUBSTFILESUFFIX, $ TEXTFILEPREFIX,
$ TEXTFILESUFFIX.

Применение: $ SUBST_DICT.

тлиб
Устанавливает конструктивные переменные для архиватора библиотеки Borlan tib.

Наборы: $ AR, $ ARCOM, $ ARFLAGS, $ LIBPREFIX, $ LIBSUFFIX.

Применение: $ ARCOMSTR.

xgettext
Этот инструмент scons является частью набора инструментов scons gettext. Он предоставляет интерфейс scons для
xgettext(1) программа, которая извлекает интернационализированные сообщения из исходного кода. В
инструмент обеспечивает POUpdate строитель, чтобы сделать заказ на поставку шаблон файлы.

Наборы: $ POTSUFFIX, $ POTUPDATE_ALIAS, $ XGETTEXTCOM, $ XGETTEXTCOMSTR, $ XGETTEXTFLAGS,
$ XGETTEXTFROM, $ XGETTEXTFROMPREFIX, $ XGETTEXTFROMSUFFIX, $ XGETTEXTPATH,
$ XGETTEXTPATHPREFIX, $ XGETTEXTPATHSUFFIX, $ _XGETTEXTDOMAIN, $ _XGETTEXTFROMFLAGS,
$ _XGETTEXTPATHFLAGS.

Применение: $ POTDOMAIN.

Yacc
Устанавливает переменные конструкции для генератора синтаксического анализа yacc.

Наборы: $ YACC, $ YACCCOM, $ YACCFLAGS, $ YACCHFILESUFFIX, $ YACCHXXFILESUFFIX,
$ YACCVCGFILESUFFIX.

Применение: $ YACCCOMSTR.

застежка-молния
Устанавливает конструктивные переменные для zip-архиватора.

Наборы: $ ZIP, $ ZIPCOM, $ ZIPCOMPRESSION, $ ZIPFLAGS, $ ZIPSUFFIX.

Применение: $ ZIPCOMSTR.

Кроме того, существует «инструмент» под названием по умолчанию который настраивает среду с помощью
набор инструментов по умолчанию для текущей платформы.

На платформах posix и cygwin SCons предпочитают инструменты GNU (например, gcc), в Windows
SCons предпочитают инструменты Microsoft (например, msvc), за которыми следует MinGW, а в OS / 2
SCons предпочитают инструменты IBM (например, icc).

строитель методы
Правила сборки задаются путем вызова методов построителя среды конструирования. В
аргументами методов построителя являются цель (список целей для создания, обычно файл
имена) и источник (список создаваемых источников, обычно имена файлов).

Поскольку длинные списки имен файлов могут привести к частому цитированию, бра поставляет Расколоть()
глобальная функция и одноименный метод среды, которые разбивают одну строку на
список, разделенный строками символов пробела. (Они похожи на split ()
функция-член строк Python, но работает, даже если ввод не является строкой.)

Как и все аргументы Python, целевые и исходные аргументы метода построителя могут быть
указаны либо с ключевыми словами "target" и "source", либо без них. Когда ключевые слова
опущено, сначала идет цель, а затем - источник. Следующие эквивалентны
примеры вызова метода построителя программ:

env.Program ('bar', ['bar.c', 'foo.c'])
env.Program ('bar', Разделить ('bar.c foo.c'))
env.Program ('бар', env.Split ('bar.c foo.c'))
env.Program (source = ['bar.c', 'foo.c'], target = 'bar')
env.Program (target = 'bar', Split ('bar.c foo.c'))
env.Program (цель = 'бар', env.Split ('bar.c foo.c'))
env.Program ('бар', источник = 'bar.c foo.c'.split ())

Имена целевого и исходного файла, которые не являются абсолютными путями (т. Е. Не начинаются с
/ в системах POSIX или \ fR on Windows систем, or без an необязательный управлять письмо)
интерпретированы относительный в каталог содержащие SПризывник файл читается. An
начальный # (знак решетки) в имени пути означает, что остальная часть имени файла интерпретируется
относительно каталога, содержащего верхний уровень SConstruct файл, даже если # is
за которым следует символ-разделитель каталогов (косая черта или обратная косая черта).

Примеры:

# Комментарии с описанием целей, которые будут построены
# предполагаем, что эти вызовы находятся в файле SConscript в
# подкаталог с именем "subdir".

# Строит программу "subdir / foo" из "subdir / foo.c":
env.Program ('foo', 'foo.c')

# Строит программу "/ tmp / bar" из "subdir / bar.c":
env.Program ('/ tmp / bar', 'bar.c')

# Начальные символы "#" или "# /" эквивалентны; следующее
# вызывает сборку программ "foo" и "bar" (в
# каталог верхнего уровня SConstruct) из "subdir / foo.c" и
# "subdir / bar.c" соответственно:
env.Program ('# foo', 'foo.c')
env.Program ('# / bar', 'bar.c')

# Строит программу "other / foo" (относительно верхнего уровня
# SConstruct directory) из "subdir / foo.c":
env.Program ('# другое / foo', 'foo.c')

Когда цель имеет то же базовое имя, что и источник, и изменяется только суффикс, и если
у метода построителя есть суффикс, определенный для целевого типа файла, затем целевой аргумент
можно полностью опустить, и бра выведет имя целевого файла из исходного файла
название. Все следующие примеры создают исполняемую программу. бар (в системах POSIX) или
бар.exe (в системах Windows) из исходного файла bar.c:

env.Program (target = 'bar', source = 'bar.c')
env.Program ('бар', источник = 'bar.c')
env.Program (источник = 'bar.c')
env.Program ('bar.c')

Для удобства исходный каталог аргумент ключевого слова может быть указан при вызове Builder. Когда
указано, все строки исходного файла, которые не являются абсолютными путями, будут интерпретированы
относительно указанного исходный каталог. В следующем примере будет построен сборка / прога (или
сборка / prog.exe в Windows) программа из файлов src / f1.c и src / f2.c:

env.Program ('build / prog', ['f1.c', 'f2.c'], srcdir = 'src')

Можно переопределить или добавить переменные конструкции при вызове метода построителя с помощью
передача дополнительных аргументов ключевого слова. Эти переопределенные или добавленные переменные будут только в
эффект при построении цели, поэтому они не будут влиять на другие части сборки. За
Например, если вы хотите добавить дополнительные библиотеки только для одной программы:

env.Program ('привет', 'привет.c', LIBS = ['gl', 'перенасыщение'])

или сгенерируйте разделяемую библиотеку с нестандартным суффиксом:

env.SharedLibrary ('слово', 'word.cpp',
SHLIBSUFFIX = '. Ocx',
LIBSUFFIXES = ['. Ocx'])

(Обратите внимание, что обе переменные $ SHLIBSUFFIX и $ LIBSUFFIXES должны быть установлены, если вы хотите, чтобы SCons
автоматически искать зависимости от нестандартных имен библиотек; увидеть
описания этих переменных, ниже, для получения дополнительной информации.)

Также можно использовать parse_flags аргумент ключевого слова в переопределении:

env = Program ('привет', 'hello.c', parse_flags = '-Iinclude -DEBUG -lm')

В этом примере к CPPPATH, "EBUG" на CPDОПРЕДЕЛЯЕТ, а 'm' - БИБЛИОТЕКИ.

Хотя методы построения, определенные бра на самом деле методы построения
объект среды, они также могут вызываться без явного указания окружения:

Программа ('привет', 'привет.c')
SharedLibrary ('слово', 'word.cpp')

В этом случае методы вызываются внутри с использованием среды построения по умолчанию.
который состоит из инструментов и ценностей, которые бра определил, подходят для
локальная система.

Методы построителя, которые могут быть вызваны без явного указания окружения, могут быть вызваны из
пользовательские модули Python, которые вы импортируете в файл SConscript, добавляя в
модуль Python:

из импорта SCons.Script *

Все методы построителя возвращают объект в виде списка, содержащий узлы, представляющие цель.
или цели, которые будут построены. А Узел - это внутренний объект SCons, представляющий сборку
цели или источники.

Возвращенный объект списка узлов может быть передан другим методам построителя в качестве источника (ов) или
передается любой функции или методу SCons, где обычно принимается имя файла. За
например, если нужно было добавить конкретный -D флаг при компиляции одного конкретного объекта
файл:

bar_obj_list = env.StaticObject ('bar.c', CPPDEFINES = '- DBAR')
env.Program (source = ['foo.c', bar_obj_list, 'main.c'])

Использование узла таким образом делает сборку более переносимой, поскольку вам не нужно указывать
зависящий от платформы суффикс объекта при вызове метода построителя Program ().

Обратите внимание, что вызовы Builder автоматически «сглаживают» списки исходных и целевых файлов, поэтому
это нормально, если список bar_obj возвращается вызовом StaticObject () в середине
список исходных файлов. Если вам нужно манипулировать списком списков, возвращаемых Строителями
напрямую с помощью Python, вы можете создать список вручную:

foo = Объект ('foo.c')
bar = Объект ('bar.c')
objects = ['begin.o'] + foo + ['middle.o'] + bar + ['end.o']
для объекта в объектах:
print str (объект)

Или вы можете использовать расплющить(), предоставляемая scons для создания списка, содержащего только
Узлы, что может быть удобнее:

foo = Объект ('foo.c')
bar = Объект ('bar.c')
objects = Flatten (['begin.o', foo, 'middle.o', bar, 'end.o'])
для объекта в объектах:
print str (объект)

Также обратите внимание, что поскольку вызовы Builder возвращают объект в виде списка, а не фактический список Python,
вам следует использовать Python += для добавления результатов Builder в список Python.
Поскольку список и объект относятся к разным типам, Python не будет обновлять исходный
list на месте, но вместо этого создаст новый объект Node-list, содержащий конкатенацию
элементов списка и результатов Builder. Это вызовет проблемы для других
Переменные Python в вашей конфигурации SCons, которые все еще сохраняют ссылку на
исходный список. Вместо этого используйте Python .продлевать() способ убедиться, что список обновлен
на месте. Пример:

объектные_файлы = []

# НЕ используйте + = следующим образом:
#
# файлы_объектов + = Объект ('bar.c')
#
# Он не будет обновлять список object_files на месте.
#
# Вместо этого используйте метод .extend ():
object_files.extend (Объект ('bar.c'))

Путь к файлу узла можно использовать, передав узел во встроенную программу Python.
str () функция:

bar_obj_list = env.StaticObject ('bar.c', CPPDEFINES = '- DBAR')
print "Путь к bar_obj:", str (bar_obj_list [0])

Еще раз обратите внимание: поскольку вызов Builder возвращает список, мы должны получить доступ к первому
элемент в списке (bar_obj_list [0]) чтобы добраться до узла, который на самом деле представляет
объектный файл.

Строитель призывает поддержать ChDir аргумент ключевого слова, который указывает, что действие (я) Строителя
должен выполняться после смены каталога. Если ChDir аргумент - строка или
узел каталога, scons перейдет в указанный каталог. Если ChDir это не строка
или Node и не равно нулю, тогда scons перейдет в каталог целевого файла.

# scons перейдет в подкаталог "sub"
# перед выполнением команды "cp".
env.Command ('вложенный / каталог / foo.out', 'вложенный / каталог / foo.in',
"cp dir / foo.in dir / foo.out",
chdir = 'sub')

# Поскольку chdir не является строкой, scons изменится на
# целевой каталог ("sub / dir") перед выполнением
# Команда "cp".
env.Command ('вложенный / каталог / foo.out', 'вложенный / каталог / foo.in',
"cp foo.in foo.out",
chdir = 1)

Обратите внимание, что бра будут автоматически изменять его раскрытие конструктивных переменных, таких как
$ TARGET и $ ИСТОЧНИК при использовании аргумента ключевого слова chdir - то есть расширенного файла
имена по-прежнему будут относиться к каталогу SConstruct верхнего уровня, и, следовательно,
неверно относительно каталога chdir. Если вы используете аргумент ключевого слова chdir, вы
обычно требуется указать другую командную строку, используя такие расширения, как $ {TARGET.file} и
$ {SOURCE.file} использовать только часть имени файла для целей и источника.

бра предоставляет следующие методы построения:

CFile (), env.CFile ()
Создает исходный файл C из входного файла lex (.l) или yacc (.y). Указанный суффикс
не провела обыск $ CFILESUFFIX конструкционная переменная (по умолчанию .c) автоматически добавляется в
цель, если ее еще нет. Пример:

# строит foo.c
env.CFile (цель = 'foo.c', источник = 'foo.l')
# строит bar.c
env.CFile (target = 'bar', source = 'bar.y')

Команда (), env.Command ()
Команда Command «Строитель» фактически реализован как функция, которая выглядит как Строитель,
но фактически принимает дополнительный аргумент действия, из которого Строитель должен
быть сделано. Увидеть Command описание функции для синтаксиса вызова и подробности.

CXXFile (), env.CXXFile ()
Создает исходный файл C ++ с учетом входного файла lex (.ll) или yacc (.yy). Суффикс
определяется $ CXXFILESUFFIX конструкционная переменная (по умолчанию .cc)
автоматически добавляется к цели, если ее еще нет. Пример:

# строит foo.cc
env.CXXFile (цель = 'foo.cc', источник = 'foo.ll')
# строит bar.cc
env.CXXFile (target = 'bar', source = 'bar.yy')

DocbookEpub (), env.DocbookEpub ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода EPUB.

env = Environment (tools = ['docbook'])
env.DocbookEpub ('manual.epub', 'manual.xml')

или просто

env = Environment (tools = ['docbook'])
env.DocbookEpub ('руководство')

DocbookHtml (), env.DocbookHtml ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода HTML.

env = Environment (tools = ['docbook'])
env.DocbookHtml ('manual.html', 'manual.xml')

или просто

env = Environment (tools = ['docbook'])
env.DocbookHtml ('руководство')

DocbookHtmlChunked (), env.DocbookHtmlChunked ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для фрагментированного вывода HTML. Он поддерживает
параметр base.dir. Файл chunkfast.xsl (требуется "EXSLT") используется в качестве
таблица стилей по умолчанию. Базовый синтаксис:

env = Environment (tools = ['docbook'])
env.DocbookHtmlChunked ('руководство')

где manual.xml - входной файл.

Если вы используете параметр root.filename в своих таблицах стилей, вы должны указать
новое целевое имя. Это гарантирует правильность зависимостей, особенно для
очистка через «scons -c»:

env = Environment (tools = ['docbook'])
env.DocbookHtmlChunked ('mymanual.html', 'руководство', xsl = 'htmlchunk.xsl')

Предоставляется некоторая базовая поддержка base.dir. Вы можете добавить ключевое слово base_dir в
ваш вызов Builder, и данный префикс будет добавлен ко всем созданным именам файлов:

env = Environment (tools = ['docbook'])
env.DocbookHtmlChunked ('руководство', xsl = 'htmlchunk.xsl', base_dir = 'output /')

Убедитесь, что вы не забыли косую черту в конце базовой папки, иначе ваш
только файлы переименовываются!

DocbookHtmlhelp (), env.DocbookHtmlhelp ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода HTMLHELP. Его основной синтаксис
это:

env = Environment (tools = ['docbook'])
env.DocbookHtmlhelp ('руководство')

где manual.xml - входной файл.

Если вы используете параметр root.filename в своих таблицах стилей, вы должны указать
новое целевое имя. Это гарантирует правильность зависимостей, особенно для
очистка через «scons -c»:

env = Environment (tools = ['docbook'])
env.DocbookHtmlhelp ('mymanual.html', 'руководство', xsl = 'htmlhelp.xsl')

Предоставляется некоторая базовая поддержка параметра base.dir. Вы можете добавить base_dir
ключевое слово к вашему вызову Builder, и данный префикс будет добавлен ко всем созданным
имена файлов:

env = Environment (tools = ['docbook'])
env.DocbookHtmlhelp ('руководство', xsl = 'htmlhelp.xsl', base_dir = 'output /')

Убедитесь, что вы не забыли косую черту в конце базовой папки, иначе ваш
только файлы переименовываются!

DocbookMan (), env.DocbookMan ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода страниц руководства. Его основной синтаксис
это:

env = Environment (tools = ['docbook'])
env.DocbookMan ('руководство')

где manual.xml - входной файл. Обратите внимание, что вы можете указать целевое имя, но
фактические выходные имена автоматически устанавливаются из записей refname в вашем источнике XML.

DocbookPdf (), env.DocbookPdf ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода PDF.

env = Environment (tools = ['docbook'])
env.DocbookPdf ('manual.pdf', 'manual.xml')

или просто

env = Environment (tools = ['docbook'])
env.DocbookPdf ('руководство')

DocbookSlidesHtml (), env.DocbookSlidesHtml ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода слайдов HTML.

env = Environment (tools = ['docbook'])
env.DocbookSlidesHtml ('руководство')

Если вы используете параметр titlefoil.html в своих таблицах стилей, вы должны указать
новое целевое имя. Это гарантирует правильность зависимостей, особенно для
очистка через «scons -c»:

env = Environment (tools = ['docbook'])
env.DocbookSlidesHtml ('mymanual.html', 'руководство', xsl = 'slideshtml.xsl')

Предоставляется некоторая базовая поддержка параметра base.dir. Вы можете добавить base_dir
ключевое слово к вашему вызову Builder, и данный префикс будет добавлен ко всем созданным
имена файлов:

env = Environment (tools = ['docbook'])
env.DocbookSlidesHtml ('руководство', xsl = 'slideshtml.xsl', base_dir = 'output /')

Убедитесь, что вы не забыли косую черту в конце базовой папки, иначе ваш
только файлы переименовываются!

DocbookSlidesPdf (), env.DocbookSlidesPdf ()
Псевдо-строитель, предоставляющий набор инструментов Docbook для вывода слайдов PDF.

env = Environment (tools = ['docbook'])
env.DocbookSlidesPdf ('manual.pdf', 'manual.xml')

или просто

env = Environment (tools = ['docbook'])
env.DocbookSlidesPdf ('руководство')

DocbookXInclude (), env.DocbookXInclude ()
Псевдо-строитель для разрешения XIncludes на отдельном этапе обработки.

env = Environment (tools = ['docbook'])
env.DocbookXInclude ('manual_xincluded.xml', 'manual.xml')

DocbookXslt (), env.DocbookXslt ()
Псевдо-строитель, применяющий заданное преобразование XSL к входному файлу.

env = Environment (tools = ['docbook'])
env.DocbookXslt ('manual_transformed.xml', 'manual.xml', xsl = 'transform.xslt')

Обратите внимание, что этот построитель требует, чтобы был установлен параметр xsl.

DVI (), env.DVI ()
Создает файл .dvi из входного файла .tex, .ltx или .latex. Если суффикс исходного файла
это .tex, scons проверит содержимое файла; если строка \ documentclass или
\ documentstyle найден, предполагается, что файл является файлом LaTeX, а целью является
построен путем обращения к $ LATEXCOM командная строка; в противном случае $ TEXCOM командная строка
использовал. Если файл является файлом LaTeX, DVI Builder также исследует
содержимое файла .aux и вызовите $ BIBTEX командная строка, если строка bibdata
найдено, начать $ MAKEINDEX для генерации индекса, если найден файл .ind, и он проверит
содержимое файла .log и повторно запустите $ LATEXCOM команда, если файл журнала говорит, что это
необходимо.

Суффикс .dvi (жестко запрограммированный в самом TeX) автоматически добавляется к цели, если
его еще нет. Примеры:

# строит из aaa.tex
env.DVI (цель = 'aaa.dvi', источник = 'aaa.tex')
# строит bbb.dvi
env.DVI (цель = 'bbb', источник = 'bbb.ltx')
# строит из ccc.latex
env.DVI (цель = 'ccc.dvi', источник = 'ccc.latex')

Gs (), env.Gs ()
Строитель для явного вызова исполняемого файла gs. В зависимости от базовой ОС
пробуются разные имена gs, gsos2 и gswin32c.

env = Environment (tools = ['gs'])
env.Gs ('cover.jpg', 'scons-scons.pdf',
GSFLAGS = '- dNOPAUSE -dBATCH -sDEVICE = jpeg -dFirstPage = 1 -dLastPage = 1 -q')
)

Установить(), env.Install ()
Устанавливает один или несколько исходных файлов или каталогов в указанную цель, которая должна
быть каталогом. Имена указанных исходных файлов или каталогов остаются прежними.
в целевом каталоге. Источники могут быть заданы как строка или как узел
возвращен строителем.

env.Install ('/ USR / местные / бен', source = [' foo ',' bar '])

InstallAs (), env.InstallAs ()
Устанавливает один или несколько исходных файлов или каталогов с определенными именами, позволяя изменять
имя файла или каталога как часть установки. Это ошибка, если цель и
Исходные аргументы перечисляют разное количество файлов или каталогов.

env.InstallAs (target = '/ usr / local / bin / foo',
источник = 'foo_debug')
env.InstallAs (target = ['../lib/libfoo.a', '../lib/libbar.a'],
source = ['libFOO.a', 'libBAR.a'])

InstallVersionedLib (), env.InstallVersionedLib ()
Устанавливает версию разделяемой библиотеки. Символические ссылки, соответствующие архитектуре, будут
быть сгенерировано на основе символических ссылок исходной библиотеки.

env.InstallVersionedLib (target = '/ usr / local / bin / foo',
источник = 'libxyz.1.5.2.so')

Банка(), env.Jar ()
Создает файл архива Java (.jar) из указанного списка источников. Любые каталоги
в списке источников будет выполняться поиск файлов .class). Любые файлы .java в исходном коде
список будет скомпилирован в файлы .class путем вызова Java Строитель.

Если же линия индикатора $ JARCHDIR установлено значение, команда jar перейдет в указанный каталог
используя -C вариант. Если $ JARCHDIR не установлен явно, SCons будет использовать верх любого
дерево подкаталогов, в котором Java .class были построены Java Строитель.

Если содержимое любого из исходных файлов начинается со строки Manifest-Version,
Предполагается, что файл является манифестом и передается команде jar с m вариант
комплект.

env.Jar (цель = 'foo.jar', источник = 'классы')

env.Jar (target = 'bar.jar',
source = ['bar1.java', 'bar2.java'])

Ява(), env.Java ()
Создает один или несколько файлов классов Java. Источники могут быть любой комбинацией явных
Файлы .java или деревья каталогов, которые будут сканироваться на наличие файлов .java.

SCons проанализирует каждый исходный файл .java, чтобы найти классы (включая внутренние классы).
определены в этом файле, и исходя из этого определить целевые файлы .class, которые будут
быть создан. Файлы классов будут помещены в указанный целевой каталог.

SCons также будет искать в каждом файле Java имя пакета Java, которое, как предполагается, может
находиться в строке, начинающейся со строки package в первом столбце; в
полученные файлы .class будут помещены в каталог, отражающий указанный пакет
название. Например, файл Foo.java, определяющий единственный общедоступный класс Foo и содержащий
имя пакета sub.dir создаст соответствующий файл класса sub / dir / Foo.class.

Примеры:

env.Java (цель = 'классы', источник = 'src')
env.Java (target = 'классы', source = ['src1', 'src2'])
env.Java (target = 'classes', source = ['File1.java', 'File2.java'])

Исходные файлы Java могут использовать собственную кодировку для базовой ОС. Поскольку SCons
по умолчанию компилируется в простом режиме ASCII, компилятор выдаст предупреждения о
несопоставимые символы, что может привести к ошибкам при дальнейшей обработке файла. В
в этом случае пользователь должен указать переменную среды LANG, чтобы сообщить компилятору
какая кодировка используется. Для мобильности лучше всего, если кодировка будет жестко запрограммирована таким образом, чтобы
что компиляция будет работать, если она будет выполнена в системе с другой кодировкой.

env = Окружающая среда ()
env ['ENV'] ['LANG'] = 'en_GB.UTF-8'

JavaH (), env.JavaH ()
Создает заголовочные файлы C и исходные файлы для реализации собственных методов Java. Цель может
быть либо каталогом, в котором будут записаны файлы заголовков, либо именем файла заголовка
который будет содержать все определения. Источником могут быть имена .class
files, имена файлов .java, которые будут скомпилированы в файлы .class путем вызова Java
Builder, или объекты, возвращаемые из Java Строительный метод.

Если конструктивная переменная $ JAVACLASSDIR устанавливается либо в среде, либо в
позвонить в JavaH построитель, то значение переменной будет
удалены из начала любых имен файлов .class.

Примеры:

# строит java_native.h
классы = env.Java (цель = 'classdir', источник = 'src')
env.JavaH (цель = 'java_native.h', источник = классы)

# сборки включают / package_foo.h и включают / package_bar.h
env.JavaH (target = 'включать',
источник = ['пакет / foo.class', 'пакет / bar.class'])

# строит export / foo.h и export / bar.h
env.JavaH (цель = 'экспорт',
source = ['классы / foo.class', 'классы / bar.class'],
JAVACLASSDIR = 'классы')

Библиотека(), env.Library ()
Синоним Статическая библиотека Строительный метод.

LoadableModule (), env.LoadableModule ()
В большинстве систем это то же самое, что Общая библиотека. На платформах Mac OS X (Darwin),
это создает загружаемый комплект модулей.

M4 (), env.M4 ()
Создает выходной файл из входного файла M4. Используется значение по умолчанию $ M4FLAGS Значение -E,
который считает все предупреждения фатальными и останавливается при первом предупреждении при использовании
Версия m4 для GNU. Пример:

env.M4 (цель = 'foo.c', источник = 'foo.c.m4')

Moc (), env.Moc ()
Создает выходной файл из входного файла moc. Входные файлы Moc являются либо файлами заголовков
или файлы cxx. Этот конструктор доступен только после использования инструмента qt. Увидеть $ QTDIR
переменная для получения дополнительной информации. Пример:

env.Moc ('foo.h') # генерирует moc_foo.cc
env.Moc ('foo.cpp') # генерирует foo.moc

MOFiles (), env.MOFiles ()
Этот строитель принадлежит инструменту msgfmt. Конструктор компилирует PO-файлы в MO-файлы.

Пример 1. Создайте pl.mo и en.mo, скомпилировав pl.po и en.po:

#...
env.MOFiles (['pl', 'en'])

Пример 2. Скомпилируйте файлы для языков, определенных в файле LINGUAS:

#...
env.MOFiles (LINGUAS_FILE = 1)

Пример 3. Создайте pl.mo и en.mo, скомпилировав файлы pl.po и en.po plus для
языки, определенные в файле LINGUAS:

#...
env.MOFiles (['pl', 'en'], LINGUAS_FILE = 1)

Пример 4. Скомпилируйте файлы для языков, определенных в файле LINGUAS (другая версия):

#...
env ['LINGUAS_FILE'] = 1
env.MOFiles ()

MSVSProject (), env.MSVSProject ()
Создает файл проекта Microsoft Visual Studio и по умолчанию создает файл решения.
так же.

Это создает файл проекта Visual Studio на основе версии Visual Studio, которая
настроен (либо последняя установленная версия, либо версия, указанная
$ MSVS_VERSION в конструкторе Environment). Для Visual Studio 6 он сгенерирует
.dsp файл. Для Visual Studio 7 (.NET) и более поздних версий будет создан файл .vcproj.
.

По умолчанию это также создает файл решения для указанного проекта, файл .dsw.
для Visual Studio 6 или файл .sln для Visual Studio 7 (.NET). Такое поведение может быть
отключено указанием auto_build_solution = 0 при вызове МСВСпроектв каком случае
вы, вероятно, хотите создать файл (ы) решения, вызвав MSVSSolution строитель
(Смотри ниже).

Команда МСВСпроект Builder берет несколько списков имен файлов для размещения в проекте
файл. В настоящее время они ограничены srcs, incs, localincs, resources и т. Д. Эти
довольно очевидны, но следует отметить, что эти списки добавлены в
ИСТОЧНИКИ конструктивная переменная в виде строк, а НЕ как файловых узлов SCons. Это потому что
они представляют имена файлов, которые будут добавлены в файл проекта, а не используемые исходные файлы
для создания файла проекта.

Все перечисленные выше списки файлов являются необязательными, хотя для
итоговый файл проекта должен быть непустым.

В дополнение к приведенным выше спискам значений могут быть указаны следующие значения:

цель
Имя целевого файла .dsp или .vcproj. Правильный суффикс для версии
Visual Studio необходимо использовать, но $ MSVSPROJECTSUFFIX конструкционная переменная будет
быть определенным до правильного значения (см. пример ниже).

вариант
Название именно этого варианта. Для проектов Visual Studio 7 это также может
быть списком вариантов имен. Обычно это такие вещи, как «Отладка» или «Выпуск»,
но на самом деле может быть все, что угодно. Для проектов Visual Studio 7 они также могут
укажите целевую платформу, отделив ее от имени варианта знаком | (вертикальная труба)
персонаж: Отладка | Xbox. Целевая платформа по умолчанию - Win32. Множественные звонки на
МСВСпроект с разными вариантами допускаются; все варианты будут добавлены в
файл проекта с соответствующими целями сборки и источниками.

cmdargs
Дополнительные аргументы командной строки для различных вариантов. Номер
Записи cmdargs должны соответствовать количеству вариантов записей или быть пустыми (не
указано). Если вы дадите только один, он будет автоматически распространен на все
варианты.

цель сборки
Необязательная строка, узел или список строк или узлов (по одному на вариант сборки), чтобы
сообщить отладчику Visual Studio, какую цель вывода использовать в каком варианте сборки.
Количество записей buildtarget должно соответствовать количеству записей вариантов.

файл запуска
Имя файла, который Visual Studio 7 и более поздних версий будет запускать и отлаживать. Этот
отображается как значение поля вывода в итоговом проекте Visual Studio
файл. Если это не указано, значение по умолчанию такое же, как указано
buildtarget значение.

Обратите внимание: поскольку SCons всегда выполняет свои команды сборки из каталога, в котором
файл SConstruct находится, если вы создаете файл проекта в другом
каталог, чем каталог SConstruct, пользователи не смогут дважды щелкнуть
имя файла в сообщениях об ошибках компиляции, отображаемых в выводе консоли Visual Studio
окно. Это можно исправить, добавив параметр компилятора Visual C / C ++ / FC в
$ CCFLAGS переменная, чтобы компилятор печатал полный путь к любым файлам, которые
вызывают ошибки компиляции.

Пример использования:

barsrcs = ['bar.cpp'],
barincs = ['bar.h'],
barlocalincs = ['StdAfx.h']
barresources = ['bar.rc', 'resource.h']
barmisc = ['bar_readme.txt']

dll = env.SharedLibrary (target = 'bar.dll',
источник = barsrcs)

env.MSVSProject (target = 'Bar' + env ['MSVSPROJECTSUFFIX'],
srcs = барскс,
инкс = баринкс,
местные = барлокальные,
ресурсы = barresources,
разное = barmisc,
цель сборки = dll,
вариант = 'Выпуск')

Начиная с версии 2.4 SCons также можно указать необязательный аргумент
Параметры отладки, который создает файлы для отладки в Visual Studio:

Параметры отладки
Словарь настроек отладки, которые записываются в .vcproj.user или в
.vcxproj.user файл, в зависимости от установленной версии. Как это сделано для cmdargs
(см. выше), вы можете указать Параметры отладки словарь по варианту. Если вы дадите
только один, он будет распространен на все варианты.

В настоящее время реализованы только Visual Studio v9.0 и Visual Studio версии v11, для
другие версии файл не создается. Чтобы сгенерировать файл пользователя, вам просто нужно добавить
Параметры отладки словарь в среду с правильными параметрами для вашего MSVS
версия. Если словарь пуст или не содержит подходящего значения, файл не будет
быть сгенерирован.

Ниже приведен более надуманный пример, включающий настройку проекта для вариантов.
и DebugSettings:

# Предполагая, что вы сохраняете свои настройки по умолчанию в файле
vars = Переменные ('variables.py')
msvcver = vars.args.get ('vc', '9')

# Проверить аргументы команд, чтобы принудительно установить одну версию Microsoft Visual Studio
если msvcver == '9' или msvcver == '11':
env = Environment (MSVC_VERSION = msvcver + '. 0', MSVC_BATCH = False)
еще:
env = Окружающая среда ()

AddOption ('- userfile', action = 'store_true', dest = 'userfile', по умолчанию = False,
help = "Создать пользовательский файл проекта Visual Studio")

#
# 1. Сконфигурируйте свой словарь настроек отладки с параметрами, которые вы хотите в списке.
# разрешенных параметров, например, если вы хотите создать пользовательский файл для запуска
# специальное приложение для тестирования вашей dll с помощью Microsoft Visual Studio 2008 (v9):
#
V9DebugSettings = {
'Command': 'c: \\ myapp \\ using \\ thisdll.exe',
'WorkingDirectory': 'c: \\ myapp \\ using \\',
'CommandArguments': '-p пароль',
# 'Прикрепить': 'false',
# 'DebuggerType': '3',
# 'Remote': '1',
# RemoteMachine: Нет,
# 'RemoteCommand': нет,
# 'HttpUrl': нет,
# 'PDBPath': нет,
# 'SQLDebugging': нет,
# 'Окружающая обстановка': '',
# 'EnvironmentMerge': 'истина',
# 'DebuggerFlavor': нет,
# 'MPIRunCommand': нет,
# 'MPIRunArguments': нет,
# 'MPIRunWorkingDirectory': нет,
# 'ApplicationCommand': нет,
# 'ApplicationArguments': нет,
# 'ShimCommand': Нет,
# 'MPIAcceptMode': Нет,
# 'MPIAcceptFilter': Нет,
}

#
# 2. Потому что есть много разных вариантов в зависимости от Microsoft
# Версия Visual Studio, если вы используете более одной версии, вам необходимо
# определить словарь для каждой версии, например, если вы хотите создать пользователя
# файл для запуска определенного приложения для тестирования вашей dll с помощью Microsoft
# Visual Studio 2012 (v11):
#
V10DebugSettings = {
'LocalDebuggerCommand': 'c:\\myapp\\using\\thisdll.exe',
'LocalDebuggerWorkingDirectory': 'c:\\myapp\\using\\',
'LocalDebuggerCommandArguments': '-p пароль',
# 'LocalDebuggerEnvironment': Нет,
# 'DebuggerFlavor': 'WindowsLocalDebugger',
# 'LocalDebuggerAttach': Нет,
# 'LocalDebuggerDebuggerType': Нет,
# 'LocalDebuggerMergeEnvironment': Нет,
# 'LocalDebuggerSQLDebugging': Нет,
# 'RemoteDebuggerCommand': Нет,
# 'RemoteDebuggerCommandArguments': Нет,
# 'RemoteDebuggerWorkingDirectory': Нет,
# 'RemoteDebuggerServerName': Нет,
# 'RemoteDebuggerConnection': Нет,
# 'RemoteDebuggerDebuggerType': Нет,
# 'RemoteDebuggerAttach': Нет,
# 'RemoteDebuggerSQLDebugging': Нет,
# 'DeploymentDirectory': Нет,
# 'Дополнительные файлы': Нет,
# 'RemoteDebuggerDeployDebugCppRuntime': Нет,
# 'WebBrowserDebuggerHttpUrl': Нет,
# 'WebBrowserDebuggerDebuggerType': Нет,
# 'WebServiceDebuggerHttpUrl': Нет,
# 'WebServiceDebuggerDebuggerType': Нет,
# 'WebServiceDebuggerSQLDebugging': Нет,
}

#
# 3. Выберите нужный словарь в зависимости от версии Visual Studio
# Файлы, которые вы хотите сгенерировать.
#
если не env.GetOption('userfile'):
dbgSettings = Нет
elif env.get('MSVC_VERSION', Нет) == '9.0':
dbgSettings = V9DebugSettings
elif env.get('MSVC_VERSION', Нет) == '11.0':
dbgSettings = V10DebugSettings
еще:
dbgSettings = Нет

#
# 4. Добавьте словарь к ключевому слову DebugSettings.
#
barrcs = ['bar.cpp', 'dllmain.cpp', 'stdafx.cpp']
barincs = ['targetver.h']
barlocalincs = ['StdAfx.h']
barresources = ['bar.rc', 'resource.h']
barmisc = ['ReadMe.txt']

dll = env.SharedLibrary (target = 'bar.dll',
источник = barsrcs)

env.MSVSProject (target = 'Bar' + env ['MSVSPROJECTSUFFIX'],
srcs = барскс,
инкс = баринкс,
местные = барлокальные,
ресурсы = barresources,
разное = barmisc,
цель сборки = [dll[0]] * 2,
вариант = ('Отладка | Win32', 'Выпуск | Win32'),
cmdargs = 'vc=%s' % msvcver,
Отладочные настройки = (dbgSettings, {}))

МСВССолюшн(), окр.MSVSSolution()
Создает файл решения Microsoft Visual Studio.

При этом создается файл решения Visual Studio на основе версии Visual Studio, которая
настроен (либо последняя установленная версия, либо версия, указанная
$ MSVS_VERSION в строительной среде). Для Visual Studio 6 он будет генерировать
файл .dsw. Для Visual Studio 7 (.NET) будет создан файл .sln.

Должны быть указаны следующие значения:

цель
Имя целевого файла .dsw или .sln. Правильный суффикс для версии
Необходимо использовать Visual Studio, но значение $MSVSSOLUTIONSUFFIX будет определено, чтобы
правильное значение (см. пример ниже).

вариант
Имя этого конкретного варианта или список имен вариантов (последний
поддерживается только для решений MSVS 7). Обычно это такие вещи, как «Отладка» или
"Релиз", но на самом деле может быть все, что угодно. Для MSVS 7 они также могут указать
целевая платформа, например "Отладка | Xbox". Платформа по умолчанию — Win32.

проектов
Список имен файлов проекта или узлов проекта, возвращаемых вызовами
МСВСпроект Builder для помещения в файл решения. Следует отметить, что
эти имена файлов НЕ добавляются в переменную окружения $SOURCES в виде
файлы, а скорее как строки. Это потому, что они представляют имена файлов как
добавлены в файл решения, а не исходные файлы, используемые для создания файла решения.

Пример использования:

env.MSVSSolution(target = 'Bar' + env['MSVSSOLUTIONSUFFIX'], проекты = ['bar'
+ env['MSVSPROJECTSUFFIX']], вариант = 'Выпуск')

Объект(), env.Объект()
Синоним СтатикОбъект Строительный метод.

Упаковка(), env.Пакет()
Создает двоичный пакет из заданных исходных файлов.

env.Package (источник = FindInstalledFiles ())

Создает пакеты распространения программного обеспечения. Пакеты состоят из файлов для установки и
информация об упаковке. Первый может быть указан с помощью источник параметр и может
быть опущено, и в этом случае Найтиустановленные файлы функция соберет все файлы, которые
есть Установите or Установить как Застройщик прилагается. Если цель не указано, что это будет
быть выведены из дополнительной информации, предоставленной этому Строителю.

Информация об упаковке задается с помощью переменных конструкции
задокументировано ниже. Эта информация называется тегом, чтобы подчеркнуть, что некоторые из них могут
также прикрепляться к файлам с Тег функция. Обязательные будут жаловаться, если
они не были указаны. Они различаются в зависимости от выбранного целевого упаковщика.

Целевой упаковщик можно выбрать с помощью параметра командной строки "PACKAGETYPE" или с помощью
$ТИП ПАКЕТА строительная переменная. На данный момент доступны следующие упаковщики:

* msi — установщик Microsoft * rpm — диспетчер пакетов Redhat * ipkg — пакет Itsy
Система управления * tarbz2 - сжатый tar * targz - сжатый tar * zip - zip файл
* src_tarbz2 - сжатый исходный файл tar * src_targz - сжатый исходный файл tar * src_zip -
источник zip-файла

Обновленный список всегда доступен в опции package_type при запуске.
"scons --help" для проекта, в котором активирован пакет.

env = Среда (инструменты = ['по умолчанию', 'упаковка'])
env.Install ('/ bin /', 'моя_программа')
env.Package(ИМЯ = 'foo',
ВЕРСИЯ = '1.2.3',
ВЕРСИЯ ПАКЕТА = 0,
ТИП ПАКЕТА = 'об/мин',
ЛИЦЕНЗИЯ = 'gpl',
РЕЗЮМЕ = 'балалалалал',
DESCRIPTION = 'это должно быть очень-очень длинным',
X_RPM_GROUP = 'Приложение/фу',
ИСТОЧНИК_URL = 'http://foo.org/foo-1.2.3.tar.gz'
)

ПЧ(), окр.PCH()
Создает предварительно скомпилированный заголовок Microsoft Visual C++. Вызов этого метода построителя возвращает
список из двух целей: PCH в качестве первого элемента и объектный файл в качестве второго
элемент. Обычно объектный файл игнорируется. Этот метод построителя предоставляется только
когда Microsoft Visual C++ используется в качестве компилятора. Метод построителя PCH
обычно используется в сочетании с конструктивной переменной PCH для форсирования объектных файлов
использовать предварительно скомпилированный заголовок:

env['PCH'] = env.PCH('StdAfx.cpp')[0]

PDF(), окр.PDF()
Создает файл .pdf из входного файла .dvi (или, в зависимости от расширения, файла .tex, .ltx или .latex).
входной файл). Суффикс, указанный $ PDFSUFFIX строительная переменная (.pdf по
default) автоматически добавляется к цели, если она еще не присутствует. Пример:

# строит из aaa.tex
env.PDF (цель = 'aaa.pdf', источник = 'aaa.tex')
# создает bbb.pdf из bbb.dvi
env.PDF (цель = 'bbb', источник = 'bbb.dvi')

ПОинит(), окр.POInit()
Этот построитель принадлежит инструменту msginit. Построитель инициализирует отсутствующие файлы PO, если
$ POAUTOINIT установлен. Если $ POAUTOINIT не установлено (по умолчанию), POInit распечатывает инструкцию для
пользователя (который должен быть переводчиком), сообщая, каким должен быть PO-файл
инициализирован. В обычных проектах должен использование POInit и использование POОбновить вместо.
POОбновить разумно выбирает между Слияние сообщений(1) и мсгинит(1). POInit всегда использует
мсгинит(1) и должен рассматриваться как застройщик для специальных целей или для временного использования
(например, для быстрой однократной инициализации группы PO-файлов) или для тестов.

Целевые узлы, определенные через POInit не создаются по умолчанию (они игнорируются из '.'
node), но добавляются к специальному псевдониму (по умолчанию 'po-create'). Псевдоним может быть
изменился через $ POCREATE_ALIAS строительная переменная. Все файлы PO определены
через POInit может быть легко инициализирован с помощью бра создавать.

Пример 1. Инициализируйте en.po и pl.po из messages.pot:

#...
env.POInit(['en', 'pl']) # messages.pot --> [en.po, pl.po]

Пример 2. Инициализировать en.po и pl.po из foo.pot:

#...
env.POInit(['en', 'pl'], ['foo']) # foo.pot --> [en.po, pl.po]

Пример 3. Инициализируйте en.po и pl.po из foo.pot, но используя $ POTDOMAIN строительство
переменная:

#...
env.POInit(['en', 'pl'], POTDOMAIN='foo') # foo.pot --> [en.po, pl.po]

Пример 4. Инициализируйте файлы PO для языков, определенных в файле LINGUAS. Файлы будут
инициализироваться из шаблона messages.pot:

#...
env.POInit(LINGUAS_FILE = 1) # нужен файл 'LINGUAS'

Пример 5. Инициализируйте файлы en.po и pl.pl PO, а также файлы для языков, определенных в
файл ЛИНГВАС. Файлы будут инициализированы из шаблона messages.pot:

#...
env.POInit(['en', 'pl'], LINGUAS_FILE = 1)

Пример 6. Вы можете предварительно настроить свою среду, а затем инициализировать PO-файлы:

#...
env['POAUTOINIT'] = 1
env ['LINGUAS_FILE'] = 1
env['POTDOMAIN'] = 'foo'
окр.POInit()

который имеет тот же эффект, что и:

#...
env.POInit(POAUTOINIT = 1, LINGUAS_FILE = 1, POTDOMAIN = 'foo')

Постскриптум(), окр.PostScript()
Создает файл .ps из входного файла .dvi (или, в зависимости от расширения, файла .tex, .ltx или .latex).
входной файл). Суффикс, указанный $ PSSUFFIX строительная переменная (.ps by
default) автоматически добавляется к цели, если она еще не присутствует. Пример:

# строит из aaa.tex
env.PostScript (цель = 'aaa.ps', источник = 'aaa.tex')
# строит bbb.ps из bbb.dvi
env.PostScript (цель = 'bbb', источник = 'bbb.dvi')

POUpdate(), окр.POTUpdate()
Построитель принадлежит инструменту xgettext. Построитель обновляет целевой файл POT, если он существует или
создает его, если это не так. Узел не создается по умолчанию (т. е. игнорируется из
'.'), но только по запросу (т. е. когда требуется данный файл POT или когда используется специальный псевдоним).
вызывается). Этот построитель добавляет свой целевой узел (например, messages.pot) к специальному псевдониму.
(пот-обновление по умолчанию, см. $ POTUPDATE_ALIAS), поэтому вы можете легко обновлять/создавать их
бра обновление горшка. Файл не записывается до тех пор, пока в нем не будет реальных изменений.
интернационализированные сообщения (или в комментариях, которые входят в файл POT).

Внимание
Вы можете увидеть xgettext(1) вызывается инструментом xgettext, даже если нет
реальное изменение интернационализированных сообщений (поэтому файл POT не обновляется).
Это происходит каждый раз, когда исходный файл изменяется. В таком случае мы вызываем
xgettext(1) и сравните его вывод с содержимым файла POT, чтобы решить,
файл должен быть обновлен или нет.

Пример 1. Создадим директорию po/ и поместим туда следующий скрипт SConstruct:

# SConstruct в подкаталоге 'po/'
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env.POTUpdate(['foo'], ['../a.cpp', '../b.cpp'])
env.POTUpdate(['bar'], ['../c.cpp', '../d.cpp'])

Затем несколько раз вызовите scons:

user@host:$ scons # Не создает ни foo.pot, ни bar.pot
user@host:$ scons foo.pot # Обновляет или создает foo.pot
user@host:$ scons pot-update # Обновляет или создает foo.pot и bar.pot
user@host:$ scons -c # Не очищает ни foo.pot, ни bar.pot.

результаты должны быть такими, как сказано в комментариях выше.

Пример 2. Команда POUpdate builder может использоваться без указания цели, и в этом случае
Целевой объект messages.pot по умолчанию будет использоваться. Цель по умолчанию также может быть переопределена
установка $ POTDOMAIN конструкторская переменная или предоставление ее в качестве переопределения POUpdate
строитель:

# Скрипт SConstruct
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env['POTDOMAIN'] = "foo"
env.POTUpdate(source = ["a.cpp", "b.cpp"]) # Создает foo.pot ...
env.POTUpdate(POTDOMAIN = "bar", source = ["c.cpp", "d.cpp"]) # и bar.pot

Пример 3. Источники могут быть указаны в отдельном файле, например
POTFILES.in:

# POTFILES.in в подкаталоге 'po/'
../a.cpp
../b.cpp
# конец файла

Имя файла (POTFILES.in), содержащего список источников, предоставляется через
$ XGETTEXTFROM:

# Файл SConstruct в подкаталоге 'po/'
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env.POTUpdate (XGETTEXTFROM = 'POTFILES.in')

Пример 4. Вы можете использовать $ XGETTEXTPATH для определения пути поиска источника. Предположим, для
например, что у вас есть файлы a.cpp, b.cpp, po/SConstruct, po/POTFILES.in. Тогда ваш
Файлы, связанные с POT, могут выглядеть следующим образом:

# POTFILES.in в подкаталоге 'po/'
а.cpp
б.cpp
# конец файла

# Файл SConstruct в подкаталоге 'po/'
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env.POTUpdate(XGETTEXTFROM = 'POTFILES.in', XGETTEXTPATH='../')

Пример 5. В списке может быть определено несколько поисковых каталогов, т.е.
XGETTEXTPATH ​​= ['каталог1', 'каталог2', ...]. Порядок в списке определяет поиск
порядок исходных файлов. Используется путь к первому найденному файлу.

Создадим скрипт 0/1/po/SConstruct:

# Файл SConstruct в подкаталоге '0/1/po/'
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env.POTUpdate(XGETTEXTFROM = 'POTFILES.in', XGETTEXTPATH=['../', '../../'])

и 0/1/po/POTFILES.in:

# POTFILES.in в подкаталоге '0/1/po/'
а.cpp
# конец файла

Напишите два файла *.cpp, первый — 0/a.cpp:

/* 0/a.cpp */
gettext("Привет от ../../a.cpp")

а второй — 0/1/a.cpp:

/* 0/1/a.cpp */
gettext("Привет от ../a.cpp")

затем запустить scons. Вы получите 0/1/po/messages.pot с сообщением «Привет от
../a.cpp". При обратном порядке в $XGETTEXTFOM, т.е. когда вы пишете SConscript как

# Файл SConstruct в подкаталоге '0/1/po/'
env = Среда (инструменты = ['по умолчанию', 'xgettext'])
env.POTUpdate(XGETTEXTFROM = 'POTFILES.in', XGETTEXTPATH=['../../', '../'])

тогда messages.pot будет содержать строку msgid «Hello from ../../a.cpp», а не msgid
"Привет от ../a.cpp".

ПООбновление(), окр.POUpdate()
Конструктор принадлежит инструменту msgmerge. Построитель обновляет файлы PO с помощью Слияние сообщений(1),
или инициализирует отсутствующие файлы PO, как описано в документации инструмента msginit и
POInit застройщик (см. также $ POAUTOINIT). Обратите внимание, что POОбновить приносит его направлена против в
создавать псевдоним as POInit делает.

Целевые узлы, определенные через POОбновить не строятся по умолчанию (они Игнорируются из
'.' узел). Вместо этого они автоматически добавляются к специальному псевдониму ('po-update' by
дефолт). Псевдоним может быть изменен через $ POUPDATE_ALIAS строительство
Переменная. Вы можете легко обновить файлы PO в своем проекте, бра обновление.

Пример 1. Обновите en.po и pl.po из шаблона messages.pot (см. также $ POTDOMAIN),
предполагая, что более поздний существует или есть правило для его построения (см. POUpdate):

#...
env.POUpdate(['en','pl']) # messages.pot --> [en.po, pl.po]

Пример 2. Обновите en.po и pl.po из шаблона foo.pot:

#...
env.POUpdate(['en', 'pl'], ['foo']) # foo.pot --> [en.po, pl.pl]

Пример 3. Обновите en.po и pl.po из foo.pot (другая версия):

#...
env.POUpdate(['en', 'pl'], POTDOMAIN='foo') # foo.pot -- > [en.po, pl.pl]

Пример 4. Обновите файлы для языков, определенных в файле LINGUAS. Файлы обновлены
из шаблона messages.pot:

#...
env.POUpdate(LINGUAS_FILE = 1) # нужен файл 'LINGUAS'

Пример 5. То же, что и выше, но обновление из шаблона foo.pot:

#...
env.POUpdate (LINGUAS_FILE = 1, источник = ['foo'])

Пример 6. Обновите файлы en.po и pl.po plus для языков, определенных в файле LINGUAS.
Файлы обновляются из шаблона messages.pot:

# создать файлы 'en.po', 'pl.po' + файлы, определенные в 'LINGUAS':
env.POUpdate(['en', 'pl' ], LINGUAS_FILE = 1)

Пример 7. Используйте $ POAUTOINIT для автоматической инициализации файла PO, если он не существует:

#...
env.POUpdate (LINGUAS_FILE = 1, POAUTOINIT = 1)

Пример 8. Обновите файлы PO для языков, определенных в файле LINGUAS. Файлы
обновлен из шаблона foo.pot. Все необходимые настройки предварительно настраиваются через
окружающей среды.

#...
env['POAUTOINIT'] = 1
env ['LINGUAS_FILE'] = 1
env['POTDOMAIN'] = 'foo'
окр.POUpdate()

Программа(), env.Программа()
Создает исполняемый файл с учетом одного или нескольких объектных файлов или исходного кода C, C++, D или Fortran.
файлы. Если указаны какие-либо исходные файлы C, C++, D или Fortran, они будут
автоматически компилируется в объектные файлы с помощью объект метод строителя; видеть, что
описание метода компоновщика для списка легальных суффиксов исходных файлов и их
интерпретируется. Префикс целевого исполняемого файла (указанный параметром $PROGPREFIX
строительная переменная; ничего по умолчанию) и суффикс (указывается $PROGSUFFIX
строительная переменная; по умолчанию .exe в системах Windows, ничего в системах POSIX)
автоматически добавляются к цели, если еще не присутствуют. Пример:

env.Program (цель = 'foo', источник = ['foo.o', 'bar.c', 'baz.f'])

РЕЗ(), окружение.RES()
Создает файл ресурсов Microsoft Visual C++. Этот метод построителя предоставляется только тогда, когда
В качестве компилятора используется Microsoft Visual C++ или MinGW. .res (или .o для
MinGW) добавляется к целевому имени, если не указан другой суффикс. Исходный файл
сканируется на наличие неявных зависимостей, как если бы это был файл C. Пример:

env.RES('resource.rc')

РМИЦ(), окр.РМИК()
Создает файлы классов-заглушек и каркасов для удаленных объектов из файлов Java .class. То
target — это каталог, относительно которого будут храниться файлы классов-заглушек и каркасов.
написано. Источником могут быть имена файлов .class или объекты, возвращенные из
Java Строительный метод.

Если конструктивная переменная $ JAVACLASSDIR устанавливается либо в среде, либо в
позвонить в РМИЦ построитель, то значение переменной будет
удалены из начала любых имен файлов .class.

классы = env.Java (цель = 'classdir', источник = 'src')
env.RMIC (цель = 'outdir1', источник = классы)

env.RMIC (цель = 'outdir2',
источник = ['пакет / foo.class', 'пакет / bar.class'])

env.RMIC (цель = 'outdir3',
source = ['классы / foo.class', 'классы / bar.class'],
JAVACLASSDIR = 'классы')

RPGenClient(), енв.RPCGenClient()
Создает файл-заглушку клиента RPC (_clnt.c) из указанного исходного файла RPC (.x).
Поскольку rpcgen создает выходные файлы только в локальном каталоге, команда будет
выполняется в каталоге исходного файла по умолчанию.

# Создает src/rpcif_clnt.c
env.RPCGenClient('src/rpcif.x')

Заголовок RPGen(), энв.RPCGenHeader()
Создает файл заголовка RPC (.h) из указанного исходного файла RPC (.x). Так как
rpcgen только создает выходные файлы в локальном каталоге, команда будет выполнена
в каталоге исходного файла по умолчанию.

# Создает src/rpcif.h
env.RPCGenHeader('src/rpcif.x')

RPGenService(), энв.RPCGenService()
Создает файл скелета сервера RPC (_svc.c) из указанного исходного файла RPC (.x).
Поскольку rpcgen создает выходные файлы только в локальном каталоге, команда будет
выполняется в каталоге исходного файла по умолчанию.

# Создает src/rpcif_svc.c
env.RPCGenClient('src/rpcif.x')

RPGenXDR(), энв.RPCGenXDR()
Создает файл подпрограммы RPC XDR (_xdr.c) из указанного исходного файла RPC (.x).
Поскольку rpcgen создает выходные файлы только в локальном каталоге, команда будет
выполняется в каталоге исходного файла по умолчанию.

# Создает src/rpcif_xdr.c
env.RPCGenClient('src/rpcif.x')

Общая библиотека (), окр.SharedLibrary()
Создает разделяемую библиотеку (.so в системе POSIX, .dll в Windows) с учетом одного или нескольких
объектные файлы или исходные файлы C, C++, D или Fortran. Если даны какие-либо исходные файлы, то
они будут автоматически скомпилированы в объектные файлы. Префикс статической библиотеки и
суффикс (если есть) автоматически добавляются к цели. Префикс файла целевой библиотеки
(указано $ SHLIBPREFIX строительная переменная; по умолчанию lib на POSIX
систем, ничего в системах Windows) и суффикс (указанный $ SHLIBSUFFIX
строительная переменная; по умолчанию .dll в системах Windows, .so в системах POSIX)
автоматически добавляется к цели, если еще не присутствует. Пример:

env.SharedLibrary (цель = 'bar', источник = ['bar.c', 'foo.o'])

В системах Windows Общая библиотека метод builder всегда будет строить импорт
(.lib) в дополнение к общей библиотеке (.dll), добавляя библиотеку .lib с
то же самое базовое имя, если файл .lib еще не указан в явном виде в
целей.

В системах Cygwin Общая библиотека метод builder всегда будет строить импорт
(.dll.a) в дополнение к общей библиотеке (.dll), добавление библиотеки .dll.a
с тем же базовым именем, если файл .dll.a еще не указан в явном виде в
целей.

Любые объектные файлы, перечисленные в исходном коде, должны быть созданы для общей библиотеки (которая
есть, используя Общий объект метод строителя). scons вызовет ошибку, если она есть.
несоответствие.

На некоторых платформах существует различие между разделяемой библиотекой (загружаемой
автоматически системой для разрешения внешних ссылок) и загружаемый модуль
(явно загружается действием пользователя). Для максимальной мобильности используйте Загружаемый модуль
строитель для последнего.

Когда $ШЛИБВЕРСИЯ конструктивная переменная определена версионная разделяемая библиотека
созданный. Это изменяет $ SHLINKFLAGS при необходимости добавляет номер версии к
имя библиотеки и создает необходимые символические ссылки.

env.SharedLibrary (цель = 'bar', источник = ['bar.c', 'foo.o'], SHLIBVERSION = '1.5.2')

В системе POSIX версии с одним токеном создают ровно одну символическую ссылку:
libbar.so.6 будет иметь только символические ссылки libbar.so. В системе POSIX версии с двумя
или более токенов создают ровно две символические ссылки: libbar.so.2.3.1 будет иметь символические ссылки
libbar.so и libbar.so.2; в системе Darwin (OSX) библиотека будет
libbar.2.3.1.dylib, а ссылка будет libbar.dylib.

В системах Windows указание register=1 приведет к регистрации .dll после
он построен с использованием REGSVR32. Выполняется команда (по умолчанию "regsvr32")
определяется по $ REGSVR конструкторская переменная, а переданные флаги определяются
$ REGSVRFLAGS, По умолчанию, $ REGSVRFLAGS включает в себя /s вариант, чтобы предотвратить диалоги от
выскакивает и требует внимания пользователя при запуске. Если вы измените $ REGSVRFLAGS, Быть
обязательно включите /s вариант. Например,

env.SharedLibrary (цель = 'бар',
источник = ['bar.cxx', 'foo.obj'],
зарегистрироваться=1)

зарегистрирует bar.dll как COM-объект, когда он будет связан с ним.

ОбщийОбъект(), env.Общий объект()
Создает объектный файл для включения в общую библиотеку. Исходные файлы должны иметь один из
тот же набор расширений, указанный выше для СтатикОбъект метод строителя. На
некоторые платформы, создающие общий объект, требуют дополнительной опции компилятора (например,
-fPIC для gcc) в дополнение к тем, которые необходимы для построения обычного (статического) объекта, но на
на некоторых платформах нет разницы между общим объектом и обычным (статическим)
один. Когда есть разница, SCons разрешают связывать только общие объекты.
в общую библиотеку и будет использовать другой суффикс для общих объектов. На
платформах, где нет разницы, SCons позволит как обычные (статические), так и
общие объекты, которые будут связаны с общей библиотекой, и будут использовать тот же суффикс для
общие и обычные (статические) объекты. Префикс целевого объектного файла (указанный параметром
$ SHOBJPREFIX строительная переменная; по умолчанию так же, как $ OBJPREFIX) и суффикс
(указано $ SHOBJSUFFIX переменная построения) автоматически добавляются в
цель, если она еще не присутствует. Примеры:

env.SharedObject (цель = 'ddd', источник = 'ddd.c')
env.SharedObject (цель = 'eee.o', источник = 'eee.cpp')
env.SharedObject (цель = 'fff.obj', источник = 'fff.for')

Обратите внимание, что исходные файлы будут сканироваться в соответствии с сопоставлениями суффиксов в
Объект SourceFileScanner. Дополнительные сведения см. в разделе «Объекты сканера» ниже.
Информация.

Статическая библиотека(), окр.StaticLibrary()
Создает статическую библиотеку по одному или нескольким объектным файлам или исходному коду C, C++, D или Fortran.
файлы. Если даны какие-либо исходные файлы, то они будут автоматически скомпилированы в
объектные файлы. Префикс и суффикс статической библиотеки (если есть) автоматически добавляются в
цель. Префикс файла целевой библиотеки (указанный параметром $ LIBPREFIX строительство
Переменная; по умолчанию lib в системах POSIX, ничего в системах Windows) и суффикс
(указано $ LIBSUFFIX строительная переменная; по умолчанию .lib в Windows
системы, .a в системах POSIX) автоматически добавляются к цели, если это еще не сделано.
настоящее время. Пример:

env.StaticLibrary (цель = 'bar', источник = ['bar.c', 'foo.o'])

Любые объектные файлы, перечисленные в исходном коде, должны быть созданы для статической библиотеки (которая
есть, используя СтатикОбъект метод строителя). scons вызовет ошибку, если она есть.
несоответствие.

СтатическийОбъект(), окр.СтатическийОбъект()
Создает статический объектный файл из одного или нескольких исходных файлов C, C++, D или Fortran.
Исходные файлы должны иметь одно из следующих расширений:

.asm файл языка ассемблера
.ASM файл языка ассемблера
.c C-файл
.C Windows: файл C
POSIX: файл C++
C++ файл .cc
C++ файл .cpp
C++ файл .cxx
C++ файл .cxx
.c++ файл C++
.С++ файл С++
.d D-файл
.f файл Фортран
.F Windows: файл Fortran
POSIX: файл Fortran + препроцессор C
.для файла Фортран
.FOR файл Фортран
.fpp файл Fortran + препроцессор C
Файл .FPP Fortran + препроцессор C
.m Файл объекта C
.mm объектный файл C++
.s файл языка ассемблера
.S Windows: файл языка ассемблера
ARM: CodeSourcery Sourcery Lite
.sx файл языка ассемблера + препроцессор C
POSIX: файл языка ассемблера + препроцессор C
.spp файл языка ассемблера + препроцессор C
.SPP файл языка ассемблера + препроцессор C

Префикс целевого объектного файла (указанный параметром $ OBJPREFIX строительная переменная;
ничего по умолчанию) и суффикс (указывается $ OBJSUFFIX строительная переменная;
.obj в системах Windows, .o в системах POSIX) автоматически добавляются к цели, если
уже не присутствует. Примеры:

env.StaticObject (цель = 'ааа', источник = 'ааа.с')
env.StaticObject (цель = 'bbb.o', источник = 'bbb.c++')
env.StaticObject (цель = 'ccc.obj', источник = 'ccc.f')

Обратите внимание, что исходные файлы будут сканироваться в соответствии с сопоставлениями суффиксов в
Объект SourceFileScanner. Дополнительные сведения см. в разделе «Объекты сканера» ниже.
Информация.

Подфайл(), окр.Substfile()
Команда Подфайл построитель создает один текстовый файл из другого файла или набора файлов путем
объединение их с $ LINESEPARATOR и замена текста с помощью $ SUBST_DICT
строительная переменная. Вложенные списки исходных файлов выравниваются. Смотрите также Текстовый файл.

Если присутствует один исходный файл с суффиксом .in, этот суффикс удаляется, а
остаток используется в качестве целевого имени по умолчанию.

Префикс и суффикс, указанные $ SUBSTFILEPREFIX и $ SUBSTFILESUFFIX
переменные построения (нулевая строка по умолчанию в обоих случаях) автоматически
добавляются к цели, если они еще не присутствуют.

Если конструктивная переменная с именем $ SUBST_DICT присутствует, это может быть либо Python
словарь или последовательность кортежей (ключ, значение). Если это словарь, он преобразуется
в список кортежей в произвольном порядке, поэтому, если один ключ является префиксом другого ключа
или если одна замена может быть дополнительно расширена другой заменой, это
непредсказуемо, произойдет ли расширение.

Любые вхождения ключа в источнике заменяются соответствующим значением, которое
может быть вызываемой функцией Python или строкой. Если значение является вызываемым, оно
вызывается без аргументов для получения строки. Строки SUBST- расширено и результат
заменяет ключ.

env = Среда (инструменты = ['по умолчанию', 'текстовый файл'])

env['префикс'] = '/ USR / бен'
script_dict = {'@prefix@': '/ бен', @exec_prefix@: '$префикс'}
env.Substfile('script.in', SUBST_DICT = script_dict)

conf_dict = {'%VERSION%': '1.2.3', '%BASE%': 'MyProg'}
env.Substfile('config.h.in', conf_dict, SUBST_DICT = conf_dict)

# НЕПРЕДСКАЗУЕМЫЙ - один ключ является префиксом другого
bad_foo = {'$foo': '$foo', '$foobar': '$foobar'}
env.Substfile('foo.in', SUBST_DICT = bad_foo)

# ПРЕДСКАЗУЕМЫЙ - сначала применяются самые длинные ключи
good_foo = [('$foobar', '$foobar'), ('$foo', '$foo')]
env.Substfile('foo.in', SUBST_DICT = good_foo)

# НЕПРЕДСКАЗУЕМО - одна замена может быть расширена
bad_bar = {'@bar@': '@soap@', '@soap@': 'щелок'}
env.Substfile('bar.in', SUBST_DICT = bad_bar)

# ПРЕДСКАЗУЕМЫЙ - замены расширяются по порядку
good_bar = (('@bar@', '@soap@'), ('@soap@', 'щелок'))
env.Substfile('bar.in', SUBST_DICT = good_bar)

# SUBST_DICT может быть общим (а не переопределением)
замены = {}
subst = Среда (инструменты = ['текстовый файл'], SUBST_DICT = замены)
замены['@foo@'] = 'foo'
subst['SUBST_DICT']['@bar@'] = 'бар'
subst.Substfile('pgm1.c', [Value('#include "@[электронная почта защищена]"'),
Value('#include "@[электронная почта защищена]"'),
"общий.in",
"pgm1.in"
])
subst.Substfile('pgm2.c', [Value('#include "@[электронная почта защищена]"'),
Value('#include "@[электронная почта защищена]"'),
"общий.in",
"pgm2.in"
])

Тар(), окр.Тар()
Создает tar-архив из указанных файлов и/или каталогов. В отличие от большинства застройщиков
методы, Деготь метод построителя может вызываться несколько раз для данной цели; каждый
дополнительный вызов добавляет в список записи, которые будут встроены в архив. Любой
исходные каталоги будут сканироваться на наличие изменений в любых файлах на диске, независимо от
знает ли scons о них из других вызовов Builder или функций.

env.Tar('src.tar', 'src')

# Создайте файл stuff.tar.
env.Tar('stuff', ['subdir1', 'subdir2'])
# Также добавьте «другой» в файл stuff.tar.
env.Tar('вещи', 'другие')

# Установите TARFLAGS для создания архива с фильтрацией gzip.
env = Окружающая среда (TARFLAGS = '-c -z')
env.Tar('foo.tar.gz', 'foo')

# Также установите суффикс .tgz.
env = Окружающая среда (TARFLAGS = '-c -z',
TARSUFFIX = '.tgz')
env.Tar('foo')

Текстовый файл(), env.Текстовый файл()
Команда Текстовый файл Builder создает один текстовый файл. Исходные строки составляют
линии; вложенные списки источников сглаживаются. $ LINESEPARATOR используется для разделения
строки.

Если присутствует, $ SUBST_DICT строительная переменная используется для изменения строк перед
они написаны; см. Подфайл описание для деталей.

Префикс и суффикс, указанные $ TEXTFILEPREFIX и $ TEXTFILESUFFIX
конструкционные переменные (нулевая строка и .txt по умолчанию соответственно)
автоматически добавляются к цели, если они еще не присутствуют. Примеры:

# создает/записывает файл foo.txt
env.Textfile(target = 'foo.txt', source = ['Гёте', 42, 'Шиллер'])

# создает/записывает bar.txt
env.Textfile (цель = 'бар',
источник = ['лалала', 'тантератей'],
LINESEPARATOR='|*')

# вложенные списки автоматически выравниваются
env.Textfile (цель = 'blob',
source = ['lalala', ['Goethe', 42 'Шиллер'], 'tanteratei'])

# файлы можно использовать в качестве входных данных, поместив их в File()
env.Textfile(target = 'concat', # объединить файлы с маркером между
источник = [Файл('concat1'), Файл('concat2')],
LINESEPARATOR = '====================\n')

Результаты:
foo.txt
....8<----
Гете
42
Шиллер
....8<---- (без перевода строки в конце)

бар.txt:
....8<----
лалала|* тантератей
....8<---- (без перевода строки в конце)

blob.txt
....8<----
Лалала
Гете
42
Шиллер
тантератей
....8<---- (без перевода строки в конце)

Перевести(), env.Перевести()
Этот псевдо-конструктор принадлежит набору инструментов gettext. Застройщик извлекает интернационализированные
сообщения из исходных файлов, обновляет шаблон POT (при необходимости), а затем обновляет PO
переводы (при необходимости). Если $ POAUTOINIT установлен, отсутствующие файлы PO будут
создается автоматически (т.е. без вмешательства переводчика). Переменные
$ LINGUAS_FILE и $ POTDOMAIN тоже учитываются. Все остальное строительство
переменные, используемые POUpdateи POОбновить работать и здесь.

Пример 1. Самый простой способ — указать входные файлы и языки вывода, встроенные в
Скрипт SCons при вызове Переведите

# SConscript в каталоге 'po/'
env = Среда (инструменты = ["по умолчанию", "gettext"])
env['POAUTOINIT'] = 1
env.Translate(['en','pl'], ['../a.cpp','../b.cpp'])

Пример 2. Если вы хотите, вы также можете придерживаться традиционного стиля, известного по автоинструментам,
т.е. используя файлы POTFILES.in и LINGUAS

# ЯЗЫКИ
ru pl
#конец

#POTFILES.in
а.cpp
б.cpp
# конец

# SConscript
env = Среда (инструменты = ["по умолчанию", "gettext"])
env['POAUTOINIT'] = 1
env['XGETTEXTPATH'] = ['../']
env.Translate (LINGUAS_FILE = 1, XGETTEXTFROM = 'POTFILES.in')

Последний подход, возможно, является рекомендуемым. Это позволяет легко разделить
интернационализация/локализация на отдельные скрипты SCons, где скрипт в
исходное дерево отвечает за переводы (из исходников в файлы PO) и скрипт(ы)
под вариантными каталогами отвечают за компиляцию файлов PO в MO для и для
установка МО файлов. Тогда «коэффициент склеивания», синхронизирующий эти два сценария, равен
содержимое файла LINGUAS. Обратите внимание, что обновленные файлы POT и PO обычно
быть зафиксированы обратно в репозиторий, поэтому они должны быть обновлены в исходном коде
каталог (а не в альтернативных каталогах). Кроме того, список файлов po/
каталог содержит файл LINGUAS, поэтому исходное дерево выглядит знакомым переводчикам, а
они могут работать с проектом как обычно.

Пример 3. Давайте подготовим дерево разработки, как показано ниже.

проект/
+ SКонструкт
+ построить/
+ источник/
+ по/
+ Призывник
+ SConscript.i18n
+ POTFILES.in
+ ЛИНГВЫ

где build является вариантным каталогом. Напишите сценарий SConstruct верхнего уровня следующим образом.

# SКонструкт
env = Среда (инструменты = ["по умолчанию", "gettext"])
VariantDir('сборка', 'источник', дубликат = 0)
env['POAUTOINIT'] = 1
SConscript('src/po/SConscript.i18n', экспорт = 'env')
SConscript('сборка/po/SConscript', экспорт = 'env')

src/po/SConscript.i18n как

# src/po/SConscript.i18n
Импорт('окружение')
env.Translate(LINGUAS_FILE=1, XGETTEXTFROM='POTFILES.in', XGETTEXTPATH=['../'])

и src/po/SConscript

# источник/po/SConscript
Импорт('окружение')
env.MOFiles (LINGUAS_FILE = 1)

Такая установка создает файлы POT и PO в исходном дереве в src/po/ и двоичные файлы MO.
под деревом вариантов в build/po/. Таким образом файлы POT и PO отделены от
другие выходные файлы, которые не должны возвращаться в исходные репозитории (например, MO
файлы).

Внимание
В приведенном выше примере файлы PO не обновляются и не создаются автоматически, когда вы
вопрос бра '' команда. Файлы должны обновляться (создаваться) вручную через бра
обновление а затем файлы MO можно скомпилировать, запустив бра ''.

Библиотека типов (), энв.ТипБиблиотека()
Создает файл библиотеки типов Windows (.tlb) из входного IDL-файла (.idl). Кроме того,
он создаст соответствующие заглушки интерфейса и исходные файлы прокси, назвав их
в соответствии с базовым именем файла .idl. Например,

env.TypeLibrary (источник = "foo.idl")

Создаст файлы foo.tlb, foo.h, foo_i.c, foo_p.c и foo_data.c.

UIC(), окр.Uic()
Создает файл заголовка, файл реализации и файл moc из файла пользовательского интерфейса. и
возвращает соответствующие узлы в указанном выше порядке. Этот конструктор доступен только
после использования инструмента 'qt'. Примечание. Вы можете указать файлы .ui непосредственно в качестве исходных файлов для
Программа, Библиотека и Общая библиотека билдеры без использования этого билдера. Используя это
builder позволяет переопределить стандартные соглашения об именах (будьте осторожны: префиксы
всегда ставится перед именами встроенных файлов; если вам не нужны префиксы, вы можете установить их
к ``). См. $ QTDIR переменная для получения дополнительной информации. Пример:

env.Uic('foo.ui') # -> ['foo.h', 'uic_foo.cc', 'moc_foo.cc']
env.Uic(target = Split('include/foo.h gen/uicfoo.cc gen/mocfoo.cc'),
source = 'foo.ui') # -> ['include/foo.h', 'gen/uicfoo.cc', 'gen/mocfoo.cc']

Почтовый индекс (), окр.Zip()
Создает zip-архив из указанных файлов и/или каталогов. В отличие от большинства застройщиков
методы, ZIP метод построителя может вызываться несколько раз для данной цели; каждый
дополнительный вызов добавляет в список записи, которые будут встроены в архив. Любой
исходные каталоги будут сканироваться на наличие изменений в любых файлах на диске, независимо от
знает ли scons о них из других вызовов Builder или функций.

env.Zip('src.zip', 'src')

# Создайте файл stuff.zip.
env.Zip('материал', ['subdir1', 'subdir2'])
# Также добавьте «другой» в файл stuff.tar.
env.Zip('вещи', 'другие')

Все цели методов компоновщика автоматически зависят от их источников. Явный
зависимость может быть указана с помощью Зависит метод построения среды (см.
ниже).

Кроме того, бра автоматически сканирует исходные файлы для различных языков программирования, поэтому
зависимости не нужно указывать явно. По умолчанию SCon могут использовать источник C
файлы, исходные файлы C++, исходные файлы Fortran с .F (только для систем POSIX), .фпп, or .ФПП
расширения файлов и файлы языка ассемблера с .S (только для систем POSIX), .спп, or .СПП
расширения файлов для зависимостей препроцессора C. SCons также имеет поддержку по умолчанию для
сканируя исходные файлы D. Вы также можете написать свои собственные сканеры, чтобы добавить поддержку
дополнительные типы исходных файлов. Они могут быть добавлены к объекту Scanner по умолчанию, используемому
объект(), СтатикОбъект(), а также Общий объект() Строители, добавив их в
ИсходныйФайлСканер объект. Дополнительную информацию см. в разделе «Объекты сканера» ниже.
об определении ваших собственных объектов Scanner и использовании ИсходныйФайлСканер объект.

методы и функции в Do Вещи
В дополнение к методам Builder, бра обеспечивает ряд других условий строительства
методы и глобальные функции для управления конфигурацией сборки.

Обычно метод среды построения и глобальная функция с одинаковыми именами
существуют, так что вам не нужно помнить, должна ли определенная часть функциональности
быть вызван с или без среды построения. В следующем списке, если вы позвоните
что-то вроде глобальной функции выглядит так:

Функция(Аргументы)

и если вы вызываете что-то через среду построения, это выглядит так:

env.Функция(Аргументы)

Если вы можете вызвать функциональность обоими способами, то будут перечислены обе формы.

Глобальные функции могут вызываться из пользовательских модулей Python, которые вы импортируете в
SConscript, добавив в модуль Python следующее:

из импорта SCons.Script *

Если не указано иное, одноименный метод среды построения и глобальный
Функция обеспечивает точно такую ​​же функциональность. Разница только в том, что где
уместно, вызов функциональности через среду конструирования заменит
конструкторские переменные в любые предоставленные строки. Например:

env = Окружающая среда (FOO = 'foo')
По умолчанию('$FOO')
env.Default('$FOO')

В приведенном выше примере первый вызов глобальной Дефолт() функция фактически добавит
цель названа $FOO в список целей по умолчанию, а второй вызов
env.По умолчанию () Метод среды построения расширит значение и добавит цель с именем
Foo в список целей по умолчанию. Для получения дополнительной информации о расширении переменной конструкции см.
следующий раздел о переменных конструкции.

Методы среды строительства и глобальные функции, поддерживаемые бра следующие:

Действие(действие, [cmd/str/fun, [var, ...]] [опция=значение, ...]), env.Action(действие,
[cmd/str/fun, [var, ...]] [опция=значение, ...])
Создает объект Action для указанного действие. См. раздел «Объекты действий».
ниже, для полного объяснения аргументов и поведения.

Обратите внимание, что окр.Действие() форма вызова будет расширять переменные конструкции
в любых строках аргументов, включая действие аргумент, в то время, когда он вызывается с использованием
строительные переменные в окр строительная среда, через которую
окр.Действие() назывался. То Экшн() задерживает раскрытие всех переменных до тех пор, пока
Объект действия фактически используется.

AddMethod(объект, функция, [имя]), env.AddMethod(функция, [имя])
При вызове с ДобавитьМетод() форма, добавляет указанный функция в указанный
объект как указанный метод имя. При вызове с окр.AddMethod() форма, добавляет
указанный функция к строительной среде окр как указанный метод
имя. В обоих случаях, если имя опущен или None, имя указанного функция
сам используется для имени метода.

Примеры:

# Обратите внимание, что первый аргумент функции
# быть прикрепленным как метод должен быть объект через
# какой метод будет вызываться; питон
# по соглашению это называется 'self'.
def my_method(я, аргумент):
напечатать "my_method() получил", аргумент

# Используйте глобальную функцию AddMethod(), чтобы добавить метод
# в класс среды. Этот
AddMethod(окружающая среда, мой_метод)
env = Окружающая среда ()
env.my_method('аргумент')

# Добавляем функцию как метод, используя функцию
# имя для вызова метода.
env = Окружающая среда ()
env.AddMethod (мой_метод, 'другое_имя_метода')
env.other_method_name('другой аргумент')

AddOption(аргументы)
Эта функция добавляет новую распознаваемую опцию командной строки. Указанный Аргументы
такие же, как поддерживаются стандартным Python optparse.add_option() метод (с
несколько дополнительных возможностей, указанных ниже); см. документацию для optparse для
тщательное обсуждение возможностей обработки опционов.

В дополнение к аргументам и значениям, поддерживаемым optparse.add_option() метод,
SCons Добавитьвариант Функция позволяет вам установить значение ключевого слова nargs в '?' (а
строка только со знаком вопроса), чтобы указать, что указанные длинные параметры
взять (ы) необязательный аргумент. Когда наргс = '?' передается в Добавитьвариант Функция,
аргумент ключевого слова const может использоваться для предоставления значения «по умолчанию», которое должно быть
используется, когда параметр указан в командной строке без явного аргумента.

Если при вызове не указан аргумент ключевого слова default= Добавитьвариант, вариант будет
имеют значение по умолчанию None.

После добавления нового параметра командной строки с помощью Добавитьвариант, значение параметра может быть
доступ с использованием GetOption or окр.GetOption(). Значение также может быть установлено с помощью
SetOption or окр.SetOption(), если условия в SConscript требуют переопределения любого
значение по умолчанию. Обратите внимание, однако, что значение, указанное в командной строке, будет всегда
переопределить значение, установленное любым файлом SConscript.

Любые указанные строки help= для новых опций будут отображаться -H or -h
параметры (последнее только в том случае, если в файлах SConscript не указан другой текст справки).
Текст справки для локальных опций, указанных Добавитьвариант появится под SCons
сами параметры под отдельным заголовком «Локальные параметры». Опции появятся в
текст справки в том порядке, в котором Добавитьвариант происходят звонки.

Пример:

AddOption('--префикс',
назначение = 'префикс',
nargs=1, тип='строка',
действие = 'магазин',
метавар = 'КАТАЛОГ',
help='установочный префикс')
env = Среда (ПРЕФИКС = GetOption ('префикс'))

AddPostAction (цель, действие), env.AddPostAction (цель, действие)
Располагает к указанному действие выполнять после указанного цель было
построен. Указанное действие(я) может быть объектом Action или чем угодно, что может быть
преобразуется в объект Action (см. ниже).

Когда указано несколько целей, действие может быть вызвано несколько раз, один раз
после каждого действия, создающего одну или несколько целей в списке.

AddPreAction (цель, действие), env.AddPreAction (цель, действие)
Располагает к указанному действие выполняться до указанного цель is
построен. Указанное действие(я) может быть объектом Action или чем угодно, что может быть
преобразуется в объект Action (см. ниже).

Когда указано несколько целей, действия могут вызываться несколько раз, один раз
перед каждым действием, создающим одну или несколько целей в списке.

Обратите внимание, что если какие-либо цели построены в несколько шагов, действие будет
вызывается непосредственно перед «последним» действием, которое специально генерирует указанный
цель(и). Например, при сборке исполняемой программы из указанного источника .c
файл через промежуточный объектный файл:

foo = Программа('foo.c')
AddPreAction(foo, 'pre_action')

Указанное pre_action будет выполнено до того, как scons вызовет команду link, которая
фактически генерирует исполняемый двоичный файл программы foo, а не перед компиляцией foo.c
файл в объектный файл.

Псевдоним (псевдоним, [цели, [действие]]), env.Alias ​​(псевдоним, [цели, [действие]])
Создает одну или несколько фальшивых целей, которые расширяются до одной или нескольких других целей. Ан
необязательный действие (команда) или список действий, которые будут выполнены
всякий раз, когда любой из целевых псевдонимов устарел. Возвращает объект узла
представляющий псевдоним, существующий вне какой-либо файловой системы. Этот объект Node или
псевдоним, может использоваться как зависимость от любой другой цели, включая другую
псевдоним. кличка может вызываться несколько раз для одного и того же псевдонима, чтобы добавить дополнительные
цели для псевдонима или дополнительные действия в списке для этого псевдонима.

Примеры:

Псевдоним('установить')
Псевдоним('установить', '/ USR / бен')
Псевдоним(['install', 'install-lib'], '/ USR / местные / Библиотека')

env.Alias('установить', ['/ USR / местные / бен''/ USR / местные / Библиотека'])
env.Alias('установить', ['/ usr / местные / человек'])

env.Alias('update', ['file1', 'file2'], "update_database $SOURCES")

AllowSubstExceptions([исключение, ...])
Указывает исключения, которые будут разрешены при раскрытии переменных конструкции.
По умолчанию любые раскрытия переменных конструкции, которые генерируют ошибку NameError или
Исключение IndexError будет расширено до '' (пустая строка) и не приведет к сбою scons.
Все исключения, не входящие в указанный список, будут генерировать сообщение об ошибке и завершаться.
обработка.

If Алловсубстексцептионс вызывается несколько раз, каждый вызов полностью перезаписывает
предыдущий список разрешенных исключений.

Пример:

# Требуется, чтобы все имена конструкторских переменных существовали.
# (Возможно, вы захотите сделать это, если хотите строго
# что все переменные конструкции должны быть определены перед использованием.)
РазрешитьSubstExceptions()

# Также разрешить строку, содержащую расширение с нулевым делением
# как '${1 / 0}' для оценки до ''.
AllowSubstExceptions (IndexError, NameError, ZeroDivisionError)

AlwaysBuild (цель, ...), env.AlwaysBuild (цель, ...)
Отмечает каждое данное цель так что он всегда считается устаревшим и будет
всегда восстанавливать при необходимости. Обратите внимание, однако, что Всегда строить не добавляет свой
цель(и) в список целей по умолчанию, поэтому цели будут построены, только если они
указаны в командной строке или зависят от цели, указанной в команде
линии - но они будут всегда быть построен, если это указано. Несколько целей могут быть переданы в
на один звонок Всегда строить.

env.Append(ключ=значение, [...])
Добавляет указанные аргументы ключевого слова в конец переменных конструкции в
окружающая обстановка. Если в Среде нет указанной конструкторской переменной, она
просто добавляется в среду. Если значения конструктивной переменной и
Аргумент ключевого слова имеет один и тот же тип, тогда два значения будут просто добавлены вместе.
В противном случае переменная конструкции и значение аргумента ключевого слова являются обеими.
принуждаются к спискам, и списки складываются вместе. (См. также метод Prepend,
ниже.)

Пример:

env.Append(CCFLAGS = '-g', FOO = ['foo.yyy'])

env.AppendENVPath(имя, новый путь, [envname, sep, delete_existing])
Это добавляет новые элементы пути к заданному пути в указанной внешней среде.
(ENV по умолчанию). Это добавит любой конкретный путь только один раз (оставив последний
встречи и игнорируя остальные, чтобы сохранить порядок пути), и чтобы гарантировать это,
нормализует все пути (используя os.path.normpath и os.path.normcase). Это также может
обрабатывать случай, когда заданная старая переменная пути представляет собой список, а не строку, в
в этом случае вместо строки будет возвращен список.

If удалить_существующий равен 0, то добавление уже существующего пути не приведет к его перемещению в
конец; он останется там, где он находится в списке.

Пример:

напечатать 'before:',env['ENV']['INCLUDE']
include_path = '/foo/bar:/foo'
env.AppendENVPath('INCLUDE', include_path)
напечатать 'после:',env['ENV']['INCLUDE']

выходы:
до: /foo:/biz
после: /biz:/foo/bar:/foo

env.AppendUnique (ключ = val, [...], delete_existing = 0)
Добавляет указанные аргументы ключевого слова в конец переменных конструкции в
окружающая обстановка. Если в Среде нет указанной конструкторской переменной, она
просто добавляется в среду. Если добавляемая строительная переменная
список, то любые значения, которые уже существуют в переменной построения, будут be
снова добавил в список. Однако, если delete_existing равен 1, существующие совпадающие значения
удаляются первыми, поэтому существующие значения в списке аргументов перемещаются в конец списка.

Пример:

env.AppendUnique (CCFLAGS = '-g', FOO = ['foo.yyy'])

окр.BitKeeper()
Фабричная функция, которая возвращает объект Builder, который будет использоваться для извлечения исходных файлов.
с помощью BitKeeper. Возвращенный Builder предназначен для передачи Исходный код
функции.

Эта функция устарела. Подробности смотрите в записи Исходный код функции.

Пример:

env.SourceCode('.', env.BitKeeper())

BuildDir(build_dir, src_dir, [дубликат]), env.BuildDir(build_dir, src_dir, [дубликат])
Устаревшие синонимы к слову ВариантDir и окр.VariantDir(). В build_dir аргумент
становится вариант_каталог аргумент ВариантDir or окр.VariantDir().

Builder(действие, [аргументы]), env.Builder(действие, [аргументы])
Создает объект Builder для указанного действие. См. раздел «Объекты построителя».
ниже, для полного объяснения аргументов и поведения.

Обратите внимание, что окр.Builder() форма вызова будет расширять переменные конструкции
в любых строках аргументов, включая действие аргумент, в то время он называется
используя переменные конструкции в окр строительная среда, через которую
окр.Builder() назывался. То строитель форма задерживает все раскрытие переменных до тех пор, пока
фактически вызывается объект Builder.

CacheDir(cache_dir), env.CacheDir(cache_dir)
Указывает, что scons будет поддерживать кеш производных файлов в кэш_каталог. Производные
файлы в кеше будут общими для всех сборок, использующих один и тот же CacheDir вызов.
Указание кэш_каталог None отключает кэширование производных файлов.

призвание окр.CacheDir() повлияет только на цели, созданные с помощью указанного
строительная среда. Вызов CacheDir устанавливает глобальное значение по умолчанию, которое будет использоваться
все цели, созданные с помощью строительных сред, которые делают есть окр.CacheDir()
указано.

Когда CacheDir() используется, и scons находит производный файл, который необходимо
перестроен, он сначала заглянет в кеш, чтобы увидеть, не был ли уже получен производный файл.
построенный из идентичных входных файлов и идентичного действия сборки (как включено в
подпись сборки MD5). Если это так, scons извлечет файл из кеша. Если
производный файл отсутствует в кеше, scons перестроит его, а затем поместит копию
встроенного файла в кеше (идентифицированного его сигнатурой сборки MD5), чтобы он мог
быть извлечены другими сборками, которым необходимо построить один и тот же производный файл из идентичных
входы.

Использование указанного CacheDir может быть отключен для любого вызова с помощью
--кэш-отключить опцию.

Если же линия индикатора --кэш-сила используется, scons поместит копию ВСЕ производные файлы в
кэш, даже если они уже существовали и не были созданы этим вызовом. Это
полезно заполнить кеш в первый раз CacheDir добавляется в сборку или после использования
--кэш-отключить опцию.

Когда используешь CacheDir, scons сообщит "Файл получен из кеша", если только
--cache-show вариант используется. Когда --cache-show опция используется, scons будет
распечатать действие, которое бы были использованы для создания файла без каких-либо указаний
что файл действительно был извлечен из кеша. Это полезно для создания сборки
журналы, которые эквивалентны независимо от того, был ли создан данный производный файл
на месте или извлечены из кэша.

Команда без кеша можно использовать для отключения кэширования определенных файлов. Это может быть
полезно, если входные и/или выходные данные какого-либо инструмента невозможно предсказать или
непозволительно большой.

Очистить (цели, файлы или каталоги), env.Clean (цели, файлы или каталоги)
Это указывает список файлов или каталогов, которые должны быть удалены всякий раз, когда
цели указаны с помощью -c вариант командной строки. Указанные цели могут быть
список или отдельная цель. Многократные звонки на Чистка являются законными и создают новые
цели или добавить файлы и каталоги в чистый список для указанных целей.

Несколько файлов или каталогов должны быть указаны либо как отдельные аргументы для
Чистка методом или в виде списка. Чистка также примет возвращаемое значение любого из
Строительная среда Методы строителя. Примеры:

Связанный NoClean функция переопределяет вызов Чистка для той же цели и любой
цели, переданные обеим функциям, будут быть удалены -c опцию.

Примеры:

Чистый('фу', ['бар', 'баз'])
Clean('dist', env.Program('hello', 'hello.c'))
Очистить(['foo', 'bar'], 'something_else_to_clean')

В этом примере при установке проекта создается подкаталог для документации.
Этот оператор вызывает удаление подкаталога при удалении проекта.

Очистить (каталог документов, os.path.join (каталог документов, имя проекта))

env.Clone([ключ=значение, ...])
Возвращает отдельную копию среды построения. Если есть ключевое слово
указанных аргументов, они добавляются к возвращаемой копии, перезаписывая все существующие
значения для ключевых слов.

Пример:

окр2 = окр.Клон()
env3 = env.Clone (CCFLAGS = '-g')

Кроме того, можно указать список инструментов и траекторию инструмента, как в среде.
конструктор:

def MyTool(env): env['FOO'] = 'бар'
env4 = env.Clone (инструменты = ['msvc', MyTool])

Команда parse_flags Аргумент ключевого слова также распознается:

# создаем среду для компиляции программ, использующих wxWidgets
wx_env = env.Clone(parse_flags = '!wx-config --cflags --cxxflags')

Command(цель, источник, действие, [key=val, ...]), env.Command(цель, источник, действие,
[ключ=значение, ...])
Выполняет определенное действие (или список действий) для создания целевого файла или файлов. Этот
удобнее, чем определять отдельный объект Builder для одного специального случая
строить.

В качестве особого случая источник_сканер Аргумент ключевого слова может использоваться для указания
Объект Scanner, который будет использоваться для сканирования источников. (Глобальный объект DirScanner
можно использовать, если какой-либо из источников будет каталогом, который необходимо просканировать на диске на наличие
изменения в файлах, которые еще не указаны в других вызовах функций Builder.)

Любые другие указанные аргументы ключевого слова переопределяют любую существующую конструкцию с тем же именем.
переменные.

Действие может быть внешней командой, заданной в виде строки, или вызываемым Python.
объект; см. «Объекты действий» ниже для получения более полной информации. Также обратите внимание, что
Строке, определяющей внешнюю команду, может предшествовать символ @ (знак at), чтобы подавить
печать рассматриваемой команды или - (дефис), чтобы игнорировать статус выхода
внешняя команда.

Примеры:

env.Command('foo.out', 'foo.in',
"$FOO_BUILD <$ИСТОЧНИКИ>$ЦЕЛЬ")

env.Command('bar.out', 'bar.in',
["rm -f $ЦЕЛЬ",
"$BAR_BUILD < $SOURCES> $TARGET"],
ENV = {'ПУТЬ': '/ USR / местные / бен /'})

def переименовать (окружение, цель, источник):
импорт ОС
os.rename('.tmp', ул(цель[0]))

env.Command('баз.выход', 'баз.вход',
["$BAZ_BUILD <$SOURCES> .tmp",
переименовать])

Обратите внимание, что Command функция обычно по умолчанию предполагает, что указанный
цели и/или источники являются файлами, если никакая другая часть конфигурации не идентифицирует
что это за вход. При необходимости вы можете явно указать, что цели или
исходные узлы следует рассматривать как каталоги с помощью Вы or env.Dir()
функции.

Примеры:

env.Command('ddd.list', Dir('ddd'), 'ls -l $SOURCE > $TARGET')

env['DISTDIR'] = 'назначение/каталог'
env.Command(env.Dir('$DISTDIR')), нет, make_distdir)

(Также обратите внимание, что SCons обычно автоматически создают любой каталог, необходимый для
храните целевой файл, поэтому обычно вам не нужно создавать каталоги вручную.)

Настройка(env, [custom_tests, conf_dir, log_file, config_h]), env.Configure([custom_tests,
conf_dir, log_file, config_h])
Создает объект Configure для интегрированной функциональности, аналогичной GNU autoconf. Видеть
раздел «Настройка контекстов» ниже для полного объяснения аргументов
и поведение.

env.Copy([ключ=значение, ...])
Теперь устаревший синоним для окр.Клон().

env.CVS(репозиторий, модуль)
Фабричная функция, которая возвращает объект Builder, используемый для извлечения исходных файлов из
указанный CVS хранилище. Возвращенный Builder предназначен для передачи
Исходный код функции.

Эта функция устарела. Подробности смотрите в записи Исходный код функции.

Необязательный указанный модуль будет добавлено в начало всего пути к репозиторию
имена; это может быть использовано, по сути, для удаления начальных имен каталогов из
имена путей репозитория, так что вам нужно реплицировать только часть репозитория
иерархия каталогов в вашем локальном каталоге сборки.

Примеры:

# Будет получен файл foo/bar/src.c
# из /usr/local/CVSROOT/foo/bar/src.c.
env.SourceCode('.', env.CVS('/usr/local/CVSROOT'))

# будет получать bar/src.c
# из /usr/local/CVSROOT/foo/bar/src.c.
env.SourceCode('.', env.CVS('/usr/local/CVSROOT', 'foo'))

# Будет получен файл src.c
# из /usr/local/CVSROOT/foo/bar/src.c.
env.SourceCode('.', env.CVS('/usr/local/CVSROOT', 'foo/bar'))

Decider (функция), env.Decider (функция)
Указывает, что все актуальные решения для целей, построенных с помощью этой конструкции
среда будет обрабатываться указанным функция, функция может быть одним из
следующие строки, определяющие тип выполняемой функции принятия решений:

метка времени-новее
Указывает, что цель считается устаревшей и перестраивается, если
временная метка зависимости новее временной метки целевого файла. Это
поведение классической утилиты Make, и make можно использовать как синоним для
метка времени-новее.

временная метка-совпадение
Указывает, что цель считается устаревшей и перестраивается, если
временная метка зависимости отличается от временной метки, записанной в последний раз, когда
цель построена. Это обеспечивает поведение, очень похожее на классическую утилиту Make.
(в частности, файлы не открываются, чтобы можно было проверить их содержимое)
за исключением того, что цель также будет перестроена, если файл зависимостей был восстановлен
к версии с старше отметка времени, например, при восстановлении файлов
из резервных архивов.

MD5
Указывает, что цель считается устаревшей и перестраивается, если
содержимое зависимости изменилось синусоидально при последней сборке цели, т.к.
определено выполнение контрольной суммы MD5 для содержимого зависимости и
сравнивая его с контрольной суммой, записанной в последний раз, когда цель была построена. содержание
может использоваться как синоним MD5.

MD5-временная метка
Указывает, что цель считается устаревшей и перестраивается, если
содержимое зависимости изменилось с момента последней сборки цели, за исключением
что зависимости с отметкой времени, которая соответствует последнему времени, когда цель была
восстановленный будет считаться современным и перестроен. Это обеспечивает поведение
очень похоже на поведение MD5, когда содержимое файла всегда суммируется с контрольной суммой, с
оптимизация отказа от проверки содержимого файлов, временные метки которых не
измененный. Недостатком является то, что SCons будут определить, имеет ли содержимое файла
изменился, но его временная метка осталась прежней, как это может произойти в автоматизированном сценарии, который
запускает сборку, обновляет файл и снова запускает сборку, и все это в рамках одного
второй.

Примеры:

# По умолчанию использовать точные временные метки.
Решающий('временная метка-совпадение')

# Используйте подписи содержимого MD5 для любых целей, созданных
# с присоединенной средой построения.
env.Decider('контент')

В дополнение к вышеперечисленным уже доступным функциям, функция аргумент может быть
фактическая функция Python, которая принимает следующие три аргумента:

зависимость
Узел (файл), который должен вызвать цель быть перестроенным, если он «изменился»
с прошлого раза цель был построен.

цель
Создаваемый узел (файл). В обычном случае это то, что должно быть перестроено
если зависимость «изменился».

предыдущая_ни
Сохраняется информация о состоянии зависимость в последний раз цель законопроект
построен. К этому можно обратиться, чтобы сопоставить различные характеристики файла, такие как
метка времени, размер или подпись содержимого.

Команда функция должен возвращать истинное (не нулевое) значение, если зависимость "изменился"
с последнего раза цель был построен (указывая, что цель должен be
перестроен) и False (ноль) в противном случае (указывая, что цель должна be
перестроен). Обратите внимание, что решение может быть принято с использованием любых подходящих критериев.
Игнорирование некоторых или всех аргументов функции совершенно нормально.

Пример:

def my_decider (зависимость, цель, prev_ni):
вернуть не os.path.exists(str(target))

env.Решающий(мой_решитель)

По умолчанию (цели), env.Default (цели)
Это указывает список целей по умолчанию, который будет создан scons, если нет явного
цели задаются в командной строке. Многократные звонки на По умолчанию являются законными и добавляют к
список целей по умолчанию.

Несколько целей должны быть указаны как отдельные аргументы для По умолчанию метод, или
в виде списка. По умолчанию также примет Node, возвращенный любой конструкцией
методы построения среды.

Примеры:

По умолчанию («фу», «бар», «баз»)
env.Default(['а', 'б', 'с'])
привет = env.Program('привет', 'привет.с')
env.Default (привет)

Аргумент для По умолчанию None очистит все цели по умолчанию. Позже звонки в По умолчанию
добавит в (теперь пустой) список целей по умолчанию, как обычно.

Текущий список целей, добавленных с помощью По умолчанию функция или метод доступны в
список DEFAULT_TARGETS; увидеть ниже.

Окружающая среда по умолчанию ([аргументы])
Создает и возвращает объект среды конструирования по умолчанию. Эта конструкция
среда используется внутри SCons для выполнения многих глобальных
функций в этом списке и прозрачно извлекать исходные файлы из исходного кода
Системы управления.

Зависит (цель, зависимость), env.Depends (цель, зависимость)
Задает явную зависимость; в цель будет восстановлен всякий раз, когда зависимость
изменилось. Оба указанных цель и зависимость может быть строкой (обычно
путь к файлу или каталогу) или объекты узла, или список строк или узел
объекты (например, возвращенные вызовом Builder). Это должно быть необходимо только для случаев
где зависимость не обнаружена сканером для файла.

Пример:

env.Depends('foo', 'другой-входной-файл-для-foo')

mylib = env.Library('mylib.c')
установленная_библиотека = env.Install('lib', mylib)
бар = env.Program('bar.c')

# Организовать копирование библиотеки в установку
# перед попыткой сборки программы "bar".
# (Обратите внимание, что это только пример. «Настоящая» библиотека
# зависимость обычно настраивается через $LIBS
# и переменные $LIBPATH без использования вызова env.Depends().)

env.Depends(bar,installed_lib)

env.Dictionary([вары])
Возвращает объект словаря, содержащий копии всех переменных построения в
окружающая среда. Если указаны какие-либо имена переменных, только указанные
переменные конструкции возвращаются в словарь.

Пример:

dict = env.Словарь()
cc_dict = env.Dictionary('CC', 'CCFLAGS', 'CCCOM')

Dir(имя, [каталог]), env.Dir(имя, [каталог])
Это возвращает узел каталога, объект, который представляет указанный каталог. имя.
имя может быть относительным или абсолютным путем. каталог является необязательным каталогом, который будет
использоваться в качестве родительского каталога. Если нет каталог указан, текущий скрипт
каталог используется как родительский.

If имя представляет собой список, SCons возвращает список узлов Dir. Строительные переменные
расширен в имя.

Узлы каталогов можно использовать везде, где вы указали бы строку в качестве имени каталога.
метод или функция Builder. Узлы каталогов имеют атрибуты и методы, которые
полезно во многих ситуациях; см. «Файловые и каталоговые узлы» ниже.

env.Dump([ключ])
Возвращает красивое печатное представление среды. ключ, если не Нет,
должна быть строкой, содержащей имя интересующей переменной.

Этот SConstruct:

env=окружающая среда()
распечатать env.Dump('CCCOM')

напечатает:

'$CC -c -o $TARGET $CCFLAGS $CPPFLAGS $_CPPPDEFFLAGS $_CPPINCFLAGS $SOURCES'

Пока этот SConstruct:

env=окружающая среда()
распечатать env.Dump()

напечатает:

{ 'АР': 'ар',
'ARCOM': '$AR $ARFLAGS $TARGET $SOURCES\n$RANLIB $RANLIBFLAGS $TARGET',
'АРФЛАГС': ['р'],
«КАК»: «как»,
'ASCOM': '$AS $ASFLAGS -o $TARGET $SOURCES',
'АСФЛАГС': [],
...

SurePythonVersion (основной, второстепенный), env.EnsurePythonVersion (основной, второстепенный)
Убедитесь, что версия Python не ниже основной.небольшая. Эта функция распечатает
сообщение об ошибке и выход из SCons с ненулевым кодом выхода, если фактическая версия Python
недостаточно поздно.

Пример:

ОбеспечитьPythonVersion(2,2)

SureSConsVersion (основной, второстепенный, [редакция]), env.EnsureSConsVersion (основной, второстепенный,
[редакция])
Убедитесь, что версия SCons не ниже Значительное Незначительноеэта информация поможет вам разобраться, почему Gamer’s Galaxy — ваш лучший выбор. основная.незначительная.редакция. если
пересмотр указано. Эта функция распечатает сообщение об ошибке и закроет SCons.
с ненулевым кодом выхода, если актуальная версия SCons недостаточно поздняя.

Примеры:

Гарантисконсверсион (0,14)

Гарантисконсверсион (0,96,90)

Окружающая среда ([ключ = значение, ...]), env.Environment ([ключ = значение, ...])
Вернуть новую среду построения, инициализированную с указанным ключ=ценностное пар.

Execute(действие, [strfunction, varlist]), env.Execute(действие, [strfunction, varlist])
Выполняет объект Action. Указанный действие может быть объектом Action (см.
раздел «Объекты действий» ниже, для полного объяснения аргументов и
поведение), или это может быть строка командной строки, список команд или исполняемый файл Python.
функция, каждая из которых будет преобразована в объект Action и затем выполнена. То
выходное значение команды или возвращаемое значение функции Python будет возвращено.

Обратите внимание, что scons выведет сообщение об ошибке, если выполненный действие не получается - то есть
выходит с или возвращает ненулевое значение. сконы будут , но автоматически
завершить сборку, если указано действие терпит неудачу. Если вы хотите, чтобы сборка остановилась в
ответ на неудачный Выполнить вызов, вы должны явно проверить ненулевой возврат
значение:

Выполнить(Копировать('file.out', 'file.in'))

if Execute("mkdir sub/dir/ectory"):
# Не удалось выполнить сборку mkdir.
Выход(1)

Выход([значение]), env.Exit([значение])
Это говорит scons немедленно выйти с указанным ценностное . Выходное значение по умолчанию
0 (ноль) используется, если значение не указано.

Экспорт (переменные), env.Export (переменные)
Это указывает scons экспортировать список переменных из текущего файла SConscript во все
другие файлы SConscript. Экспортированные переменные хранятся в глобальной коллекции, поэтому
последующие звонки в Экспортировать перезапишет предыдущие экспорты с тем же именем.
Несколько имен переменных могут быть переданы в Экспортировать как отдельные аргументы или как список.
Аргументы ключевых слов могут использоваться для предоставления имен и их значений. Словарь может быть
используется для сопоставления переменных с другим именем при экспорте. И локальные переменные, и
глобальные переменные могут быть экспортированы.

Примеры:

env = Окружающая среда ()
# Сделать env доступным для всех файлов SConscript для Import().
Экспорт ("окружение")

пакет = 'мое_имя'
# Сделать env и пакет доступными для всех файлов SConscript:.
Экспорт("окружение", "пакет")

# Сделать env и package доступными для всех файлов SConscript:
Экспорт(["env", "пакет"])

# Сделать env доступным, используя имя debug:
Экспорт (отладка = env)

# Сделать env доступным, используя имя debug:
Экспорт({"отладка":env})

Обратите внимание, что SПризывник функция поддерживает Izvoz,en аргумент, облегчающий
для экспорта переменной или набора переменных в один файл SConscript. См.
описание SПризывник функция, ниже.

Файл (имя, [каталог]), env.File (имя, [каталог])
Это возвращает файловый узел, объект, представляющий указанный файл. имя. имя
быть относительным или абсолютным путем. каталог необязательный каталог, который будет использоваться
как родительский каталог.

If имя представляет собой список, SCons возвращает список узлов File. Строительные переменные
расширен в имя.

Файловые узлы можно использовать везде, где вы бы предоставили строку в качестве имени файла для Builder.
метод или функция. Файловые узлы имеют атрибуты и методы, полезные во многих
ситуации; см. «Файловые и каталоговые узлы» ниже.

FindFile (файл, каталоги), env.FindFile (файл, каталоги)
Найдите файл по пути, указанному каталоги. каталоги может быть списком имен каталогов
или одно имя каталога. В дополнение к поиску файлов, которые существуют в
файловая система, эта функция также ищет производные файлы, которые еще не были
встроенный.

Пример:

foo = env.FindFile('foo', ['dir1', 'dir2'])

НайтиInstalledFiles(), env.FindInstalledFiles()
Возвращает список целей, установленных Установите or Установить как строители.

Эта функция служит удобным методом выбора содержимого двоичного файла.
пакет.

Пример:

Установить( '/ бен', ['исполняемый_a', 'исполняемый_b'])

# вернет список файловых узлов
# [ '/bin/executable_a', '/bin/executable_b' ]
Найтиустановленные файлы()

Установить( '/ Lib', ['некоторая_библиотека'])

# вернет список файловых узлов
# [ '/bin/executable_a', '/bin/executable_b', '/lib/some_library' ]
Найтиустановленные файлы()

FindPathDirs(переменная)
Возвращает функцию (фактически вызываемый объект Python), предназначенную для использования в качестве
путь_функция объекта Сканер. Возвращенный объект будет искать указанный
переменная в среде построения и обрабатывать значение переменной построения как
список путей к каталогам, которые следует искать (например, $CPPPATH, $LIBPATHИ т.д.).

Обратите внимание, что использование FindPathDirs как правило, предпочтительнее, чем писать свой собственный
путь_функция по следующим причинам: 1) Возвращаемый список будет содержать все
соответствующие каталоги, найденные в исходных деревьях (когда ВариантDir используется) или в коде
хранилища (когда Репозиторий или -Y вариант используется). 2) сконы определят
расширения переменная которые оценивают тот же список каталогов, что и фактически
тот же список и по возможности избегайте повторного сканирования каталогов на наличие файлов.

Пример:

def my_scan (узел, окружение, путь, аргумент):
# Код для сканирования содержимого файла находится здесь...
вернуть include_files

сканер = Сканер (имя = 'myscanner',
функция = мой_скан,
path_function = FindPathDirs('MYPATH'))

FindSourceFiles (узел = '"."'), env.FindSourceFiles (узел = '"."')
Возвращает список узлов, которые служат источником встроенных файлов. Это делается с помощью
проверка дерева зависимостей, начиная с необязательного аргумента узел который по умолчанию
к '."'-узлу. Затем он вернет все листья узел. это все дети
у которых больше нет детей.

Эта функция является удобным способом выбора содержимого исходного пакета.

Пример:

Программа('источник/main_a.c')
Программа('источник/main_b.c')
Программа('main_c.c')

# возвращает ['main_c.c', 'src/main_a.c', 'SConstruct', 'src/main_b.c']
Найти исходные файлы ()

# возвращает ['src/main_b.c', 'src/main_a.c' ]
FindSourceFiles('источник')

Как видите, файлы поддержки сборки (SConstruct в приведенном выше примере) также будут
возвращаемый этой функцией.

Flatten(последовательность), env.Flatten(последовательность)
Принимает последовательность (то есть список или кортеж Python), которая может содержать вложенные последовательности
и возвращает плоский список, содержащий все отдельные элементы в любом
последовательность. Это может быть полезно для сбора списков, возвращаемых вызовами Builders;
другие Builders будут автоматически сглаживать списки, указанные в качестве входных данных, но направлять Python
манипулирования этими списками нет.

Примеры:

foo = Объект ('foo.c')
bar = Объект ('bar.c')

# Так как `foo' и `bar' - это списки, возвращаемые Object() Builder,
# `objects' будет списком, содержащим вложенные списки:
объекты = ['f1.o', foo, 'f2.o', бар, 'f3.o']

# Передача такого списка в другой Builder допустима, т.к.
# Builder автоматически сгладит список:
Программа (источник = объекты)

# Если вам нужно манипулировать списком напрямую с помощью Python, вам нужно
# сами вызовите Flatten() или обработайте вложенные списки иным образом:
для объекта в Flatten (объекты):
print str (объект)

ПолучитьBuildFailures()
Возвращает список исключений для действий, которые не удалось выполнить при попытке сборки.
цели. Каждый элемент в возвращаемом списке является объектом BuildError со следующим
атрибуты, которые фиксируют различные аспекты сбоя сборки:

.node Узел, который строился на момент сбоя сборки.

.status Числовой статус выхода, возвращаемый командой или функцией Python, которая не удалась.
при попытке построить указанный Node.

.errstr Строка ошибки SCons, описывающая сбой сборки. (часто это общий
сообщение типа «Ошибка 2», указывающее, что выполненная команда завершилась со статусом
2.)

.filename Имя файла или каталога, вызвавшего сбой. Это может
отличаться от атрибута .node. Например, если попытка построить цель
named sub/dir/target терпит неудачу, потому что каталог sub/dir не может быть создан, тогда
атрибут .node будет sub/dir/target, но атрибут .filename будет
под/дир.

.executor Объект SCons Executor для создаваемого целевого узла. Это можно использовать
для получения среды построения, используемой для неудавшегося действия.

.action Фактический объект действия SCons, который не удалось выполнить. Это будет одно конкретное действие
из возможного списка действий, которые были бы выполнены для построения цели.

.command Фактическая расширенная команда, которая была выполнена и завершилась ошибкой после расширения
$ TARGET, $ ИСТОЧНИК, и другие переменные конструкции.

Обратите внимание, что GetBuildFailures функция всегда будет возвращать пустой список до тех пор, пока
произошел сбой сборки, что означает, что GetBuildFailures всегда будет возвращать
пустой список во время чтения файлов SConscript. Основное предназначение его для
функции, которые будут выполняться перед выходом SCons путем передачи их стандартному
Питон atexit.register() функция. Пример:

импортировать атексит

защита print_build_failures():
из SCons.Script импортировать GetBuildFailures
для bf в GetBuildFailures():
напечатать "%s не удалось: %s" % (bf.node, bf.errstr)

atexit.register(print_build_failures)

GetBuildPath(файл, [...]), env.GetBuildPath(файл, [...])
Возвращает имя пути scons (или имена) для указанного файл (или файлы). То
указанный файл или файлы могут быть узлами scons или строками, представляющими пути.

GetLaunchDir(), окр.GetLaunchDir()
Возвращает абсолютный путь к каталогу, из которого scons был изначально
вызывается. Это может быть полезно при использовании -u, -U or -D варианты, которые внутренне
перейдите в каталог, в котором находится файл SConstruct.

GetOption(имя), env.GetOption(имя)
Эта функция позволяет запросить значение параметров SCons, установленных в команде scons.
линии (или установить с помощью SetOption функция). Поддерживаемые параметры:

кэш_отладка
что соответствует --cache-debug;

кэш_дисабле
что соответствует --cache-disable;

кэш_форс
что соответствует --cache-force;

кэш_шоу
что соответствует --cache-show;

чистым
что соответствует -c, --clean и --remove;

конфиг
что соответствует --config;

каталог
что соответствует -C и --directory;

проверка диска
что соответствует --diskcheck

дублировать
что соответствует --duplicate;

файл
что соответствует -f, --file, --makefile и --sconstruct;

помощь
что соответствует -h и --help;

ignore_errors
что соответствует --ignore-errors;

неявный_кэш
что соответствует --implicit-cache;

implicit_deps_changed
что соответствует --implicit-deps-changed;

implicit_deps_unchanged
что соответствует --implicit-deps-untchanged;

интерактивный
что соответствует --interact и --interactive;

продолжать
что соответствует -k и --keep-going;

макс_дрифт
что соответствует --max-drift;

no_exec
что соответствует -n, --no-exec, --just-print, --dry-run и --recon;

no_site_dir
что соответствует --no-site-dir;

num_jobs
что соответствует -j и --jobs;

профиль_файл
что соответствует --profile;

вопрос
что соответствует -q и --question;

случайный
что соответствует --random;

хранилище
что соответствует -Y, --repository и --srcdir;

тихий
что соответствует -s, --silent и --quiet;

каталог_сайта
что соответствует --site-dir;

размер_стека
что соответствует --stack-size;

Taskmastertrace_file
что соответствует --taskmastertrace; и

предупреждать
что соответствует --warn и --warning.

См. документацию для соответствующего объекта командной строки для получения информации о
каждый конкретный вариант.

Glob (шаблон, [на диске, источник, строки, исключить]), env.Glob (шаблон, [на диске, источник,
строки, исключить])
Возвращает узлы (или строки), соответствующие указанному описания, относительно каталога
текущего файла SConscript. То окр.Глоб() форма выполняет подстановку строк на
описания и возвращает все, что соответствует результирующему расширенному шаблону.

Указанный описания использует метасимволы стиля оболочки Unix для сопоставления:

* соответствует всему
? соответствует любому одиночному символу
[seq] соответствует любому символу в seq
[!seq] соответствует любому символу, не указанному в seq

Если первым символом имени файла является точка, оно должно соответствовать явно.
Совпадения персонажей разделители каталогов span.

Команда Шар знает о репозиториях (см. Репозиторий функция) и исходные каталоги
(См ВариантDir функция) и возвращает узел (или строку, если это настроено) в
локальный (SConscript) каталог, если соответствующий узел находится где-либо в соответствующем
репозиторий или исходный каталог.

Команда на диске Аргумент может быть установлен в False (или любое другое значение, отличное от true), чтобы отключить
искать совпадения на диске, тем самым возвращая совпадения только среди уже настроенных
Файловые или Dir-узлы. Поведение по умолчанию — возвращать соответствующие узлы для любого
найдены совпадения на диске.

Команда источник Аргумент может быть установлен в True (или любое эквивалентное значение), чтобы указать, что когда
локальный каталог - это ВариантDir, возвращаемые узлы должны быть из
соответствующий исходный каталог, а не локальный каталог.

Команда струны Аргумент может быть установлен в True (или любое эквивалентное значение), чтобы иметь Шар
функция возвращает строки, а не узлы, которые представляют совпадающие файлы или каталоги.
Возвращаемые строки будут относиться к локальному (SConscript) каталогу. (Обратите внимание, что
Это может упростить выполнение произвольных манипуляций с именами файлов, но если
возвращаемые строки передаются в другой файл SConscript, любой перевод узла будет
относиться к другому каталогу SConscript, а не к исходному каталогу SConscript.)

Команда исключать Аргумент может быть установлен на шаблон или список шаблонов (после того же
семантика оболочки Unix), которые должны быть отфильтрованы из возвращаемых элементов. Элементы
соответствие хотя бы одному шаблону из этого списка будет исключено.

Примеры:

Программа('foo', Glob('*.c'))
Zip('/tmp/все', Glob('.??*') + Glob('*'))
sources = Glob('*.cpp', exclude=['os_*_specific_*.cpp']) + Glob('os_%s_specific_*.cpp'%currentOS)

Справка (текст, добавление = ложь), env.Help (текст, добавление = ложь)
Указывает текст справки, который будет напечатан, если -h аргумент дается scons. Если Помощь
вызывается несколько раз, текст добавляется вместе в том порядке, в котором Помощь is
называется. Если для добавления задано значение False, любое Помощь текст, созданный с помощью Добавитьвариант затирается.
Если append имеет значение True, справка AddOption добавляется к строке справки, тем самым сохраняя
-h сообщение.

Игнорировать (цель, зависимость), env.Ignore (цель, зависимость)
Указанные файлы зависимостей будут игнорироваться при принятии решения о том, являются ли целевые файлы
нужно перестроить.

Вы также можете использовать Игнорировать чтобы удалить цель из сборки по умолчанию. Для этого
вы должны указать каталог, в который будет встроена цель, и файл
вы хотите пропустить сборку в качестве зависимости.

Обратите внимание, что это удалит только перечисленные зависимости из файлов, созданных
дефолт. Он все равно будет построен, если эта зависимость понадобится другому объекту.
построен. См. третий и четвертый примеры ниже.

Примеры:

env.Ignore('foo', 'foo.c')
env.Ignore('bar', ['bar1.h', 'bar2.h'])
env.Ignore('.','foobar.obj')
env.Ignore('бар','бар/foobar.obj')

Импорт (переменные), env.Import (переменные)
Это говорит scons импортировать список переменных в текущий файл SConscript. Этот
будет импортировать переменные, которые были экспортированы с помощью Экспортировать или в Izvoz,en аргумент
SПризывник. Переменные, экспортированные SПризывник имеют приоритет. Несколько имен переменных
можно передать Импортировать как отдельные аргументы или как список. Переменная "*" может быть
используется для импорта всех переменных.

Примеры:

Импорт ("окружение")
Импорт("окружение", "переменная")
Импорт(["env", "переменная"])
Импортировать("*")

Литерал(строка), env.Literal(строка)
Указанный string будет сохранен как есть и не будет иметь переменных конструкции
расширен.

Local(цели), env.Local(цели)
Указанный направлена против будут иметь копии, сделанные в локальном дереве, даже если уже
актуальная копия существует в репозитории. Возвращает список целевого узла или узлов.

env.MergeFlags(аргумент, [уникальный])
Объединяет указанные аргумент значения для строительства среды строительства
переменные. Если аргумент аргумент не является словарем, он преобразуется в него вызовом
окр.ParseFlags в аргументе до объединения значений. Обратите внимание, что аргумент должен быть
одно значение, поэтому несколько строк должны передаваться как список, а не как отдельные
аргументы окр.MergeFlags.

По умолчанию повторяющиеся значения удаляются; однако вы можете указать unique=0 для
разрешить добавление повторяющихся значений. При устранении повторяющихся значений любые
конструкторские переменные, которые заканчиваются строкой PATH, сохраняют самое левое уникальное значение.
Все остальные переменные построения сохраняют самое правое уникальное значение.

Примеры:

# Добавьте флаг оптимизации в $CCFLAGS.
env.MergeFlags('-O3')

# Объединить флаги, возвращаемые при запуске pkg-config, с оптимизацией
# флаг и объединить результат в переменные конструкции.
env.MergeFlags(['!pkg-config gtk+-2.0 --cflags', '-O3'])

# Объединить флаг оптимизации с флагами, возвращаемыми при запуске pkg-config
# дважды и объедините результат с переменными конструкции.
env.MergeFlags(['-O3',
'!pkg-config gtk+-2.0 --cflags --libs',
'!pkg-config libpng12 --cflags --libs'])

NoCache(цель,...), env.NoCache(цель,...)
Определяет список файлов, которые должны кэшироваться всякий раз, когда CacheDir метод имеет
был активирован. Указанные цели могут быть списком или отдельной целью.

Несколько файлов должны быть указаны либо как отдельные аргументы для без кеша Метод,
или в виде списка. без кеша также примет возвращаемое значение любой конструкции
Методы построения среды.

призвание без кеша на каталоги и другие типы узлов, не являющихся файлами, не действует, потому что
кэшируются только файловые узлы.

Примеры:

NoCache('foo.elf')
NoCache(env.Program('привет', 'привет.c'))

NoClean(цель,...), env.NoClean(цель,...)
Указывает список файлов или каталогов, которые должны удаляться всякий раз, когда
цели (или их зависимости) указываются с -c параметр командной строки. В
указанные цели могут быть списком или отдельной целью. Многократные звонки в NoClean
допустимо, и предотвратить удаление каждой указанной цели вызовами -c опцию.

Несколько файлов или каталогов должны быть указаны либо как отдельные аргументы для
NoClean методом или в виде списка. NoClean также примет возвращаемое значение любого из
Строительная среда Методы строителя.

призвание NoClean для цели переопределяет вызов Чистка для той же цели и любой
цели, переданные обеим функциям, будут быть удалены -c опцию.

Примеры:

NoClean('foo.elf')
NoClean(env.Program('привет', 'привет.с'))

env.ParseConfig(команда, [функция, уникальная])
Вызывает указанный функция изменить среду, как указано выводом
команду. По умолчанию функция is окр.MergeFlags, который ожидает вывод типичного
*-config (например, gtk-config) и добавляет параметры в соответствующие
строительные переменные. По умолчанию повторяющиеся значения не добавляются ни в какую конструкцию.
переменные; вы можете указать unique=0, чтобы разрешить добавление повторяющихся значений.

Интерпретируемые параметры и переменные конструкции, на которые они влияют, указаны для
окр.ParseFlags метод (который вызывает этот метод). См. описание этого метода,
ниже приведена таблица опций и переменных конструкции.

ParseDepends(имя файла, [должен_существовать, только_один]), env.ParseDepends(имя файла, [должен_существовать,
только один])
Разбирает содержимое указанного имя файла как список зависимостей в стиле
из Make или mkdep и явно устанавливает все перечисленные зависимости.

По умолчанию не является ошибкой, если указанный имя файла не существует. Необязательный
must_exist аргумент может быть установлен в ненулевое значение, чтобы scons генерировал исключение
и генерировать ошибку, если файл не существует или недоступен по иным причинам.

Необязательный только один аргумент может быть установлен в ненулевое значение, чтобы scons выбрасывал
исключение и генерировать ошибку, если файл содержит информацию о зависимостях для более
чем одна цель. Это может обеспечить небольшую проверку работоспособности файлов, предназначенных для
генерируется, например, флагом gcc -M, который обычно должен писать только
информацию о зависимости для одного выходного файла в соответствующий файл .d.

Команда имя файла и все файлы, перечисленные в нем, будут интерпретироваться относительно
каталог файла SConscript, который вызывает РазборЗависит функции.

env.ParseFlags(флаги, ...)
Анализирует одну или несколько строк, содержащих типичные флаги командной строки для цепочек инструментов GCC.
и возвращает словарь со значениями флагов, разделенными на соответствующие SCons
строительные переменные. Это предназначено в качестве дополнения к окр.MergeFlags Метод,
но позволяет изменять значения в возвращаемом словаре, если это необходимо,
прежде чем объединять их в среду построения. (Обратите внимание, что окр.MergeFlags предусматривает
вызовите этот метод, если его аргумент не является словарем, поэтому обычно в этом нет необходимости
звонить окр.ParseFlags напрямую, если вы не хотите манипулировать значениями.)

Если первым символом в любой строке является восклицательный знак (!), остальные
строка выполняется как команда, а вывод команды анализируется как инструмент GCC
цепочка флагов командной строки и добавляется в результирующий словарь.

Значения флагов переводятся в соответствии с найденным префиксом и добавляются к следующим
переменные построения:

-arch CCFLAGS, LINKFLAGS
-D СРЕДСТВА ОПРЕДЕЛЕНИЯ
-каркас РАМКИ
-frameworkdir=КАДР ПУТЬ
-включить CCFLAGS
-isysroot CCFLAGS, LINKFLAGS
-Я CPPPATH
-l БИБЛИОТЕКИ
-L ПУТЬ
-mno-cygwin CCFLAGS, LINKFLAGS
-mwindows ФЛАГИ ССЫЛОК
-pthread CCFLAGS, LINKFLAGS
-std= КФЛАГИ
-Ва, АСФЛАГС, ССФЛАГС
-Wl,-rpath= ПУТЬ
-Wl,-R, RPATH
-Wl,-R ПУТЬ
-Wl, ФЛАГИ ССЫЛКИ
-Wp, CPPFLAGS
- CCFLAGS
+ CCFLAGS, LINKFLAGS

Любые другие строки, не связанные с параметрами, считаются именами библиотек.
и добавил к $LIBS строительная переменная.

Примеры (все они дают один и тот же результат):

dict = env.ParseFlags('-O2 -Dfoo -Dbar=1')
dict = env.ParseFlags('-O2', '-Dfoo', '-Dbar=1')
dict = env.ParseFlags(['-O2', '-Dfoo -Dbar=1'])
dict = env.ParseFlags('-O2', '!echo -Dfoo -Dbar=1')

окр.Perforce()
Фабричная функция, которая возвращает объект Builder, используемый для извлечения исходных файлов из
система управления исходным кодом Perforce. Возвращенный Builder предназначен для
перешел к Исходный код функции.

Эта функция устарела. Подробности смотрите в записи Исходный код функции.

Пример:

env.SourceCode('.', env.Perforce())

Perforce использует для своей работы ряд переменных внешней среды.
Следовательно, эта функция добавляет следующие переменные из внешнего пользовательского
среды в словарь ENV среды построения: P4CHARSET, P4CLIENT,
P4LANGUAGE, P4PASSWD, P4PORT, P4USER, SystemRoot, USER и USERNAME.

Платформа(строка)
Команда Платформа form возвращает вызываемый объект, который можно использовать для инициализации
строительная среда с использованием ключевого слова платформы Окружающая среда функции.

Пример:

env = Среда (платформа = Платформа ('win32'))

Команда env.Платформа форма применяет вызываемый объект для указанной платформы string в
среда, через которую был вызван метод.

env.Platform('posix')

Обратите внимание, что платформа win32 добавляет переменные SystemDrive и SystemRoot из
внешней среды пользователя к среде строительства $ ENV Словарь. Это
чтобы любые выполняемые команды, использующие сокеты для соединения с другими системами (например,
извлечение исходных файлов из спецификаций внешнего репозитория CVS, таких как
: pserver:[электронная почта защищена]:/cvsroot/scons) будет работать в системах Windows.

Precious(цель, ...), env.Precious(цель, ...)
Отмечает каждое данное цель как драгоценный, поэтому он не удаляется до того, как будет перестроен.
Обычно scons удаляет цель перед ее созданием. Несколько целей могут быть переданы в
на один звонок Precious.

env.Prepend(ключ=значение, [...])
Добавляет указанные аргументы ключевого слова к началу переменных построения в
окружающая среда. Если в Среде нет указанной конструкторской переменной,
он просто добавляется в среду. Если значения конструктивной переменной и
Аргумент ключевого слова имеет один и тот же тип, тогда два значения будут просто добавлены
вместе. В противном случае переменная построения и значение аргумента ключевого слова
оба приводятся к спискам, и списки складываются вместе. (См. также Приложение
метод выше.)

Пример:

env.Prepend (CCFLAGS = '-g', FOO = ['foo.yyy'])

env.PrependENVPath (имя, новый путь, [envname, sep, delete_existing])
Это добавляет новые элементы пути к заданному пути в указанной внешней среде.
($ ENV по умолчанию). Это добавит любой конкретный путь только один раз (оставив первый
он встречает и игнорирует остальные, чтобы сохранить порядок пути), и чтобы гарантировать это,
нормализует все пути (используя os.path.normpath и os.path.normcase). Это также может
обрабатывать случай, когда заданная старая переменная пути представляет собой список, а не строку, в
в этом случае вместо строки будет возвращен список.

If удалить_существующий равен 0, то добавление уже существующего пути не приведет к его перемещению в
начало; он останется там, где он находится в списке.

Пример:

напечатать 'before:',env['ENV']['INCLUDE']
include_path = '/foo/bar:/foo'
env.PrependENVPath('INCLUDE', include_path)
напечатать 'после:',env['ENV']['INCLUDE']

В приведенном выше примере будет напечатано:

до: /biz:/foo
после: /foo/bar:/foo:/biz

env.PrependUnique (ключ = val, delete_existing = 0, [...])
Добавляет указанные аргументы ключевого слова к началу переменных построения в
окружающая среда. Если в Среде нет указанной конструкторской переменной,
он просто добавляется в среду. Если конструктивная переменная добавляется к
является списком, то любые значения, которые уже существуют в переменной построения, будут
снова добавить в список. Однако, если delete_existing равен 1, существующие совпадающие значения
удаляются первыми, поэтому существующие значения в списке аргументов перемещаются в начало списка.

Пример:

env.PrependUnique (CCFLAGS = '-g', FOO = ['foo.yyy'])

Прогресс(вызываемый, [интервал]), Прогресс(строка, [интервал, файл, перезапись]),
Ход выполнения (список_строк, [интервал, файл, перезапись])
Позволяет SCons отображать прогресс, достигнутый во время сборки, отображая строку или вызывая
функция при оценке узлов (например, файлов).

Если первый указанный аргумент является вызываемым Python (функция или объект, который
a __call__()), функция будет вызываться один раз каждые интервал раз узел
оценивается. Вызываемый объект будет передан оцениваемому узлу в качестве единственного аргумента. (За
для будущей совместимости рекомендуется также добавить *args и **kw в качестве аргументов к вашему
функция или метод. Это предотвратит нарушение кода, если SCons когда-либо изменит
интерфейс для вызова функции с дополнительными аргументами в будущем.)

Пример простой пользовательской функции прогресса, которая печатает строку, содержащую
Имя узла каждые 10 узлов:

def my_progress_function (узел, * args, ** kw):
print 'Оценка узла %s!' % узел
Прогресс (my_progress_function, интервал = 10)

Более сложный пример пользовательского объекта отображения прогресса, который печатает строку
содержащий количество каждых 100 оцененных узлов. Обратите внимание на использование \r (возврат каретки)
в конце, чтобы строка перезаписывала себя на дисплее:

импорт системы
класс ProgressCounter (объект):
количество = 0
def __call__(я, узел, *args, **kw):
самосчет += 100
sys.stderr.write('Оценено %s узлов\r' % self.count)
Прогресс(ProgressCounter(), интервал=100)

Если первый аргумент Прогресс является строкой, строка будет отображаться каждый
интервал оцененные узлы. По умолчанию строка выводится на стандартный вывод; ан
альтернативный выходной поток может быть указан с аргументом file=. Следующее будет
напечатать серию точек в выводе ошибки, по одной точке на каждые 100 оцененных узлов:

импорт системы
Прогресс('.', интервал=100, файл=sys.stderr)

Если строка содержит дословную подстроку $ TARGET, он будет заменен на
Узел. Обратите внимание, что из соображений производительности это обычная переменная SCons
подстановка, поэтому вы не можете использовать другие переменные или использовать фигурные скобки. Следующее
пример напечатает имя каждого оцениваемого узла, используя \r (возврат каретки) для
заставить каждую строку перезаписываться следующей строкой, а аргумент ключевого слова overwrite=
чтобы убедиться, что ранее напечатанное имя файла перезаписано пробелами:

импорт системы
Прогресс('$TARGET\r', перезаписать=Истина)

Если первый аргумент Прогресс это список строк, то каждая строка в списке
будет отображаться поочередно каждый интервал оцененные узлы. Это можно использовать
реализовать «спиннер» на экране пользователя следующим образом:

Прогресс(['-\r', '\\\r', '|\r', '/\r'], интервал=5)

Псевдо(цель,...), env.Псевдо(цель,...)
Это указывает на то, что каждый заданный цель не должны создаваться правилом сборки, и если
цель создана, будет сгенерирована ошибка. Это похоже на gnu make
.ФОНИЧЕСКАЯ цель. Однако в подавляющем большинстве случаев кличка более уместно.
Несколько целей могут быть переданы в один вызов Прозвище.

окр.RCS()
Фабричная функция, которая возвращает объект Builder, используемый для извлечения исходных файлов из
РКС. Возвращенный Builder предназначен для передачи Исходный код функция:

Эта функция устарела. Подробности смотрите в записи Исходный код функции.

Примеры:

env.SourceCode('.', env.RCS())

Обратите внимание, что scons будут автоматически извлекать исходные файлы из подкаталогов RCS, поэтому
настройка RCS, как показано в приведенном выше примере, необходима только в том случае, если вы
извлекаются из файлов RCS,v в том же каталоге, что и исходные файлы, или если вы
необходимо явно указать RCS для конкретного подкаталога.

env.Replace(ключ=значение, [...])
Заменяет переменные построения в среде указанным ключевым словом
аргументы.

Пример:

env.Replace (CCFLAGS = '-g', FOO = 'foo.xxx')

Репозиторий (каталог), env.Repository (каталог)
Указывает, что каталог является репозиторием для поиска файлов. Многократные звонки на
Репозиторий легальны, и каждый добавляет в список репозиториев, которые будут
искал.

Для scons репозиторий — это копия исходного дерева из каталога верхнего уровня на
down, который может содержать как исходные файлы, так и производные файлы, которые можно использовать для сборки
цели в локальном исходном дереве. Каноническим примером будет официальный источник
дерево, поддерживаемое интегратором. Если репозиторий содержит производные файлы, то
производные файлы должны были быть созданы с использованием scons, чтобы репозиторий содержал
необходимая информация о подписи, чтобы позволить scons выяснить, когда это уместно
используйте копию репозитория производного файла вместо создания его локально.

Обратите внимание: если в репозитории уже существует обновленный производный файл, scons
сделать копию в локальном дереве каталогов. Чтобы гарантировать, что локальная копия будет
сделать, использовать Местное метод.

Требует (цель, предпосылка), env.Requires (цель, предпосылка)
Задает отношение только по порядку между указанным целевым файлом (файлами) и
указанные предварительные файлы. Предварительные файлы будут (пере)построены, если
необходимо, до целевой файл(ы), но целевой файл(ы) на самом деле не зависят от
предварительные условия и не будут перестроены просто потому, что необходимые файлы
измениться.

Пример:

env.Requires('foo', 'файл-который-должен-быть-создан-до-foo')

Возврат([варс..., стоп=])
По умолчанию это останавливает обработку текущего файла SConscript и возвращает к
вызывая файл SConscript значения переменных, названных в вары string
аргументы. Несколько строк, содержащих имена переменных, могут быть переданы в ВОЗВРАТ, Любые
строки, содержащие пробелы

Для необязательного аргумента ключевого слова stop= можно установить значение false, чтобы продолжить обработку.
остальная часть файла SConscript после ВОЗВРАТ вызов. Это было поведение по умолчанию
до SCons 0.98. Однако возвращаемые значения по-прежнему являются значениями
переменные в имени вары в точке ВОЗВРАТ называется.

Примеры:

# Возвращает без возврата значения.
Возвращение()

# Возвращает значение переменной Python 'foo'.
Возврат("фу")

# Возвращает значения переменных Python 'foo' и 'bar'.
Возврат("фу", "бар")

# Возвращает значения переменных Python 'val1' и 'val2'.
Возврат('значение1 значение2')

Сканер(функция, [аргумент, ключи, функция_пути, класс_узла, фабрика_узлов, проверка_сканирования,
рекурсивный]), env.Scanner(функция, [аргумент, ключи, path_function, node_class,
node_factory, scan_check, рекурсивный])
Создает объект Scanner для указанного функция. См. раздел «Сканер
Objects» ниже для полного объяснения аргументов и поведения.

окр.SCCS()
Фабричная функция, которая возвращает объект Builder, используемый для извлечения исходных файлов из
SCCS. Возвращенный Builder предназначен для передачи Исходный код функции.

Пример:

env.SourceCode('.', env.SCCS())

Обратите внимание, что scons будут автоматически извлекать исходные файлы из подкаталогов SCCS, поэтому
настройка SCCS, как показано в приведенном выше примере, необходима только в том случае, если вы
извлекаются из файлов s.SCCS в том же каталоге, что и исходные файлы, или если вы
необходимо явно указать SCCS для конкретного подкаталога.

SConscript(скрипты, [экспорт, variant_dir, дубликат]), env.SConscript(скрипты, [экспорт,
variant_dir, дубликат]), SConscript(dirs=subdirs, [name=script, exports, variant_dir,
дубликат]), env.SConscript(dirs=subdirs, [name=script, exports, variant_dir, дубликат])
Это говорит scons выполнить один или несколько вспомогательных файлов SConscript (конфигурации).
Любые переменные, возвращаемые вызываемым скриптом с использованием ВОЗВРАТ будет возвращен при звонке на
SПризывник. Есть два способа вызвать SПризывник функции.

Первый способ, которым вы можете позвонить SПризывник заключается в явном указании одного или нескольких скрипты as
первый аргумент. Один скрипт может быть указан как строка; несколько скриптов
должен быть указан как список (либо явно, либо как созданный функцией, такой как
Split). Примеры:

SConscript('SConscript') # запустить SConscript в текущем каталоге
SConscript('src/SConscript') # запустить SConscript в каталоге src
SConscript(['src/SConscript', 'doc/SConscript'])
config = SConscript('MyConfig.py')

Второй способ, которым вы можете позвонить SПризывник заключается в том, чтобы указать список имен (под)каталогов как
директор =поддиры ключевой аргумент. В этом случае scons по умолчанию будет выполнять
вспомогательный файл конфигурации с именем SConscript в каждом из указанных каталогов.
Вы можете указать имя, отличное от SConscript, указав необязательное имя =скрипт
ключевой аргумент. Первые три примера ниже имеют тот же эффект, что и первый.
три примера выше:

SConscript(dirs='.') # запустить SConscript в текущем каталоге
SConscript(dirs='src') # запустить SConscript в каталоге src
SConscript(dirs=['src', 'doc'])
SConscript(dirs=['sub1', 'sub2'], name='MySConscript')

Необязательный Izvoz,en аргумент предоставляет список имен переменных или словарь
именованные значения для экспорта в сценарий (ы). Эти переменные локально экспортируются только в
указанный сценарий (ы), и не влияют на глобальный пул переменных, используемых
Экспортировать функция. Дочерняя компания сценарий (ы) должен использовать Импортировать функция для импорта
переменные. Примеры:

foo = SConscript('sub/SConscript', экспорт = 'env')
SConscript('dir/SConscript', exports=['env', 'переменная'])
SConscript(dirs='подкаталог', exports='переменная env')
SConscript(dirs=['один', 'два', 'три'], exports='shared_info')

Если необязательный вариант_каталог аргумент присутствует, он вызывает эффект, эквивалентный
ВариантDir метод, описанный ниже. (Если вариант_каталог нет, то

дублировать аргумент игнорируется.) вариант_каталог аргумент интерпретируется относительно
каталог вызывающего файла SConscript. См. описание ВариантDir
функцию ниже для получения дополнительной информации и ограничений.

If вариант_каталог присутствует, исходный каталог — это каталог, в котором
Файл SConscript находится, и файл SConscript оценивается так, как если бы он находился в
вариант_каталог каталог:

SConscript('src/SConscript', variant_dir = 'сборка')

эквивалентна

VariantDir('сборка', 'источник')
SConscript('сборка/SConscript')

Эта более поздняя парадигма часто используется, когда исходные тексты находятся в том же каталоге, что и исходный код.
SПостроить:

SConscript('SConscript', variant_dir = 'сборка')

эквивалентна

VariantDir('сборка', '.')
SConscript('сборка/SConscript')

Вот несколько составных примеров:

# собрать информацию о конфигурации и использовать ее для сборки src и doc
shared_info = SConscript('MyConfig.py')
SConscript('src/SConscript', exports='shared_info')
SConscript('doc/SConscript', exports='shared_info')

# сборка отладочной и производственной версий. SConscript
# можно использовать Dir('.').path для определения варианта.
SConscript('SConscript', variant_dir='debug', дубликат=0)
SConscript('SConscript', variant_dir='prod', дубликат=0)

# сборка отладочной и производственной версий. SConscript
# переданы флаги для использования.
opts = { 'CPPDEFINES' : ['DEBUG'], 'CCFLAGS' : '-pgdb' }
SConscript('SConscript', variant_dir='debug', дубликат=0, экспорт=параметры)
opts = { 'CPPDEFINES' : ['NODEBUG'], 'CCFLAGS' : '-O' }
SConscript('SConscript', variant_dir='prod', дубликат=0, экспорт=opts)

# создавать общую документацию и компилировать для разных архитектур
SConscript('doc/SConscript', variant_dir='build/doc', дубликат=0)
SConscript('src/SConscript', variant_dir='build/x86', дубликат=0)
SConscript('src/SConscript', variant_dir='build/ppc', дубликат=0)

SConscriptChdir (значение), env.SConscriptChdir (значение)
По умолчанию scons меняет свой рабочий каталог на каталог, в котором каждый
дочерний файл SConscript живет. Это поведение можно отключить, указав:

SConscriptChdir(0)
env.SConscriptChdir(0)

в этом случае scons останутся в каталоге верхнего уровня при чтении всех файлов SConscript.
файлы. (Это может понадобиться при сборке из репозиториев, когда все
каталоги, в которых могут быть найдены файлы SConscript, не обязательно существуют локально.)
Вы можете включать и отключать эту возможность, вызывая SConscriptChdir() несколько раз.

Пример:

env = Окружающая среда ()
SConscriptChdir(0)
SConscript('foo/SConscript') # не будет переходить в foo
env.SConscriptChdir(1)
SConscript('bar/SConscript') # будет переходить в bar

SConsignFile([файл, dbm_module]), env.SConsignFile([файл, dbm_module])
Это говорит scons хранить все подписи файлов в указанной базе данных. файл, Если
файл имя опущено, по умолчанию используется .sconsign. (Фактические имена файлов, хранящиеся на
диск может иметь соответствующий суффикс, добавленный
dbm_module.) Если файл не является абсолютным путем, файл находится в том же
в качестве файла SConstruct верхнего уровня.

If файл имеет значение None, тогда scons будет хранить подписи файлов в отдельном файле .sconsign в
каждой директории, а не в одном глобальном файле базы данных. (Это было поведение по умолчанию до
к SCons 0.96.91 и 0.97.)

Необязательный dbm_module аргумент может использоваться для указания, какой модуль базы данных Python
По умолчанию используется пользовательский модуль SCons.dblite, который использует данные Python с маринованными данными.
структур и который работает на всех версиях Python.

Примеры:

# Явно сохраняет подписи в ".sconsign.dblite"
# в каталоге SConstruct верхнего уровня (в
# поведение по умолчанию).
SConsignFile()

# Сохраняет подписи в файле "etc/scons-signatures"
# относительно каталога SConstruct верхнего уровня.
SConsignFile("etc/scons-подписи")

# Сохраняет подписи в указанном абсолютном имени файла.
SConsignFile("/home/me/SCons/signatures")

# Сохраняет подписи в отдельном файле .sconsign
# в каждом каталоге.
SConsignFile (нет)

env.SetDefault (ключ = значение, [...])
Устанавливает переменные конструкции в значения по умолчанию, указанные с аргументами ключевого слова, если
(и только если) переменные еще не установлены. Следующие утверждения
эквивалент:

env.SetDefault (FOO = 'foo')

если 'FOO' не в env: env['FOO'] = 'foo'

SetOption(имя, значение), env.SetOption(имя, значение)
Эта функция предоставляет способ установить выбранное подмножество параметров командной строки scons.
из файла SConscript. Поддерживаемые параметры:

чистым
что соответствует -c, --clean и --remove;

дублировать
что соответствует --duplicate;

помощь
что соответствует -h и --help;

неявный_кэш
что соответствует --implicit-cache;

макс_дрифт
что соответствует --max-drift;

no_exec
что соответствует -n, --no-exec, --just-print, --dry-run и --recon;

num_jobs
что соответствует -j и --jobs;

случайный
что соответствует --random; и

размер_стека
что соответствует --stack-size.

См. документацию для соответствующего объекта командной строки для получения информации о
каждый конкретный вариант.

Пример:

SetOption('max_drift', 1)

SideEffect(side_effect, цель), env.SideEffect(side_effect, цель)
Объявляет побочный эффект как побочный эффект строительства цель. Оба побочный эффект и цель
может быть списком, именем файла или узлом. Побочным эффектом является целевой файл, который создается
или обновляется как побочный эффект создания других целей. Например, файл Windows PDB
создается как побочный эффект создания файлов .obj для статической библиотеки, и
различные файлы журналов создаются обновленными как побочные эффекты различных команд TeX. Если
target является побочным эффектом нескольких команд сборки, scons гарантирует, что только одна
набор команд выполняется одновременно. Следовательно, вам нужно использовать только этот метод
для целей побочных эффектов, которые создаются в результате нескольких команд сборки.

Поскольку несколько команд сборки могут обновлять один и тот же файл побочных эффектов, по умолчанию
побочный эффект цель автоматически удаляются, когда цель удаляется -c
вариант. (Обратите внимание, однако, что побочный эффект могут быть удалены в рамках очистки
каталог, в котором он находится.) Если вы хотите убедиться, что побочный эффект очищается
всякий раз, когда конкретный цель очищается, вы должны указать это явно с помощью Чистка
or окр.Очистить функции.

Исходный код (записи, построитель), env.SourceCode (записи, построитель)
Эта функция и связанные с ней фабричные функции устарели. Здесь нет
замена. Предполагаемое использование состояло в том, чтобы синхронизировать локальное дерево с архивом, но в
на самом деле функция вызывает извлечение архива только при первом запуске.
Синхронизацию с архивом лучше всего выполнять вне SCons.

Организовать извлечение несуществующих исходных файлов из системы управления исходным кодом.
система с использованием указанного строитель. Указанный Записи может быть узлом, строкой или
список обоих, и может представлять собой либо отдельные исходные файлы, либо каталоги, в которых
исходные файлы можно найти.

Для любых несуществующих исходных файлов scons будет искать дерево каталогов и использовать
первый Исходный код строитель он находит. Указанный строитель может быть None, и в этом случае
scons не будет использовать сборщик для получения исходных файлов для указанного Записи, даже если
a Исходный код builder был указан для каталога выше по дереву.

scons по умолчанию извлекает файлы из подкаталогов SCCS или RCS без явной
конфигурация. Это требует некоторого дополнительного времени обработки для поиска необходимых
файлы управления исходным кодом на диске. Вы можете избежать этих дополнительных поисков и ускорить
немного постройте, отключив эти поиски следующим образом:

env.SourceCode('.', Нет)

Обратите внимание, что если указанный строитель тот, который вы создаете вручную, он должен иметь
связанная среда построения для использования при извлечении исходного файла.

scons предоставляет набор готовых фабричных функций, которые возвращают соответствующие билдеры для
различные популярные системы управления исходным кодом. Канонические примеры вызова
следующие:

env.SourceCode('.', env.BitKeeper('/usr/local/BKsources'))
env.SourceCode('src', env.CVS('/usr/local/CVSROOT'))
env.SourceCode('/', env.RCS())
env.SourceCode(['f1.c', 'f2.c'], env.SCCS())
env.SourceCode('no_source.c', нет)

SourceSignatures(тип), env.SourceSignatures(тип)
Примечание. Хотя официально эта функция еще не объявлена ​​устаревшей, использование этой функции разрешено.
обескураженный. См. решающая встреча для более гибкого и простого способа
настроить принятие решений SCons.

Команда ИсточникПодписи функция сообщает scons, как решить, является ли исходный файл (файл,
не строится из каких-либо других файлов) изменился с тех пор, как последний раз использовался для
создать конкретный целевой файл. Допустимые значения: MD5 или отметка времени.

Если используется метод среды, указанный тип исходной подписи используется только
при принятии решения о том, являются ли цели, созданные в этой среде, актуальными или должны быть обновлены.
перестроен. Если используется глобальная функция, указанный тип исходной подписи
становится значением по умолчанию, используемым для всех решений о том, являются ли цели актуальными.

MD5 означает, что scons решает, что исходный файл изменился, если контрольная сумма MD5 его
содержимое изменилось с тех пор, как оно в последний раз использовалось для перестроения конкретной цели
.

отметка времени означает, что scons решает, что исходный файл изменился, если его отметка времени
(время модификации) изменилось с момента последнего использования для перестроения
конкретный целевой файл. (Обратите внимание, что хотя это похоже на поведение Make,
по умолчанию он также будет перестраиваться, если зависимость старший чем в прошлый раз это было
используется для восстановления целевого файла.)

Нет никакой разницы между двумя поведениями для Python. Значение узловые объекты.

Подписи MD5 вычисляются дольше, но они более точны, чем метки времени.
подписи. Значение по умолчанию — MD5.

Обратите внимание, что по умолчанию Целевые подписи настройка (см. ниже) заключается в использовании этого
ИсточникПодписи настройка для любых целевых файлов, которые используются для создания других целевых
файлы. Следовательно, изменение значения ИсточникПодписи будет по умолчанию влиять
актуальное решение для всех файлов в сборке (или всех файлов, собранных с определенным
строительная среда, когда env.SourceSignatures используется).

Разделить (аргумент), env.Split (аргумент)
Возвращает список имен файлов или других объектов. Если arg является строкой, она будет разделена на
строки пробельных символов внутри строки, что упрощает написание длинных
списки имен файлов. Если arg уже является списком, список будет возвращен без изменений. Если
arg — объект любого другого типа, он будет возвращен в виде списка, содержащего только
объект.

Пример:

файлы = Разделить ("f1.c f2.c f3.c")
файлы = env.Split ("f4.c f5.c f6.c")
файлы = Разделить("""
f7.с
f8.с
f9.с
"" ")

env.subst (вход, [необработанный, целевой, исходный, конв.])
Выполняет интерполяцию переменных конструкции для указанной строки или последовательности
аргумент вход.

По умолчанию начальные или конечные пробелы будут удалены из результата. и все
последовательности пробелов будут сжаты до одного символа пробела. Кроме того,
любые последовательности символов $( и $) будут удалены из возвращаемой строки.
необязательный сырье Аргумент может быть установлен в 1, если вы хотите сохранить пробелы и $(-$)
последовательности. сырье аргумент может быть установлен на 2, если вы хотите удалить все символы
между любыми парами $( и $) (как это делается для вычисления подписи).

Если вход представляет собой последовательность (список или кортеж), отдельные элементы последовательности
будет расширен, и результаты будут возвращены в виде списка.

Необязательный цель и источник Аргументы ключевых слов должны быть установлены в списки целевых и
узлы-источники соответственно, если вы хотите $ TARGET, $ЦЕЛИ, $ ИСТОЧНИК и ИСТОЧНИКИ в
быть доступным для расширения. Обычно это необходимо, если вы звоните env.subst
из функции Python, используемой в качестве действия SCons.

Возвращаемые строковые значения или элементы последовательности преобразуются в их строку
представление по умолчанию. Необязательный усл аргумент может указывать преобразование
функция, которая будет использоваться вместо функции по умолчанию. Например, если вы хотите Python
объектов (включая узлы SCons), которые должны быть возвращены как объекты Python, вы можете использовать
Идиома Python Λ для передачи безымянной функции, которая просто возвращает непреобразованный
аргумент.

Пример:

print env.subst("Компилятор C: $CC")

компиляция def (цель, источник, окружение):
sourceDir = env.subst("${SOURCE.srcdir}",
цель = цель,
источник = источник)

source_nodes = env.subst('$EXPAND_TO_NODELIST',
усл=лямбда х: х)

Тег(узел, теги)
Аннотирует узлы файлов или каталогов информацией о том, как Упаковка строитель
должны упаковать эти файлы или каталоги. Все теги являются необязательными.

Примеры:

# гарантирует, что собранная библиотека будет установлена ​​с файлом 0644
# режим доступа
Тег(Библиотека('lib.c'), UNIX_ATTR="0644" )

# помечает file2.txt как файл документации
Тег('file2.txt', DOC)

TargetSignatures(тип), env.TargetSignatures(тип)
Примечание. Хотя официально эта функция еще не объявлена ​​устаревшей, использование этой функции разрешено.
обескураженный. См. решающая встреча для более гибкого и простого способа
настроить принятие решений SCons.

Команда Целевые подписи функция сообщает scons, как решить, является ли целевой файл (файл, который
is построенный из любых других файлов) изменился с тех пор, как последний раз использовался для сборки
какой-то другой целевой файл. Допустимые значения: «строить»; «контент» (или его синоним «MD5»);
"отметка времени"; или «источник».

Если используется метод среды, указанный тип целевой подписи используется только
для целей, созданных в этой среде. Если используется глобальная функция, указанный
тип подписи становится используемым по умолчанию для всех целевых файлов, которые не имеют
явный целевой тип подписи, указанный для их сред.

«content» (или его синоним «MD5») означает, что scons решает, что целевой файл изменился, если
контрольная сумма MD5 его содержимого изменилась с тех пор, как он последний раз использовался для
перестроить какой-нибудь другой целевой файл. Это означает, что scons откроет сумму MD5 содержимого
целевые файлы после их сборки и может решить, что не нужно перестраивать
"нисходящие" целевые файлы, если файл был перестроен с точно таким же содержимым, как и исходный.
последний раз.

«отметка времени» означает, что scons решает, что целевой файл изменился, если его отметка времени
(время модификации) изменилось с момента последнего использования для перестроения некоторых других
целевой файл. (Обратите внимание, что хотя это похоже на поведение Make, по умолчанию
он также будет перестроен, если зависимость старший чем в прошлый раз, когда он был использован для
перестроить целевой файл.)

"источник" означает, что scons решает, что целевой файл изменился, как указано
соответствующий ИсточникПодписи настройка ("MD5" или "отметка времени"). Это означает, что сконы
будет обрабатывать все входные файлы для цели одинаково, независимо от того, являются ли они
исходные файлы или были созданы из других файлов.

«сборка» означает, что scons решает, что целевой файл изменился, если он был перестроен в
этот вызов или если его содержимое или временная метка изменились, как указано
соответствующий ИсточникПодписи параметр. Это «распространяет» статус восстановленного файла.
так что другие "нисходящие" целевые файлы всегда будут перестраиваться, даже если содержимое
или метка времени не изменилась.

Подписи «построить» быстрее всего, потому что подписи «контента» (или «MD5») требуют больше времени для создания.
вычисления, но более точны, чем сигнатуры с отметками времени, и могут предотвратить
ненужные «нисходящие» перестроения, когда целевой файл перестраивается в точно такой же
содержимое как в предыдущей сборке. Параметр «источник» обеспечивает наиболее последовательный
поведение, когда другие целевые файлы могут быть перестроены как из исходного, так и из целевого ввода
файлы. Значение по умолчанию — «источник».

Поскольку значением по умолчанию является «источник», использование ИсточникПодписи как правило,
предпочтительнее Целевые подписи, так что актуальное решение будет непротиворечивым для
все файлы (или все файлы, созданные в определенной среде конструирования). Использование
Целевые подписи обеспечивает особый контроль над тем, как созданные целевые файлы влияют на их
«нижние» зависимости.

Инструмент(строка, [траектория, **kw]), env.Tool(строка, [траектория, **kw])
Команда Инструмент форма функции возвращает вызываемый объект, который можно использовать для инициализации
среда разработки с помощью ключевого слова tools метода Environment(). То
объект может вызываться со средой построения в качестве аргумента, и в этом случае
объект добавит необходимые переменные в среду построения и имя
инструмента будет добавлен в $ИНСТРУМЕНТЫ строительная переменная.

Дополнительные аргументы ключевого слова передаются в порождать() метод.

Примеры:

env = Среда (инструменты = [Инструмент ('msvc') ])

env = Окружающая среда ()
т = Инструмент('msvc')
t(env) # добавляет 'msvc' в переменную TOOLS
u = Инструмент('opengl', путь к инструменту = ['инструменты'])
u(env) # добавляет 'opengl' в переменную TOOLS

Команда env.Инструмент форма функции применяет вызываемый объект для указанного инструмента
string к среде, через которую был вызван метод.

Дополнительные аргументы ключевого слова передаются в порождать() метод.

env.Tool('gcc')
env.Tool('opengl', путь к инструменту = ['сборка/инструменты'])

Значение (значение, [встроенное_значение]), env.Value (значение, [встроенное_значение])
Возвращает объект Node, представляющий указанное значение Python. Можно использовать узлы значений
как зависимости целей. Если результат вызова ул(ценностное ) изменения между SCons
работает, любые цели в зависимости от Значение(ценностное ) будет восстановлен. (Это верно даже тогда, когда
использование меток времени для определения актуальности файлов.) При использовании источника меток времени
подписи, временные метки Value Nodes равны системному времени, когда Node
создано.

Возвращенный объект Value Node имеет записывать() метод, который можно использовать для «построения»
Value Node, установив новое значение. Необязательный построенное_значение можно указать аргумент
когда создается узел значения, чтобы указать, что узел уже следует рассматривать
«построен». Существует соответствующий читать() метод, который вернет построенное значение
узел.

Примеры:

env = Окружающая среда ()

def create (цель, источник, среда):
# Функция, которая запишет 'prefix=$SOURCE'
# строка в имя файла, указанное как
# $ЦЕЛЬ.
f = открыть (str (цель [0]), 'wb')
f.write('prefix=' + источник[0].get_contents())

# Получить аргумент prefix=, если он есть, из команды
# строка и используйте / USR / местные по умолчанию.
префикс = ARGUMENTS.get('префикс', '/ USR / местные')

# Прикрепите построитель .Config() для вышеуказанного действия функции
# к строительной среде.
env['BUILDERS']['Config'] = Строитель (действие = создать)
env.Config (цель = 'package-config', источник = значение (префикс))

def build_value (цель, источник, окружение):
# Функция, которая «строит» значение Python, обновляя
# значение Python с содержимым файла
# указан как источник вызова Builder ($SOURCE).
цель[0].записать(источник[0].get_contents())

вывод = env.Value («до»)
ввод = env.Value('после')

# Прикрепите построитель .UpdateValue() для вышеуказанной функции
# действие на строительную среду.
env['BUILDERS']['UpdateValue'] = Builder(action = build_value)
env.UpdateValue (цель = значение (выход), источник = значение (ввод))

VariantDir(variant_dir, src_dir, [дубликат]), env.VariantDir(variant_dir, src_dir,
[дубликат])
Использовать ВариантDir функция для создания копии исходников в другом месте: если
имя под вариант_каталог не найден, но существует под src_dir, файл или каталог
Скопирован в вариант_каталог. Целевые файлы могут быть созданы в каталоге, отличном от
оригинальные источники, просто ссылаясь на источники (и цели) в варианте
дерево.

ВариантDir можно вызывать несколько раз с одним и тем же src_dir настроить несколько
сборки с разными вариантами (варианты). src_dir место должно быть в или
под каталогом файла SConstruct и вариант_каталог может быть не снизу
src_dir.

По умолчанию scons физически дублируют исходные файлы в
Вариантное дерево. Таким образом, сборка, выполненная в дереве вариантов, гарантированно будет
идентична сборке, выполненной в исходном дереве, даже если промежуточные исходные файлы
генерируются во время сборки, или препроцессоры или другие сканеры ищут включенные
файлы относительно исходного файла, или отдельные компиляторы или другие вызванные инструменты
жестко запрограммированы для размещения производных файлов в том же каталоге, что и исходные файлы.

Если возможно на платформе, дублирование выполняется путем ссылки, а не
копирование; см. также - дублировать параметр командной строки. Причем только нужные файлы
для сборки дублируются; файлы и каталоги, которые не используются, отсутствуют
in вариант_каталог.

Дублирование исходного дерева можно отключить, установив для аргумента дубликата значение 0.
(нуль). Это заставит scons вызывать Builders, используя пути к исходным файлам.
in src_dir и пути к производным файлам внутри вариант_каталог. Это всегда больше
эффективнее, чем дубликат = 1, и обычно безопасен для большинства сборок (но см. выше для
случаи, которые могут вызвать проблемы).

Обратите внимание, что ВариантDir наиболее естественно работает с вспомогательным файлом SConscript. Тем не мение,
тогда вы вызовете вспомогательный файл SConscript не в исходном каталоге, а в
вариант_каталог, независимо от значения дубликата. Вот как вы говорите scons
какой вариант исходного дерева построить:

# запустить src/SConscript в двух каталогах вариантов
VariantDir('сборка/вариант1', 'источник')
SConscript('сборка/вариант1/SConscript')
VariantDir('сборка/вариант2', 'источник')
SConscript('сборка/вариант2/SConscript')

См. Также SПризывник функцию, описанную выше, для другого способа указать
variant в сочетании с вызовом вспомогательного файла SConscript.

Примеры:

# использовать имена в каталоге сборки, а не в исходном каталоге
VariantDir('сборка', 'источник', дубликат=0)
Программа('сборка/прог', 'сборка/source.c')

# это создает и исходный код, и документы в отдельном поддереве
VariantDir('сборка', '.', дубликат=0)
SConscript(dirs=['сборка/источник','сборка/документ'])

# то же, что и в предыдущем примере, но использует только SConscript
SConscript(dirs='src', variant_dir='build/src', дубликат=0)
SConscript(dirs='doc', variant_dir='build/doc', дубликат=0)

WhereIs(программа, [путь, путь, отклонение]), env.WhereIs(программа, [путь, путь, отклонение])
Ищет указанный исполняемый файл программа, возвращая полный путь к
program, если она найдена, и возвращает None, если нет. Ищет указанный путь,
значение PATH вызывающей среды (env['ENV']['PATH']) или текущий пользовательский
внешний ПУТЬ (os.environ['ПУТЬ']) по умолчанию. В системах Windows ищет
исполняемые программы с любым из расширений файлов, перечисленных в указанном путь,
PATHEXT вызывающей среды (env['ENV']['PATHEXT']) или текущий пользовательский
PATHEXT (os.environ['PATHEXT']) по умолчанию. Не будет выбирать какое-либо имя пути или имена в
указанный отвергать список, если есть.

SПризывник Переменные
В дополнение к глобальным функциям и методам, бра поддерживает ряд Python
переменные, которые можно использовать в файлах SConscript, чтобы повлиять на то, как вы хотите, чтобы сборка была
выполненный. Доступ к этим переменным можно получить из пользовательских модулей Python, которые вы импортируете в
файл SConscript, добавив в модуль Python следующее:

из импорта SCons.Script *

АРГЛИСТ
Список ключевое слово=ценностное аргументы, указанные в командной строке. Каждый элемент в списке
представляет собой кортеж, содержащий (ключевое слово,ценностное ) аргумента. Отдельный ключевое слово и
ценностное к элементам кортежа можно получить доступ, подписавшись на элемент [0] и [1] of
кортеж соответственно.

Пример:

print "первое ключевое слово, значение =", ARGLIST[0][0], ARGLIST[0][1]
print "второе ключевое слово, значение =", ARGLIST[1][0], ARGLIST[1][1]
Third_tuple = СПИСОК_АРГЛИСТА[2]
print "третье ключевое слово, значение =", Third_tuple[0], Third_tuple[1]
для ключа, значение в ARGLIST:
# ключ и значение процесса

АРГУМЕНТЫ
Словарь всех ключевое слово=ценностное аргументы, указанные в командной строке. То
словарь не в порядке, и если данное ключевое слово имеет более одного значения, присвоенного
это в командной строке, последнее (крайнее правое) значение - это значение в АРГУМЕНТЫ
Словарь.

Пример:

если ARGUMENTS.get ('отладка', 0):
env = Окружающая среда (CCFLAGS = '-g')
еще:
env = Окружающая среда ()

BUILD_TARGETS
Список целей, которые бра на самом деле попытается построить, независимо от того,
они были указаны в командной строке или через По умолчанию() функция или метод. То
элементы этого списка могут быть строками or узлы, поэтому вы должны запустить список через
Питон ул функция, чтобы убедиться, что любые пути к узлу преобразуются в строки.

Поскольку этот список может быть взят из списка целей, указанных с помощью По умолчанию()
функции или метода содержимое списка может меняться при каждом последующем вызове
По умолчанию(). См. DEFAULT_TARGETS список ниже для получения дополнительной информации.

Пример:

если 'foo' в BUILD_TARGETS:
print "Не забудьте протестировать программу `foo'!"
если «специальное/программное» в BUILD_TARGETS:
SConscript('специальный')

Обратите внимание, что BUILD_TARGETS список содержит только ожидаемые цели, перечисленные в командной строке
или по звонку в По умолчанию() функция или метод. Оно делает содержать все зависимые
цели, которые будут построены в результате проверки того, что явно указанные цели
обновлены.

COMMAND_LINE_TARGETS
Список целей, явно указанных в командной строке. если нет
цели, указанные в командной строке, список пуст. Это можно использовать, для
например, предпринимать определенные действия только тогда, когда определенная цель или цели явно
в процессе постройки.

Пример:

если 'foo' в COMMAND_LINE_TARGETS:
print "Не забудьте протестировать программу `foo'!"
если "специальный/программа" в COMMAND_LINE_TARGETS:
SConscript('специальный')

DEFAULT_TARGETS
Список целей узлы которые были указаны с помощью По умолчанию() функция или
метод. Элементы списка являются узлами, поэтому вам нужно запустить их через Python
ул для получения пути к каждому узлу.

Пример:

напечатать строку (DEFAULT_TARGETS [0])
если 'foo' в карте (str, DEFAULT_TARGETS):
print "Не забудьте протестировать программу `foo'!"

Содержание DEFAULT_TARGETS изменение списка при каждом последующем вызове
По умолчанию() функция:

print map(str, DEFAULT_TARGETS) # изначально []
По умолчанию («фу»)
print map(str, DEFAULT_TARGETS) # теперь узел ['foo']
По умолчанию («бар»)
print map(str, DEFAULT_TARGETS) # теперь узел ['foo', 'bar']
По умолчанию (нет)
print map(str, DEFAULT_TARGETS) # вернуться к []

Следовательно, обязательно используйте DEFAULT_TARGETS только после того, как вы сделаете все свои По умолчанию()
вызовы, или просто следите за порядком этих операторов в ваших файлах SConscript.
так что вы не будете искать конкретную цель по умолчанию до того, как она будет фактически добавлена ​​в
список.

Строительство Переменные
Строительная среда имеет связанный словарь строительство переменные , которые являются
используется встроенными или пользовательскими правилами сборки. Строительные переменные должны следовать одинаковым
правила для идентификаторов Python: начальный символ должен быть символом подчеркивания или буквой,
за которым следует любое количество знаков подчеркивания, букв или цифр.

Ряд полезных переменных построения автоматически определяется scons для каждого
поддерживаемая платформа, а дополнительные переменные конструкции могут быть определены пользователем. То
Ниже приведен список автоматически определяемых переменных построения:

__LDMODULEVERSIONFLAGS
Эта конструктивная переменная автоматически вводит $ _LDMODULEVERSIONFLAGS if
$ LDMODULEVERSION установлен. В противном случае он оценивается как пустая строка.

__SHLIBVERSIONFLAGS
Эта конструктивная переменная автоматически вводит $ _SHLIBVERSIONFLAGS if
$ШЛИБВЕРСИЯ установлен. В противном случае он оценивается как пустая строка.

AR
Архиватор статической библиотеки.

АРХИТЕКТУРА
Указывает системную архитектуру, для которой строится пакет. По умолчанию
системная архитектура машины, на которой работает SCons. Это используется для заполнения
в поле «Архитектура:» в управляющем файле Ipkg и как часть имени
сгенерированный RPM-файл.

ARCOM
Командная строка, используемая для создания статической библиотеки из объектных файлов.

АРКОМСТР
Строка, отображаемая при создании объектного файла из источника на языке ассемблера.
файл. Если это не установлено, то $ ARCOM (командная строка).

env = Среда (ARCOMSTR = "Архивация $TARGET")

АРФЛАГС
Общие параметры переданы архиватору статической библиотеки.

AS
Ассемблер.

АСКОМ
Командная строка, используемая для создания объектного файла из источника на языке ассемблера.
.

АСКОМСТР
Строка, отображаемая при создании объектного файла из источника на языке ассемблера.
файл. Если это не установлено, то $ ASCOM (командная строка).

env = Среда (ASCOMSTR = "Сборка $TARGET")

АСФЛАГИ
Общие параметры передаются ассемблеру.

АСППКОМ
Командная строка, используемая для сборки исходного файла на языке ассемблера в объектный файл.
после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ ASFLAGS и $ CPPFLAGS переменные конструкции включены в эту командную строку.

АСППКОМСТР
Строка, отображаемая при создании объектного файла из источника на языке ассемблера.
файл после первого запуска файла через препроцессор C. Если это не установлено, то
$ ASPPCOM (командная строка).

env = Environment(ASPPCOMSTR = "Сборка $TARGET")

АСПФЛАГИ
Общие параметры при сборке исходного файла на языке ассемблера в объект
файл после первого запуска файла через препроцессор C. По умолчанию используется
Значение $ ASFLAGS.

БИБТЕКС
Генератор библиографии для форматировщика и набора текста TeX и LaTeX
структурированный форматтер и наборщик.

БИБТЕКСКОМ
Командная строка, используемая для вызова генератора библиографии для форматтера TeX и
верстальщик и структурированный форматировщик и верстальщик LaTeX.

БИБТЕКСКОМСТР
Строка, отображаемая при создании библиографии для TeX или LaTeX. Если это не
установить, затем $ BIBTEXCOM (командная строка).

env = Environment(BIBTEXCOMSTR = "Создание библиографии $TARGET")

БИБТЕКСФЛАГС
Общие параметры передаются генератору библиографии для форматтера TeX и
верстальщик и структурированный форматировщик и верстальщик LaTeX.

БИТКИПЕР
Исполняемый файл BitKeeper.

БИТКИПЕРКОМ
Командная строка для загрузки исходных файлов с помощью BitKeeper.

БИТКИПЕРКОМСТР
Строка, отображаемая при извлечении исходного файла с помощью BitKeeper. Если это не установлено,
тогда $ BITKEEPERCOM (командная строка).

БИТКИПЕРГЕТ
Команда ($ BITKEEPER) и подкоманда для загрузки исходных файлов с помощью BitKeeper.

БИТКИПЕРГЕТФЛАГС
Параметры, которые передаются BitKeeper получить подкоманда.

СТРОИТЕЛИ
Словарь, отображающий имена сборщиков, доступных через эту среду, в
базовые объекты Builder. Построители с именами Alias, CFile, CXXFile, DVI, Library,
Объект, PDF, PostScript и Программа доступны по умолчанию. Если вы инициализируете это
переменная при создании среды:

env = Окружающая среда (СТРОИТЕЛИ = {'NewBuilder': foo})

Строители по умолчанию больше не будут доступны. Чтобы использовать новый объект Builder в
В дополнение к Builders по умолчанию добавьте новый объект Builder следующим образом:

env = Окружающая среда ()
env.Append(СТРОИТЕЛИ = {'NewBuilder': foo})

или это:

env = Окружающая среда ()
env['BUILDERS]['NewBuilder'] = foo

CC
Компилятор C.

CCCOM
Командная строка, используемая для компиляции исходного файла C в (статический) объектный файл. Любой
параметры, указанные в $ CFLAGS, $ CCFLAGS и $ CPPFLAGS строительные переменные
включены в эту командную строку.

CCCOMSTR
Строка, отображаемая при компиляции исходного файла C в (статический) объектный файл. Если
это не установлено, то $ CCCOM (командная строка).

env = Environment(CCCOMSTR = "Компиляция статического объекта $TARGET")

CCFLAGS
Общие параметры, которые передаются компиляторам C и C++.

CCPCHFLAGS
Параметры, добавленные в командную строку компилятора для поддержки сборки с предварительно скомпилированным
заголовки. Значение по умолчанию расширяется до соответствующего Microsoft Visual C++.
параметры командной строки, когда $ PCH установлена ​​строительная переменная.

CCDPBFLAGS
Параметры, добавленные в командную строку компилятора для поддержки хранения отладочной информации в
PDB-файл Microsoft Visual C++. Значение по умолчанию расширяется до соответствующего
Параметры командной строки Microsoft Visual C++ при $ PDB установлена ​​строительная переменная.

Параметр компилятора Visual C++, который SCons использует по умолчанию для создания информации PDB.
is / Z7. Это работает правильно с параллельным (-j) строится, потому что в него встроены отладочные
информация в промежуточных объектных файлах, в отличие от совместного использования одного файла PDB
между несколькими объектными файлами. Это также единственный способ получить отладочную информацию.
встроен в статическую библиотеку. С помощью / Zi вместо этого может улучшить время соединения
производительность, хотя параллельные сборки больше не будут работать.

Вы можете создавать файлы PDB с помощью / Zi переключиться, переопределив значение по умолчанию $ CCPDBFLAGS
переменная следующим образом:

env['CCPDBFLAGS'] = ['${(PDB и "/Zi /Fd%s" % File(PDB)) или ""}']

Альтернативой было бы использование / Zi поместить отладочную информацию в отдельный
.pdb для каждого объектного файла, переопределив $ CCPDBFLAGS переменная следующим образом:

env['CCPDBFLAGS'] = '/Zi /Fd${TARGET}.pdb'

ВЕРСИЯ
Номер версии компилятора C. Это может быть или не быть установлено, в зависимости от
используется конкретный компилятор C.

CFILEСУФФИКС
Суффикс для исходных файлов C. Это используется внутренним компоновщиком CFile, когда
создание файлов C из входных файлов Lex (.l) или YACC (.y). Суффикс по умолчанию, из
конечно, это .c (нижний регистр). В системах, нечувствительных к регистру (например, Windows), символы SCons также
обрабатывает файлы .C (верхний регистр) как файлы C.

КФЛАГИ
Общие параметры, которые передаются компилятору C (только C, а не C++).

CHANGE_SPECFILE
Хук для изменения файла, управляющего сборкой пакета (.spec для RPM,
элемент управления для Ipkg, .wxs для MSI). Если установлено, функция будет вызываться после
Шаблон SCons для файла написан. ХХХ

ИЗМЕНЕННЫЕ_ИСТОЧНИКИ
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

CHANGED_TARGETS
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

CHANGELOG
Имя файла, содержащего текст журнала изменений, который будет включен в пакет. Этот
включается как раздел %changelog файла RPM .spec.

_concat
Функция, используемая для создания таких переменных, как $ _CPPINCFLAGS. Требуется четыре или пять
аргументы: префикс для объединения с каждым элементом, список элементов, суффикс для
конкатенировать на каждый элемент, среду для интерполяции переменных и
необязательная функция, которая будет вызываться для преобразования списка перед конкатенацией.

env['_CPPINCFLAGS'] = '$(${_concat(INCPREFIX, CPPPATH, INCSUFFIX, __env__, RDirs)} $)',

НАСТРОЙКА
Имя каталога, в который записываются тестовые файлы Configure context. То
по умолчанию — .sconf_temp в каталоге верхнего уровня, содержащем файл SConstruct.

НАСТРОЙКА
Имя файла журнала конфигурации контекста. По умолчанию это config.log на верхнем уровне.
каталог, содержащий файл SConstruct.

_CPPDEFFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая препроцессор C.
параметры командной строки для определения значений. Значение $ _CPPDEFFLAGS создается
добавление $ CPPDEFPREFIX и $ CPPDEFSUFFIX к началу и концу каждого определения
in $CPPDEFINES.

CPDОПРЕДЕЛЯЕТ
Независимая от платформы спецификация определений препроцессора C. Определения
будут добавлены в командные строки через автоматически сгенерированный $ _CPPDEFFLAGS
строительная переменная (см. выше), которая строится по типу значения
of $CPPDEFINES:

If $CPPDEFINES представляет собой строку, значения $ CPPDEFPREFIX и $ CPPDEFSUFFIX
переменные построения будут добавлены в начало и конец.

# Добавит -Dxyz в командные строки компилятора POSIX,
# и /Dxyz в командные строки Microsoft Visual C++.
env = Окружающая среда (CPPDEFINES = 'xyz')

If $CPPDEFINES представляет собой список, значения $ CPPDEFPREFIX и $ CPPDEFSUFFIX
переменные конструкции будут добавлены к началу и концу каждого элемента в
список. Если какой-либо элемент является списком или кортежем, то первым элементом является имя
определено, а второй элемент является его значением:

# Добавит -DB=2 -DA в командные строки компилятора POSIX,
# и /DB=2 /DA в командные строки Microsoft Visual C++.
env = Окружающая среда (CPPDEFINES = [('B', 2), 'A'])

If $CPPDEFINES словарь, значения $ CPPDEFPREFIX и $ CPPDEFSUFFIX
переменные построения будут добавлены к началу и концу каждого элемента из
Словарь. Ключ каждого элемента словаря — это имя, определяемое для словаря.
соответствующее значение элемента; если значение равно None, то имя определяется без
явное значение. Обратите внимание, что полученные флаги сортируются по ключевому слову, чтобы гарантировать, что
порядок параметров в командной строке неизменен при каждом запуске scons.

# Добавит -DA -DB=2 в командные строки компилятора POSIX,
# и /DA /DB=2 в командные строки Microsoft Visual C++.
env = Среда (CPPDEFINES = {'B': 2, 'A': Нет})

CPPDEFPREFIX
Префикс, используемый для указания определений препроцессора в командной строке компилятора C.
Это будет добавлено к началу каждого определения в $CPPDEFINES
строительная переменная, когда $ _CPPDEFFLAGS переменная генерируется автоматически.

CPPDEFСУФФИКС
Суффикс, используемый для указания определений препроцессора в командной строке компилятора C.
Это будет добавлено в конец каждого определения в $CPPDEFINES строительство
переменная, когда $ _CPPDEFFLAGS переменная генерируется автоматически.

CPPFЛАГИ
Пользовательские параметры препроцессора C. Они будут включены в любую команду, которая использует
препроцессор C, включая не только компиляцию исходных файлов C и C++ через
$ CCCOM, $ SHCCCOM, $ CXXCOM и $ SHCXXCOM командные строки, но и $ FORTRANPPCOM,
$ SHFORTRANPPCOM, $ F77PPCOM и $ SHF77PPCOM командные строки, используемые для компиляции Fortran
исходный файл и $ ASPPCOM командная строка, используемая для сборки языка ассемблера
исходный файл, предварительно пропустив каждый файл через препроцессор C. Обратите внимание, что это
переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $CPPPATH. Посмотреть $ _CPPINCFLAGS, ниже, для переменной, которая
расширяется до этих параметров.

_CPPINCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая препроцессор C.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _CPPINCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $CPPPATH.

CPPPATH
Список каталогов, которые препроцессор C будет искать, включает каталоги.
Сканер неявных зависимостей C/C++ будет искать в этих каталогах включаемые файлы.
Не помещайте явно аргументы каталога включения в CCFLAGS или CXXFLAGS, потому что
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в CPPPATH будут искаться относительно SConscript.
каталог, когда они используются в команде. Чтобы заставить scons искать каталог
относительно корня исходного дерева используйте #:

env = среда (CPPPATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (CPPPATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _CPPINCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $CPPPATH. Любые определяемые вами командные строки, которым требуется каталог CPPPATH.
список должен включать $ _CPPINCFLAGS:

env = Environment(CCCOM="my_compiler $_CPPINCFLAGS -c -o $TARGET $SOURCE")

CPPСУФФИКСЫ
Список суффиксов файлов, которые будут проверены на наличие неявного препроцессора C
зависимости (#include строки). Список по умолчанию:

[.c", ".C", ".cxx", ".cpp", ".c++", ".cc",
".h", ".H", ".hxx", ".hpp", ".hh",
".F", ".fpp", ".FPP",
".М-м-м",
".S", ".spp", ".SPP"]

CVS
Исполняемый файл CVS.

CVSCOФЛАГИ
Параметры, которые передаются подкоманде CVS checkout.

CVSCOM
Командная строка, используемая для загрузки исходных файлов из репозитория CVS.

CVSCOMSTR
Строка, отображаемая при извлечении исходного файла из репозитория CVS. Если это не
установить, затем $ CVSCOM (командная строка).

CVSFЛАГИ
Общие параметры, которые передаются в CVS. По умолчанию установлено значение -d $CVSREPOSITORY.
чтобы указать, откуда файлы должны быть извлечены.

CVSРЕПОЗИТОРИЙ
Путь к репозиторию CVS. Это указано в стандартном $ CVSFLAGS значения.

СХХ
Компилятор C ++.

CXXCOM
Командная строка, используемая для компиляции исходного файла C++ в объектный файл. Любые варианты
указано в $ CXXFLAGS и $ CPPFLAGS переменные конструкции включены в это
командная строка.

CXXCOMSTR
Строка, отображаемая при компиляции исходного файла C++ в (статический) объектный файл. Если
это не установлено, то $ CXXCOM (командная строка).

env = Environment(CXXCOMSTR = "Компиляция статического объекта $TARGET")

CXXFILESUFFIX
Суффикс для исходных файлов C++. Это используется внутренним компоновщиком CXXFile, когда
создание файлов C++ из входных файлов Lex (.ll) или YACC (.yy). Суффикс по умолчанию
.cc SCons также обрабатывает файлы с суффиксами .cpp, .cxx, .c++ и .C++ как C++.
файлы и файлы с суффиксами .mm как файлы Objective C++. В системах с учетом регистра
(Linux, UNIX и другие подобные POSIX), SCons также обрабатывает файлы .C (верхний регистр) как C++
файлы.

CXXFLAGS
Общие параметры, которые передаются компилятору C++. По умолчанию это включает в себя
Значение $ CCFLAGS, так что настройка $ CCFLAGS влияет на компиляцию C и C++. если ты
хотите добавить специфичные для C++ флаги, вы должны установить или переопределить значение $ CXXFLAGS.

CXXВЕРСИЯ
Номер версии компилятора C++. Это может быть или не быть установлено, в зависимости от
используется конкретный компилятор C++.

DC
ОКРУГ КОЛУМБИЯ.

DCOM
ДКОМ.

ДДЕБУГ
ДДЕБУГ.

_DDEBUGFLAGS
_DDEBUGFLAGS.

ДДЕБУГПРЕФИКС
ДДЕБУГПРЕФИКС.

ДДЕБУГСУФФИКС
ДДЕБУГСУФФИКС.

ОПИСАНИЕ
Подробное описание упаковываемого проекта. Это входит в соответствующие
раздел файла, управляющий сборкой упаковки.

DESCRIPTION_lang
Подробное описание конкретного языка для указанного Ланг. Это используется для заполнения
раздел %description -l RPM-файла .spec.

DFILEСУФФИКС
DФАЙЛСУФФИКС.

ДФЛАГПРЕФИКС
ДФЛАГПРЕФИКС.

_DFLAGS
_DFLAGS.

ДФЛАГС
ДФЛАГС.

ДФЛАГСУФФИКС
ДФЛАГСУФФИКС.

_DINCFLAGS
_ДИНКФЛАГС.

ДИНКПРЕФИКС
ДИНКПРЕФИКС.

DINCСУФФИКС
DINCСУФФИКС.

Вы
Функция, которая преобразует строку в экземпляр Dir относительно целевого объекта.
встроенный.

Функция, которая преобразует строку в экземпляр Dir относительно целевого объекта.
встроенный.

Диры
Функция, которая преобразует список строк в список экземпляров Dir относительно
строящаяся цель.

ДЛИБ
ДЛИБ.

ДЛИБКОМ
ДЛИБКОМ.

_DLIBDIRFLAGS
_DLIBDIRFLAGS.

ДЛИБДИПРРЕФИКС
ДЛИБДИПРРЕФИКС.

ДЛИБДИРСУФФИКС
ДЛИБДИРСУФФИКС.

ДЛИБФЛАГПРЕФИКС
ДЛИБФЛАГПРЕФИКС.

_DLIBFLAGS
_DLIBFLAGS.

ДЛИБФЛАГСУФФИКС
ДЛИБФЛАГСУФФИКС.

ДЛИБЛИНКПРЕФИКС
ПРЕФИКС ДЛИБЛИНК.

ДЛИБЛИНКСУФФИКС
ДЛИБЛИНКСУФФИКС.

DLINK
ДЛИНК.

ДЛИНККОМ
ДЛИНККОМ.

ДЛИНКФЛАГПРЕФИКС
ДЛИНКФЛАГПРЕФИКС.

ДЛИНКФЛАГС
ДЛИНКФЛАГИ.

ДЛИНКФЛАГСУФФИКС
ДЛИНКФЛАГСУФФИКС.

DOCBOOK_DEFAULT_XSL_EPUB
XSLT-файл по умолчанию для ДокументEpub билдер в текущей среде, если
никакой другой XSLT не указывается через ключевое слово.

DOCBOOK_DEFAULT_XSL_HTML
XSLT-файл по умолчанию для DocbookHTML билдер в текущей среде, если
никакой другой XSLT не указывается через ключевое слово.

DOCBOOK_DEFAULT_XSL_HTMLCHUNKED
XSLT-файл по умолчанию для DocbookHtmlChunked застройщик в текущем
среде, если никакой другой XSLT не указан с помощью ключевого слова.

DOCBOOK_DEFAULT_XSL_HTMLHELP
XSLT-файл по умолчанию для DocbookHtmlhelp строитель в текущей среде,
если никакой другой XSLT не указан через ключевое слово.

DOCBOOK_DEFAULT_XSL_MAN
XSLT-файл по умолчанию для ДокументЧеловек билдер в текущей среде, если нет
другой XSLT указывается через ключевое слово.

DOCBOOK_DEFAULT_XSL_PDF
XSLT-файл по умолчанию для Документ PDF билдер в текущей среде, если нет
другой XSLT указывается через ключевое слово.

DOCBOOK_DEFAULT_XSL_SLIDESHTML
XSLT-файл по умолчанию для ДокументСлайдыHtml застройщик в текущем
среде, если никакой другой XSLT не указан с помощью ключевого слова.

DOCBOOK_DEFAULT_XSL_SLIDESPDF
XSLT-файл по умолчанию для DocbookСлайдыPdf строитель в текущей среде,
если никакой другой XSLT не указан через ключевое слово.

DOCBOOK_FOP
Путь к рендереру PDF fop или xep, если один из них установлен (fop проверяется
первый).

DOCBOOK_FOPCOM
Полная командная строка для средства визуализации PDF fop или xep.

DOCBOOK_FOPCOMSTR
Строка, отображаемая, когда средство визуализации, такое как fop или xep, используется для создания вывода PDF из
XML-файл.

DOCBOOK_FOPFLAGS
Дополнительные флаги командной строки для средства визуализации PDF fop или xep.

DOCBOOK_XMLLINT
Путь к внешнему исполняемому файлу xmlint, если он установлен. Обратите внимание, что это
используется только как последний запасной вариант для разрешения XInclude, если нет libxml2 или lxml Python
привязку можно импортировать в текущую систему.

DOCBOOK_XMLLINTCOM
Полная командная строка для внешнего исполняемого файла xmllint.

DOCBOOK_XMLLINTCOMSTR
Строка, отображаемая, когда xmllint используется для разрешения XInclude для данного XML-файла.

DOCBOOK_XMLLINTFLAGS
Дополнительные флаги командной строки для внешнего исполняемого файла xmllint.

DOCBOOK_XSLTPROC
Путь к внешнему исполняемому файлу xsltproc (или saxon, xalan), если один из них
установлен. Обратите внимание, что это используется только как последний запасной вариант для XSL-преобразований, если
никакая привязка libxml2 или lxml Python не может быть импортирована в текущую систему.

DOCBOOK_XSLTPROCCOM
Полная командная строка для внешнего исполняемого файла xsltproc (или saxon, xalan).

DOCBOOK_XSLTPROCCOMSTR
Строка, отображаемая, когда xsltproc используется для преобразования XML-файла с помощью заданного XSLT.
таблицы стилей.

DOCBOOK_XSLTPROCFLAGS
Дополнительные флаги командной строки для внешнего исполняемого файла xsltproc (или saxon, xalan).

DOCBOOK_XSLTPROCPARAMS
Дополнительные параметры, не предназначенные для исполняемого файла процессора XSLT, но
Сама обработка XSL. По умолчанию они добавляются в конец командной строки.
для саксонского и саксонского-xslt соответственно.

ДПУТЬ
ПУТЬ.

DСУФФИКСЫ
Список суффиксов файлов, которые будут проверены на наличие импортированных файлов D-пакета. То
список по умолчанию:

['.d']

_DVERFLAGS
_DVERFLAGS.

ДВЕРПРЕФИКС
ДВЕРЬПРЕФИКС.

ВЕРСИИ
ВЕРСИИ.

ДВЕРСУФФИКС
ДВЕРСУФФИКС.

ДВИПДФ
Конвертер файлов TeX DVI в PDF.

ДВИПДФКОМ
Командная строка, используемая для преобразования файлов TeX DVI в файл PDF.

ДВИПДФКОМСТР
Строка, отображаемая при преобразовании файла TeX DVI в файл PDF. Если это не
установить, затем $ DVIPDFCOM (командная строка).

ДВИПДФФЛАГС
Общие параметры, переданные конвертеру файлов TeX DVI в PDF.

ДВИПС
Преобразователь файла TeX DVI в PostScript.

ДВИПСФЛАГИ
Общие параметры передаются конвертеру файлов TeX DVI в PostScript.

ENV
Словарь переменных среды для использования при вызове команд. Когда $ ENV используется
в команде все значения списка будут объединены с использованием разделителя пути и любого другого
нестроковые значения будут просто преобразованы в строку. Обратите внимание, что по умолчанию scons
приносит распространять действующую среду, когда вы выполняете scons для команд
используется для создания целевых файлов. Это сделано для того, чтобы сборки были гарантированно воспроизводимыми.
независимо от переменных среды, установленных во время вызова scons.

Если вы хотите распространить свои переменные среды на команды, выполняемые для сборки
target файлы, вы должны сделать это явно:

импорт ОС
env = Окружающая среда (ENV = os.environ)

Обратите внимание, что вы можете распространять только определенные переменные среды. Общий
например система PATH переменная окружения, чтобы scons использовал те же утилиты
как вызывающая оболочка (или другой процесс):

импорт ОС
env = Environment (ENV = {'ПУТЬ': os.environ ['ПУТЬ']})

УХОД
Функция, которая будет вызываться для экранирования специальных символов оболочки в командных строках.
Функция должна принимать один аргумент: строку командной строки для экранирования; и должен
вернуть экранированную командную строку.

F03
Компилятор Фортран 03. Обычно вы должны установить $ FORTRAN переменная, которая
определяет компилятор Fortran по умолчанию для всех версий Fortran. Вам нужно только установить
03 долларов США если вам нужно использовать определенный компилятор или версию компилятора для файлов Fortran 03.

F03COM
Командная строка, используемая для компиляции исходного файла Fortran 03 в объектный файл. Только ты
нужно установить $ F03COM если вам нужно использовать определенную командную строку для файлов Fortran 03.
Обычно вы должны установить $ FORTRANCOM переменная, которая указывает команду по умолчанию
строка для всех версий Fortran.

F03COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 03 в объектный файл. Если
это не установлено, то $ F03COM or $ FORTRANCOM (командная строка).

F03ФАЙЛСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект F03. По умолчанию это
это ['.f03']

F03ФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran 03. Обратите внимание, что
эта переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $F03PATH. Посмотреть $ _F03INCFLAGS ниже для переменной, которая
расширяется до этих параметров. Вам нужно только установить $ F03ФЛАГИ если вам нужно определить
специальные пользовательские параметры для файлов Fortran 03. Обычно вы должны установить $ FORTRANFLAGS
переменная, которая определяет указанные пользователем параметры, передаваемые по умолчанию в Fortran.
компилятор для всех версий Fortran.

_F03INCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran 03.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _F03INCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $F03PATH.

F03ПУТЬ
Список каталогов, которые будет искать компилятор Fortran 03, включает
каталоги. Сканер неявных зависимостей будет искать в этих каталогах включение
файлы. Не указывайте явно аргументы каталога include в $ F03ФЛАГИ поскольку
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в $F03PATH будет искаться относительно
Каталог SConscript, когда они используются в команде. Чтобы заставить scons искать
каталог относительно корня исходного дерева используйте #: вам нужно только установить $F03PATH
если вам нужно определить конкретный путь включения для файлов Fortran 03. Вам следует
обычно устанавливают $ФОРТРАНПУТ переменная, которая указывает путь включения для
Компилятор Fortran по умолчанию для всех версий Fortran.

env = среда (F03PATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (F03PATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _F03INCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $F03PATH. Любые определяемые вами командные строки, которым требуется каталог F03PATH.
список должен включать $ _F03INCFLAGS:

env = Environment(F03COM="my_compiler $_F03INCFLAGS -c -o $TARGET $SOURCE")

F03PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 03 в объектный файл после
первый запуск файла через препроцессор C. Любые параметры, указанные в
$ F03ФЛАГИ и $ CPPFLAGS переменные конструкции включены в эту командную строку. Ты
нужно только установить $ F03PPCOM если вам нужно использовать конкретную командную строку C-препроцессора
для файлов Fortran 03. Обычно вы должны установить $ FORTRANPPCOM переменная, которая
определяет командную строку C-препроцессора по умолчанию для всех версий Fortran.

F03PPCOMSTR
Строка, отображаемая, когда исходный файл Fortran 03 компилируется в объектный файл после
первый запуск файла через препроцессор C. Если это не установлено, то $ F03PPCOM
or $ FORTRANPPCOM (командная строка).

F03PPФАЙЛСУФФИКСЫ
Список расширений файлов, для которых проходит компиляция + препроцессор по F03
будет использоваться диалект. По умолчанию здесь пусто

F08
Компилятор Фортран 08. Обычно вы должны установить $ FORTRAN переменная, которая
определяет компилятор Fortran по умолчанию для всех версий Fortran. Вам нужно только установить
08 долларов США если вам нужно использовать определенный компилятор или версию компилятора для файлов Fortran 08.

F08COM
Командная строка, используемая для компиляции исходного файла Fortran 08 в объектный файл. Только ты
нужно установить $ F08COM если вам нужно использовать определенную командную строку для файлов Fortran 08.
Обычно вы должны установить $ FORTRANCOM переменная, которая указывает команду по умолчанию
строка для всех версий Fortran.

F08COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 08 в объектный файл. Если
это не установлено, то $ F08COM or $ FORTRANCOM (командная строка).

F08ФАЙЛСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект F08. По умолчанию это
это ['.f08']

F08ФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran 08. Обратите внимание, что
эта переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $F08PATH. Посмотреть $ _F08INCFLAGS ниже для переменной, которая
расширяется до этих параметров. Вам нужно только установить $ F08ФЛАГИ если вам нужно определить
специальные пользовательские параметры для файлов Fortran 08. Обычно вы должны установить $ FORTRANFLAGS
переменная, которая определяет указанные пользователем параметры, передаваемые по умолчанию в Fortran.
компилятор для всех версий Fortran.

_F08INCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran 08.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _F08INCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $F08PATH.

F08ПУТЬ
Список каталогов, которые будет искать компилятор Fortran 08, включает
каталоги. Сканер неявных зависимостей будет искать в этих каталогах включение
файлы. Не указывайте явно аргументы каталога include в $ F08ФЛАГИ поскольку
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в $F08PATH будет искаться относительно
Каталог SConscript, когда они используются в команде. Чтобы заставить scons искать
каталог относительно корня исходного дерева используйте #: вам нужно только установить $F08PATH
если вам нужно определить конкретный путь включения для файлов Fortran 08. Вам следует
обычно устанавливают $ФОРТРАНПУТ переменная, которая указывает путь включения для
Компилятор Fortran по умолчанию для всех версий Fortran.

env = среда (F08PATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (F08PATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _F08INCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $F08PATH. Любые определяемые вами командные строки, которым требуется каталог F08PATH.
список должен включать $ _F08INCFLAGS:

env = Environment(F08COM="my_compiler $_F08INCFLAGS -c -o $TARGET $SOURCE")

F08PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 08 в объектный файл после
первый запуск файла через препроцессор C. Любые параметры, указанные в
$ F08ФЛАГИ и $ CPPFLAGS переменные конструкции включены в эту командную строку. Ты
нужно только установить $ F08PPCOM если вам нужно использовать конкретную командную строку C-препроцессора
для файлов Fortran 08. Обычно вы должны установить $ FORTRANPPCOM переменная, которая
определяет командную строку C-препроцессора по умолчанию для всех версий Fortran.

F08PPCOMSTR
Строка, отображаемая, когда исходный файл Fortran 08 компилируется в объектный файл после
первый запуск файла через препроцессор C. Если это не установлено, то $ F08PPCOM
or $ FORTRANPPCOM (командная строка).

F08PPФАЙЛСУФФИКСЫ
Список расширений файлов, для которых проходит компиляция + препроцессор по F08
будет использоваться диалект. По умолчанию здесь пусто

F77
Компилятор Фортран 77. Обычно вы должны установить $ FORTRAN переменная, которая
определяет компилятор Fortran по умолчанию для всех версий Fortran. Вам нужно только установить
77 долларов США если вам нужно использовать определенный компилятор или версию компилятора для файлов Fortran 77.

F77COM
Командная строка, используемая для компиляции исходного файла Fortran 77 в объектный файл. Только ты
нужно установить $ F77COM если вам нужно использовать определенную командную строку для файлов Fortran 77.
Обычно вы должны установить $ FORTRANCOM переменная, которая указывает команду по умолчанию
строка для всех версий Fortran.

F77COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 77 в объектный файл. Если
это не установлено, то $ F77COM or $ FORTRANCOM (командная строка).

F77ФАЙЛСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект F77. По умолчанию это
это ['.f77']

F77ФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran 77. Обратите внимание, что
эта переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $F77PATH. Посмотреть $ _F77INCFLAGS ниже для переменной, которая
расширяется до этих параметров. Вам нужно только установить $ F77ФЛАГИ если вам нужно определить
специальные пользовательские параметры для файлов Fortran 77. Обычно вы должны установить $ FORTRANFLAGS
переменная, которая определяет указанные пользователем параметры, передаваемые по умолчанию в Fortran.
компилятор для всех версий Fortran.

_F77INCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran 77.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _F77INCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $F77PATH.

F77ПУТЬ
Список каталогов, которые будет искать компилятор Fortran 77, включает
каталоги. Сканер неявных зависимостей будет искать в этих каталогах включение
файлы. Не указывайте явно аргументы каталога include в $ F77ФЛАГИ поскольку
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в $F77PATH будет искаться относительно
Каталог SConscript, когда они используются в команде. Чтобы заставить scons искать
каталог относительно корня исходного дерева используйте #: вам нужно только установить $F77PATH
если вам нужно определить конкретный путь включения для файлов Fortran 77. Вам следует
обычно устанавливают $ФОРТРАНПУТ переменная, которая указывает путь включения для
Компилятор Fortran по умолчанию для всех версий Fortran.

env = среда (F77PATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (F77PATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _F77INCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $F77PATH. Любые определяемые вами командные строки, которым требуется каталог F77PATH.
список должен включать $ _F77INCFLAGS:

env = Environment(F77COM="my_compiler $_F77INCFLAGS -c -o $TARGET $SOURCE")

F77PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 77 в объектный файл после
первый запуск файла через препроцессор C. Любые параметры, указанные в
$ F77ФЛАГИ и $ CPPFLAGS переменные конструкции включены в эту командную строку. Ты
нужно только установить $ F77PPCOM если вам нужно использовать конкретную командную строку C-препроцессора
для файлов Fortran 77. Обычно вы должны установить $ FORTRANPPCOM переменная, которая
определяет командную строку C-препроцессора по умолчанию для всех версий Fortran.

F77PPCOMSTR
Строка, отображаемая, когда исходный файл Fortran 77 компилируется в объектный файл после
первый запуск файла через препроцессор C. Если это не установлено, то $ F77PPCOM
or $ FORTRANPPCOM (командная строка).

F77PPФАЙЛСУФФИКСЫ
Список расширений файлов, для которых проходит компиляция + препроцессор по F77
будет использоваться диалект. По умолчанию здесь пусто

F90
Компилятор Фортран 90. Обычно вы должны установить $ FORTRAN переменная, которая
определяет компилятор Fortran по умолчанию для всех версий Fortran. Вам нужно только установить
90 долларов США если вам нужно использовать определенный компилятор или версию компилятора для файлов Fortran 90.

F90COM
Командная строка, используемая для компиляции исходного файла Fortran 90 в объектный файл. Только ты
нужно установить $ F90COM если вам нужно использовать определенную командную строку для файлов Fortran 90.
Обычно вы должны установить $ FORTRANCOM переменная, которая указывает команду по умолчанию
строка для всех версий Fortran.

F90COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 90 в объектный файл. Если
это не установлено, то $ F90COM or $ FORTRANCOM (командная строка).

F90ФАЙЛСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект F90. По умолчанию это
это ['.f90']

F90ФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran 90. Обратите внимание, что
эта переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $F90PATH. Посмотреть $ _F90INCFLAGS ниже для переменной, которая
расширяется до этих параметров. Вам нужно только установить $ F90ФЛАГИ если вам нужно определить
специальные пользовательские параметры для файлов Fortran 90. Обычно вы должны установить $ FORTRANFLAGS
переменная, которая определяет указанные пользователем параметры, передаваемые по умолчанию в Fortran.
компилятор для всех версий Fortran.

_F90INCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran 90.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _F90INCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $F90PATH.

F90ПУТЬ
Список каталогов, которые будет искать компилятор Fortran 90, включает
каталоги. Сканер неявных зависимостей будет искать в этих каталогах включение
файлы. Не указывайте явно аргументы каталога include в $ F90ФЛАГИ поскольку
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в $F90PATH будет искаться относительно
Каталог SConscript, когда они используются в команде. Чтобы заставить scons искать
каталог относительно корня исходного дерева используйте #: вам нужно только установить $F90PATH
если вам нужно определить конкретный путь включения для файлов Fortran 90. Вам следует
обычно устанавливают $ФОРТРАНПУТ переменная, которая указывает путь включения для
Компилятор Fortran по умолчанию для всех версий Fortran.

env = среда (F90PATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (F90PATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _F90INCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $F90PATH. Любые определяемые вами командные строки, которым требуется каталог F90PATH.
список должен включать $ _F90INCFLAGS:

env = Environment(F90COM="my_compiler $_F90INCFLAGS -c -o $TARGET $SOURCE")

F90PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 90 в объектный файл после
первый запуск файла через препроцессор C. Любые параметры, указанные в
$ F90ФЛАГИ и $ CPPFLAGS переменные конструкции включены в эту командную строку. Ты
нужно только установить $ F90PPCOM если вам нужно использовать конкретную командную строку C-препроцессора
для файлов Fortran 90. Обычно вы должны установить $ FORTRANPPCOM переменная, которая
определяет командную строку C-препроцессора по умолчанию для всех версий Fortran.

F90PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 90 после первого запуска
файл через препроцессор C. Если это не установлено, то $ F90PPCOM or $ FORTRANPPCOM
(командная строка).

F90PPФАЙЛСУФФИКСЫ
Список расширений файлов, для которых проходит компиляция + препроцессор по F90
будет использоваться диалект. По умолчанию здесь пусто

F95
Компилятор Фортран 95. Обычно вы должны установить $ FORTRAN переменная, которая
определяет компилятор Fortran по умолчанию для всех версий Fortran. Вам нужно только установить
95 долларов США если вам нужно использовать определенный компилятор или версию компилятора для файлов Fortran 95.

F95COM
Командная строка, используемая для компиляции исходного файла Fortran 95 в объектный файл. Только ты
нужно установить $ F95COM если вам нужно использовать определенную командную строку для файлов Fortran 95.
Обычно вы должны установить $ FORTRANCOM переменная, которая указывает команду по умолчанию
строка для всех версий Fortran.

F95COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 95 в объектный файл. Если
это не установлено, то $ F95COM or $ FORTRANCOM (командная строка).

F95ФАЙЛСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект F95. По умолчанию это
это ['.f95']

F95ФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran 95. Обратите внимание, что
эта переменная делает содержать -I (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $F95PATH. Посмотреть $ _F95INCFLAGS ниже для переменной, которая
расширяется до этих параметров. Вам нужно только установить $ F95ФЛАГИ если вам нужно определить
специальные пользовательские параметры для файлов Fortran 95. Обычно вы должны установить $ FORTRANFLAGS
переменная, которая определяет указанные пользователем параметры, передаваемые по умолчанию в Fortran.
компилятор для всех версий Fortran.

_F95INCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran 95.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы. То
Значение $ _F95INCFLAGS создается путем добавления $ INCPREFIX и $ INCSUFFIX до
начало и конец каждого каталога в $F95PATH.

F95ПУТЬ
Список каталогов, которые будет искать компилятор Fortran 95, включает
каталоги. Сканер неявных зависимостей будет искать в этих каталогах включение
файлы. Не указывайте явно аргументы каталога include в $ F95ФЛАГИ поскольку
результат будет непереносимым, и зависимость не будет искать каталоги
сканер. Примечание: имена каталогов в $F95PATH будет искаться относительно
Каталог SConscript, когда они используются в команде. Чтобы заставить scons искать
каталог относительно корня исходного дерева используйте #: вам нужно только установить $F95PATH
если вам нужно определить конкретный путь включения для файлов Fortran 95. Вам следует
обычно устанавливают $ФОРТРАНПУТ переменная, которая указывает путь включения для
Компилятор Fortran по умолчанию для всех версий Fortran.

env = среда (F95PATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = среда (F95PATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _F95INCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начале и в конце каждого
в каталоге $F95PATH. Любые определяемые вами командные строки, которым требуется каталог F95PATH.
список должен включать $ _F95INCFLAGS:

env = Environment(F95COM="my_compiler $_F95INCFLAGS -c -o $TARGET $SOURCE")

F95PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 95 в объектный файл после
первый запуск файла через препроцессор C. Любые параметры, указанные в
$ F95ФЛАГИ и $ CPPFLAGS переменные конструкции включены в эту командную строку. Ты
нужно только установить $ F95PPCOM если вам нужно использовать конкретную командную строку C-препроцессора
для файлов Fortran 95. Обычно вы должны установить $ FORTRANPPCOM переменная, которая
определяет командную строку C-препроцессора по умолчанию для всех версий Fortran.

F95PPCOMSTR
Строка, отображаемая, когда исходный файл Fortran 95 компилируется в объектный файл после
первый запуск файла через препроцессор C. Если это не установлено, то $ F95PPCOM
or $ FORTRANPPCOM (командная строка).

F95PPФАЙЛСУФФИКСЫ
Список расширений файлов, для которых проходит компиляция + препроцессор по F95
будет использоваться диалект. По умолчанию здесь пусто

Файл
Функция, которая преобразует строку в экземпляр File относительно целевого объекта.
встроенный.

Функция, которая преобразует строку в экземпляр File относительно целевого объекта.
встроенный.

ФОРТРАН
Компилятор Fortran по умолчанию для всех версий Fortran.

ФОРТРАНКОМ
Командная строка, используемая для компиляции исходного файла Fortran в объектный файл. По умолчанию,
любые параметры, указанные в $ FORTRANFLAGS, $ CPPFLAGS, $ _CPPDEFFLAGS,
$ _FORTRANMODFLAGи $ _FORTRANINCFLAGS переменные конструкции включены в это
командная строка.

ФОРТРАНКОМСТР
Строка, отображаемая при компиляции исходного файла Fortran в объектный файл. Если это
не установлен, то $ FORTRANCOM (командная строка).

ФОТРАНСФИЛЬНЫЕСУФФИКСЫ
Список расширений файлов, для которых будет использоваться диалект FORTRAN. По умолчанию,
это ['.f', '.for', '.ftn']

ФОРТРАФЛАГИ
Общие определяемые пользователем параметры, которые передаются компилятору Fortran. Обратите внимание, что это
переменная делает содержать -I (или аналогичные) включают или модульные параметры пути поиска, которые
scons генерируется автоматически из $ФОРТРАНПУТ. Посмотреть $ _FORTRANINCFLAGS и
$ _FORTRANMODFLAG, ниже, для переменных, которые расширяют эти параметры.

_FORTRANINCFLAGS
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran.
параметры командной строки для указания каталогов, в которых нужно искать включаемые файлы и
файлы модулей. Значение $ _FORTRANINCFLAGS создается путем добавления/добавления
$ INCPREFIX и $ INCSUFFIX к началу и концу каждого каталога в $ФОРТРАНПУТ.

ФОРТРАНМОДДИР
Расположение каталога, в котором компилятор Fortran должен размещать любые файлы модулей.
генерирует. Эта переменная по умолчанию пуста. Некоторые компиляторы Фортрана внутренне
также добавьте этот каталог в путь поиска для файлов модулей.

ФОРТРАНМОДДИПРРЕФИКС
Префикс, используемый для указания каталога модуля в командной строке компилятора Fortran.
Это будет добавлено к началу каталога в $ FORTRANMODDIR
строительные переменные, когда $ _FORTRANMODFLAG переменные генерируются автоматически.

ФОРТРАНМОДДИРСУФФИКС
Суффикс, используемый для указания каталога модуля в командной строке компилятора Fortran.
Это будет добавлено к началу каталога в $ FORTRANMODDIR
строительные переменные, когда $ _FORTRANMODFLAG переменные генерируются автоматически.

_FORTRANMODFLAG
Автоматически сгенерированная конструкторская переменная, содержащая компилятор Fortran.
параметр командной строки для указания расположения каталога, в котором находится компилятор Fortran.
должны размещать любые файлы модулей, которые генерируются во время компиляции. То
Значение $ _FORTRANMODFLAG создается путем добавления/добавления $ FORTRANMODDIRPREFIX и
$ FORTRANMODDIRSUFFIX в начало и конец каталога в $ FORTRANMODDIR.

ФОРТРАНМОДПРЕФИКС
Префикс файла модуля, используемый компилятором Fortran. SCons предполагает, что Fortran
компилятор следует квазистандартному соглашению об именах для файлов модулей
имя_модуля.mod. В результате эта переменная по умолчанию остается пустой. Для ситуаций
в котором компилятор не обязательно следует обычному соглашению, пользователь может
используйте эту переменную. Его значение будет добавлено к имени файла каждого модуля в виде scons.
пытается разрешить зависимости.

ФОРТРАНМОДСУФФИКС
Суффикс файла модуля, используемый компилятором Fortran. SCons предполагает, что Fortran
компилятор следует квазистандартному соглашению об именах для файлов модулей
имя_модуля.mod. В результате эта переменная по умолчанию имеет значение «.mod». За
ситуации, в которых компилятор не обязательно следует обычному соглашению,
пользователь может использовать эту переменную. Его значение будет добавлено к каждому имени файла модуля.
поскольку scons пытается разрешить зависимости.

ФОРТРАНПУТ
Список каталогов, в которых компилятор Фортрана будет искать включаемые файлы и
(для некоторых компиляторов) файлы модулей. Сканер неявных зависимостей Fortran будет искать
эти каталоги для включаемых файлов (но не для файлов модулей, поскольку они генерируются автоматически
и, как таковой, может фактически не существовать во время сканирования). Не
явно поместите аргументы каталога включения в FORTRANFLAGS, потому что результат будет
непереносимый, и сканер зависимостей не будет искать каталоги. Примечание:
имена каталогов в FORTRANPATH будут искать относительно каталога SConscript
когда они используются в команде. Чтобы заставить scons искать каталог относительно
корень исходного дерева используйте #:

env = Окружающая среда (FORTRANPATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = Окружающая среда (FORTRANPATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _FORTRANINCFLAGS строительная переменная, которая строится путем добавления значений
$ INCPREFIX и $ INCSUFFIX строительные переменные в начало и конец
каждый каталог в $ФОРТРАНПУТ. Любые определяемые вами командные строки, для которых требуется FORTRANPATH
список каталогов должен включать $ _FORTRANINCFLAGS:

env = Environment(FORTRANCOM="my_compiler $_FORTRANINCFLAGS -c -o $TARGET $SOURCE")

ФОРТРАНППКОМ
Командная строка, используемая для компиляции исходного файла Fortran в объектный файл после первого
прогон файла через препроцессор C. По умолчанию все параметры, указанные в
$ FORTRANFLAGS, $ CPPFLAGS, $ _CPPDEFFLAGS, $ _FORTRANMODFLAGи $ _FORTRANINCFLAGS
переменные конструкции включены в эту командную строку.

ФОРТРАНППКОМСТР
Строка, отображаемая, когда исходный файл Fortran компилируется в объектный файл после
первый запуск файла через препроцессор C. Если это не установлено, то
$ FORTRANPPCOM (командная строка).

СУФФИКСЫ ФАЙЛОВ FORTRANPP
Список расширений файлов, для которых проходит компиляция + препроцессор для FORTRAN
будет использоваться диалект. По умолчанию это ['.fpp', '.FPP']

ТРАНСУФФИКСЫ
Список суффиксов файлов, которые будут проверены на наличие неявных зависимостей Fortran
(INCLUDE строки и операторы USE). Список по умолчанию:

[.f", ".F", ".for", ".FOR", ".ftn", ".FTN", ".fpp", ".FPP",
".f77", ".F77", ".f90", ".F90", ".f95", ".F95"]

РАМКАПУТЬ
В Mac OS X с gcc — список, содержащий пути для поиска фреймворков. Использован
компилятор для поиска включений в стиле фреймворка, таких как #include . Использован
компоновщик для поиска указанных пользователем фреймворков при компоновке (см. РАМКИ). Для
пример:

env.AppendUnique(FRAMEWORKPATH='#myframeworkdir')

добавлю

... -Fmyframeworkdir

в командные строки компилятора и компоновщика.

_КАДР ПУТЬ
В Mac OS X с gcc автоматически сгенерированная конструктивная переменная, содержащая
параметры командной строки компоновщика, соответствующие $ FRAMEWORKPATH.

ПРЕФИКС ПУТИ FRAMEWORKPATH
В Mac OS X с gcc — префикс, используемый для записей FRAMEWORKPATH. (видеть
$ FRAMEWORKPATH). Значение по умолчанию - -F.

ПРЕФИКС РАМКИ
В Mac OS X с gcc префикс, используемый для связывания в фреймворках (см.
РАМКИ). Значение по умолчанию - -фреймворк.

_КАДРАМЫ
В Mac OS X с gcc автоматически сгенерированная конструктивная переменная, содержащая
Параметры командной строки компоновщика для связывания с FRAMEWORKS.

РАМКИ
В Mac OS X с gcc список имен фреймворков, которые нужно связать с программой или
общая библиотека или пакет. Значение по умолчанию — пустой список. Например:

env.AppendUnique(FRAMEWORKS=Split('System Cocoa SystemConfiguration'))

РАМКИFLAGS
В Mac OS X с gcc общие параметры фреймворка, предоставляемые пользователем, добавляются в конце.
командной строки, создающей загружаемый модуль. (Это было в значительной степени заменено
$ FRAMEWORKPATH, $ FRAMEWORKPATHPREFIX, $FRAMEWORKPREFIX и РАМКИ переменные
описано выше.)

GS
Программа Ghostscript, используемая, например, для преобразования файлов PostScript в PDF.

Высшая школа связи
Полная командная строка Ghostscript, используемая для процесса преобразования. Его значение по умолчанию
это «$GS $GSFLAGS -sOutputFile=$TARGET $SOURCES».

ГСКОМСТР
Строка, отображаемая при вызове Ghostscript для процесса преобразования. Если это
не установлено (по умолчанию), то $ GSCOM (командная строка).

ГСФЛАГИ
Общие параметры, передаваемые программе Ghostscript при преобразовании PostScript в PDF
файлы например. Его значение по умолчанию: «-dNOPAUSE -dBATCH -sDEVICE=pdfwrite».

ХОСТ_АРХ
Имя аппаратной архитектуры хоста, используемой для создания среды. Если
платформа указана при создании Среды, то логика этой Платформы будет
обрабатывать установку этого значения. Это значение является неизменным и не должно изменяться
пользователя после инициализации среды. В настоящее время установлено только для Win32.

Задает архитектуру хоста для компилятора Visual Studio. Если не установлено, по умолчанию
обнаруженная архитектура хоста: обратите внимание, что это может зависеть от используемого вами Python.
Эта переменная должна быть передана в качестве аргумента конструктору Environment(); параметр
позже это не имеет никакого эффекта.

Допустимые значения такие же, как для $TARGET_ARCH.

В настоящее время используется только в Windows, но в будущем будет использоваться и в других
операционки тоже.

ХОСТ_ОС
Имя операционной системы хоста, используемой для создания среды. Если платформа
указанный при создании Среды, то логика этой Платформы будет обрабатывать
установка этого значения. Это значение является неизменным и не должно изменяться пользователем.
после инициализации среды. В настоящее время установлено только для Win32.

IDLСУФФИКСЫ
Список суффиксов файлов, которые будут проверены на наличие неявных зависимостей IDL
(#include или импортировать строки). Список по умолчанию:

[.idl", ".IDL"]

IMPLIBNOVERSIONSIMLINKS
Используется для переопределения $SHLIBNOVERSIONSYMLINKS/$ LDMODULENOVERSIONSYMLINKS при создании
версионная библиотека импорта для общей библиотеки/загружаемого модуля. Если не определено, то
$SHLIBNOVERSIONSYMLINKS/$ LDMODULENOVERSIONSYMLINKS используется, чтобы определить, следует ли
отключить генерацию символических ссылок или нет.

ИМПЛИБПРЕФИКС
Префикс, используемый для имен библиотек импорта. Например, cygwin использует библиотеки импорта.
(libfoo.dll.a) в паре с динамическими библиотеками (cygfoo.dll). Компоновщик Cyglink устанавливает
$ IMPLIBPREFIX к 'lib' и $ SHLIBPREFIX на «киг».

ИМПЛИБСУФФИКС
Суффикс, используемый для имен импортируемых библиотек. Например, cygwin использует библиотеки импорта.
(libfoo.dll.a) в паре с динамическими библиотеками (cygfoo.dll). Компоновщик Cyglink устанавливает
$ IMPLIBSUFFIX в '.dll.a' и $ SHLIBSUFFIX в «.dll».

ИМПЛИБВЕРСИЯ
Используется для переопределения $ШЛИБВЕРСИЯ/$ LDMODULEVERSION при создании версионного импорта
библиотека для общей библиотеки/загружаемого модуля. Если не определено, то
$ШЛИБВЕРСИЯ/$ LDMODULEVERSION используется для определения версии версионного импорта
библиотека.

IMPLICIT_COMMAND_DEPENDENCIES
Определяет, будут ли SCons добавлять неявные зависимости для выполняемых команд.
для построения целей.

По умолчанию SCons добавит к каждой цели неявную зависимость от команды
представлен первым аргументом в любой командной строке, которую он выполняет. Конкретный файл
поскольку зависимость находится путем поиска PATH переменная в ENV используемая среда
выполнить команду.

Если конструктивная переменная $IMPLICIT_COMMAND_DEPENDENCIES установлено ложное значение
(None, False, 0 и т. д.), то неявная зависимость не будет добавлена ​​к таргетам
построенный с этой строительной средой.

env = Окружающая среда (IMPLICIT_COMMAND_DEPENDENCIES = 0)

INCPREFIX
Префикс, используемый для указания каталога включения в командной строке компилятора C. Этот
будет добавлен к началу каждого каталога в $CPPPATH и $ФОРТРАНПУТ
строительные переменные, когда $ _CPPINCFLAGS и $ _FORTRANINCFLAGS переменные
генерируется автоматически.

ИНКСУФФИКС
Суффикс, используемый для указания каталога включения в командной строке компилятора C. Этот
будет добавлен в конец каждого каталога в $CPPPATH и $ФОРТРАНПУТ
строительные переменные, когда $ _CPPINCFLAGS и $ _FORTRANINCFLAGS переменные
генерируется автоматически.

УСТАНОВИТЬ
Функция, которая вызывается для установки файла в целевое имя файла. По умолчанию
функция копирует файл в место назначения (и устанавливает режим файла назначения
и биты разрешения для соответствия исходному файлу). Функция принимает следующее
аргументы:

def install(dest, source, env):

Dest это путь к файлу назначения. источник это путь к источнику
. окр среда построения (словарь значений построения) в
принудительно для установки этого файла.

УСТАНОВКАСТР
Строка, отображаемая при установке файла в целевое имя файла. То
по умолчанию:

Файл установки: "$SOURCE" как "$TARGET"

INTEL_C_COMPILER_VERSION
Установите с помощью инструмента «intelc» основной номер версии выбранного компилятора Intel C.
для использования.

JAR-
Инструмент архивации Java.

Инструмент архивации Java.

ДЖАРЧДИР
Каталог, в который должен перейти инструмент архивирования Java (используя -C опция).

Каталог, в который должен перейти инструмент архивирования Java (используя -C опция).

ДЖАРКОМ
Командная строка, используемая для вызова инструмента архивации Java.

Командная строка, используемая для вызова инструмента архивации Java.

ЖАРКОМСТР
Строка, отображаемая при вызове инструмента архивирования Java. Если это не установлено, то
$ JARCOM (командная строка).

env = Environment(JARCOMSTR = "JARchiving $SOURCES в $TARGET")

Строка, отображаемая при вызове инструмента архивирования Java. Если это не установлено, то
$ JARCOM (командная строка).

env = Environment(JARCOMSTR = "JARchiving $SOURCES в $TARGET")

ДЖАРФЛАГС
Общие параметры, переданные инструменту архивирования Java. По умолчанию установлено значение cf в
создать необходимые банка .

Общие параметры, переданные инструменту архивирования Java. По умолчанию установлено значение cf в
создать необходимые банка .

ДЖАРСУФФИКС
Суффикс для архивов Java: .jar по умолчанию.

Суффикс для архивов Java: .jar по умолчанию.

JAVABOOTCLASSPATH
Указывает список каталогов, которые будут добавлены в командную строку javac с помощью
-bootclasspath вариант. Имена отдельных каталогов будут разделены
путь к операционной системе, отдельный символ (: в UNIX/Linux/POSIX, ; в Windows).

ЯВАК
Компилятор Java.

ДЖАВАККОМ
Командная строка, используемая для компиляции дерева каталогов, содержащего исходные файлы Java, для
соответствующие файлы классов Java. Любые параметры, указанные в $ JAVACFLAGS строительство
переменная включены в эту командную строку.

ЯВАККОМСТР
Строка, отображаемая при компиляции дерева каталогов исходных файлов Java в
соответствующие файлы классов Java. Если это не установлено, то $ JAVACCOM (командная строка)
отображается.

env = Environment(JAVACCOMSTR = "Компиляция файлов классов $TARGETS из $SOURCES")

ЯВАКФЛАГИ
Общие параметры, которые передаются компилятору Java.

JAVACLASSDIR
Каталог, в котором можно найти файлы классов Java. Это снято с
начало любых имен файлов Java .class, переданных компоновщику JavaH.

ПУТЬ ЯВАКЛАССА
Указывает список каталогов, в которых будет выполняться поиск файла Java .class. То
каталоги в этом списке будут добавлены в командные строки javac и javah через
- путь к классам вариант. Имена отдельных каталогов будут разделены рабочим
системный путь отдельным символом (: в UNIX/Linux/POSIX, ; в Windows).

Обратите внимание, что в настоящее время это просто добавляет указанный каталог через - путь к классам опцию.
SCons в настоящее время не выполняет поиск $ JAVACLASSPATH каталоги для зависимостей .class
файлы.

JAVACLASSСУФФИКС
Суффикс для файлов классов Java; .класс по умолчанию.

ДЖАВА
Генератор Java для заголовков C и файлов-заглушек.

ДЖАВАКОМ
Командная строка, используемая для создания заголовков C и файлов-заглушек из классов Java. Любой
параметры, указанные в $ JAVAHFLAGS строительная переменная включена в это
командная строка.

ЯВАХКОМСТР
Строка, отображаемая, когда файлы заголовков C и файлы-заглушки создаются из классов Java. Если
это не установлено, то $ JAVAHCOM (командная строка).

env = Environment(JAVAHCOMSTR = "Создание файлов заголовков/заглушек $TARGETS из $SOURCES")

ДЖАВАФЛАГС
Общие параметры передаются генератору заголовков C и файлов-заглушек для классов Java.

JAVASOURCEPATH
Указывает список каталогов, в которых будет выполняться поиск входного файла .java. То
каталоги в этом списке будут добавлены в командную строку javac через -исходный путь
вариант. Имена отдельных каталогов будут разделены именем операционной системы.
отдельный символ пути (: в UNIX/Linux/POSIX, ; в Windows).

Обратите внимание, что в настоящее время это просто добавляет указанный каталог через -исходный путь опцию.
SCons в настоящее время не выполняет поиск $ JAVASOURCEPATH каталоги для зависимости .java
файлы.

ЯВАСУФФИКС
Суффикс для файлов Java; .java по умолчанию.

ЯВАВЕРСИЯ
Указывает версию Java, используемую Java строитель. Это в настоящее время используется
чтобы выбрать одну версию компилятора Java вместо другой. Вместо этого вы должны установить это
чтобы указать версию Java, поддерживаемую вашим компилятором javac. По умолчанию 1.4.

Иногда это необходимо, поскольку Java 1.5 изменила имена создаваемых файлов.
для вложенных анонимных внутренних классов, что может привести к несоответствию с файлами, которые
Ожидается, что SCons будет сгенерирован компилятором javac. Параметр $JAVВЕРСИЯ до 1.5 (или
1.6, в зависимости от обстоятельств) может заставить SCon понять, что сборка Java 1.5 или 1.6 на самом деле
своевременно.

ЛАТЕКС
Структурированный форматировщик и наборщик LaTeX.

ЛАТЕКСКОМ
Командная строка, используемая для вызова структурированного форматирования и набора текста LaTeX.

ЛАТЕКСКОМСТР
Строка, отображаемая при вызове структурного форматирования и набора текста LaTeX. Если
это не установлено, то $ LATEXCOM (командная строка).

env = Environment(LATEXCOMSTR = "Построение $TARGET из входных данных LaTeX $SOURCES")

ЛАТЕКСФЛАГИ
Общие параметры передаются структурному форматировщику и наборщику LaTeX.

ЛАТЕКСРЕТРИИ
Максимальное количество повторных запусков LaTeX, если файл .log, сгенерированный
$ LATEXCOM указывает, что имеются неопределенные ссылки. По умолчанию попробовать
разрешить неопределенные ссылки путем повторного запуска LaTeX до трех раз.

ЛАТЕКССУФФИКСЫ
Список суффиксов файлов, которые будут проверены на наличие неявных зависимостей LaTeX
(\включить или \импортировать файлы). Список по умолчанию:

[.tex", ".ltx", ".latex"]

LDМОДУЛЬ
Компоновщик для сборки загружаемых модулей. По умолчанию это то же самое, что и $ SHLINK.

ЛДМОДУЛЕКОМ
Командная строка для сборки загружаемых модулей. В Mac OS X для этого используется $ LDMODULE,
$ LDMODULEFLAGS и $ FRAMEWORKSFLAGS переменные. В других системах это то же самое, что и
$ SHLINK.

ЛДМОДУЛКОМСТР
Строка, отображаемая при создании загружаемых модулей. Если это не установлено, то
$ LDMODULECOM (командная строка).

LDMODULEFLAGS
Общие параметры пользователя передаются компоновщику для создания загружаемых модулей.

LDMODULENOVERSIONSYMLINKS
инструктирует Загружаемый модуль билдер, чтобы автоматически не создавать символические ссылки для
версионные модули. По умолчанию $SHLIBNOVERSIONSYMLINKS

ЛДМОДУЛЕПРЕФИКС
Префикс, используемый для имен файлов загружаемых модулей. В Mac OS X это значение равно null; на другом
системы, это то же самое, что $ SHLIBPREFIX.

_LDMODULESONAME
Макрос, автоматически генерирующий SONAME загружаемого модуля на основе $TARGET,
$LDMODULEVERSION и $LDMODULESUFFIX. Использован Загружаемый модуль билдер, когда компоновщик
инструмент поддерживает SONAME (например, gnulink).

ЛДМОДУЛЕСУФФИКС
Суффикс, используемый для имен файлов загружаемых модулей. В Mac OS X это значение равно null; на другом
системах это то же самое, что и $SHLIBSUFFIX.

ЛДМОДУЛЬВЕРСИЯ
Когда эта конструкционная переменная определена, версионный загружаемый модуль создается
Загружаемый модуль строитель. Это активирует $ _LDMODULEVERSIONFLAGS и таким образом изменяет
$ LDMODULECOM при необходимости добавляет номер версии к имени библиотеки и создает
необходимые символические ссылки. $ LDMODULEVERSION версии должны существовать в одном и том же
отформатировать как $ШЛИБВЕРСИЯ.

ЛДМОДУЛЬВЕРСИЯФЛАГИ
Добавлены дополнительные флаги $ LDMODULECOM при построении версии Загружаемый модуль. Эти флаги
используются только когда $ LDMODULEVERSION установлен.

_LDMODULEVERSIONFLAGS
Этот макрос автоматически вводит дополнительные флаги в $ LDMODULECOM при строительстве
версионный Загружаемый модуль (это когда $ LDMODULEVERSION установлено).
_LDMODULEVERSIONFLAGS обычно добавляет $ SHLIBVERSIONFLAGS и некоторые дополнительные динамические
сгенерированные параметры (например, -Wl,-soname=$_LDMODULESONAME). Он не используется равниной
(неверсированные) загружаемые модули.

LEX
Генератор лексического анализатора.

ЛЕКСКОМ
Командная строка, используемая для вызова генератора лексического анализатора для генерации исходного кода.
.

ЛЕКСКОМСТР
Строка, отображаемая при генерации исходного файла с помощью лексического анализатора
генератор. Если это не установлено, то $ LEXCOM (командная строка).

env = Environment(LEXCOMSTR = "Lex'ing $TARGET from $SOURCES")

ЛЕКСФЛАГС
Общие параметры передаются генератору лексического анализатора.

_LIBDIRFLAGS
Автоматически сгенерированная переменная конструкции, содержащая командную строку компоновщика.
варианты указания каталогов для поиска библиотеки. Значение
$_LIBDIRFLAGS создается путем добавления $ LIBDIRPREFIX и $ LIBDIRSUFFIX к началу
и конец каждого каталога в $LIBPATH.

ЛИБДИПРРЕФИКС
Префикс, используемый для указания каталога библиотеки в командной строке компоновщика. Это будет
добавляться в начало каждого каталога в $LIBPATH строительная переменная
когда окно $_LIBDIRFLAGS переменная генерируется автоматически.

ЛИБДИРСУФФИКС
Суффикс, используемый для указания каталога библиотеки в командной строке компоновщика. Это будет
добавляться в конец каждого каталога в $LIBPATH строительная переменная, когда
$_LIBDIRFLAGS переменная генерируется автоматически.

ЛИБЕМИТТЕР
TODO

_LIBFLAGS
Автоматически сгенерированная переменная конструкции, содержащая командную строку компоновщика.
параметры для указания библиотек, которые будут связаны с результирующей целью. Значение
$_LIBFLAGS создается путем добавления $ LIBLINKPREFIX и $ LIBLINKSUFFIX к началу
и конец каждого имени файла в $LIBS.

ПРЕФИКС ЛИБЛИНК
Префикс, используемый для указания библиотеки для компоновки в командной строке компоновщика. Это будет
добавляется к началу каждой библиотеки в $LIBS строительная переменная, когда
$_LIBFLAGS переменная генерируется автоматически.

ЛИБЛИНКСУФФИКС
Суффикс, используемый для указания библиотеки для компоновки в командной строке компоновщика. Это будет
добавляется в конец каждой библиотеки в $LIBS строительная переменная, когда
$_LIBFLAGS переменная генерируется автоматически.

Либпуть
Список каталогов, в которых будут искать библиотеки. Неявная зависимость
сканер будет искать в этих каталогах включаемые файлы. Не включать явно
аргументы каталога в $ LINKFLAGS or $ SHLINKFLAGS потому что результат будет
непереносимый, и сканер зависимостей не будет искать каталоги. Примечание:
имена каталогов в LIBPATH будут искать относительно каталога SConscript, когда
они используются в команде. Чтобы заставить scons искать каталог относительно корня
исходного дерева используйте #:

env = Среда (LIBPATH = '#/libs')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

библиотеки = Dir('библиотеки')
env = среда (LIBPATH = библиотеки)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$_LIBDIRFLAGS строительная переменная, которая строится путем добавления значений
$ LIBDIRPREFIX и $ LIBDIRSUFFIX строительные переменные в начало и конец
каждый каталог в $LIBPATH. Любые определяемые вами командные строки, для которых требуется LIBPATH
список каталогов должен включать $_LIBDIRFLAGS:

env = Environment(LINKCOM="my_linker $_LIBDIRFLAGS $_LIBFLAGS -o $TARGET $SOURCE")

ЛИБПРЕФИКС
Префикс, используемый для (статических) имен файлов библиотек. Значение по умолчанию устанавливается для каждого
платформе (posix, win32, os2 и т. д.), но значение переопределяется отдельными инструментами
(ar, mslib, sgiar, sunar, tlib и т. д.), чтобы отразить имена библиотек, которые они
создана.

ЛИБПРЕФИКСЫ
Список всех разрешенных префиксов для имен файлов библиотек. При поиске библиотеки
зависимости, SCons будут искать файлы с этими префиксами, именем базовой библиотеки,
и суффиксы в $LIBSUFFIXES .

БИБЛИОТЕКИ
Список одной или нескольких библиотек, которые будут связаны с любыми исполняемыми программами.
созданные этой средой.

Список библиотек будет добавлен в командную строку через автоматически сгенерированный
$_LIBFLAGS конструкторская переменная, которая строится путем добавления значений
$ LIBLINKPREFIX и $ LIBLINKSUFFIX строительные переменные в начало и конец
каждое имя файла в $LIBS. Любые определяемые вами командные строки, которым требуется список библиотек LIBS.
должны включать $_LIBFLAGS:

env = Environment(LINKCOM="my_linker $_LIBDIRFLAGS $_LIBFLAGS -o $TARGET $SOURCE")

Если вы добавите объект File в $LIBS список, имя этого файла будет добавлено в
$_LIBFLAGS, и, таким образом, линия связи, как есть, без $ LIBLINKPREFIX or $ LIBLINKSUFFIX.
Например:

env.Append(LIBS=Файл('/tmp/mylib.so'))

Во всех случаях scons будут добавлять зависимости от исполняемой программы ко всем
библиотеки в этом списке.

ЛИБСУФФИКС
Суффикс, используемый для (статических) имен файлов библиотек. Значение по умолчанию устанавливается для каждого
платформе (posix, win32, os2 и т. д.), но значение переопределяется отдельными инструментами
(ar, mslib, sgiar, sunar, tlib и т. д.), чтобы отразить имена библиотек, которые они
создана.

ЛИБСУФФИКСЫ
Список всех допустимых суффиксов для имен файлов библиотек. При поиске библиотеки
зависимости, SCons будут искать файлы с префиксами, в $LIBPREFIXES список,
имя базовой библиотеки и эти суффиксы.

ЛИЦЕНЗИИ
Сокращенное название лицензии, под которой выпущен данный проект (gpl, lpgl,
бсд и др.). Видеть http://www.opensource.org/licenses/alphabetical для списка лицензий
имена.

РАЗДЕЛИТЕЛЬ ЛИНИЙ
Разделитель, используемый Подфайл и Текстовый файл строители. Это значение используется между
источников при построении цели. По умолчанию используется текущая системная строка
разделитель.

LINGUAS_FILE
Команда $ LINGUAS_FILE определяет файл(ы), содержащие список дополнительных языков, которые будут
обработано POInit, POОбновить or MO-файлы строители. Это также влияет Переведите строитель.
Если переменная содержит строку, она определяет имя файла списка. То $ LINGUAS_FILE
также может быть списком имен файлов. Если $ LINGUAS_FILE имеет значение True (или ненулевое
числовое значение), список будет считан из файла по умолчанию с именем LINGUAS.

LINK
Линкер.

ЛИНККОМ
Командная строка, используемая для связывания объектных файлов в исполняемый файл.

ЛИНККОМСТР
Строка, отображаемая, когда объектные файлы связаны с исполняемым файлом. Если это не
установить, затем $ LINKCOM (командная строка).

env = Среда (LINKCOMSTR = "Связывание $TARGET")

ССЫЛОЧНЫЕ ФЛАГИ
Общие параметры пользователя передаются компоновщику. Обратите внимание, что эта переменная должна содержать
-l (или аналогичные) опции для связи с библиотеками, перечисленными в $LIBS, ни -L (или
аналогичные) параметры пути поиска библиотеки, которые scons генерирует автоматически из $LIBPATH.
Увидеть $_LIBFLAGS выше, для переменной, которая расширяется до опций библиотечной ссылки, и
$_LIBDIRFLAGS выше, для переменной, которая расширяется до параметров пути поиска библиотеки.

M4
Препроцессор макросов M4.

М4КОМ
Командная строка, используемая для передачи файлов через препроцессор макросов M4.

М4КОМСТР
Строка, отображаемая при прохождении файла через препроцессор макросов M4. Если это
не установлен, то $ M4COM (командная строка).

M4FLAGS
Общие параметры передаются препроцессору макросов M4.

МАКИНДЕКС
Генератор makeindex для форматирования и набора текста TeX и структурированного LaTeX.
форматировщик и наборщик.

МАКИНДЕКСКОМ
Командная строка, используемая для вызова генератора makeindex для форматтера TeX и
верстальщик и структурированный форматировщик и верстальщик LaTeX.

МАКИНДЕКСКОМСТР
Строка, отображаемая при вызове генератора makeindex для форматтера TeX и
верстальщик и структурированный форматировщик и верстальщик LaTeX. Если это не установлено, то
$ MAKEINDEXCOM (командная строка).

СДЕЛАТЬИНДЕКСФЛАГИ
Общие параметры, передаваемые генератору makeindex для форматирования и набора текста TeX.
и структурированный форматировщик и наборщик LaTeX.

MAXLINELENGTH
Максимальное количество символов, разрешенное во внешней командной строке. На Win32
системы, строки ссылок длиннее этого количества символов связаны через временный файл
имя.

МИДЛ
Компилятор Microsoft IDL.

МИДЛКОМ
Командная строка, используемая для передачи файлов компилятору Microsoft IDL.

МИДЛКОМСТР
Строка, отображаемая при вызове компилятора Microsoft IDL. Если это не установлено,
тогда $ MIDLCOM (командная строка).

СРЕДНИЕ ФЛАГИ
Общие параметры передаются компилятору Microsoft IDL.

МОСУФФИКС
Суффикс, используемый для файлов MO (по умолчанию: '.mo'). См. инструмент msgfmt и MO-файлы строитель.

МСГМТ
Абсолютный путь к мсгфмт(1) двоичный файл, найденный Обнаружить(). См. инструмент msgfmt и MO-файлы
строитель.

МСГФМТКОМ
Полная командная строка для запуска мсгфмт(1) программа. См. инструмент msgfmt и MO-файлы строитель.

МСГФМТКОМСТР
Строка для отображения, когда мсгфмт(1) вызывается (по умолчанию: '', что означает ``print
$ MSGFMTCOM''). См. инструмент msgfmt и MO-файлы строитель.

МСГМТФЛАГС
Дополнительные флаги для мсгфмт(1). См. инструмент msgfmt и MO-файлы строитель.

МСГИНИТ
Путь к мсгинит(1) программа (найдена через Detect()). См. инструмент msginit и POInit строитель.

МСГИНИТКОМ
Полная командная строка для запуска мсгинит(1) программа. См. инструмент msginit и POInit строитель.

МГИНИТКОМСТР
Строка для отображения, когда мсгинит(1) вызывается (по умолчанию: '', что означает ``print
$ MSGINITCOM''). См. инструмент msginit и POInit строитель.

МССГИНИТФЛАГС
Список дополнительных флагов к мсгинит(1) (По умолчанию: []). См. инструмент msginit и POInit
строитель.

_MSGINITLOCALE
Внутренний ``макрос''. Вычисляет имя локали (языка) на основе имени целевого файла (по умолчанию:
'${TARGET.filebase}').

См. инструмент msginit и POInit строитель.

МСГМЕРГЕ
Абсолютный путь к Слияние сообщений(1) двоичный файл, найденный Обнаружить(). См. инструмент msgmerge и
POОбновить строитель.

МСГМЕРГЕКОМ
Полная командная строка для запуска Слияние сообщений(1) команда. См. инструмент msgmerge и POОбновить
строитель.

МСГМЕРГЕКОМСТР
Строка, которая будет отображаться, когда Слияние сообщений(1) вызывается (по умолчанию: '', что означает ``print
$ MSGMERGECOM''). См. инструмент msgmerge и POОбновить строитель.

МСГМЕРГЕФЛАГС
Дополнительные флаги для Слияние сообщений(1) команда. См. инструмент msgmerge и POОбновить строитель.

MSSDK_DIR
Каталог, содержащий Microsoft SDK (либо Platform SDK, либо Windows SDK), который будет
используется для компиляции.

MSSDK_VERSION
Строка версии Microsoft SDK (либо Platform SDK, либо Windows SDK), которая должна быть
используется для компиляции. Поддерживаемые версии включают 6.1, 6.0A, 6.0, 2003R2 и 2003R1.

MSVC_BATCH
Если задано любое истинное значение, указывает, что SCon должны выполнять пакетную компиляцию объекта.
файлы при вызове компилятора Microsoft Visual C/C++. Все компиляции исходников
файлы из того же исходного каталога, которые генерируют целевые файлы в одном и том же выводе
каталог и были настроены в SCons с использованием одной и той же среды построения, будут
строится одним вызовом компилятора. Только исходные файлы, которые изменились с
созданные ими объектные файлы будут передаваться при каждом вызове компилятора (через
$CHANGED_SOURCES конструктивная переменная). Любые компиляции, в которых объект (цель)
базовое имя файла (минус .obj) не совпадает с базовым именем исходного файла.
составляется отдельно.

MSVC_USE_SCRIPT
Используйте пакетный скрипт для настройки компилятора Microsoft Visual Studio.

$MSVC_USE_SCRIPT переопределения $MSVC_VERSION и $TARGET_ARCH. Если установлено имя
.bat-файл Visual Studio (например, vcvars.bat), SCons запустит этот bat-файл и извлечет
соответствующие переменные из результата (обычно %INCLUDE%, %LIB% и %PATH%).
Установка для MSVC_USE_SCRIPT значения None полностью обходит автоматическое определение Visual Studio; использовать
это если вы запускаете SCons в окне cmd Visual Studio и импортируете оболочку
переменные среды.

MSVC_VERSION
Устанавливает предпочтительную версию Microsoft Visual C/C++ для использования.

If $MSVC_VERSION не установлен, SCons (по умолчанию) выберет последнюю версию
В вашей системе установлен Visual C/C++. Если указанная версия не установлена, инструмент
инициализация завершится ошибкой. Эта переменная должна быть передана в качестве аргумента
конструктор среды(); установка его позже не имеет никакого эффекта.

Допустимые значения для Windows: 12.0, 12.0Exp, 11.0, 11.0Exp, 10.0, 10.0Exp, 9.0, 9.0Exp,
8.0, 8.0Exp, 7.1, 7.0 и 6.0. Версии, оканчивающиеся на Exp, относятся к «Экспресс» или «Экспресс».
для рабочего стола».

МСВС
Когда инструменты Microsoft Visual Studio инициализируются, они настраивают этот словарь
со следующими ключами:

Версия
используемая версия MSVS (можно установить через $ MSVS_VERSION)

ВЕРСИИ
доступные версии MSVS установлены

VCINSTALLDIR
установленный каталог Visual C++

ВСИСТАЛДИР
установленный каталог Visual Studio

FRAMEWORKDIR
установленный каталог .NET framework

РАМОЧНЫЕ ВЕРСИИ
список установленных версий .NET Framework, отсортированных от самой последней к самой старой.

РАМОЧНАЯ ВЕРСИЯ
последняя установленная версия .NET framework

РАМКИSDKDIR
установленное расположение .NET SDK.

ПЛАТФОРМSDKDIR
установленное расположение Platform SDK.

PLATFORMSDK_MODULES
словарь установленных модулей Platform SDK, где ключи словаря
ключевые слова для различных модулей, а значения представляют собой 2 кортежа, где первый
дата выпуска, а второй номер версии.

Если значение не задано, оно недоступно в реестре.

MSVS_ARCH
Задает архитектуру, для которой должны создаваться сгенерированные проекты.

Значение по умолчанию — x86. amd64 также поддерживается SCons для некоторых Visual Studio.
версии. Попытка установить $MSVS_ARCH к архитектуре, которая не поддерживается для данного
Версия Visual Studio выдаст ошибку.

MSVS_PROJECT_GUID
Строка, помещенная в сгенерированный файл проекта Microsoft Visual Studio в качестве значения
атрибут ProjectGUID. Там нет значения по умолчанию. Если он не определен, создается новый GUID.
генерируется.

MSVS_SCC_AUX_PATH
Имя пути, помещенное в сгенерированный файл проекта Microsoft Visual Studio в качестве значения
атрибута SccAuxPath, если MSVS_SCC_PROVIDER строительная переменная также
задавать. Там нет значения по умолчанию.

MSVS_SCC_CONNECTION_ROOT
Корневой путь проектов в рабочей области SCC, т. е. путь, по которому все проекты
и будут созданы файлы решения. Он используется в качестве эталонного пути, с которого
относительные пути сгенерированного проекта Microsoft Visual Studio и файлов решения
вычислено. Относительный путь к файлу проекта помещается как значение SccLocalPath.
атрибут файла проекта и как значения
SccProjectFilePathRelativizedFromConnection[i] (где [i] находится в диапазоне от 0 до числа
проектов в решении) атрибуты GlobalSection(SourceCodeControl)
раздел файла решения Microsoft Visual Studio. Аналогично относительное решение
путь к файлу помещается в виде значений SccLocalPath[i] (где [i] находится в диапазоне от 0 до
количество проектов в решении) атрибуты
Раздел GlobalSection(SourceCodeControl) файла решения Microsoft Visual Studio.
Используется только в том случае, если MSVS_SCC_PROVIDER также задана строительная переменная. То
значение по умолчанию — текущий рабочий каталог.

MSVS_SCC_PROJECT_NAME
Имя проекта, помещенное в сгенерированный файл проекта Microsoft Visual Studio в качестве
значение атрибута SccProjectName, если MSVS_SCC_PROVIDER строительная переменная
также установлен. В этом случае строка также помещается в атрибут SccProjectName0.
раздела GlobalSection(SourceCodeControl) Microsoft Visual Studio
файл решения. Там нет значения по умолчанию.

MSVS_SCC_PROVIDER
Строка, помещенная в сгенерированный файл проекта Microsoft Visual Studio в качестве значения
атрибут SccProvider. Строка также помещается в атрибут SccProvider0
раздел GlobalSection(SourceCodeControl) решения Microsoft Visual Studio
файл. Там нет значения по умолчанию.

MSVS_VERSION
Задает предпочтительную версию Microsoft Visual Studio для использования.

If $ MSVS_VERSION не установлен, SCons (по умолчанию) выберет последнюю версию
Visual Studio установлена ​​в вашей системе. Итак, если у вас версия 6 и версия 7 (MSVS
.NET), он предпочтет версию 7. Вы можете переопределить это, указав
MSVS_VERSION переменная в инициализации среды, установив для нее соответствующее
версии (например, «6.0» или «7.0»). Если указанная версия не установлена, инструмент
инициализация завершится ошибкой.

Это устарело: используйте $MSVC_VERSION вместо. Если $ MSVS_VERSION установлен и $MSVC_VERSION
не является, $MSVC_VERSION будет автоматически установлено значение $ MSVS_VERSION. Если оба настроены на
различные значения, scons вызовет ошибку.

МСВСБИЛДКОМ
Командная строка сборки помещается в сгенерированный файл проекта Microsoft Visual Studio. То
по умолчанию Visual Studio вызывает SCons с любыми указанными целями сборки.

МСВСКЛИНКОМ
Чистая командная строка помещается в сгенерированный файл проекта Microsoft Visual Studio. То
по умолчанию Visual Studio вызывает SCons с параметром -c для удаления любых
заданные цели.

МСВСЕНКОДИНГ
Строка кодировки помещается в сгенерированный файл проекта Microsoft Visual Studio. То
по умолчанию используется кодировка Windows-1252.

МСВСПРОЕКТКОМ
Действие, используемое для создания файлов проекта Microsoft Visual Studio.

МСВСПРОЕКТСУФФИКС
Суффикс, используемый для файлов проекта Microsoft Visual Studio (DSP). Значение по умолчанию
.vcproj при использовании Visual Studio версии 7.x (.NET) или более поздней версии и .dsp при
с использованием более ранних версий Visual Studio.

МСВСРЕБИЛДКОМ
Командная строка перестроения помещается в сгенерированный файл проекта Microsoft Visual Studio.
По умолчанию Visual Studio вызывает SCons с любыми указанными целями перестроения.

МСВССКОНС
SCons, используемые в сгенерированных файлах проекта Microsoft Visual Studio. По умолчанию
версия SCons, используемая для создания файла проекта.

МСВССКОНСКОМ
Команда SCons по умолчанию, используемая в сгенерированных файлах проекта Microsoft Visual Studio.

МСВССКОНСКРИПТ
Файл sconscript (то есть файл SConstruct или SConscript), который будет вызываться
Файлы проекта Visual Studio (через $ MSVSSCONSCOM Переменная). По умолчанию
тот же файл сценария, который содержит вызов МСВСпроект для создания файла проекта.

МСВССКОНСФЛАГС
Флаги SCons, используемые в сгенерированных файлах проекта Microsoft Visual Studio.

MSVSSOLUTIONCOM
Действие, используемое для создания файлов решений Microsoft Visual Studio.

MSVSSOLUTIONСУФФИКС
Суффикс, используемый для файлов решения Microsoft Visual Studio (DSW). Значение по умолчанию
.sln при использовании Visual Studio версии 7.x (.NET) и .dsw при использовании более ранних версий.
Visual Studio.

MT
Программа, используемая в системах Windows для встраивания манифестов в библиотеки DLL и EXE. Смотрите также
$WINDOWS_EMBED_MANIFEST.

МТЭКСЕКОМ
Командная строка Windows, используемая для встраивания манифестов в исполняемые файлы. Смотрите также
$MTSHLIBCOM.

МТФЛАГИ
Флаги переданы $ млн. программа встраивания манифеста (только для Windows).

МТШЛИБКОМ
Командная строка Windows, используемая для встраивания манифестов в общие библиотеки (DLL). Видеть
причислены $МТЕХЕКОМ.

MWCW_VERSION
Номер версии используемого компилятора MetroWerks CodeWarrior C.

MWCW_VERSIONS
Список установленных версий компилятора MetroWerks CodeWarrior C в этой системе.

ИМЯ
Указывает имя проекта для упаковки.

no_import_lib
Если установлено ненулевое значение, подавляет создание соответствующей статической библиотеки импорта Windows.
компоновщиком SharedLibrary при использовании с MinGW, Microsoft Visual Studio или
Метроверкс. Это также подавляет создание файла экспорта (.exp) при использовании
Microsoft Visual Studio.

ОБЖПРЕФИКС
Префикс, используемый для имен (статических) объектных файлов.

СУФФИКС ОБЪЕКТА
Суффикс, используемый для имен (статических) объектных файлов.

P4
Исполняемый файл Perforce.

P4COM
Командная строка, используемая для загрузки исходных файлов из Perforce.

P4COMSTR
Строка, отображаемая при получении исходного файла из Perforce. Если это не установлено,
тогда $ P4COM (командная строка).

P4FLAGS
Общие параметры, которые передаются в Perforce.

ПАКЕТРУТ
Указывает каталог, в который будут помещены все файлы результирующего архива, если
применимый. Значение по умолчанию: "$NAME-$VERSION".

ТИП УПАКОВКИ
Выбирает тип пакета для сборки. На данный момент доступны:

* msi — установщик Microsoft * rpm — диспетчер пакетов Redhat * ipkg — пакет Itsy
Система управления * tarbz2 - сжатый tar * targz - сжатый tar * zip - zip файл
* src_tarbz2 - сжатый исходный файл tar * src_targz - сжатый исходный файл tar * src_zip -
источник zip-файла

Это можно переопределить с помощью параметра командной строки "package_type".

ВЕРСИЯ ПАКЕТА
Версия пакета (не базового проекта). В настоящее время используется только
упаковщиком rpm и должен отражать изменения в упаковке, а не в основном
сам код проекта.

PCH
Предварительно скомпилированный заголовок Microsoft Visual C++, который будет использоваться при компиляции объекта.
файлы. Эта переменная игнорируется другими инструментами, кроме Microsoft Visual C++. Когда это
переменная определена. SCons добавит параметры в командную строку компилятора, чтобы заставить ее
использовать предварительно скомпилированный заголовок, а также установит зависимости для файла PCH.
Пример:

env['PCH'] = 'StdAfx.pch'

ПЧКОМ
Командная строка, используемая PCH билдер для создания предварительно скомпилированного заголовка.

ПЧКОМСТР
Строка, отображаемая при создании предварительно скомпилированного заголовка. Если это не установлено, то
$ PCHCOM (командная строка).

ПЧПДБФЛАГС
Конструктивная переменная, которая при расширении добавляет флаг /yD в командную строку.
только если $ PDB установлена ​​строительная переменная.

ПЧСТОП
Эта переменная указывает, какая часть исходного файла предварительно скомпилирована. Эта переменная
игнорируется инструментами, отличными от Microsoft Visual C++, или когда переменная PCH не
использовался. Когда эта переменная определена, она должна быть строкой, которая является именем
заголовок, включенный в конец предварительно скомпилированной части исходных файлов, или
пустая строка, если используется конструкция "#pragma hrdstop":

env['PCHSTOP'] = 'StdAfx.h'

PDB
PDB-файл Microsoft Visual C++, в котором будет храниться отладочная информация для объекта.
файлы, общие библиотеки и программы. Эта переменная игнорируется другими инструментами, кроме
Microsoft Visual С++. Когда эта переменная определена, SCons добавит параметры в
командная строка компилятора и компоновщика, чтобы заставить их генерировать внешнюю отладку
информацию, а также установит зависимости для файла PDB. Пример:

env['PDB'] = 'привет.pdb'

Переключатель компилятора Visual C++, который SCons использует по умолчанию для создания информации PDB.
is / Z7. Это работает правильно с параллельным (-j) строится, потому что в него встроены отладочные
информация в промежуточных объектных файлах, в отличие от совместного использования одного файла PDB
между несколькими объектными файлами. Это также единственный способ получить отладочную информацию.
встроен в статическую библиотеку. С помощью / Zi вместо этого может улучшить время соединения
производительность, хотя параллельные сборки больше не будут работать. Вы можете создавать файлы PDB
с / Zi переключиться, переопределив значение по умолчанию $ CCPDBFLAGS Переменная; см. запись для
эту переменную для конкретных примеров.

ПДФКОМ
Устаревший синоним слова $ DVIPDFCOM.

PDFLATEX
Утилита pdflatex.

PDFLATEXCOM
Командная строка, используемая для вызова утилиты pdflatex.

PDFLATEXCOMSTR
Строка, отображаемая при вызове утилиты pdflatex. Если это не установлено, то
$ PDFLATEXCOM (командная строка).

env = Environment(PDFLATEX;COMSTR = "Построение $TARGET из входных данных LaTeX $SOURCES")

PDFLATEXFLAGS
Общие параметры, переданные утилите pdflatex.

PDFПРЕФИКС
Префикс, используемый для имен файлов PDF.

PDFСУФФИКС
Суффикс, используемый для имен файлов PDF.

ПДФТЕКС
Утилита pdftex.

PDFTEXCOM
Командная строка, используемая для вызова утилиты pdftex.

PDFTEXCOMSTR
Строка, отображаемая при вызове утилиты pdftex. Если это не установлено, то
$ PDFTEXCOM (командная строка).

env = Environment(PDFTEXCOMSTR = "Построение $TARGET из входных данных TeX $SOURCES")

PDFTEXFLAGS
Общие параметры, переданные утилите pdftex.

ПКГЧК
В системах Solaris программа проверки пакетов, которая будет использоваться (вместе с
$PKGINFO) для поиска установленных версий компилятора Sun PRO C++. По умолчанию
/usr/sbin/pgkchk.

ПКГИНФО
В системах Solaris программа информации о пакете, которая будет использоваться (вместе с
$ПКГЧК) для поиска установленных версий компилятора Sun PRO C++. По умолчанию
информация о пакете.

ПЛАТФОРМА
Имя платформы, используемой для создания среды. Если платформа не указана
при создании среды scons автоматически определяет платформу.

env = Среда (инструменты = [])
если env['ПЛАТФОРМА'] == 'cygwin':
Инструмент('mingw')(env)
еще:
Инструмент('msvc')(env)

ПОАВТОИНИТ
Команда $ POAUTOINIT переменная, если установлено значение True (для ненулевого числового значения), пусть msginit
инструмент для автоматической инициализации отсутствующий PO-файлы с мсгинит(1), Это относится к
обе, POInit и POОбновить строители (и другие, которые используют любой из них).

POCREATE_ALIAS
Общий псевдоним для всех файлов PO, созданных с помощью POInit строитель (по умолчанию: 'po-create'). Видеть
инструмент msginit и POInit строитель.

ПОСУФФИКС
Суффикс, используемый для файлов PO (по умолчанию: '.po'). См. инструмент msginit и POInit строитель.

ПОТДОМЕН
Команда $ POTDOMAIN определяет домен по умолчанию, используемый для генерации имени файла POT как $ POTDOMAIN.горшок
когда имя файла POT не указано пользователем. Это относится к POUpdate, POInit и
POОбновить строители (и строители, которые их используют, например Переведите). Обычно (если
$ POTDOMAIN не определено), разработчики используют messages.pot в качестве имени файла POT по умолчанию.

ПОТСУФФИКС
Суффикс, используемый для файлов шаблонов заказов на поставку (по умолчанию: '.pot'). См. инструмент xgettext и POUpdate
строитель.

POTUPDATE_ALIAS
Имя общей фальшивой цели для всех шаблонов заказов на поставку, созданных с помощью POОбновить (дефолт:
«горшок-обновление»). См. инструмент xgettext и POUpdate строитель.

POUPDATE_ALIAS
Общий псевдоним для всех файлов PO, определяемых с помощью POОбновить строитель (по умолчанию:
«по-обновление»). См. инструмент msgmerge и POОбновить строитель.

PRINT_CMD_LINE_FUNC
Функция Python, используемая для печати командных строк по мере их выполнения (при условии, что
печать команд не отключена -q or -s варианты или их эквиваленты). То
функция должна принимать четыре аргумента: s, выполняемая команда (строка), цель,
создаваемая цель (узел файла, список или имя строки), источник, источники)
используется (узел файла, список или имя строки) и окр, используемая среда.

Функция должна сама выполнять печать. Реализация по умолчанию, используемая, если это
переменная не задана или имеет значение None, это:

def print_cmd_line(s, target, source, env):
sys.stdout.write(s + "\n")

Вот пример более интересной функции:

def print_cmd_line(s, target, source, env):
sys.stdout.write("Здание %s -> %s...\n" %
(' и '.join([str(x) для x в исходном коде]),
' и '.join([str(x) для x в цели])))
env = среда (PRINT_CMD_LINE_FUNC = print_cmd_line)
env.Program ('foo', 'foo.c')

Это просто печатает «Строительство имя цели от имя источника..." вместо фактического
команды. Такая функция может также регистрировать фактические команды в файле журнала, для
пример.

ПРОГЕМИТТЕР
TODO

ПРОГПРЕФИКС
Префикс, используемый для имен исполняемых файлов.

ПРОГСУФФИКС
Суффикс, используемый для имен исполняемых файлов.

ПСКОМ
Командная строка, используемая для преобразования файлов TeX DVI в файл PostScript.

ПСКОМСТР
Строка, отображаемая при преобразовании файла TeX DVI в файл PostScript. Если это
не установлен, то $ PSCOM (командная строка).

ПРЕФИКС
Префикс, используемый для имен файлов PostScript.

PSСУФФИКС
Префикс, используемый для имен файлов PostScript.

QT_АВТОСКАНИРОВАНИЕ
Отключите сканирование мобильных файлов. Используйте Moc Builder для явного указания файлов
для запуска moc.

QT_BINPATH
Путь, по которому установлены двоичные файлы qt. Значение по умолчанию: '$ QTDIR/ бен'.

QT_CPPPATH
Путь, по которому установлены заголовочные файлы qt. Значение по умолчанию
'$ QTDIR/включать'. Примечание. Если вы установите для этой переменной значение «Нет», инструмент не изменит
$CPPPATH строительная переменная.

QT_DEBUG
Выводит много отладочной информации при сканировании moc-файлов.

QT_LIB
Значение по умолчанию — «qt». Вы можете установить это на «qt-mt». Примечание. Если вы установите это
значение None, инструмент не изменит $LIBS Переменная.

QT_LIBPATH
Путь, по которому установлены библиотеки qt. Значение по умолчанию: '$ QTDIR/ Lib'.
Примечание. Если вы установите для этой переменной значение «Нет», инструмент не изменит $LIBPATH
строительная переменная.

QT_MOC
Значение по умолчанию: '$ QT_BINPATH/ мок'.

QT_MOCCXXPREFIX
Значение по умолчанию — ''. Префикс для выходных файлов moc, если источником является файл cxx.

QT_MOCCXXSUFFIX
Значение по умолчанию — «.moc». Суффикс для выходных файлов moc, если источником является файл cxx.

QT_MOCFROMCXXCOM
Команда для создания файла moc из файла cpp.

QT_MOCFROMCXXCOMSTR
Строка, отображаемая при создании файла moc из файла cpp. Если это не установлено,
тогда $ QT_MOCFROMCXXCOM (командная строка).

QT_MOCFROMCXXFLAGS
Значение по умолчанию — «-i». Эти флаги передаются в moc при имитации файла C++.

QT_MOCFROMHCOM
Команда для создания moc-файла из заголовка.

QT_MOCFROMHCOMSTR
Строка, отображаемая при создании файла moc из файла cpp. Если это не установлено,
тогда $ QT_MOCFROMHCOM (командная строка).

QT_MOCFROMHFLAGS
Значение по умолчанию — ''. Эти флаги передаются moc при имитации файла заголовка.

QT_MOCHPREFIX
Значение по умолчанию — «moc_». Префикс для выходных файлов moc, когда источником является заголовок.

QT_MOCHSUFFIX
Значение по умолчанию: '$ CXXFILESUFFIX'. Суффикс для выходных файлов moc, когда источником является
заголовка.

QT_UIC
Значение по умолчанию: '$ QT_BINPATH/uic'.

QT_UICCOM
Команда для создания файлов заголовков из файлов .ui.

QT_UICCOMSTR
Строка, отображаемая при создании файлов заголовков из файлов .ui. Если это не установлено,
тогда $ QT_UICCOM (командная строка).

QT_UICDECLFLAGS
Значение по умолчанию — ''. Эти флаги передаются в uic при создании файла aah из
.ui-файл.

QT_UICDECLPPREFIX
Значение по умолчанию — ''. Префикс для файлов заголовков, сгенерированных uic.

QT_UICDECLSUFFIX
Значение по умолчанию — «.h». Суффикс для файлов заголовков, сгенерированных uic.

QT_UICIMPLFLAGS
Значение по умолчанию — ''. Эти флаги передаются в uic при создании файла cxx из
.ui-файл.

QT_UICIMPLPREFIX
Значение по умолчанию — «uic_». Префикс для файлов реализации, сгенерированных uic.

QT_UICIMPLSUFFIX
Значение по умолчанию: '$ CXXFILESUFFIX'. Суффикс для файлов реализации, сгенерированных uic.

QT_UISUFFIX
Значение по умолчанию — «.ui». Суффикс входных файлов дизайнера.

QTDIR
Инструмент qt пытается взять это из os.environ. Он также инициализирует все QT_*
конструктивные переменные, перечисленные ниже. (Обратите внимание, что все пути построены с
метод os.path.join() python, но они перечислены здесь с разделителем '/' для упрощения
чтения.) Кроме того, переменные среды построения $CPPPATH, $LIBPATH и
$LIBS могут быть изменены, а переменные $ПРОГЕМИТТЕР, $SHLIBEMITTER и $LIBEMITTER
модифицированы. Поскольку при использовании этого инструмента производительность сборки снижается, у вас есть
чтобы явно указать его при создании среды:

Окружающая среда (инструменты = ['по умолчанию', 'qt'])

Инструмент qt поддерживает следующие операции:

Автоматический мок файл поколение от заголовок файлы. Вам не нужно указывать файлы moc
явно, инструмент делает это за вас. Однако для этого есть несколько предпосылок:
Ваш заголовочный файл должен иметь ту же файловую базу, что и файл реализации, и должен оставаться
в том же каталоге. Он должен иметь один из суффиксов .h, .hpp, .H, .hxx, .hh. Ты
можно отключить автоматическую генерацию файла moc, установив для QT_AUTOSCAN значение 0. См. также
соответствующий Мок() метод построителя.

Автоматический мок файл поколение от CXX файлы. Как указано в документации qt,
включите файл moc в конец файла cxx. Обратите внимание, что вы должны включить
файл, созданный преобразованием
${QT_MOCCXXPREFIX} ${QT_MOCCXXSUFFIX}, по умолчанию .мок. Предупреждение
создается после создания moc-файла, если вы не включили правильный файл. Если
вы используете VariantDir, вам может потребоваться указать дубликат = 1. Вы можете отключить
автоматическая генерация файла moc путем установки QT_AUTOSCAN в 0. См. также соответствующий
Мок Строительный метод.

Автоматический обращение of .ui файлы. Файлы реализации, сгенерированные из файлов .ui
обрабатываются почти так же, как файлы yacc или lex. Каждый файл .ui, указанный в качестве источника
Программа, библиотека или общая библиотека будут генерировать три файла: файл декларации,
файл реализации и файл moc. Поскольку есть также сгенерированные заголовки, вы можете
необходимо указать дубликат = 1 в вызовах VariantDir. См. также соответствующий УИК
Строительный метод.

РАНЛИБ
Индексатор архива.

РАНЛИБКОМ
Командная строка, используемая для индексации архива статической библиотеки.

РАНЛИБКОМСТР
Строка, отображаемая при индексации архива статической библиотеки. Если это не установлено,
тогда $ RANLIBCOM (командная строка).

env = Environment(RANLIBCOMSTR = "Индексирование $TARGET")

РАНЛИБФЛАГС
Общие параметры передаются индексатору архива.

RC
Компилятор ресурсов, используемый для создания файла ресурсов Microsoft Visual C++.

РККОМ
Командная строка, используемая для создания файла ресурсов Microsoft Visual C++.

РЦКОМСТР
Строка, отображаемая при вызове компилятора ресурсов для создания Microsoft Visual.
Файл ресурсов С++. Если это не установлено, то $ RCCOM (командная строка).

РЦФЛАГИ
Флаги, переданные компилятору ресурсов компоновщиком RES.

РЦИНКФЛАГС
Автоматически сгенерированная переменная конструкции, содержащая параметры командной строки.
для указания каталогов для поиска компилятором ресурсов. Значение
$ RCINCFLAGS создается путем добавления $ RCINCPREFIX и $ RCINCSUFFIX к началу и
конец каждого каталога в $CPPPATH.

RCINCPREFIX
Префикс (флаг), используемый для указания каталога включения в компиляторе ресурсов.
командная строка. Это будет добавлено к началу каждого каталога в $CPPPATH
строительная переменная, когда $ RCINCFLAGS переменная расширяется.

RCINCSUFFIX
Суффикс, используемый для указания каталога включения в командной строке компилятора ресурсов.
Это будет добавлено в конец каждого каталога в $CPPPATH строительство
переменная, когда $ RCINCFLAGS переменная расширяется.

RCS
Исполняемый файл RCS. Обратите внимание, что эта переменная на самом деле не используется для команды
получить исходные файлы из RCS; см. $ RCS_CO строительная переменная, ниже.

RCS_CO
Исполняемый файл RCS «checkout», используемый для извлечения исходных файлов из RCS.

RCS_COCOM
Командная строка, используемая для извлечения (извлечения) исходных файлов из RCS.

RCS_COCOMSTR
Строка, отображаемая при получении исходного файла из RCS. Если это не установлено, то
$ RCS_COCOM (командная строка).

RCS_COFLAGS
Параметры, которые передаются $ RCS_CO команда.

РДирс
Функция, которая преобразует строку в список экземпляров Dir путем поиска
Хранилища.

РЕГСВР
Программа, используемая в системах Windows для регистрации вновь созданной библиотеки DLL всякий раз, когда
Общая библиотека builder передается аргумент ключевого слова register=1.

РЕГСВРКОМ
Командная строка, используемая в системах Windows для регистрации недавно созданной библиотеки DLL.
всякий раз, когда Общая библиотека builder передается аргумент ключевого слова register=1.

РЕГСВРКОМСТР
Строка, отображаемая при регистрации вновь созданного файла DLL. Если это не установлено, то
$ REGSVRCOM (командная строка).

РЕГСВРФЛАГС
Флаги, передаваемые программе регистрации DLL в системах Windows, когда вновь созданная DLL
библиотека зарегистрирована. По умолчанию это включает в себя /s что предотвращает диалоговые окна
от всплывающих и требующих внимания пользователя.

РМИЦ
Компилятор-заглушка Java RMI.

РМИККОМ
Командная строка, используемая для компиляции файлов классов-заглушек и скелетов из классов Java, которые
содержат реализации RMI. Любые параметры, указанные в $ RMICFLAGS строительство
переменная включены в эту командную строку.

РМИККОМСТР
Строка, отображаемая при компиляции файлов классов-заглушек и скелетов из классов Java.
которые содержат реализации RMI. Если это не установлено, то $ RMICCOM (командная строка)
отображается.

env = Environment(RMICCOMSTR = "Создание файлов классов-заглушек/каркасов $TARGETS из $SOURCES")

РМИФЛАГИ
Общие параметры передаются компилятору-заглушке Java RMI.

_RPATH
Автоматически сгенерированная конструктивная переменная, содержащая используемые флаги rpath.
при компоновке программы с разделяемыми библиотеками. Значение $ _RPATH создается
добавление $ RPATHPREFIX и $ RPATHSUFFIX к началу и концу каждого каталога в
$RPATH.

РПУТЬ
Список путей для поиска разделяемых библиотек при запуске программ. В настоящее время только
используется в компоновщиках GNU (gnulink), IRIX (sgilink) и Sun (sunlink). Игнорируется
платформы и наборы инструментов, которые его не поддерживают. Обратите внимание, что пути, добавленные в RPATH,
никак не преобразуется scons: если вам нужен абсолютный путь, вы должны сделать его
абсолютизировать себя.

РПУТЬПРРЕФИКС
Префикс, используемый для указания каталога для поиска разделяемых библиотек при
запущенные программы. Это будет добавлено к началу каждого каталога в
$RPATH строительная переменная, когда $ _RPATH переменная генерируется автоматически.

РПУТСУФФИКС
Суффикс, используемый для указания каталога для поиска разделяемых библиотек при
запущенные программы. Это будет добавлено в конец каждого каталога в $RPATH
строительная переменная, когда $ _RPATH переменная генерируется автоматически.

РПЦГЕН
Компилятор протокола RPC.

RPCGENCLIENTFLAGS
Параметры, передаваемые компилятору протокола RPC при создании заглушек на стороне клиента. Эти
являются дополнением к любым флагам, указанным в $ RPCGENFLAGS строительная переменная.

РПЦГЕНФЛАГС
Общие параметры передаются компилятору протокола RPC.

RPCGENHEADERFLAGS
Параметры, передаваемые компилятору протокола RPC при создании файла заголовка. Эти
в дополнение к любым флагам, указанным в $ RPCGENFLAGS строительная переменная.

НПЦГЕНСЕРВИСФЛАГС
Параметры, передаваемые компилятору протокола RPC при создании заглушек на стороне сервера. Эти
являются дополнением к любым флагам, указанным в $ RPCGENFLAGS строительная переменная.

РПКГЕНКСДРФЛАГС
Параметры, передаваемые компилятору протокола RPC при создании подпрограмм XDR. Это в
в дополнение к любым флагам, указанным в $ RPCGENFLAGS строительная переменная.

СКАНЕРЫ
Список доступных сканеров неявных зависимостей. Могут быть добавлены новые файловые сканеры
путем добавления к этому списку, хотя более гибкий подход состоит в том, чтобы связать
сканеры с определенным билдером. См. разделы «Объекты конструктора» и «Сканер».
Объекты», ниже, для получения дополнительной информации.

СККС
Исполняемый файл SCCS.

СККСКОМ
Командная строка, используемая для получения исходных файлов из SCCS.

SCCSCOMSTR
Строка, отображаемая при извлечении исходного файла из репозитория CVS. Если это не
установить, затем $ SCCSCOM (командная строка).

SCCSFЛАГИ
Общие параметры, которые передаются в SCCS.

SCCSGETFLAGS
Параметры, которые передаются специально для подкоманды SCCS "get". Это можно установить,
например, чтобы -e для извлечения редактируемых файлов из SCCS.

SCONS_HOME
Путь (необязательный) к каталогу библиотеки SCons, инициализированный из внешнего
Окружающая среда. Если установлено, это используется для создания более короткого и более эффективного поиска.
путь в $ MSVSSCONS командная строка, выполняемая из проекта Microsoft Visual Studio
файлы.

SHCC
Компилятор C, используемый для создания объектов общей библиотеки.

SHCCCOM
Командная строка, используемая для компиляции исходного файла C в объектный файл общей библиотеки. Любой
параметры, указанные в $ SHCFLAGS, $ SHCCFLAGS и $ CPPFLAGS переменные конструкции
включены в эту командную строку.

ШКККОМСТР
Строка, отображаемая при компиляции исходного файла C в общий объектный файл. Если это
не установлен, то $ SHCCCOM (командная строка).

env = Environment(SHCCCOMSTR = "Компиляция общего объекта $TARGET")

SHCCFЛАГС
Параметры, которые передаются компиляторам C и C++ для создания объектов общей библиотеки.

ШКФЛАГИ
Параметры, которые передаются компилятору C (только; не C++) для создания общей библиотеки.
объекты.

SHXXX
Компилятор C++, используемый для создания объектов общей библиотеки.

SHCXXCOM
Командная строка, используемая для компиляции исходного файла C++ в объектный файл общей библиотеки.
Любые параметры, указанные в $ SHCXXFLAGS и $ CPPFLAGS строительные переменные
включены в эту командную строку.

SHCXXCOMSTR
Строка, отображаемая при компиляции исходного файла C++ в общий объектный файл. Если
это не установлено, то $ SHCXXCOM (командная строка).

env = Environment(SHCXXCOMSTR = "Компиляция общего объекта $TARGET")

SHCXXFLAGS
Параметры, которые передаются компилятору C++ для создания объектов общей библиотеки.

ШДК
ШДК.

ШДКОМ
ШДКОМ.

ШДЛИНК
ШДЛИНК.

ШДЛИНККОМ
ШДЛИНККОМ.

ШДЛИНКФЛАГС
ШДЛИНКФЛАГС.

SHELL
Строка с именем программы оболочки, которая будет передана в $СПАВН функция. Увидеть
$СПАВН строительная переменная для получения дополнительной информации.

СВЧ03
Компилятор Fortran 03, используемый для создания объектов общей библиотеки. Вам следует
обычно устанавливают $ ШФОРТРАН переменная, которая указывает компилятор Fortran по умолчанию для
все версии Фортрана. Вам нужно только установить 03 долларов США если вам нужно использовать конкретный
компилятор или версия компилятора для файлов Fortran 03.

SHF03COM
Командная строка, используемая для компиляции исходного файла Fortran 03 в объект общей библиотеки.
файл. Вам нужно только установить $ SHF03COM если вам нужно использовать определенную командную строку для
Файлы Фортран 03. Обычно вы должны установить $ SHFORTRANCOM переменная, которая указывает
командная строка по умолчанию для всех версий Fortran.

SHF03COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 03 в разделяемую библиотеку.
объектный файл. Если это не установлено, то $ SHF03COM or $ SHFORTRANCOM (командная строка) есть
отображается.

SHF03ФЛАГИ
Параметры, которые передаются компилятору Fortran 03 для создания общей библиотеки.
объекты. Вам нужно только установить $ SHF03FLAGS если вам нужно определить конкретные параметры пользователя
для файлов Fortran 03. Обычно вы должны установить $ SHFORTRANFLAGS переменная, которая
указывает указанные пользователем параметры, передаваемые компилятору Fortran по умолчанию для всех
Фортран версии.

SHF03PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 03 в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHF03FLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линия. Вам нужно только установить $ SHF03PPCOM если вам нужно использовать определенный C-препроцессор
командная строка для файлов Fortran 03. Обычно вы должны установить $ SHFORTRANPPCOM
переменная, которая определяет командную строку C-препроцессора по умолчанию для всех файлов Fortran.
версий.

SHF03PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 03 в разделяемую библиотеку.
объектный файл после первого запуска файла через препроцессор C. Если это не
установить, затем $ SHF03PPCOM or $ SHFORTRANPPCOM (командная строка).

СВЧ08
Компилятор Fortran 08, используемый для создания объектов общей библиотеки. Вам следует
обычно устанавливают $ ШФОРТРАН переменная, которая указывает компилятор Fortran по умолчанию для
все версии Фортрана. Вам нужно только установить 08 долларов США если вам нужно использовать конкретный
компилятор или версия компилятора для файлов Fortran 08.

SHF08COM
Командная строка, используемая для компиляции исходного файла Fortran 08 в объект общей библиотеки.
файл. Вам нужно только установить $ SHF08COM если вам нужно использовать определенную командную строку для
Файлы Фортран 08. Обычно вы должны установить $ SHFORTRANCOM переменная, которая указывает
командная строка по умолчанию для всех версий Fortran.

SHF08COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 08 в разделяемую библиотеку.
объектный файл. Если это не установлено, то $ SHF08COM or $ SHFORTRANCOM (командная строка) есть
отображается.

SHF08ФЛАГИ
Параметры, которые передаются компилятору Fortran 08 для создания общей библиотеки.
объекты. Вам нужно только установить $ SHF08FLAGS если вам нужно определить конкретные параметры пользователя
для файлов Fortran 08. Обычно вы должны установить $ SHFORTRANFLAGS переменная, которая
указывает указанные пользователем параметры, передаваемые компилятору Fortran по умолчанию для всех
Фортран версии.

SHF08PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 08 в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHF08FLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линия. Вам нужно только установить $ SHF08PPCOM если вам нужно использовать определенный C-препроцессор
командная строка для файлов Fortran 08. Обычно вы должны установить $ SHFORTRANPPCOM
переменная, которая определяет командную строку C-препроцессора по умолчанию для всех файлов Fortran.
версий.

SHF08PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 08 в разделяемую библиотеку.
объектный файл после первого запуска файла через препроцессор C. Если это не
установить, затем $ SHF08PPCOM or $ SHFORTRANPPCOM (командная строка).

СВЧ77
Компилятор Fortran 77, используемый для создания объектов общей библиотеки. Вам следует
обычно устанавливают $ ШФОРТРАН переменная, которая указывает компилятор Fortran по умолчанию для
все версии Фортрана. Вам нужно только установить 77 долларов США если вам нужно использовать конкретный
компилятор или версия компилятора для файлов Fortran 77.

SHF77COM
Командная строка, используемая для компиляции исходного файла Fortran 77 в объект общей библиотеки.
файл. Вам нужно только установить $ SHF77COM если вам нужно использовать определенную командную строку для
Файлы Фортран 77. Обычно вы должны установить $ SHFORTRANCOM переменная, которая указывает
командная строка по умолчанию для всех версий Fortran.

SHF77COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 77 в разделяемую библиотеку.
объектный файл. Если это не установлено, то $ SHF77COM or $ SHFORTRANCOM (командная строка) есть
отображается.

SHF77ФЛАГИ
Параметры, которые передаются компилятору Fortran 77 для создания общей библиотеки.
объекты. Вам нужно только установить $ SHF77FLAGS если вам нужно определить конкретные параметры пользователя
для файлов Fortran 77. Обычно вы должны установить $ SHFORTRANFLAGS переменная, которая
указывает указанные пользователем параметры, передаваемые компилятору Fortran по умолчанию для всех
Фортран версии.

SHF77PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 77 в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHF77FLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линия. Вам нужно только установить $ SHF77PPCOM если вам нужно использовать определенный C-препроцессор
командная строка для файлов Fortran 77. Обычно вы должны установить $ SHFORTRANPPCOM
переменная, которая определяет командную строку C-препроцессора по умолчанию для всех файлов Fortran.
версий.

SHF77PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 77 в разделяемую библиотеку.
объектный файл после первого запуска файла через препроцессор C. Если это не
установить, затем $ SHF77PPCOM or $ SHFORTRANPPCOM (командная строка).

СВЧ90
Компилятор Fortran 90, используемый для создания объектов общей библиотеки. Вам следует
обычно устанавливают $ ШФОРТРАН переменная, которая указывает компилятор Fortran по умолчанию для
все версии Фортрана. Вам нужно только установить 90 долларов США если вам нужно использовать конкретный
компилятор или версия компилятора для файлов Fortran 90.

SHF90COM
Командная строка, используемая для компиляции исходного файла Fortran 90 в объект общей библиотеки.
файл. Вам нужно только установить $ SHF90COM если вам нужно использовать определенную командную строку для
Файлы Фортран 90. Обычно вы должны установить $ SHFORTRANCOM переменная, которая указывает
командная строка по умолчанию для всех версий Fortran.

SHF90COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 90 в разделяемую библиотеку.
объектный файл. Если это не установлено, то $ SHF90COM or $ SHFORTRANCOM (командная строка) есть
отображается.

SHF90ФЛАГИ
Параметры, которые передаются компилятору Fortran 90 для создания общей библиотеки.
объекты. Вам нужно только установить $ SHF90FLAGS если вам нужно определить конкретные параметры пользователя
для файлов Fortran 90. Обычно вы должны установить $ SHFORTRANFLAGS переменная, которая
указывает указанные пользователем параметры, передаваемые компилятору Fortran по умолчанию для всех
Фортран версии.

SHF90PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 90 в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHF90FLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линия. Вам нужно только установить $ SHF90PPCOM если вам нужно использовать определенный C-препроцессор
командная строка для файлов Fortran 90. Обычно вы должны установить $ SHFORTRANPPCOM
переменная, которая определяет командную строку C-препроцессора по умолчанию для всех файлов Fortran.
версий.

SHF90PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 90 в разделяемую библиотеку.
объектный файл после первого запуска файла через препроцессор C. Если это не
установить, затем $ SHF90PPCOM or $ SHFORTRANPPCOM (командная строка).

СВЧ95
Компилятор Fortran 95, используемый для создания объектов общей библиотеки. Вам следует
обычно устанавливают $ ШФОРТРАН переменная, которая указывает компилятор Fortran по умолчанию для
все версии Фортрана. Вам нужно только установить 95 долларов США если вам нужно использовать конкретный
компилятор или версия компилятора для файлов Fortran 95.

SHF95COM
Командная строка, используемая для компиляции исходного файла Fortran 95 в объект общей библиотеки.
файл. Вам нужно только установить $ SHF95COM если вам нужно использовать определенную командную строку для
Файлы Фортран 95. Обычно вы должны установить $ SHFORTRANCOM переменная, которая указывает
командная строка по умолчанию для всех версий Fortran.

SHF95COMSTR
Строка, отображаемая при компиляции исходного файла Fortran 95 в разделяемую библиотеку.
объектный файл. Если это не установлено, то $ SHF95COM or $ SHFORTRANCOM (командная строка) есть
отображается.

SHF95ФЛАГИ
Параметры, которые передаются компилятору Fortran 95 для создания общей библиотеки.
объекты. Вам нужно только установить $ SHF95FLAGS если вам нужно определить конкретные параметры пользователя
для файлов Fortran 95. Обычно вы должны установить $ SHFORTRANFLAGS переменная, которая
указывает указанные пользователем параметры, передаваемые компилятору Fortran по умолчанию для всех
Фортран версии.

SHF95PPCOM
Командная строка, используемая для компиляции исходного файла Fortran 95 в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHF95FLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линия. Вам нужно только установить $ SHF95PPCOM если вам нужно использовать определенный C-препроцессор
командная строка для файлов Fortran 95. Обычно вы должны установить $ SHFORTRANPPCOM
переменная, которая определяет командную строку C-препроцессора по умолчанию для всех файлов Fortran.
версий.

SHF95PPCOMSTR
Строка, отображаемая при компиляции исходного файла Fortran 95 в разделяемую библиотеку.
объектный файл после первого запуска файла через препроцессор C. Если это не
установить, затем $ SHF95PPCOM or $ SHFORTRANPPCOM (командная строка).

ШФОРТРАН
Компилятор Fortran по умолчанию, используемый для создания объектов общей библиотеки.

ШФОРТРАНКОМ
Командная строка, используемая для компиляции исходного файла Fortran в объект общей библиотеки.
.

ШФОРТРАНКОМСТР
Строка, отображаемая при компиляции исходного файла Fortran в объект общей библиотеки.
файл. Если это не установлено, то $ SHFORTRANCOM (командная строка).

ШФОРТРАФЛАГИ
Параметры, которые передаются компилятору Fortran для создания объектов общей библиотеки.

ШФОРТРАНППКОМ
Командная строка, используемая для компиляции исходного файла Fortran в объектный файл общей библиотеки.
после первого запуска файла через препроцессор C. Любые параметры, указанные в
$ SHFORTRANFLAGS и $ CPPFLAGS переменные конструкции включены в эту команду
линии.

ШФОРТРАНППКОМСТР
Строка, отображаемая при компиляции исходного файла Fortran в объект общей библиотеки.
файл после первого запуска файла через препроцессор C. Если это не установлено, то
$ SHFORTRANPPCOM (командная строка).

ШЛИБЕМИТТЕР
TODO

ШЛИБНОВЕРСИИСИМВОЛКИ
инструктирует Общая библиотека билдер, чтобы не создавать символические ссылки для версионных общих
библиотеки.

ШЛИБПРЕФИКС
Префикс, используемый для имен файлов общей библиотеки.

_SHLIBSONAME
Макрос, который автоматически генерирует SONAME разделяемой библиотеки на основе $TARGET,
$SHLIBVERSION и $SHLIBSUFFIX. Использован Общая библиотека билдер, когда инструмент компоновщика
поддерживает SONAME (например, gnulink).

ШЛИБСУФФИКС
Суффикс, используемый для имен файлов общей библиотеки.

ШЛИБВЕРСИЯ
Когда эта конструкционная переменная определена, версионная разделяемая библиотека создается
Общая библиотека строитель. Это активирует $ _SHLIBVERSIONFLAGS и таким образом изменяет
$ SHLINKCOM при необходимости добавляет номер версии к имени библиотеки и создает
необходимые символические ссылки. $ШЛИБВЕРСИЯ версии должны существовать как буквенно-цифровые,
десятичные значения с разделителями, определенные регулярным выражением "\w+[\.\w+]*". Пример
$ШЛИБВЕРСИЯ значения включают «1», «1.2.3» и «1.2.gitaa412c8b».

_SHLIBVERSIONFLAGS
Этот макрос автоматически вводит дополнительные флаги в $ SHLINKCOM при построении версии
Общая библиотека (это когда $ШЛИБВЕРСИЯ установлен). _SHLIBVERSIONFLAGS обычно добавляет
$ SHLIBVERSIONFLAGS и некоторые дополнительные динамически генерируемые параметры (такие как
-Wl,-soname=$_SHLIBSONAME. Он не используется «обычными» (неверсионными) разделяемыми библиотеками.

ШЛИБВЕРСИЯФЛАГИ
Добавлены дополнительные флаги $ SHLINKCOM при построении версии Общая библиотека. Эти флаги
используется только тогда, когда $ШЛИБВЕРСИЯ установлен.

ШЛИНК
Компоновщик для программ, использующих разделяемые библиотеки.

ШЛИНККОМ
Командная строка, используемая для компоновки программ с использованием общих библиотек.

ШЛИНККОМСТР
Строка, отображаемая при компоновке программ, использующих разделяемые библиотеки. Если это не
установить, затем $ SHLINKCOM (командная строка).

env = Environment(SHLINKCOMSTR = "Связывание общего доступа $TARGET")

ШЛИНКФЛАГС
Общие пользовательские параметры, передаваемые компоновщику для программ, использующих разделяемые библиотеки. Примечание
что эта переменная должна содержать -l (или аналогичные) варианты связи с
библиотеки, перечисленные в $LIBS, ни -L (или аналогичные) включают параметры пути поиска,
генерируется автоматически из $LIBPATH. Посмотреть $_LIBFLAGS выше, для переменной, которая
расширяется до параметров ссылки на библиотеку и $_LIBDIRFLAGS выше, для переменной, которая
расширяется до параметров пути поиска библиотеки.

ШОБДЖПРЕФИКС
Префикс, используемый для имен файлов общих объектов.

ШОБЖСУФФИКС
Суффикс, используемый для имен файлов общих объектов.

СОНАМ
Переменная, используемая для жесткого кодирования SONAME для версионной общей библиотеки/загружаемого модуля.

env.SharedLibrary('test', 'test.c', SHLIBVERSION='0.1.2', SONAME='libtest.so.2')

Переменная используется, например, компоновщиком gnulink.

ИСТОЧНИК
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

ИСТОЧНИК_URL
URL-адрес (веб-адрес) местоположения, из которого был получен проект. Это
используется для заполнения поля Источник: в управляющей информации для Ipkg и RPM
пакеты.

ИСТОЧНИКИ
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

ПОРОЖДАТЬ
Функция интерпретатора команд, которая будет вызываться для выполнения строк командной строки.
Функция должна ожидать следующие аргументы:

def spawn(shell, escape, cmd, args, env):

sh это строка с именем используемой программы-оболочки. бежать это функция, которая может быть
вызывается для экранирования специальных символов оболочки в командной строке. CMD это путь к
команда для выполнения. арг это аргументы команды. окр это словарь
переменные окружения, в которых должна выполняться команда.

STATIC_AND_SHARED_OBJECTS_ARE_THE_SAME
Когда эта переменная имеет значение true, предполагается, что статические объекты и общие объекты являются основными.
такой же; то есть SCons не проверяет связывание статических объектов с общей библиотекой.

SUBST_DICT
Словарь, которым пользовался Подфайл or Текстовый файл построители для замещающих значений. Это
может быть чем угодно, приемлемым для конструктора dict(), поэтому в дополнение к словарю
также допустимы списки кортежей.

ПРЕФИКС ПОДФАЙЛА
Префикс, используемый для Подфайл имена файлов, нулевая строка по умолчанию.

СУФФИКС ПОДФАЙЛА
Суффикс, используемый для Подфайл имена файлов, нулевая строка по умолчанию.

РЕЗЮМЕ
Краткое содержание проекта. Это используется для заполнения Резюме:
поле в управляющей информации для пакетов Ipkg и RPM, а также в качестве
Описание: поле в пакетах MSI.

Сковорода
Оболочка языка сценариев и генератор интерфейса.

SWIGCFILESUFFIX
Суффикс, который будет использоваться для промежуточных исходных файлов C, созданных
оболочка языка сценариев и генератор интерфейса. Значение по умолчанию
_сворачивать$ CFILESUFFIX. По умолчанию это значение используется всякий раз, когда -c ++ опция
указывается как часть $ SWIGFLAGS строительная переменная.

СВИГКОМ
Командная строка, используемая для вызова оболочки языка сценариев и генератора интерфейса.

СВИГКОМСТР
Строка, отображаемая при вызове оболочки и интерфейса языка сценариев.
генератор. Если это не установлено, то $ SWIGCOM (командная строка).

SWIGCXXFILESUFFIX
Суффикс, который будет использоваться для промежуточных исходных файлов C++, сгенерированных
оболочка языка сценариев и генератор интерфейса. Значение по умолчанию
_сворачивать$ CFILESUFFIX. По умолчанию это значение используется всякий раз, когда указан параметр -c++.
указывается как часть $ SWIGFLAGS строительная переменная.

SWIGDIRECTORСУФФИКС
Суффикс, который будет использоваться для промежуточных заголовочных файлов C++, созданных
оболочка языка сценариев и генератор интерфейса. Они создаются только для C++
код, когда функция SWIG «режиссеры» включена. Значение по умолчанию — _wrap.h.

СВИГФЛАГС
Общие параметры передаются оболочке языка сценариев и генератору интерфейса. Этот
где вы должны установить -питон, -perl5, -tcl, или любые другие параметры, которые вы хотите
указать SWIG. Если вы установите -c ++ option в этой переменной, scons по умолчанию
создать промежуточный исходный файл C++ с расширением, указанным в качестве
$ CXXFILESUFFIX Переменная.

_SWIGINCFLAGS
Автоматически сгенерированная конструктивная переменная, содержащая командную строку SWIG.
параметры для указания каталогов для поиска включенных файлов. Значение
$ _SWIGINCFLAGS создается путем добавления $ SWIGINCPREFIX и $ SWIGINCSUFFIX до
начало и конец каждого каталога в $ SWIGPATH.

СВИГИНКПРЕФИКС
Префикс, используемый для указания включаемого каталога в командной строке SWIG. Это будет
добавляется к началу каждого каталога в $ SWIGPATH строительная переменная
когда окно $ _SWIGINCFLAGS переменная генерируется автоматически.

SWIGINCSUFFIX
Суффикс, используемый для указания включаемого каталога в командной строке SWIG. Это будет
добавляется в конец каждого каталога в $ SWIGPATH строительная переменная, когда
$ _SWIGINCFLAGS переменная генерируется автоматически.

СВИГУТДИР
Указывает выходной каталог, в котором находятся оболочка языка сценариев и интерфейс.
генератор должен размещать сгенерированные файлы для конкретного языка. Это будет использоваться SCons
для идентификации файлов, которые будут сгенерированы вызовом swig и переведены в
swig -outdir в командной строке.

СВИГПУТЬ
Список каталогов, которые генерируются оболочкой языка сценариев и интерфейсом.
будет искать включенные файлы. Сканер неявных зависимостей SWIG будет искать эти
каталоги для включаемых файлов. Значение по умолчанию — пустой список.

Не помещайте явно аргументы каталога включения в SWIGFLAGS; результат будет
непереносимый, и сканер зависимостей не будет искать каталоги. Примечание:
имена каталогов в SWIGPATH будут искать относительно каталога SConscript
когда они используются в команде. Чтобы заставить scons искать каталог относительно
корень исходного дерева используйте #:

env = Среда (SWIIGPATH = '#/include')

Поиск в каталоге также может быть принудительно выполнен с помощью Вы() функция:

включить = Dir('включить')
env = Окружающая среда (SWIGPATH = включить)

Список каталогов будет добавлен в командную строку через автоматически сгенерированный
$ _SWIGINCFLAGS строительная переменная, которая строится путем добавления значений
$ SWIGINCPREFIX и $ SWIGINCSUFFIX переменные построения в начало и конец
каждого каталога в $ SWIGPATH. Любые определяемые вами командные строки, для которых требуется SWIGPATH
список каталогов должен включать $ _SWIGINCFLAGS:

env = Среда (SWIGCOM="my_swig -o $TARGET $_SWIGINCFLAGS $SOURCES")

ПОВОРОТНАЯ ВЕРСИЯ
Номер версии инструмента SWIG.

TAR
Архиватор tar.

ТАРКОМ
Командная строка, используемая для вызова архиватора tar.

ТАРКОМСТР
Строка, отображаемая при архивировании файлов с помощью архиватора tar. Если это не установлено,
тогда $ TARCOM (командная строка).

env = Environment(TARCOMSTR = "Архивация $TARGET")

ТАРФЛАГИ
Общие параметры переданы архиватору tar.

TARGET
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

TARGET_ARCH
Имя целевой аппаратной архитектуры для скомпилированных объектов, созданных этим
Окружающая среда. По умолчанию это значение HOST_ARCH, и пользователь может переопределить его.
В настоящее время установлено только для Win32.

Устанавливает целевую архитектуру для компилятора Visual Studio (т.е. архив двоичных файлов
генерируется компилятором). Если не установлено, по умолчанию $HOST_ARCH, или, если это не установлено,
к архитектуре ОС работающей машины (обратите внимание, что сборка python или
архитектура не влияет). Эта переменная должна быть передана в качестве аргумента
конструктор среды(); установка его позже не имеет никакого эффекта. В настоящее время используется только
на Windows, но в будущем он будет использоваться и на других ОС.

Допустимые значения для Windows: x86, i386 (для 32-разрядной версии); amd64, emt64, x86_64 (для 64
биты); и ia64 (Итаниум). Например, если вы хотите скомпилировать 64-битные двоичные файлы, вам
установит TARGET_ARCH='x86_64' в вашей среде SCons.

TARGET_OS
Имя целевой операционной системы для скомпилированных объектов, созданных этим
Окружающая среда. По умолчанию это значение HOST_OS, и пользователь может переопределить его.
В настоящее время установлено только для Win32.

ЦЕЛЕВЫЕ
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

ТАРСУФФИКС
Суффикс, используемый для имен файлов tar.

ТЕМПФИЛПРЕФИКС
Префикс временного файла, используемый для выполнения строк длиннее $MAXLINELENGTH.
по умолчанию '@'. Это может быть установлено для цепочек инструментов, которые используют другие значения, например '-@' для
компилятор diab или «-via» для инструментальной цепочки ARM.

TEX
Средство форматирования и набора текста TeX.

ТЕКСКОМ
Командная строка, используемая для вызова модуля форматирования и набора текста TeX.

ТЕКСКОМСТР
Строка, отображаемая при вызове средства форматирования и набора текста TeX. Если это не
установить, затем $ TEXCOM (командная строка).

env = Environment(TEXCOMSTR = "Построение $TARGET из входных данных TeX $SOURCES")

ТЕКСФЛАГС
Общие параметры передаются форматировщику и наборщику TeX.

ТЕКСИНПУТЫ
Список каталогов, которые программа LaTeX будет искать, включая каталоги.
Сканер неявных зависимостей LaTeX будет искать в этих каталогах \include и
\импортировать файлы.

ПРЕФИКС ТЕКСТФАЙЛА
Префикс, используемый для Текстовый файл имена файлов, нулевая строка по умолчанию.

СУФФИКС ТЕКСТОВОГО ФАЙЛА
Суффикс, используемый для Текстовый файл имена файлов; .txt по умолчанию.

ИНСТРУМЕНТЫ
Список названий спецификаций Инструмента, которые являются частью этой конструкции.
окружающей среды.

НЕИЗМЕНЕННЫЕ_ИСТОЧНИКИ
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

UNCHANGED_TARGETS
Зарезервированное имя переменной, которое нельзя задавать или использовать в среде конструирования.
(См. «Подстановка переменных» ниже.)

ПОСТАВЩИК
Лицо или организация, которые поставляют упакованное программное обеспечение. Это используется для заполнения
поле Поставщик: в контролирующей информации для пакетов RPM, а поле
Производитель: поле в управляющей информации для пакетов MSI.

Версия
Версия проекта в виде строки.

WIN32_INSERT_DEF
Устаревший синоним слова $ WINDOWS_INSERT_DEF.

WIN32ДЕФПРЕФИКС
Устаревший синоним слова $ WINDOWSDEFPREFIX.

WIN32ДЕФСУФФИКС
Устаревший синоним слова $ WINDOWSDEFSUFFIX.

ВИН32ЭКСПРЕФИКС
Устаревший синоним слова $ WINDOWSEXPSUFFIX.

WIN32EXPSСУФФИКС
Устаревший синоним слова $ WINDOWSEXPSUFFIX.

WINDOWS_EMBED_MANIFEST
Установите для этой переменной значение True или 1, чтобы внедрить созданный компилятором манифест (обычно
${TARGET}.manifest) во все исполняемые файлы Windows и библиотеки DLL, созданные в этой среде, в качестве
ресурс на этапе их ссылки. Это делается с помощью $ млн. и $МТЕХЕКОМ и $MTSHLIBCOM.

WINDOWS_INSERT_DEF
Если для этого параметра установлено значение true, сборка общей библиотеки Windows (файл .dll) будет
также одновременно создайте соответствующий файл .def, если файл .def еще не создан.
указан в качестве цели сборки. Значение по умолчанию — 0 (не создавать файл .def).

WINDOWS_INSERT_MANIFEST
Если для этого параметра установлено значение true, scons будет знать о файлах .manifest, созданных
MicrosoftVisua С/С++ 8.

WINDOWSDEPREFIX
Префикс, используемый для имен файлов Windows .def.

ВИНДОДЕФСУФФИКС
Суффикс, используемый для имен файлов Windows .def.

ВИНДОВСЭКППРЕФИКС
Префикс, используемый для имен файлов Windows .exp.

WINDOWSEXPСУФФИКС
Суффикс, используемый для имен файлов Windows .exp.

ПРЕФИКС WINDOWSPROGMANIFEST
Префикс, используемый для файлов исполняемой программы .manifest, созданных Microsoft Visual.
С/С++.

WINDOWSPROGMANIFESTSUFFIX
Суффикс, используемый для файлов исполняемой программы .manifest, созданных Microsoft Visual.
С/С++.

WINDOWSSHIBMANIFESTPREFIX
Префикс, используемый для файлов общей библиотеки .manifest, созданных Microsoft Visual.
С/С++.

WINDOWSSHIBMANIFESTSUFFIX
Суффикс, используемый для файлов общей библиотеки .manifest, созданных Microsoft Visual.
С/С++.

X_IPK_DEPENDS
Это используется для заполнения поля Зависит: в управляющей информации для Ipkg.
пакеты.

X_IPK_DESCRIPTION
Это используется для заполнения поля «Описание:» в управляющей информации для Ipkg.
пакеты. Значение по умолчанию: $SUMMARY\n$DESCRIPTION.

X_IPK_MAINTAINER
Это используется для заполнения поля «Сопровождающий:» в управляющей информации для Ipkg.
пакеты.

X_IPK_PRIORITY
Это используется для заполнения поля «Приоритет:» в управляющей информации для Ipkg.
пакеты.

X_IPK_SECTION
Это используется для заполнения поля Раздел: в управляющей информации для Ipkg.
пакеты.

X_MSI_LANGUAGE
Это используется для заполнения атрибута Language: в контрольной информации для MSI.
пакеты.

X_MSI_LICENSE_TEXT
Текст лицензии на программное обеспечение в формате RTF. Символы возврата каретки будут
заменен эквивалентом RTF \\par.

X_MSI_UPGRADE_CODE
TODO

X_RPM_AUTOREQPROV
Это используется для заполнения поля AutoReqProv: в файле RPM .spec.

X_RPM_BUILD
внутренний, но переопределяемый

X_RPM_BUILDREQUIRES
Это используется для заполнения поля BuildRequires: в файле RPM .spec.

X_RPM_BUILDROOT
внутренний, но переопределяемый

X_RPM_CLEAN
внутренний, но переопределяемый

X_RPM_CONFLICTS
Это используется для заполнения поля Conflicts: в файле RPM .spec.

X_RPM_DEFATTR
Это значение используется в качестве атрибутов по умолчанию для файлов в пакете RPM.
значение по умолчанию (-, корень, корень).

X_RPM_DISPRIBUTION
Это используется для заполнения поля Distribution: в файле RPM .spec.

X_RPM_EPOCH
Это используется для заполнения поля Epoch: в управляющей информации для RPM.
пакеты.

X_RPM_EXCLUDEARCH
Это используется для заполнения поля ExcludeArch: в файле RPM .spec.

X_RPM_EXLUSIVEARCH
Это используется для заполнения поля ExclusiveArch: в файле RPM .spec.

X_RPM_GROUP
Это используется для заполнения поля Group: в файле RPM .spec.

X_RPM_GROUP_язык
Это используется для заполнения поля Group(lang): в файле RPM .spec. Обратите внимание, что Ланг
не является буквальным и должен быть заменен соответствующим кодом языка.

X_RPM_ICON
Это используется для заполнения поля Icon: в файле RPM .spec.

X_RPM_INSTALL
внутренний, но переопределяемый

X_RPM_PACKAGER
Это используется для заполнения поля Packager: в файле RPM .spec.

X_RPM_POSTINSTALL
Это используется для заполнения раздела %post: в файле RPM .spec.

X_RPM_POSTUNINSTALL
Это используется для заполнения раздела %postun: в файле RPM .spec.

X_RPM_PREFIX
Это используется для заполнения поля Prefix: в файле RPM .spec.

X_RPM_PREINSTALL
Это используется для заполнения раздела %pre: в файле RPM .spec.

X_RPM_PREP
внутренний, но переопределяемый

X_RPM_PREUNINSTALL
Это используется для заполнения раздела %preun: в файле RPM .spec.

X_RPM_PROVIDES
Это используется для заполнения поля «Предоставляет:» в файле RPM .spec.

X_RPM_REQUIRES
Это используется для заполнения поля Requires: в файле RPM .spec.

X_RPM_SERIAL
Это используется для заполнения поля Serial: в файле RPM .spec.

X_RPM_URL
Это используется для заполнения поля Url: в файле RPM .spec.

XGETTEXT
Путь к xgettext(1) программа (найдена через Обнаружить()). См. инструмент xgettext и POUpdate
строитель.

XGETTEXTCOM
Заполните командную строку xgettext. См. инструмент xgettext и POUpdate строитель.

XGETTEXTCOMSTR
Строка, которая отображается, когда xgettext(1) вызывается команда (по умолчанию: '', что означает
"Распечатать $ XGETTEXTCOM"). См. инструмент xgettext и POUpdate строитель.

_XGETTEXTDOMAIN
Внутреннее «макро». Генерирует xgettext источник и цель формы доменного имени (по умолчанию:
'${TARGET.filebase}').

XGETTEXTFLAGS
Дополнительные флаги для xgettext(1). См. инструмент xgettext и POUpdate строитель.

XGETTEXTFROM
Имя файла, содержащего список xgettext(1)исходные файлы . Пользователи Autotools это знают
как POTFILES.in, поэтому в большинстве случаев здесь устанавливается XGETTEXTFROM="POTFILES.in".
$ XGETTEXTFROM файлы имеют тот же синтаксис и семантику, что и хорошо известный GNU POTFILES.in.
См. инструмент xgettext и POUpdate строитель.

_XGETTEXTFROMFLAGS
Внутреннее «макро». Генерирует список -D флаги из $ XGETTEXTPATH .

XGETTEXTFROMPREFIX
Этот флаг используется для добавления одного $ XGETTEXTFROM файл в xgettext(1)командная строка
(по умолчанию: '-f').

XGETTEXTFROMSUFFIX
(дефолт: '')

XGETTEXTPATH
Список каталогов, там xgettext(1) будет искать исходные файлы (по умолчанию: []).

Внимание
Эта переменная работает только вместе с $ XGETTEXTFROM
См. также инструмент xgettext и POUpdate строитель.

_XGETTEXTPATHFLAGS
Внутреннее «макро». Генерирует список -f флаги из $ XGETTEXTFROM.

XGETTEXTPATPREFIX
Этот флаг используется для добавления единого пути поиска в xgettext(1)командная строка (по умолчанию:
«-Д»).

XGETTEXTPATTHSUFFIX
(дефолт: '')

ЯАКК
Генератор парсеров.

ЯКККОМ
Командная строка, используемая для вызова генератора парсера для создания исходного файла.

ЯКККОМСТР
Строка, отображаемая при создании исходного файла с помощью генератора парсера. Если это
не установлен, то $ YACCCOM (командная строка).

env = Environment(YACCCOMSTR = "Yacc'ing $TARGET from $SOURCES")

ЯККФЛАГИ
Общие параметры передаются генератору парсера. Если $ YACCFLAGS содержит -d вариант,
SCons предполагает, что вызов также создаст файл .h (если исходный файл yacc заканчивается
с суффиксом .y) или файл .hpp (если исходный файл yacc заканчивается суффиксом .yy)

YACCHFILESUFFIX
Суффикс заголовочного файла C, сгенерированный генератором синтаксического анализа, когда -d вариант
используется. Обратите внимание, что установка этой переменной не приводит к тому, что генератор синтаксического анализатора
создать заголовочный файл с указанным суффиксом, он существует, чтобы вы могли указать
какой суффикс генератор парсера будет использовать по собственному желанию. Значение по умолчанию — .h.

YACCHXXFILESUFFIX
Суффикс заголовочного файла C++, сгенерированный генератором синтаксического анализа, когда -d вариант
используется. Обратите внимание, что установка этой переменной не приводит к тому, что генератор синтаксического анализатора
создать заголовочный файл с указанным суффиксом, он существует, чтобы вы могли указать
какой суффикс генератор парсера будет использовать по собственному желанию. Значение по умолчанию
.hpp, за исключением Mac OS X, где по умолчанию используется ${TARGET.suffix}.h. потому что по умолчанию
Генератор парсера bison просто добавляет .h к имени сгенерированного файла C++.

YACCVCGFILESUFFIX
Суффикс файла, содержащего определение автомата грамматики VCG, когда
--graph = вариант используется. Обратите внимание, что установка этой переменной не приводит к тому, что синтаксический анализатор
генератор для создания файла VCG с указанным суффиксом, он существует, чтобы позволить вам
указать, какой суффикс генератор синтаксического анализатора будет использовать по своему усмотрению. Значение по умолчанию
это .vcg.

ZIP
Утилита сжатия zip и упаковки файлов.

ЗИПКОМ
Командная строка, используемая для вызова утилиты zip, или внутренняя функция Python, используемая для
создать zip-архив.

ZIP-СЖАТИЕ
Команда (сила) флаг из модуля zipfile Python, используемого внутренним
функция для управления сжатием zip-архива или нет. Значение по умолчанию
zipfile.ZIP_DEFLATED, который создает сжатый zip-архив. Это значение не влияет
если модуль zipfile недоступен.

ЗИПКОМСТР
Строка, отображаемая при архивировании файлов с помощью утилиты zip. Если это не установлено,
тогда $ ZIPCOM (командная строка или внутренняя функция Python).

env = Environment(ZIPCOMSTR = "Архивирование $TARGET")

ЗИПФЛАГИ
Общие параметры, переданные утилите zip.

ЗИПРУТ
Необязательный корневой каталог zip (по умолчанию пустой). Имена файлов, хранящиеся в zip-файле
будет относиться к этому каталогу, если он задан. В противном случае имена файлов относятся к
текущий каталог команды. Например:

env = Окружающая среда ()
env.Zip('foo.zip', 'subdir1/subdir2/file1', ZIPROOT='subdir1')

создаст zip-файл foo.zip, содержащий файл с именем subdir2/file1, а не
чем подкаталог1/подкаталог2/файл1.

ЗИПСУФФИКС
Суффикс, используемый для имен zip-файлов.

Переменные построения можно получить и установить с помощью Dictionary метод
среда строительства:

dict = env.Словарь()
dict["CC"] = "cc"

или с помощью оператора []:

env["CC"] = "cc"

Переменные построения также могут быть переданы конструктору среды построения:

env = Окружающая среда (CC = "cc")

или при копировании среды конструирования с помощью Клон Метод:

env2 = env.Clone(CC="cl.exe")

Настроить Контексты
бра поддерживает конфигурировать контексты, интегрированный механизм, аналогичный различным AC_CHECK
макросы в GNU autoconf для проверки наличия заголовочных файлов C, библиотек и т. д. В
в отличие от autoconf, бра не поддерживает явный кеш проверенных значений, но
использует свое обычное отслеживание зависимостей, чтобы поддерживать проверенные значения в актуальном состоянии. Тем не менее, пользователи
может переопределить это поведение с помощью --config командной строки.

Для проверки можно использовать следующие методы:

Настроить(окр[custom_tests, conf_dir, журнальный файл, config_h, чистым, помощь]),
env.Настроить([custom_tests, conf_dir, журнальный файл, config_h, чистым, помощь])
Это создает контекст конфигурации, который можно использовать для выполнения проверок. окр определяет
среда для создания тестов. Эта среда может быть изменена, когда
выполнение проверок. custom_tests это словарь, содержащий пользовательские тесты. См. также
раздел о пользовательских тестах ниже. По умолчанию пользовательские тесты не добавляются в
настроить контекст. conf_dir указывает каталог, в котором создаются тестовые примеры.
Обратите внимание, что этот каталог не используется для создания обычных целей. Значение по умолчанию
каталог #/.sconf_temp. журнальный файл указывает файл, который собирает выходные данные из
команды, которые выполняются для проверки существования заголовочных файлов, библиотек и т. д.
По умолчанию используется файл #/config.log. Если вы используете ВариантDir() метод, вы
может захотеть указать подкаталог в вашем каталоге вариантов. config_h указывает
Заголовочный файл C, куда будут записываться результаты тестов, например #define HAVE_STDIO_H,
#define HAVE_LIBM и т. д. По умолчанию не записывается config.h файл. Вы можете указать
тоже самое config.h файл в нескольких вызовах Configure, и в этом случае бра предусматривает
объединить все результаты в указанном файле. Обратите внимание, что SCons использует свой обычный
проверка зависимостей, чтобы решить, нужно ли пересобирать указанный config_h
файл. Это означает, что файл не обязательно перестраивается каждый раз при запуске scons, но
перестраивается только в том случае, если его содержимое будет изменено, и какая-либо цель, зависящая от
config_h файл строится.

Необязательный чистым и помощь аргументы могут использоваться для подавления выполнения
тесты конфигурации, когда -c/--очистить or -H/-h/--помощь используются варианты,
соответственно. Поведение по умолчанию всегда заключается в выполнении контекстных тестов конфигурации, поскольку
результаты тестов могут повлиять на список целей, подлежащих очистке или помощь
текст. Если тесты конфигурации не влияют на них, вы можете добавить чистый = Ложь or
помощь=ложь аргументы (или оба), чтобы избежать ненужного выполнения теста.

Созданный Настроить экземпляр имеет следующие связанные методы:

СКонф.Готово(контекст), sconf.Заканчивать()
Этот метод следует вызывать после завершения настройки. Он возвращает окружающую среду
как изменено в результате выполненных проверок конфигурации. После вызова этого метода нет
дальнейшие проверки могут быть выполнены с этим контекстом конфигурации. Однако вы можете
создайте новый контекст Configure для выполнения дополнительных проверок. Только один контекст должен
быть активным в то время.

Следующие проверки предопределены. (Вероятно, этот список со временем будет увеличиваться.
by и разработчики вносят новые полезные тесты.)

SConf.CheckHeader(контекст, заголовок[include_quotes, язык]), sconf.ПроверитьЗаголовок(заголовок,
[include_quotes, язык])
Проверяет, если заголовок можно использовать на указанном языке. заголовок может быть списком, в котором
случай, когда последний элемент списка является проверяемым заголовочным файлом, а предыдущий список
элементы представляют собой заголовочные файлы, #включают строки должны предшествовать строке заголовка
проверено на. Необязательный аргумент include_quotes должна быть двухсимвольной строкой,
где первый символ обозначает открывающую кавычку, а второй символ обозначает
заключительная цитата. По умолчанию оба символа — " (двойная кавычка). Необязательный
аргумент язык должно быть либо C or C + + и выбирает компилятор, который будет использоваться для
чек. Возвращает 1 в случае успеха и 0 в случае неудачи.

SConf.CheckCHeader(контекст, заголовок[include_quotes]), sconf.ПроверитьЧадер(заголовок,
[include_quotes])
Это обертка вокруг SConf.CheckHeader который проверяет, если заголовок можно использовать в C
язык. заголовок может быть списком, и в этом случае последний элемент списка является заголовком
проверяемый файл, а предыдущие элементы списка являются заголовочными файлами, #включают линий
должен предшествовать проверяемой строке заголовка. Необязательный аргумент include_quotes
должна быть строкой из двух символов, где первый символ обозначает открывающую кавычку
а второй символ обозначает закрывающую кавычку (оба значения по умолчанию \N'34'). Возвращает 1
в случае успеха и 0 в случае неудачи.

SConf.CheckCXXHeader(контекст, заголовок[include_quotes]), sconf.CheckCXXHeader(заголовок,
[include_quotes])
Это обертка вокруг SConf.CheckHeader который проверяет, если заголовок можно использовать в C++
язык. заголовок может быть списком, и в этом случае последний элемент списка является заголовком
проверяемый файл, а предыдущие элементы списка являются заголовочными файлами, #включают линий
должен предшествовать проверяемой строке заголовка. Необязательный аргумент include_quotes
должна быть строкой из двух символов, где первый символ обозначает открывающую кавычку
а второй символ обозначает закрывающую кавычку (оба значения по умолчанию \N'34'). Возвращает 1
в случае успеха и 0 в случае неудачи.

SConf.CheckFunc(контекст,, имя_функции[заголовок, язык]),
sconf.CheckFunc(имя_функции[заголовок, язык])
Проверяет, доступна ли указанная функция C или C++. имя_функции это имя
функция для проверки. Необязательный заголовок аргумент - это строка, которая будет
размещается в верхней части тестового файла, который будет скомпилирован, чтобы проверить, работает ли функция
существуют; значение по умолчанию:

#ifdef __cplusplus
внешний "C"
#endif
char имя_функции();

Необязательный язык аргумент должен быть C or C + + и выбирает компилятор, который будет использоваться
для чека; по умолчанию "С".

SConf.CheckLib(контекст[библиотека, символ, заголовок, язык, автодобавить=1]),
sconf.CheckLib([библиотека, символ, заголовок, язык, автодобавить=1])
Проверяет, если библиотека приводит символ. Если значение автоматическое добавление это 1 и библиотека
обеспечивает указанные символ, добавляет библиотеку к конструкции LIBS
переменная среды. библиотека также может быть None (по умолчанию), в этом случае символ is
проверяется с помощью текущей переменной LIBS или списка имен библиотек, и в этом случае каждый
библиотека в списке будет проверена на наличие символ. Если символ не установлено или Ничто, то
SConf.CheckLib() просто проверяет, можете ли вы ссылаться на указанный библиотека,
необязательный язык аргумент должен быть C or C + + и выбирает компилятор, который будет использоваться для
чек; по умолчанию "С". Значение по умолчанию для автоматическое добавление равно 1. Этот метод возвращает
1 в случае успеха и 0 в случае ошибки.

SConf.CheckLibWithHeader(контекст, библиотека, заголовок, язык[призывают, автоматическое добавление]),
sconf.CheckLibWithHeader(библиотека, заголовок, язык[призывают, автоматическое добавление])
В отличие от вызова SConf.CheckLib, этот вызов обеспечивает более сложный способ
проверить по библиотекам. Опять таки, библиотека указывает библиотеку или список библиотек
Проверять. заголовок указывает заголовок для проверки. заголовок может быть списком, в котором
случай, когда последний элемент списка является проверяемым заголовочным файлом, а предыдущий список
элементы представляют собой заголовочные файлы, #включают строки должны предшествовать строке заголовка
проверено на. язык может быть одним из «C», «c», «CXX», «cxx», «C++» и «c++». призывают может быть
любое допустимое выражение (с завершающим ';'). Если призывают не установлен, по умолчанию просто
проверяет, что вы можете связать с указанным библиотека. автоматическое добавление указывает, следует ли
добавить библиотеку в среду (только если проверка прошла успешно). Этот метод возвращает 1
в случае успеха и 0 в случае ошибки.

SConf.CheckType(контекст, имя_типа[включает в себя, язык]), sconf.CheckType(имя_типа,
[включает в себя, язык])
Проверяет существование типа, определенного ЬурейеЕ. имя_типа указывает на
имя typedef для проверки. включает в себя это строка, содержащая один или несколько #включают линий
который будет вставлен в программу, которая будет запущена для проверки существования
тип. Необязательный язык аргумент должен быть C or C + + и выбирает компилятор
использовать для проверки; по умолчанию "С". Пример:

sconf.CheckType('foo_type', '#include "my_types.h"', 'C++')

Настроить.CheckCC(себя)
Проверяет, работает ли компилятор C (как определено конструкторской переменной CC) с помощью
пытаюсь скомпилировать небольшой исходный файл.

По умолчанию SCons определяет только наличие программы с правильным именем, а не
является работающим компилятором.

Здесь используется та же самая команда, что и в построителе объектов для источника C.
файл, поэтому его можно использовать для определения того, работает ли конкретный флаг компилятора или нет.

Настроить.ПроверитьCXX(себя)
Проверяет, работает ли компилятор C++ (как определено конструктивной переменной CXX),
пытаюсь скомпилировать небольшой исходный файл. По умолчанию SCons обнаруживает только наличие
программу с правильным именем, если это не работающий компилятор.

Здесь используется та же команда, что и в построителе объектов для CXX.
исходные файлы, поэтому его можно использовать для определения того, работает ли конкретный флаг компилятора или нет.

Настроить.ПроверитьSHCC(себя)
Проверяет, работает ли компилятор C (как определено конструкторской переменной SHCC) с помощью
пытаюсь скомпилировать небольшой исходный файл. По умолчанию SCons обнаруживает только наличие
программу с правильным именем, если это не работающий компилятор.

Здесь используется та же самая команда, что и в построителе объектов для источника C.
файл, поэтому его можно использовать для определения того, работает ли конкретный флаг компилятора или нет. Этот
не проверяет, можно ли использовать объектный код для создания разделяемой библиотеки, только
что компиляция (не ссылка) прошла успешно.

Настроить.ПроверитьSHCXX(себя)
Проверяет, работает ли компилятор C++ (как определено конструкторской переменной SHCXX)
пытаясь скомпилировать небольшой исходный файл. По умолчанию SCons обнаруживает только наличие
программу с правильным именем, если это не работающий компилятор.

Здесь используется та же команда, что и в построителе объектов для CXX.
исходные файлы, поэтому его можно использовать для определения того, работает ли конкретный флаг компилятора или нет.
Это не проверяет, можно ли использовать объектный код для создания общей библиотеки,
только то, что компиляция (не ссылка) прошла успешно.

Пример типичного использования Configure:

env = Окружающая среда ()
conf = настроить (окружение)
если не conf.CheckCHeader('math.h'):
print 'Нам действительно нужна math.h!'
Выход(1)
если conf.CheckLibWithHeader('qt', 'qapp.h', 'С++',
'QПриложение qapp(0,0);' ):
# делать вещи для qt - использование, например
conf.env.Append(CPPFLAGS = '-DWITH_QT')
окр = конф.Готово()

SConf.CheckTypeSize(контекст, имя_типа[заголовок, язык, ожидать]),
sconf.CheckTypeSize(имя_типа[заголовок, язык, ожидать])
Проверяет размер типа, определенного ЬурейеЕ. имя_типа определяет определение типа
имя для проверки. Необязательный заголовок аргумент представляет собой строку, которая будет помещена в
верхняя часть тестового файла, который будет скомпилирован для проверки существования функции; в
по умолчанию пусто. Необязательный язык аргумент должен быть C or C + + и выбирает
компилятор, который будет использоваться для проверки; по умолчанию "С". Необязательный ожидать аргумент
должно быть целым числом. Если используется этот аргумент, функция только проверит,
тип, указанный в type_name, имеет ожидаемый размер (в байтах). Например,
CheckTypeSize('короткий', ожидать = 2) вернет успех, только если короткое значение равно двум байтам.

SConf.CheckDeclaration(контекст, символ[включает в себя, язык]),
sconf.CheckDeclaration(символ[включает в себя, язык])
Проверяет, указан ли символ объявлен включает в себя строка, содержащая один или
больше #включают строки, которые будут вставлены в программу, которая будет запускаться для проверки
для существования типа. Необязательный язык аргумент должен быть C or C + + и
выбирает компилятор, который будет использоваться для проверки; по умолчанию "С".

SConf.Define(контекст, символ[ценностное , комментарий]), sconf.Определять(символ[ценностное , комментарий])
Эта функция ничего не проверяет, но определяет символ препроцессора, который
добавить в заголовочный файл конфигурации. Это эквивалент AC_DEFINE, и
определяет символ имя с необязательным ценностное и необязательный комментарий комментарий.

Примеры:

env = Окружающая среда ()
conf = настроить (окружение)

# Помещает следующую строку в заголовочный файл конфигурации:
# # определить A_SYMBOL
conf.Define('A_SYMBOL')

# Помещает следующую строку в заголовочный файл конфигурации:
# # определить A_SYMBOL 1
conf.Define('A_SYMBOL', 1)

Однако будьте осторожны с цитированием строковых значений:

env = Окружающая среда ()
conf = настроить (окружение)

# Помещает следующую строку в заголовочный файл конфигурации:
# #define A_SYMBOL YA
conf.Define('A_SYMBOL', "ДА")

# Помещает следующую строку в заголовочный файл конфигурации:
# # определить A_SYMBOL "YA"
conf.Define('A_SYMBOL', '"ДА"')

Для комментария:

env = Окружающая среда ()
conf = настроить (окружение)

# Помещает следующие строки в заголовочный файл конфигурации:
# /* Установите в 1, если у вас есть символ */
# # определить A_SYMBOL 1
conf.Define('A_SYMBOL', 1, 'Установите 1, если у вас есть символ')

Вы можете определить свои собственные пользовательские проверки. в дополнение к предопределенным проверкам. Это
передается в словаре функции Configure. Этот словарь отображает названия
проверяет определяемые пользователем вызываемые объекты Python (либо функции Python, либо экземпляры классов
реализация __призывают__ метод). Первым аргументом вызова всегда является Проверитьконтекст
instance, за которым следуют аргументы, которые должен предоставить пользователь проверки. Эти
Экземпляры CheckContext определяют следующие методы:

ПроверитьКонтекст.Сообщение(себя, текст)
Обычно вызывается перед началом проверки. текст будет отображаться для пользователя, например
'Проверка библиотеки X...'

ПроверитьКонтекст.Результат(самостоятельно,, разрешения)
Обычно вызывается после проверки. разрешения может быть либо целым числом, либо строкой. В
В первом случае пользователю отображается «да» (res != 0) или «нет» (res == 0), в
В последнем случае отображается заданная строка.

CheckContext.TryCompile(себя, текст, расширение)
Проверяет, является ли файл с указанным расширение (например, '.c'), содержащий текст может быть
скомпилировано с использованием окружения объект строитель. Возвращает 1 в случае успеха и 0 в случае
отказ.

CheckContext.TryLink(себя, текст, расширение)
Проверяет, является ли файл с указанным расширение (например, '.c'), содержащий текст может быть
скомпилировано с использованием окружения Программа строитель. Возвращает 1 в случае успеха и 0 в случае
отказ.

CheckContext.TryRun(себя, текст, расширение)
Проверяет, является ли файл с указанным расширение (например, '.c'), содержащий текст может быть
скомпилировано с использованием окружения Программа строитель. В случае успеха программа запускается. Если
программа выполняется успешно (то есть ее статус возврата равен 0), кортеж (1,
выходнаяStr) возвращается, где выходнаяStr стандартный вывод программы. Если
программа терпит неудачу при выполнении (ее статус возврата не равен нулю), затем возвращается (0, '').

CheckContext.TryAction(себя, действие[текст, расширение])
Проверяет, указан ли действие с необязательным исходным файлом (содержимое текст , расширение
расширение = '' ) может быть выполнен. действие может быть чем угодно, что может быть преобразовано в
бра Действие. На успех, (1, выходнаяStr) возвращается, где выходнаяStr содержание
целевого файла. При неудаче (0, '') возвращается.

CheckContext.TryBuild(себя, строитель[текст, расширение])
Низкоуровневая реализация для тестирования конкретных сборок; вышеперечисленные методы основаны на
Этот способ. Учитывая экземпляр Builder строитель и необязательный текст исходного файла
с необязательным расширение, этот метод возвращает 1 в случае успеха и 0 в случае неудачи. В
Кроме того, self.lastTarget устанавливается в целевой узел сборки, если сборка была
успешный.

Пример реализации и использования пользовательских тестов:

def CheckQt(контекст, qtdir):
context.Message('Проверка qt...')
lastLIBS = context.env['LIBS']
lastLIBPATH = context.env['LIBPATH']
lastCPPPATH= context.env['CPPPATH']
context.env.Append(LIBS = 'qt', LIBPATH = qtdir + '/ Lib', CPPPATH = qtdir + '/include' )
рет = контекст.TryLink("""
#включают
int main (int argc, char ** argv) {
QApplication qapp(argc, argv);
0 вернуться;
}
"" ")
если не рет:
context.env.Replace(LIBS =lastLIBS, LIBPATH=lastLIBPATH, CPPPATH=lastCPPPATH)
контекст.Результат(возврат)
возвратиться

env = Окружающая среда ()
conf = Configure(env, custom_tests = {'CheckQt': CheckQt})
если не conf.CheckQt('/usr/lib/qt'):
print 'Нам действительно нужен qt!'
Выход(1)
окр = конф.Готово()

Командная строка Строительство Переменные
Часто при создании программного обеспечения некоторые переменные должны быть указаны во время сборки. Например,
библиотеки, необходимые для сборки, могут находиться в нестандартных местах или компиляторе для конкретного сайта.
параметры, возможно, потребуется передать компилятору. бра обеспечивает Переменные Возражать
поддержка переопределения переменных построения в командной строке:

$ scons ПЕРЕМЕННАЯ=foo

Значения переменных также можно указать в текстовом файле SConscript. Чтобы создать
объекта Variables, вызовите функцию Variables():

Переменные([файлов], [арг])
Это создает объект Variables, который будет считывать переменные построения из файла или
список имен файлов, указанных в файлов. Если файлы не указаны или файлов аргумент
is Ничто, то никакие файлы не будут прочитаны. Необязательный аргумент арг это словарь
значения, которые переопределяют все, что читается из указанных файлов; это прежде всего
предназначен для прохождения АРГУМЕНТЫ словарь, содержащий переменные, указанные в
командная строка. Пример:

vars = переменные('custom.py')
vars = Переменные('overrides.py', АРГУМЕНТЫ)
vars = переменные (нет, {FOO: 'расширение', BAR: 7})

Объекты переменных имеют следующие методы:

Добавлять(ключ[помощь, по умолчанию, валидатор, Преобразователь])
Это добавляет настраиваемую переменную построения к объекту Variables. ключ это
имя переменной. помощь текст справки для переменной. по умолчанию по умолчанию
значение переменной; если значение по умолчанию Ничто и нет явного значения
указано, конструктивная переменная будет добавить в конструкцию
окружающей среды. валидатор вызывается для проверки значения переменной и должен
принимать три аргумента: ключ, значение и среду. Рекомендуемый способ обращения с
неверным значением является возбуждение исключения (см. пример ниже). Преобразователь призван
преобразовать значение, прежде чем помещать его в среду, и должно принимать либо
значение или значение и среда в качестве параметров. Преобразователь должен вернуть значение,
который будет преобразован в строку перед проверкой валидатор (если есть)
а затем добавил в среду.

Примеры:

vars.Add('CC', 'Компилятор C')

def validate_color (ключ, val, env):
если не val в ['красный', 'синий', 'желтый']:
поднять исключение («Неверное значение цвета '%s'» % val)
vars.Add('ЦВЕТ', validator=valid_color)

ДобавитьПеременные(список)
Сценарий-оболочка, который добавляет несколько настраиваемых переменных построения в Variables.
объект. список представляет собой список кортежей или объектов списка, содержащих аргументы для
индивидуальный звонок в Добавить метод.

опт.ДобавитьПеременные(
("отладка", '', 0),
(«CC», «Компилятор Си»),
('VALIDATE', 'Опция проверки валидации',
'notset', валидатор, None),
)

Обновлять(окр[арг])
Это обновляет среду построения окр с индивидуальной конструкцией
переменные. Любые указанные переменные, которые настроен для объекта Variables
будут сохранены и могут быть восстановлены с помощью неизвестные переменные() ниже.

Обычно этот метод не вызывается напрямую, а вызывается косвенно путем передачи
Объект переменных для функции Environment():

env = среда (переменные = переменные)

Текстовые файлы, указанные при создании объекта Variables, выполняются как
Сценарии Python и значения (глобальных) переменных Python, установленных в файле, добавляются в
строительная среда.

Пример:

CC = 'my_cc'

Неизвестные переменные()
Возвращает словарь, содержащий любые переменные, которые были указаны либо в файлах
или словарь, которым был инициализирован объект Variables, но для которого
Объект переменных не настроен.

env = среда (переменные = переменные)
для ключа значение в vars.UnknownVariables():
напечатать "неизвестная переменная: %s=%s" % (ключ, значение)

Сохранять(имя файла, окр)
Это сохраняет текущие установленные переменные в файл сценария с именем имя файла , которые могут быть
используется при следующем вызове для автоматической загрузки текущих настроек. Этот способ
в сочетании с методом Variables можно использовать для поддержки кэширования переменных между
пробеги.

env = Окружающая среда ()
vars = Переменные(['variables.cache', 'custom.py'])
варс.Добавить(...)
vars.Update(окр.)
vars.Save('variables.cache', env)

Генерировать текст справки(окр[sort])
Это генерирует текст справки, документирующий настраиваемые переменные построения, подходящие
для передачи в функцию Help(). окр это строительная среда, которая будет
использоваться для получения фактических значений настраиваемых переменных. Вызов с необязательным
sort функция приведет к сортировке вывода по указанному аргументу.
конкретный sort функция должна принимать два аргумента и возвращать -1, 0 или 1 (например,
стандартный Python CMP функция).

Справка (vars.GenerateHelpText (env))
Справка (vars.GenerateHelpText (env, sort = cmp))

ФорматVariableHelpText(окр, выбирать, помощь, по умолчанию, фактического соединения)
Этот метод возвращает отформатированную строку, содержащую печатный текст справки для одного
вариант. Обычно он не вызывается напрямую, а вызывается Генерировать текст справки()
метод для создания возвращаемого текста справки. Это может быть переопределено вашей собственной функцией
который принимает указанные выше аргументы и возвращает строку текста справки в формате
на ваш вкус. Обратите внимание, что Генерировать текст справки() не будет помещать пустые строки или лишние
символы между записями, поэтому вы должны добавить эти символы в возвращаемый
string, если вы хотите, чтобы записи были разделены.

def my_format (env, opt, help, default, fact):
fmt = "\n%s: по умолчанию=%s фактическое=%s (%s)\n"
вернуть fmt % (необязательный, по умолчанию, актуальный, справка)
vars.FormatVariableHelpText = мой_формат

Чтобы было удобнее работать с настраиваемыми переменными, бра обеспечивает
количество функций, упрощающих настройку различных типов переменных:

Логическая переменная(ключ, помощь, по умолчанию)
Возвращает кортеж аргументов для установки логического параметра. Опция будет использовать
указанное имя ключ, имеют значение по умолчанию по умолчанию, и отобразить указанный помощь
текст. Опция будет интерпретировать значения y, Да, t, правда, 1, on и ВСЕ как правда, и
ценности n, нет, f, ложный, 0, от и нет как ложь

Переменная Переменная(ключ, помощь, по умолчанию, разрешенные_значения[карта, игнорировать])
Возвращает кортеж аргументов для установки параметра, значение которого может быть одним из указанных
список допустимых перечисляемых значений. Опция будет использовать указанное имя ключ, Имеют
значение по умолчанию по умолчанию, и отобразить указанный помощь текст. Вариант будет только
поддерживать эти ценности в разрешенные_значения список. Необязательный карта аргумент
словарь, который можно использовать для преобразования входных значений в определенные допустимые значения в
разрешенные_значения список. Если значение ignore_case равно 0 (по умолчанию), то значения
чувствительны к регистру. Если значение ignore_case равно 1, тогда значения будут сопоставляться
без учета регистра. Если значение ignore_case равно 2, тогда значения будут сопоставляться
без учета регистра, и все входные значения будут преобразованы в нижний регистр.

СписокПеременных(ключ, помощь, по умолчанию, имена[,карта])
Возвращает кортеж аргументов для установки параметра, значение которого может быть одним или несколькими из
указанный список допустимых перечисляемых значений. Опция будет использовать указанное имя ключ,
иметь значение по умолчанию по умолчанию, и отобразить указанный помощь текст. Опция будет
поддерживать только ценности ВСЕ, нетили значения в имена список. Больше одного
значение может быть указано, все значения разделены запятыми. По умолчанию может быть
строка значений по умолчанию, разделенных запятыми, или список значений по умолчанию.
необязательный карта аргумент — это словарь, который можно использовать для преобразования входных значений в
конкретные юридические значения в имена .

ПакетПеременная(ключ, помощь, по умолчанию)
Возвращает кортеж аргументов для установки параметра, значение которого является путем к
пакет, который может быть включен, отключен или ему может быть задано явное имя пути. Опция будет
использовать указанное имя ключ, имеют значение по умолчанию по умолчанию, и отобразить указанный
помощь текст. Опция будет поддерживать значения Да, правда, on, включить or по области применения и отправлять адресату
в каком случае указанный по умолчанию будет использоваться, или параметр может быть установлен на
произвольная строка (обычно это путь к активируемому пакету).
опция также будет поддерживать значения нет, ложный, от or запрещать отключить использование
указанный вариант.

ПутьПеременная(ключ, помощь, по умолчанию[валидатор])
Возвращает кортеж аргументов, чтобы настроить параметр, значение которого, как ожидается, будет путем
имя. Опция будет использовать указанное имя ключ, имеют значение по умолчанию по умолчаниюи
отображать указанный помощь текст. Дополнительный валидатор можно указать, что будет
вызывается для проверки приемлемости указанного пути. SCons поставляет следующее
готовые валидаторы: PathVariable.PathExists (по умолчанию), который проверяет,
указанный путь существует; PathVariable.PathIsFile, который проверяет, что указанный путь
существующий файл; PathVariable.PathIsDir, который проверяет, что указанный путь
существующий каталог; PathVariable.PathIsDirCreate, который проверяет, что указанный
путь является каталогом и создаст указанный каталог, если путь не
существует; а также PathVariable.PathAccept, который просто принимает конкретное имя пути
аргумент без проверки, и который подходит, если вы хотите, чтобы ваши пользователи могли
чтобы указать путь к каталогу, который будет создан как часть процесса сборки, для
пример. Вы можете поставить свой собственный валидатор функция, которая должна принимать три аргумента
(ключ, имя устанавливаемой переменной; волна, указанное значение проверяется; а также
окр, среда построения) и должен вызвать исключение, если указанный
значение не приемлемо.

Эти функции упрощают создание ряда переменных с согласованным
поведение в одном вызове Добавить переменные Метод:

Варс.ДобавитьПеременные(
BoolVariable('предупреждения', 'компиляция с -Wall и подобным', 1),
EnumVariable('отладка', 'вывод и символы отладки', 'нет'
разрешенные_значения=('да', 'нет', 'полный'),
map={}, ignorecase=0), # с учетом регистра
СписокПеременных('общий',
'библиотеки для сборки как разделяемые библиотеки',
'все',
имена = список_библиотек),
ПакетПеременная('x11',
'использовать X11, установленный здесь (да = искать в некоторых местах)',
'да'),
PathVariable('qtdir', 'где установлен корень Qt', qtdir),
PathVariable('foopath', 'куда установлена ​​библиотека foo', foopath,
PathVariable.PathIsDir),

)

Файл и Каталог Nodes
Команда Файл() и Вы() функции возвращают Файл и Вы узлов соответственно. объекты питона,
соответственно. Эти объекты имеют несколько видимых пользователю атрибутов и методов, которые
часто полезно:

путь
Путь сборки данного файла или каталога. Этот путь относится к верхнему уровню
каталог (где SConstruct файл найден). Путь сборки такой же, как и
исходный путь, если вариант_каталог не используется.

абспат
Абсолютный путь сборки данного файла или каталога.

исходный узел ()
Команда исходный узел() метод возвращает другой Файл or Вы объект, представляющий источник путь
данного Файл or Вы,

# Получить путь к текущему каталогу сборки относительно вершины.
Директор('.').путь
# Абсолютный путь к текущему каталогу
Дир('.').abspath
# Следующая строка всегда '.', потому что это путь к верхнему каталогу относительно самого себя.
Каталог('#.').путь
File('foo.c').srcnode().path # исходный путь к данному исходному файлу.

# Строители также возвращают объекты File:
foo = env.Program('foo.c')
print "foo будет встроен в %s"%foo.path

A Вы узел или Файл Узел также можно использовать для создания узлов файлов и подкаталогов.
относительно генерирующего узла. А Вы Node поместит новые узлы в
каталог, который он представляет. А Файл узел поместит новые узлы в свой родитель
каталог (то есть «рядом» с рассматриваемым файлом). Если d - это Вы (каталог) Узел и
f - это Файл (file) Node, то доступны следующие методы:

d.Дир(имя)
Возвращает узел каталога для подкаталога d названный имя.

d.Файл(имя)
Возвращает файловый узел для файла внутри d названный имя.

d.Вход(имя)
Возвращает неразрешенный узел внутри d названный имя.

f.Дир(имя)
Возвращает каталог с именем имя в родительском каталоге f.

f.Файл(имя)
Возвращает файл с именем имя в родительском каталоге f.

f.Вход(имя)
Возвращает неразрешенный узел с именем имя в родительском каталоге f.

Например:

# Получить узел для файла в каталоге
вкл = Направление('включить')
f = вкл.Файл('header.h')

# Получить узел для подкаталога внутри каталога
dist = Dir('проект-3.2.1)
src = dist.Dir('src')

# Получить узел для файла в том же каталоге
cfile = Файл('sample.c')
hfile = cfile.File('sample.h')

# Комбинированный пример
документы = Каталог('документы')
html = docs.Dir('html')
индекс = html.Файл('index.html')
css = index.File('app.css')

РАСШИРЕНИЕ СКОНС

строитель Объекты
бра может быть расширен для создания различных типов целей путем добавления новых объектов Builder в
строительная среда. In Генеральная, вам нужно только добавить новый объект Builder
когда вы хотите создать новый тип файла или другую внешнюю цель. Если вы просто хотите
вызвать другой компилятор или другой инструмент для создания программы, объекта, библиотеки или любого другого
другой тип выходного файла, для которого бра уже есть существующий Builder, как правило,
гораздо проще использовать существующие Builders в строительной среде, которая устанавливает
соответствующие переменные конструкции (CC, LINK и т. д.).

Объекты Builder создаются с помощью строитель функция. строитель функция принимает
следующие аргументы:

действие
Строка командной строки, используемая для создания цели из исходного кода. действие так же может быть:
список строк, представляющих выполняемую команду и ее аргументы (подходящие
для включения пробела в аргумент), имя исходного файла сопоставления словаря
суффиксы к любой комбинации строк командной строки (если сборщик должен принимать
несколько расширений исходного файла), функция Python; объект Action (см. следующий
раздел); или список любого из вышеперечисленного.

Функция действия принимает три аргумента: источник - список исходных узлов, цель - к
список целевых узлов, окр - среда строительства.

префикс
Префикс, который будет добавлен к имени целевого файла. Это может быть указано как:
* string,

* вызываемый объект - функция или другой вызываемый объект, который принимает два аргумента (a
среда построения и список источников) и возвращает префикс,

* словарь - задает отображение из определенного исходного суффикса (первого исходного
указанный) к соответствующему целевому префиксу. Исходный суффикс и целевой префикс
спецификации могут использовать подстановку переменных среды и целевой префикс (т.
'значение' в словаре) также может быть вызываемым объектом. Цель по умолчанию
префикс может быть указан записью словаря со значением ключа None.

b = Builder("build_it <$SOURCE>$TARGET",
префикс = "файл-")

def gen_prefix (окружение, источники):
вернуть "файл-" + env['ПЛАТФОРМА'] + '-'
b = Builder("build_it <$SOURCE>$TARGET",
префикс = gen_prefix)

b = Builder("build_it <$SOURCE>$TARGET",
суффикс = { Нет: "файл-",
"$SRC_SFX_A": gen_prefix })

суффикс
Суффикс, который будет добавлен к имени целевого файла. Это может быть указано в
так же, как префикс выше. Если суффикс является строкой, то бра добавит
'.' к началу суффикса, если его еще нет. Строка, возвращенная
вызываемый объект (или полученный из словаря) остается нетронутым и должен добавлять свой собственный
'.' к началу, если это необходимо.

b = Builder("build_it <$SOURCE>$TARGET"
суффикс = "-файл")

def gen_suffix (env, источники):
возвращаться "." + env['ПЛАТФОРМА'] + "-файл"
b = Builder("build_it <$SOURCE>$TARGET",
суффикс = род_суффикс)

b = Builder("build_it <$SOURCE>$TARGET",
суффикс = { Нет: ".sfx1",
"$SRC_SFX_A": gen_suffix })

гарантировать_суффикс
При установке любого истинного значения вызывает бра для добавления целевого суффикса, указанного
суффикс ключевое слово для любых целевых строк с другим суффиксом. (По умолчанию
поведение заключается в том, чтобы оставить нетронутым любое имя целевого файла, которое выглядит так, как будто оно уже имеет какие-либо
суффикс.)

b1 = Builder("build_it <$SOURCE>$TARGET"
суффикс = ".out")
b2 = Builder("build_it <$SOURCE>$TARGET"
суффикс = ".out",
гарантировать_суффикс)
env = Окружающая среда ()
env['СТРОИТЕЛИ']['B1'] = b1
env['СТРОИТЕЛИ']['B2'] = b2

# Создает "foo.txt", так как не задан параметр sure_suffix.
env.B1('foo.txt', 'foo.in')

# Создает "bar.txt.out", потому что задан параметр sure_suffix.
env.B2('bar.txt', 'bar.in')

src_suffix
Ожидаемый суффикс имени исходного файла. Это может быть строка или список строк.

целевой_сканер
Объект Scanner, который будет вызываться для поиска неявных зависимостей для этой цели.
файл. Этот аргумент ключевого слова следует использовать для объектов сканера, которые находят неявные
зависимости, основанные только на целевом файле и среде построения, для
неявные зависимости на основе исходных файлов. (См. раздел «Объекты сканера» ниже,
для получения информации о создании объектов Scanner.)

источник_сканер
Объект Scanner, который будет вызываться для поиска неявных зависимостей в любом источнике.
файлы, используемые для создания этого целевого файла. Здесь вы должны указать сканер для
найти такие вещи, как #включают строки в исходных файлах. предварительно построенный Дирсканнер Сканер
может использоваться, чтобы указать, что этот Builder должен сканировать деревья каталогов для
изменения на диске файлов, которые бра не знает о других Builder или функциях
звонки. (См. раздел «Объекты сканера» ниже для получения информации о создании
собственные объекты Scanner.)

target_factory
Фабричная функция, которую Builder будет использовать для преобразования любых целей, указанных в виде строк.
в узлы SCons. По умолчанию SCons предполагает, что все цели являются файлами. Другое полезное
значения target_factory включают Вы, когда Builder создает целевой каталог и
Запись, когда Builder может создать целевой файл или каталог.

Пример:

MakeDirectoryBuilder = Builder (action=my_mkdir, target_factory=Dir)
env = Окружающая среда ()
env.Append(BUILDERS = {'MakeDirectory':MakeDirectoryBuilder})
env.MakeDirectory('новый_каталог', [])

Обратите внимание, что при вызове MakeDirectory Builder необходимо указать пустой список источников.
чтобы строка представляла цель строителя; без этого он предполагал бы
является источником и попытается вывести из него целевое имя, которое в
отсутствие автоматически добавляемого префикса или суффикса приведет к совпадению цели и
имя источника и циклическая зависимость.

источник_фабрика
Фабричная функция, которую Builder будет использовать для преобразования любых источников, указанных в виде строк.
в узлы SCons. По умолчанию SCons предполагает, что все источники являются файлами. Другое полезное
значения source_factory включают Вы, потому что когда Builder использует каталог в качестве источника,
и Запись, когда Builder может использовать файлы или каталоги (или и то, и другое) в качестве источников.

Пример:

CollectBuilder = Builder (действие = my_mkdir, source_factory = запись)
env = Окружающая среда ()
env.Append(BUILDERS = {'Collect':CollectBuilder})
env.Collect('архив', ['имя_каталога', 'имя_файла'])

эмиттер
Функция или список функций для управления целевым и исходным списками перед
зависимости устанавливаются, и цель (цели) фактически построена. эмиттер Можно также
быть строкой, содержащей переменную конструкции для расширения до функции эмиттера или
список функций или словарь, отображающий суффиксы исходного файла на функции эмиттера.
(Только суффикс первого исходного файла используется для выбора фактического эмиттера.
функция из словаря эмиттера.)

Функция эмиттера принимает три аргумента: источник - список исходных узлов, цель - к
список целевых узлов, окр - среда строительства. Эмиттер должен возвращать
кортеж, содержащий два списка, список целей, которые должны быть построены этим компоновщиком, и
список источников для этого билдера.

Пример:

def e (цель, источник, среда):
return (цель + ['foo.foo'], источник + ['foo.src'])

# Простая ассоциация функции эмиттера с Builder.
b = Builder("my_build < $TARGET > $SOURCE",
эмиттер = е)

def e2 (цель, источник, окружение):
возврат (цель + ['bar.foo'], источник + ['bar.src'])

# Простая ассоциация списка функций-эмиттеров с Builder.
b = Builder("my_build < $TARGET > $SOURCE",
эмиттер = [e, e2])

# Вызов функции-эмиттера через конструкторскую переменную.
env = Окружающая среда (MY_EMITTER = e)
b = Builder("my_build < $TARGET > $SOURCE",
эмиттер = '$MY_EMITTER')

# Вызов списка функций-эмиттеров через конструкторскую переменную.
env = Окружающая среда (EMITTER_LIST = [e, e2])
b = Builder("my_build < $TARGET > $SOURCE",
эмиттер = '$ EMITTER_LIST')

# Связывание нескольких эмиттеров с разными файлами
# суффиксы с использованием словаря.
def e_suf1 (цель, источник, окружение):
return (цель + ['another_target_file'], источник)
def e_suf2 (цель, источник, окружение):
return (цель, источник + ['another_source_file'])
b = Builder("my_build < $TARGET > $SOURCE",
эмиттер = {'.suf1' : e_suf1,
'.suf2' : e_suf2})

много
Указывает, разрешено ли вызывать этот построитель несколько раз для одного и того же
целевой файл(ы). Значение по умолчанию равно 0, что означает, что построитель нельзя назвать несколькими
раз для одного и того же целевого файла (файлов). Многократный вызов строителя для одного и того же
target просто добавляет к цели дополнительные исходные файлы; не разрешается изменять
среду, связанную с целью, указать дополнительные переопределения среды или
связать другого строителя с целью.

окр
Среда построения, которую можно использовать для извлечения исходного кода с помощью этого Builder.
(Обратите внимание, что эта среда используется для обычных сборок обычных целевых файлов,
которые используют среду, которая использовалась для вызова Builder для целевого файла.)

генератор
Функция, которая возвращает список действий, которые будут выполнены для создания цели (целей).
из источника(ов). Возвращаемые действия могут быть объектом Action или чем-либо, что
может быть преобразован в объект Action (см. следующий раздел).

Функция генератора принимает четыре аргумента: источник - список исходных узлов, цель -
список целевых узлов, окр - строительная среда, на подпись - логическое значение
значение, указывающее, вызывается ли генератор для создания сборки
подпись (в отличие от фактического выполнения команды). Пример:

def g (источник, цель, окружение, for_signature):
вернуть [["gcc", "-c", "-o"] + цель + источник]

b = Строитель (генератор = g)

Команда генератор и действие аргументы не должны использоваться для одного и того же Builder.

src_builder
Указывает построитель, который следует использовать, когда суффикс имени исходного файла не соответствует ни одному из
суффиксы строителя. Использование этого аргумента создает многоэтапный построитель.

единственный источник
Указывает, что этот построитель ожидает ровно один исходный файл для каждого вызова. Давать больше, чем
один исходный файл без целевых файлов приводит к неявному вызову построителя
несколько раз (по одному разу для каждого источника). Предоставление нескольких исходных файлов вместе
с целевыми файлами приводит к исключению UserError.

Команда генератор и действие аргументы не должны использоваться для одного и того же Builder.

source_ext_match
Когда указанный действие аргумент - это словарь, поведение по умолчанию, когда
билдеру передается несколько исходных файлов, чтобы убедиться, что расширения всех
исходные файлы совпадают. Допустимо ли, чтобы этот билдер вызывался со списком исходных
файлы с разными расширениями, эту проверку можно подавить, установив
source_ext_match в Ничто или какое-то другое неверное значение. Когда source_ext_match is
отключить, бра будет использовать суффикс первого указанного исходного файла для выбора
соответствующие действия со стороны действие Словарь.

В следующем примере настройка source_ext_match предотвращает бра от выхода
с ошибкой из-за несоответствия суффиксов foo.in и foo.extra.

b = Builder(action={'.in' : 'создать $SOURCES > $TARGET'},
source_ext_match = Нет)

env = Среда (СТРОИТЕЛИ = {'MyBuild':b})
env.MyBuild('foo.out', ['foo.in', 'foo.extra'])

окр
Среда построения, которую можно использовать для извлечения исходного кода с помощью этого Builder.
(Обратите внимание, что эта среда используется для обычных сборок обычных целевых файлов,
которые используют среду, которая использовалась для вызова Builder для целевого файла.)

b = Builder(action="сборка <$SOURCE>$TARGET")
env = Окружающая среда (СТРОИТЕЛИ = {'MyBuild': b})
env.MyBuild('foo.out', 'foo.in', my_arg = 'xyzzy')

ChDir
Каталог, из которого scons будут выполнять действия, указанные для этого Builder. Если
ChDir аргумент представляет собой строку или узел каталога, scons изменится на указанный
каталог. Если ChDir не является строкой или узлом и не равен нулю, то scons будет
перейдите в каталог целевого файла.

Обратите внимание, что бра будут автоматически изменять его расширение переменных конструкции
" У аборигенов $ TARGET и $ ИСТОЧНИК при использовании аргумента ключевого слова chdir, то есть расширенного
имена файлов по-прежнему будут относиться к каталогу SConstruct верхнего уровня, и
следовательно, неверно относительно каталога chdir. Строители, созданные с помощью chdir
аргумент ключевого слова, нужно будет использовать расширения переменных построения, такие как
$ {TARGET.file} и $ {SOURCE.file} использовать только часть имени файла целей и
источник.

b = Builder(action="сборка < ${SOURCE.file} > ${TARGET.file}",
chdir = 1)
env = Окружающая среда (СТРОИТЕЛИ = {'MyBuild': b})
env.MyBuild('sub/dir/foo.out', 'sub/dir/foo.in')

ПРЕДУПРЕЖДЕНИЕ: Python сохраняет только одно текущее местоположение каталога для всех потоков. Этот
означает, что использование ChDir аргумент будет работа с SCons -j вариант, потому что
отдельные рабочие потоки, порожденные SCons, мешают друг другу при запуске
изменение каталога.

Любые дополнительные аргументы ключевого слова, предоставляемые при создании объекта Builder (т.
вызывается функция Builder()) будет установлена ​​в исполняемой среде построения
при вызове объекта Builder. Каноническим примером здесь было бы установить
конструкторская переменная в репозиторий системы исходного кода.

Любые дополнительные аргументы ключевого слова, предоставленные, когда Builder объект называется будет только
связанный с целью, созданной этим конкретным вызовом Builder (и любыми другими файлами
построенный в результате призыва).

Эти дополнительные аргументы ключевого слова передаются следующим функциям: генератор команд
функции, действия функций и функции эмиттера.

Экшн Объекты
Команда строитель() превратит свою действие аргумент ключевого слова в соответствующий внутренний
Объект действия. Вы также можете явно создавать объекты Action с помощью Экшн() Глобальный
функция, которая затем может быть передана в строитель() функция. Это можно использовать для
настроить объект Action более гибко, или это может быть просто более эффективно, чем позволить
каждый отдельный объект Builder создает отдельное действие, когда требуется несколько объектов Builder
делать то же самое.

Команда Экшн() глобальная функция возвращает соответствующий объект для действия, представленного
тип первого аргумента:

Экшн
Если первый аргумент уже является объектом Action, объект просто возвращается.

строка
Если первый аргумент является строкой, возвращается действие командной строки. Обратите внимание, что
строке командной строки может предшествовать @ (знак at) для подавления печати
указанной командной строки, или с помощью - (дефис), чтобы игнорировать статус выхода из
указанная команда:

Действие('$CC -c -o $TARGET $SOURCES')

# Не печатает выполняемую строку.
Действие('@build $TARGET $SOURCES')

# Игнорирует возвращаемое значение
Действие('-построить $TARGET $SOURCES')

Список
Если первым аргументом является список, то возвращается список объектов Action. Действие
объект создается по мере необходимости для каждого элемента в списке. Если элемент одной
список сам по себе является списком, внутренний список — это команда и аргументы, которые должны быть выполнены
через командную строку. Это позволяет заключать в аргумент пробелы с помощью
определение команды в списке внутри списка:

Действие([['cc', '-c', '-DWHITE SPACE', '-o', '$TARGET', '$SOURCES']])

Функция
Если первый аргумент является функцией Python, возвращается действие функции. Питон
функция должна принимать три аргумента ключевого слова, цель (объект Node, представляющий
целевой файл), источник (объект Node, представляющий исходный файл) и окр (
среда построения, используемая для построения целевого файла). цель и источник
аргументы могут быть списками объектов Node, если существует более одного целевого файла или источника
файл. Фактические имена целевых и исходных файлов могут быть получены из их узлов.
объекты с помощью встроенной функции Python str():

target_file_name = str(цель)
source_file_names = карта (лямбда x: строка (x), источник)

Функция должна возвращать 0 или Ничто чтобы указать на успешную сборку цели
файл(ы). Функция может вызвать исключение или вернуть ненулевой статус выхода в
указывают на неудачную сборку.

def build_it (цель = нет, источник = нет, окружение = нет):
# собрать цель из исходников
вернуть 0

a = Действие (build_it)

Если аргумент действия не является одним из перечисленных выше, возвращается None.

Второй аргумент является необязательным и используется для определения вывода, который печатается, когда
Действие действительно выполняется. При отсутствии этого параметра или если он пустой
строка, используется вывод по умолчанию в зависимости от типа действия. Например,
действие командной строки напечатает выполненную команду. Аргумент должен быть либо Python
функция или строка.

В первом случае это функция, которая возвращает строку, которая должна быть напечатана для описания
выполняемое действие. Функция также может быть указана с помощью функция= ключевое слово
аргумент. Подобно функции для создания файла, эта функция должна принимать три ключевых слова.
аргументы: цель (объект Node, представляющий целевой файл), источник (объект узла
представляющий исходный файл) и окр (строительная среда). цель и источник
аргументы могут быть списками объектов Node, если существует более одного целевого файла или источника
.

Во втором случае вы предоставляете саму строку. Строка также может быть указана
cmdstr= аргумент ключевого слова. Строка обычно содержит переменные, в частности $TARGET(S) и
$SOURCE(S) или состоит только из одной переменной, которая может быть где-то определена
еще. Сам SCons активно использует последний вариант.

Примеры:

def build_it (цель, источник, окружение):
# собрать цель из исходников
вернуть 0

def string_it (цель, источник, окружение):
вернуть "создание '%s' из '%s'" % (цель[0], источник[0])

# Используйте позиционный аргумент.
f = действие (build_it, string_it)
s = Action(build_it, "создание '$TARGET' из '$SOURCE'")

# В качестве альтернативы используйте аргумент ключевого слова.
f = действие (build_it, strfunction=string_it)
s = Action(build_it, cmdstr="создание '$TARGET' из '$SOURCE'")

# Вы можете указать настраиваемую переменную.
l = действие (build_it, '$STRINGIT')

Третий и последующие аргументы, если они присутствуют, могут быть либо конструкторской переменной, либо
список переменных построения, значения которых будут включены в сигнатуру
Действие при принятии решения о том, следует ли перестроить цель, потому что действие изменилось.
переменные также могут быть указаны с помощью список переменных= параметр ключевого слова; если оба присутствуют, они
сочетаются. Это необходимо всякий раз, когда вы хотите, чтобы цель была перестроена, когда определенная
переменные конструкции меняются. Это не часто требуется для строкового действия, так как
расширенные переменные обычно являются частью командной строки, но могут понадобиться, если
Действие функции Python использует значение конструктивной переменной при создании
командная строка.

def build_it (цель, источник, окружение):
# построить цель из конструкторской переменной 'XXX'
открыть (цель [0], 'w'). написать (env ['XXX'])
вернуть 0

# Используйте позиционные аргументы.
a = действие (build_it, '$STRINGIT', ['XXX'])

# В качестве альтернативы используйте аргумент ключевого слова.
a = действие (build_it, varlist=['XXX'])

Команда Экшн() глобальной функции могут быть переданы следующие необязательные аргументы ключевого слова в
изменить поведение объекта Action:

ChDir Команда ChDir Аргумент ключевого слова указывает, что scons выполнит действие после
переход в указанный каталог. Если ChDir аргумент - это строка или каталог
Node, scons перейдут в указанный каталог. Если ChDir аргумент не является строкой
или Node и не равно нулю, тогда scons перейдет в каталог целевого файла.

Обратите внимание, что бра будут автоматически изменять его раскрытие конструктивных переменных, таких как
$ TARGET и $ ИСТОЧНИК при использовании аргумента ключевого слова chdir - то есть расширенного файла
имена по-прежнему будут относиться к каталогу SConstruct верхнего уровня, и, следовательно,
неверно относительно каталога chdir. Строители, созданные с использованием аргумента ключевого слова chdir,
нужно будет использовать расширения переменных конструкции, такие как $ {TARGET.file} и $ {SOURCE.file}
использовать только часть имени файла для целей и источника.

a = Action("сборка < ${SOURCE.file} > ${TARGET.file}",
chdir = 1)

выходстатфунк Команда Экшн() глобальная функция также принимает выходстатфунк аргумент ключевого слова
который указывает функцию, которой передается статус выхода (или возвращаемое значение) из
указанное действие и может возвращать произвольное или измененное значение. Это можно использовать, для
Например, чтобы указать, что возвращаемое значение объекта Action должно игнорироваться в специальных
Таким образом, условия и SCons должны учитывать, что действие всегда завершается успешно:

защита всегда_succeed(s):
# Всегда возвращайте 0, что указывает на успех.
вернуть 0
a = Action("сборка < ${SOURCE.file} > ${TARGET.file}",
exitstatfunc=всегда_успешно)

пакетный_ключ Команда пакетный_ключ Аргумент ключевого слова можно использовать, чтобы указать, что действие может создавать
несколько целевых файлов путем одновременной обработки нескольких независимых исходных файлов. (
каноническим примером является "пакетная компиляция" нескольких объектных файлов путем передачи нескольких
исходные файлы в один вызов компилятора, такого как Microsoft Visual C/C++
компилятор.) Если пакетный_ключ Аргумент — это любое неложное, не вызываемое значение Python,
сконфигурированный объект Action вызовет бра собрать все цели, построенные с помощью действия
объект и сконфигурирован с одной и той же средой построения в одиночные вызовы
командная строка или функция объекта Action. Командные строки обычно хотят использовать
ИЗМЕНЕННЫЕ_ИСТОЧНИКИ строительная переменная (и, возможно, CHANGED_TARGETS тоже) только пройти
в командную строку те источники, которые фактически изменились с тех пор, как их цели были
встроенный.

Пример:

a = Действие («создать $CHANGED_SOURCES», batch_key = True)

Команда пакетный_ключ аргумент также может быть вызываемой функцией, которая возвращает ключ, который будет
используется для идентификации различных «пакетов» целевых файлов, которые необходимо собрать для пакетного построения. А
пакетный_ключ функция должна принимать следующие аргументы:

действие
Объект действия.

окр
Среда построения, настроенная для цели.

цель
Список целей для определенного настроенного действия.

источник
Список источников для определенного настроенного действия.

Возвращаемый ключ обычно должен быть кортежем значений, полученных из аргументов,
используя любую подходящую логику, чтобы решить, как следует группировать несколько вызовов. За
например, пакетный_ключ функция может решить вернуть значение определенного
строительная переменная из окр аргумент, который вызовет бра пакетная сборка
цели с соответствующими значениями этой переменной или, возможно, вернуть id() принадлежащий
вся строительная среда, и в этом случае бра будет пакетно строить все цели
сконфигурирован с той же средой конструирования. Возвращение Ничто указывает на то, что
конкретная цель должна быть частью любой пакетной сборки, но вместо этого будет построен
отдельным вызовом команды или функции действия. Пример:

def batch_key (действие, окружение, цель, источник):
tdir = цель[0].dir
если tdir.name == 'специальный':
# Не создавать пакетную сборку любой цели
# в подкаталоге special/.
возврат Нет
возврат (идентификатор (действие), идентификатор (окружение), tdir)
a = действие («собрать $CHANGED_SOURCES», batch_key=batch_key)

Прочее Экшн функции
бра предоставляет ряд функций, которые упорядочивают различные общие файлы и каталоги.
манипуляции, которые необходимо выполнить. Они похожи по концепции на «задачи» в сборке Ant.
инструмент, хотя реализация немного отличается. Эти функции фактически не
выполнить указанное действие во время вызова функции, но вместо этого вернуть
Объект действия, который может быть выполнен в нужное время. (В объектно-ориентированном
терминологии, на самом деле это Action Завод функции, которые возвращают объекты Action.)

На практике существует два естественных способа, которыми эти функции действия должны быть реализованы.
используемый.

Во-первых, если вам нужно выполнить действие во время чтения файла SConscript,
вы можете использовать Выполнить глобальная функция для этого:

Выполнить(Прикоснуться('файл'))

Во-вторых, вы можете использовать эти функции для предоставления действий в списке для использования Command
метод. Это может позволить вам выполнять более сложные последовательности манипуляций с файлами.
не полагаясь на внешние команды для конкретной платформы:

env = Среда (TMPBUILD = '/tmp/builddir')
env.Command('foo.out', 'foo.in',
[Мкдир('$TMPBUILD'),
Копировать('$TMPBUILD', '${SOURCE.dir}'),
"cd $TMPBUILD && сделать",
Удалить('$TMPBUILD')])

Чмод(Dest, Режим)
Возвращает объект Action, который изменяет разрешения для указанного Dest файл или
каталог в указанный Режим, Примеры:

Выполнить(Chmod('файл', 0755))

env.Command('foo.out', 'foo.in',
[Копировать('$ЦЕЛЬ', '$ИСТОЧНИК'),
Chmod('$TARGET', 0755)])

Копировать(Dest, SRC)
Возвращает объект Action, который скопирует SRC исходный файл или каталог в Dest
конечный файл или каталог. Примеры:

Выполнить(Копировать('foo.output', 'foo.input'))

env.Command('bar.out', 'bar.in',
Копировать('$ ЦЕЛЬ', '$ ИСТОЧНИК'))

Удалить(запись[must_exist])
Возвращает действие, которое удаляет указанный запись, который может быть файлом или каталогом
дерево. Если каталог указан, все дерево каталогов будет удалено. Если
must_exist флаг установлен, то будет выдана ошибка Python, если указанная запись
не существует; по умолчанию must_exist=0, то есть Действие молча ничего не сделает
если запись не существует. Примеры:

Выполнить(Удалить('/tmp/buildroot'))

env.Command('foo.out', 'foo.in',
[Удалить('${ЦЕЛЬ.каталог}'),
MyBuildAction])

Выполнить(Удалить('файл_который_должен_существовать', должен_существовать=1))

Мкдир(директория)
Возвращает действие, которое создает указанный каталог директория . Примеры:

Выполнить(Mkdir('/tmp/outputdir'))

env.Command('foo.out', 'foo.in',
[Mkdir('/tmp/builddir'),
Копировать('/tmp/builddir/foo.in', '$ИСТОЧНИК'),
"cd /tmp/builddir && make",
Копировать('$TARGET', '/tmp/builddir/foo.out')])

Шаг(Dest, SRC)
Возвращает действие, которое перемещает указанный SRC файл или каталог в указанный Dest
файл или каталог. Примеры:

Выполнить(Переместить('файл.назначение', 'файл.источник'))

env.Command('выходной_файл', 'входной_файл',
[MyBuildAction,
Переместить('$TARGET', 'file_created_by_MyBuildAction')])

Трогать(файл)
Возвращает действие, которое обновляет время модификации для указанного файл, Примеры:

Выполнить(Прикоснуться('file_to_be_touched'))

env.Command('маркер', 'входной_файл',
[MyBuildAction,
Нажмите('$TARGET')])

Технология подмена
Перед выполнением команды бра выполняет интерполяцию переменных построения на
строки, из которых состоит командная строка сборщиков. Переменные вводятся с помощью $ приставка.
Помимо переменных построения, scons предоставляет следующие переменные для каждой команды.
исполнение:

ИЗМЕНЕННЫЕ_ИСТОЧНИКИ
Имена файлов всех исходников команды сборки, которые изменились с момента создания цели.
был построен последним.

CHANGED_TARGETS
Имена файлов всех целей, которые будут созданы из источников, которые изменились с момента
цель была построена последней.

ИСТОЧНИК
Имя файла источника команды сборки или имя файла первого источника
если создается несколько источников.

ИСТОЧНИКИ
Имена файлов исходников команды сборки.

TARGET
Имя файла создаваемой цели или имя файла первой цели, если
строятся несколько целей.

ЦЕЛЕВЫЕ
Имена файлов всех создаваемых целей.

НЕИЗМЕНЕННЫЕ_ИСТОЧНИКИ
Имена файлов всех исходников команды сборки, которые изменилось с тех пор
цель была построена последней.

UNCHANGED_TARGETS
Имена файлов всех целей, которые будут созданы из исходных кодов, менялась
с тех пор, как цель была построена в последний раз.

(Обратите внимание, что вышеуказанные переменные зарезервированы и не могут быть установлены в конструкции
Окружающая среда.)

Например, при заданной переменной построения CC='cc', target=['foo'] и
источники=['foo.c', 'bar.c']:

action='$CC -c -o $ЦЕЛЬ $ИСТОЧНИКИ'

выдаст командную строку:

cc -c -o foo foo.c bar.c

Имена переменных могут быть заключены в фигурные скобки ({}), чтобы отделить имя от
завершающие символы. Внутри фигурных скобок имя переменной может иметь срез Python
добавленный нижний индекс для выбора одного или нескольких элементов из списка. В предыдущем примере значение
строка:

${ИСТОЧНИКИ[1]}

произвел бы:

бар.с

Кроме того, к имени переменной могут быть добавлены следующие специальные модификаторы.
закрывающие фигурные скобки для изменения интерполированной строки:

Использование темпера с изогнутым основанием
Базовый путь имени файла, включая путь к каталогу, но без суффикса.

директория
Имя каталога, в котором находится файл.

файл
Имя файла за вычетом любой части каталога.

файловая база
Просто базовое имя файла без суффикса и каталога.

суффикс
Просто расширение файла.

абспат
Абсолютный путь к файлу.

POSIX
Форма пути POSIX с каталогами, разделенными / (косая черта) не
обратная косая черта. Это иногда необходимо в системах Windows, когда путь ссылается на
файл в других (POSIX) системах.

исходный путь
Каталог и имя файла исходного файла, связанного с этим файлом через
ВариантDir(). Если этот файл не связан, он просто возвращает каталог и имя файла
без изменений.

исходный каталог
Каталог, содержащий исходный файл, связанный с этим файлом через ВариантDir(). Если
этот файл не связан, он просто возвращает часть имени файла, относящуюся к каталогу.

rsrcpath
Каталог и имя файла исходного файла, связанного с этим файлом через
ВариантDir(). Если файл не существует локально, но существует в репозитории, путь
в репозиторий возвращается. Если этот файл не связан, он просто возвращает
каталог и имя файла без изменений.

rsrcdir
Каталог репозитория, содержащий исходный файл, связанный с этим файлом через
ВариантDir(). Если этот файл не связан, он просто возвращает часть каталога
имя файла.

Например, указанная цель будет расширяться следующим образом для соответствующих модификаторов:

$TARGET => sub/dir/file.x
${TARGET.base} => подкаталог/файл
${TARGET.dir} => подкаталог/каталог
${TARGET.file} => файл.x
${TARGET.filebase} => файл
${TARGET.suffix} => .x
${TARGET.abspath} => /top/dir/sub/dir/file.x

SConscript('src/SConscript', variant_dir='sub/dir')
$SOURCE => sub/dir/file.x
${SOURCE.srcpath} => источник/файл.x
${SOURCE.srcdir} => источник

Репозиторий('/usr/репозиторий')
$SOURCE => sub/dir/file.x
${SOURCE.rsrcpath} => /usr/repository/src/file.x
${SOURCE.rsrcdir} => /usr/repository/src

Обратите внимание, что фигурные скобки также могут использоваться для заключения произвольного кода Python, который будет
оценивается. (На самом деле так подставляются вышеуказанные модификаторы, они просто
атрибуты объектов Python, которые представляют ЦЕЛЬ, ИСТОЧНИКИ и т. д.) См. раздел
«Подстановка кода Python» ниже, чтобы увидеть более подробные примеры того, как это можно использовать.

Наконец, имя переменной может быть вызываемой функцией Python, связанной с конструкцией.
переменная в окружающей среде. Функция должна принимать четыре аргумента: цель - список
целевые узлы, источник - список исходных узлов, окр - строительная среда,
на подпись - логическое значение, указывающее, вызывается ли функция для
создание подписи сборки. SCons будет вставлять все, что возвращает вызванная функция, в
расширенная строка:

def foo (цель, источник, окружение, for_signature):
вернуть "бар"

# Расширит $BAR до "bar baz"
env = Окружающая среда (FOO = foo, BAR = "$ FOO баз")

Вы можете использовать эту функцию для передачи аргументов функции Python, создав вызываемый объект.
класс, который хранит один или несколько аргументов в объекте, а затем использует их, когда
__вызов__() метод называется. Обратите внимание, что в этом случае все расширение переменной должно быть
заключены в фигурные скобки, так что аргументы будут связаны с инстанцированием
класса:

класс foo (объект):
def __init__(я, аргумент):
self.arg = аргумент

def __call__(я, цель, источник, окружение, for_signature):
вернуть self.arg + "bar"

# Расширит $BAR до "моя панель аргументов baz"
env=Environment(FOO=foo, BAR="${FOO('мой аргумент')} baz")

Специальные псевдопеременные $( и $) может использоваться для выделения частей командной строки
это может измениться без вызывающие перестройку, то есть, которые не включены в
подпись целевых файлов, созданных с помощью этой команды. Весь текст между $( и $) будет
удаляется из командной строки перед добавлением в сигнатуры файлов, а $( и $)
будут удалены до выполнения команды. Например, командная строка:

echo Произошла последняя сборка $($TODAY $). > $ЦЕЛЬ

выполнит команду:

echo Произошла последняя сборка $TODAY. > $ЦЕЛЬ

но сигнатура команды, добавленная к любым целевым файлам, будет следующей:

echo Произошла последняя сборка. > $ЦЕЛЬ

Питон Code подмена
Любой код Python внутри ${-} пары оцениваются с помощью python 'eval' с глобальными переменными python
установить в текущий набор переменных построения среды. Итак, в следующем случае:

env['УСЛОВИЕ'] = 0
env.Command('foo.out', 'foo.in',
'''echo ${COND==1 и 'FOO' или 'BAR'} > $TARGET''')

выполняемая команда будет либо

эхо FOO > foo.out

or

эхо BAR > foo.out

в соответствии с текущим значением env['COND'] при выполнении команды. Оценка
происходит при построении цели, а не при чтении SConscript. Так что если
env['COND'] изменяется позже в SConscript, будет использоваться окончательное значение.

Вот более интересный пример. Обратите внимание, что все COND, FOO и BAR относятся к среде.
переменные, и их значения подставляются в финальную команду. FOO — это список, поэтому его
элементы интерполируются через пробелы.

env=окружающая среда()
env['УСЛОВИЕ'] = 0
env['FOO'] = ['foo1', 'foo2']
env['BAR'] = 'варвар'
env.Command('foo.out', 'foo.in',
'эхо ${COND==1 и FOO или BAR} > $TARGET')

# Выполнит это:
# эхо foo1 foo2 > foo.out

SCons использует следующие правила при преобразовании переменных построения в командные строки:

строка
Когда значение представляет собой строку, оно интерпретируется как список командной строки, разделенный пробелами.
аргументы.

Список
Когда значение представляет собой список, оно интерпретируется как список аргументов командной строки. Каждый
элемент списка преобразуется в строку.

Другой
Все, что не является списком или строкой, преобразуется в строку и интерпретируется как
один аргумент командной строки.

Новая линия
Символы новой строки (\n) разграничивают строки. Разбор новой строки выполняется после всех остальных
синтаксический анализ, поэтому невозможно, чтобы аргументы (например, имена файлов) содержали встроенные
символы новой строки. Это ограничение, скорее всего, исчезнет в будущей версии SCons.

Сканер Объекты
Вы можете использовать Сканер функция для определения объектов для сканирования новых типов файлов на неявные
зависимости. Сканер функция принимает следующие аргументы:

функция
Это может быть либо: 1) функция Python, которая будет обрабатывать Node (файл) и возвращать
список файловых узлов, представляющих неявные зависимости (имена файлов), найденные в
содержание; или: 2) словарь, который отображает ключи (обычно суффикс файла, но см. ниже
для более подробного обсуждения) другим сканерам, которые должны быть вызваны.

Если аргумент на самом деле является функцией Python, функция должна принимать три или четыре
аргументы:

def scan_function (узел, окружение, путь):

def scan_function (узел, окружение, путь, аргумент = нет):

Команда узел аргумент — это внутренний узел SCons, представляющий файл. Использовать ул (узел) в
получить имя файла и узел.get_contents() чтобы получить содержимое файла.
Обратите внимание, что файл гарантированно существует до вызова сканера, поэтому
функция сканера должна проверить, есть ли шанс, что отсканированный файл может
не существует (например, если он собран из других файлов).

Команда окр аргументом является среда построения для сканирования. Получить значения из него
используя env.Словарь() метод.

Команда путь аргумент представляет собой кортеж (или список) каталогов, в которых можно искать файлы.
Обычно это кортеж, возвращаемый путь_функция аргумент (см. ниже).

Команда аргумент аргумент — это аргумент, предоставленный при создании сканера, если он есть.

имя
Имя сканера. Это в основном используется для внутренней идентификации сканера.

аргумент
Необязательный аргумент, который, если он указан, будет передан в функцию сканера.
(описано выше) и функция пути (описана ниже).

скейс
Необязательный список, который можно использовать для определения того, какой сканер следует использовать для
данный узел. В обычном случае сканирования имен файлов этим аргументом будет список
суффиксов для различных типов файлов, которые этот сканер умеет сканировать. Если
аргумент является строкой, тогда он будет расширен в список текущей средой.

путь_функция
Функция Python, принимающая четыре или пять аргументов: среда построения,
Узел для каталога, содержащего файл SConscript, в котором находилась первая цель.
определен, список целевых узлов, список исходных узлов и необязательный аргумент
поставляется при создании сканера. путь_функция возвращает кортеж
каталоги, в которых можно искать файлы, возвращаемые этим объектом сканера.
(Обратите внимание, что FindPathDirs() можно использовать для возврата готового
путь_функция для заданного имени переменной конструкции, вместо того, чтобы писать свой
собственная функция с нуля.)

класс_узла
Класс Node, который должен быть возвращен этим объектом Scanner. Любые строки или другие
объекты, возвращаемые функцией сканера, которые не относятся к этому классу, будут запущены
через node_factory функции.

node_factory
Функция Python, которая берет строку или другой объект и превращает его в
соответствующий класс узла, который должен быть возвращен этим объектом сканера.

scan_check
Необязательная функция Python, которая принимает два аргумента: узел (файл) и конструкцию.
среде и возвращает, действительно ли узел должен быть просканирован на наличие
зависимости. Эту проверку можно использовать для исключения ненужных обращений к сканеру
работать, когда, например, базовый файл, представленный узлом, еще не
существовать.

рекурсивный
Необязательный флаг, указывающий, следует ли повторно вызывать этот сканер в
файлы зависимостей, возвращенные сканером. Если этот флаг не установлен, узел
подсистема будет вызывать сканер только для сканируемого файла, а не (для
пример) также в файлах, указанных строками #include в сканируемом файле.
рекурсивный может быть вызываемой функцией, и в этом случае она будет вызываться со списком
Узлы найдены и должны возвращать список Узлов, которые следует рекурсивно сканировать; это
может использоваться для выбора определенного подмножества узлов для дополнительного сканирования.

Обратите внимание, что бра имеет глобальный ИсходныйФайлСканер объект, который используется объект(),
Общий объект(), а также СтатикОбъект() строители решают, какой сканер следует использовать для
различные расширения файлов. Вы можете с помощью SourceFileScanner.add_scanner() метод добавления
свой собственный объект Scanner в бра инфраструктура, которая строит целевые программы или
библиотеки из списка исходных файлов разных типов:

def xyz_scan (узел, окружение, путь):
содержимое = узел.get_text_contents()
# Сканировать содержимое и вернуть включенные файлы.

XYZScanner = Сканер (xyz_scan)

SourceFileScanner.add_scanner('.xyz', XYZScanner)

env.Program('my_prog', ['file1.c', 'file2.f', 'file3.xyz'])

ДЛЯ СИСТЕМЫ ПОВЕДЕНИЕ

SCons и его конфигурационные файлы очень переносимы, во многом благодаря их реализации в
Питон. Однако есть несколько проблем с переносимостью, которые могут застать врасплох неосторожных.

.C файл суффикс
SCons обрабатывает верхний регистр .C суффикс файла по-разному, в зависимости от возможностей
базовая система. В системах с учетом регистра, таких как Linux или UNIX, SCons обрабатывает
файл с .C суффикс исходного файла C++. В системе, нечувствительной к регистру, такой как Windows,
SCons обрабатывает файл с .C суффикс в качестве исходного файла C.

.F файл суффикс
SCons обрабатывает верхний регистр .F суффикс файла по-разному, в зависимости от возможностей
базовая система. В системах с учетом регистра, таких как Linux или UNIX, SCons обрабатывает
файл с .F суффикс в качестве исходного файла Fortran, который должен быть сначала запущен через
стандартный препроцессор Си. В системе, нечувствительной к регистру, такой как Windows, SCons обрабатывает файл
с .F суффикс в качестве исходного файла Fortran, который должен быть запущенным через C
препроцессор.

Windows: Cygwin Инструменты и Cygwin Питон против Windows Питоны
Cygwin предоставляет набор инструментов и утилит, которые позволяют пользователям работать в системе Windows, используя
более POSIX-подобная среда. Инструменты Cygwin, включая Cygwin Python, делают это в
часть, разделяя способность интерпретировать UNIX-подобные имена путей. Например, Cygwin.
инструменты будут внутренне переводить имя пути Cygwin, например /cygdrive/c/mydir, в эквивалентное
Путь Windows к C:/mydir (эквивалентен C:\mydir).

Версии Python, созданные для собственного исполнения Windows, такие как python.org и
Версии ActiveState не имеют семантики имени пути Cygwin. Это означает, что с помощью
собственная версия Python для Windows для создания скомпилированных программ с использованием инструментов Cygwin (таких как
gcc, bison и flex) могут привести к непредсказуемым результатам. "Смешивание и сопоставление" таким образом
можно заставить работать, но это требует особого внимания к использованию имен путей в
Файлы SConscript.

На практике пользователи могут обойти эту проблему, приняв следующие правила:
используйте поставляемый Cygwin интерпретатор Python для запуска SCons; при использовании Microsoft Visual C/C++
(или какой-либо другой компилятор Windows) используйте версию Python python.org или ActiveState для
запустить SCons.

Windows: scons.bat файл
В системах Windows SCons выполняется через оболочку scons.bat файл. Это имеет (по крайней мере)
два разветвления:

Во-первых, пользователи командной строки Windows, которые хотят использовать назначение переменных в командной строке.
возможно, придется поставить двойные кавычки вокруг назначений:

scons "FOO=BAR" "BAZ=BLEH"

Во-вторых, оболочка Cygwin не распознает этот файл как аналогичный бра
команда, выдаваемая в командной строке. Вы можете обойти это, выполнив
scons.bat из командной строки Cygwin или создав сценарий оболочки с именем бра
.

MinGW
Каталог bin MinGW должен находиться в вашей переменной окружения PATH или в переменной PATH.
под переменной построения ENV для SCons для обнаружения и использования инструментов MinGW. Когда
работая под родным интерпретатором Windows Python, SCons предпочтут инструменты MinGW
над инструментами Cygwin, если они оба установлены, независимо от порядка корзины
каталоги в переменной PATH. Если у вас установлены и MSVC, и MinGW, и вы хотите
чтобы использовать MinGW вместо MSVC, вы должны явно указать SCons использовать MinGW, передав

инструменты=['mingw']

к функции Environment(), потому что SCons предпочтут инструменты MSVC, а не MinGW.
инструментов.

ПРИМЕРЫ

Чтобы помочь вам начать работу с SCons, в этом разделе содержится краткий обзор некоторых распространенных
Задачи.

Базовый Сборник от a Один Источник Файл
env = Окружающая среда ()
env.Program (цель = 'foo', источник = 'foo.c')

Примечание. Создайте файл, указав цель в качестве аргумента ("scons foo" или "scons
foo.exe"). Или указав точку ("scons .").

Базовый Сборник от Многочисленные Источник Файлы
env = Окружающая среда ()
env.Program (цель = 'foo', источник = Split ('f1.c f2.c f3.c'))

настройка a Сборник Флаг
env = Окружающая среда (CCFLAGS = '-g')
env.Program (цель = 'foo', источник = 'foo.c')

Поиск Команда Местное Каталог Что касается .h Файлы
Примечание: вы делаете необходимо установить CCFLAGS, чтобы указать параметры -I вручную. SCons будет строить
правый -I варианты из CPPPATH.

env = Среда (CPPPATH = ['.'])
env.Program (цель = 'foo', источник = 'foo.c')

Поиск Многочисленные Справочники Что касается .h Файлы
env = Среда (CPPPATH = ['include1', 'include2'])
env.Program (цель = 'foo', источник = 'foo.c')

Здание a статический Библиотека
env = Окружающая среда ()
env.StaticLibrary(target = 'foo', source = Split('l1.c l2.c'))
env.StaticLibrary (цель = 'бар', источник = ['l3.c', 'l4.c'])

Здание a общий Библиотека
env = Окружающая среда ()
env.SharedLibrary (цель = 'foo', источник = ['l5.c', 'l6.c'])
env.SharedLibrary(target = 'bar', source = Split('l7.c l8.c'))

Связывающий a Местное Библиотека В a Программа
env = Environment (LIBS = 'mylib', LIBPATH = ['.'])
env.Library(target = 'mylib', source = Split('l1.c l2.c'))
env.Program (цель = 'программа', источник = ['p1.c', 'p2.c'])

Определяющий ВАШЕ Собственный строитель объект
Обратите внимание, что когда вы вызываете Builder, вы можете не указывать суффикс целевого файла и
SCons добавит его автоматически.

bld = Builder(action = 'pdftex <$SOURCES>$TARGET'
суффикс = '.pdf',
src_suffix = '.tex')
env = Окружающая среда (СТРОИТЕЛИ = {'PDFBuilder': bld})
env.PDFBuilder (цель = 'foo.pdf', источник = 'foo.tex')

# Следующее создает "bar.pdf" из "bar.tex"
env.PDFBuilder (цель = 'бар', источник = 'бар')

Также обратите внимание, что приведенная выше инициализация перезаписывает объекты Builder по умолчанию, поэтому
Среда, созданная выше, не может использоваться для вызовов Builders, таких как env.Program(), env.Object(),
env.StaticLibrary() и т.д.

Добавление ВАШЕ Собственный строитель объект в an Окружающая среда
bld = Builder(action = 'pdftex <$SOURCES>$TARGET'
суффикс = '.pdf',
src_suffix = '.tex')
env = Окружающая среда ()
env.Append(BUILDERS = {'PDFBuilder': bld})
env.PDFBuilder (цель = 'foo.pdf', источник = 'foo.tex')
env.Program (target = 'bar', source = 'bar.c')

Вы также можете использовать другие методы Pythonic для добавления в строительную переменную BUILDERS,
, таких как:

env = Окружающая среда ()
env['BUILDERS]['PDFBuilder'] = bld

Определяющий ВАШЕ Собственный Сканер объект
В следующем примере показан очень простой сканер (т. kfile_scan() функция), которая
вообще не использует путь поиска и просто возвращает имена файлов, присутствующие на любом включают
строк в отсканированном файле. Это неявно предполагает, что все включенные файлы находятся в
каталог верхнего уровня:

импорт ре

include_re = re.compile(r'^include\s+(\S+)$', re.M)

def kfile_scan (узел, окружение, путь, аргумент):
содержимое = узел.get_text_contents()
include = include_re.findall (содержимое)
вернуть env.File (включает)

kscan = Сканер (имя = 'kfile',
функция = kfile_scan,
аргумент = нет,
skeys = ['.k'])
сканеры = Окружающая среда (). Словарь ('СКАНЕРЫ')
env = Окружающая среда (СКАНЕРЫ = сканеры + [kscan])

env.Command('foo', 'foo.k', 'kprocess < $SOURCES > $TARGET')

bar_in = Файл('bar.in')
env.Command('bar', bar_in, 'kprocess $SOURCES > $TARGET')
bar_in.target_scanner = ксскан

Важно отметить, что вы должны вернуть список файловых узлов из сканирования.
функции, простые строки для имен файлов не подойдут. Как в примерах, которые мы показываем
здесь вы можете использовать Файл() функция вашей текущей среды для создания узлов
на лету из последовательности имен файлов с относительными путями.

Вот аналогичный, но более полный пример, который ищет путь к каталогам (указанный
как МОЙ ПУТЬ конструкторская переменная) для реально существующих файлов:

импорт ре
импорт ОС
include_re = re.compile(r'^include\s+(\S+)$', re.M)

def my_scan (узел, окружение, путь, аргумент):
содержимое = узел.get_text_contents()
include = include_re.findall (содержимое)
если включает == []:
возвращение []
результаты = []
для вкл. включает:
для каталога в пути:
файл = ул (каталог) + os.sep + inc
если os.path.exists (файл):
результаты.append(файл)
перерыв
вернуть env.File (результаты)

сканер = Сканер (имя = 'myscanner',
функция = мой_скан,
аргумент = нет,
ключи = ['.x'],
path_function = FindPathDirs('MYPATH')
)
сканеры = Окружающая среда (). Словарь ('СКАНЕРЫ')
env = Среда (СКАНЕРЫ = сканеры + [сканер],
МОЙ ПУТЬ = ['вкл'])

env.Command('foo', 'foo.x', 'xprocess < $SOURCES > $TARGET')

Команда FindPathDirs(), использованная в предыдущем примере, возвращает функцию (на самом деле
вызываемый объект Python), который вернет список каталогов, указанных в $МОЙ ПУТЬ
строительная переменная. Это позволяет SCons обнаруживать файл incs/foo.inc , даже если foo.x содержит
линия включают foo.inc Только. Если вам нужно настроить способ получения пути поиска,
вы бы предоставили свой собственный путь_функция аргумент при создании объекта Scanner, как
следующим образом:

# MYPATH - это список каталогов для поиска файлов в
def pf(env, dir, target, source, arg):
top_dir = Каталог('#').abspath
результаты = []
если «MYPATH» в env:
для p в env['MYPATH']:
results.append(top_dir + os.sep + p)
результаты возврата

сканер = Сканер (имя = 'myscanner',
функция = мой_скан,
аргумент = нет,
ключи = ['.x'],
функция_пути = pf
)

Создающий a иерархическая Построить
Обратите внимание, что имена файлов, указанные в файле SConscript подкаталога, относятся к
этот подкаталог.

SПостроить:

env = Окружающая среда ()
env.Program (цель = 'foo', источник = 'foo.c')

SConscript('sub/SConscript')

суб/SConscript:

env = Окружающая среда ()
# Создает sub/foo из sub/foo.c
env.Program (цель = 'foo', источник = 'foo.c')

SConscript('каталог/SConscript')

подкаталог/SConscript:

env = Окружающая среда ()
# Создает sub/dir/foo из sub/dir/foo.c
env.Program (цель = 'foo', источник = 'foo.c')

разделение Переменные от SПризывник Файлы
Вы должны явно указать переменные Export() и Import(), которые вы хотите разделить между
Файлы SConscript.

SПостроить:

env = Окружающая среда ()
env.Program (цель = 'foo', источник = 'foo.c')

Экспорт ("окружение")
SConscript('подкаталог/SConscript')

подкаталог/SConscript:

Импорт ("окружение")
env.Program (цель = 'foo', источник = 'foo.c')

Здание Многочисленные Варианты от Одна и та же Источник
Используйте аргумент ключевого слова variant_dir для функции SConscript, чтобы установить один или несколько
отдельные деревья каталогов сборки вариантов для данного исходного каталога:

SПостроить:

cppdefine = ['FOO']
Экспорт ("cppdefines")
SConscript('src/SConscript', variant_dir='foo')

cppdefine = ['BAR']
Экспорт ("cppdefines")
SConscript('src/SConscript', variant_dir='bar')

src / SConscript:

Импорт ("cppопределяет")
env = среда (CPPDEFINES = cppdefines)
env.Program (цель = 'src', источник = 'src.c')

Обратите внимание на использование метода Export() для установки переменной "cppdefines" в другое значение.
каждый раз, когда мы вызываем функцию SConscript.

иерархическая Построить of Две Библиотеки Связанный В a Программа
SПостроить:

env = Среда (LIBPATH = ['#libA', '#libB'])
Экспорт ('env')
SConscript('libA/SConscript')
SConscript('libB/SConscript')
SConscript('Основной/SConscript')

libA/SConscript:

Импорт('окружение')
env.Library('a', Разделить('a1.c a2.c a3.c'))

libB/SConscript:

Импорт('окружение')
env.Library('b', Разделить('b1.c b2.c b3.c'))

Основной/SConscript:

Импорт('окружение')
e = env.Copy (LIBS = ['a', 'b'])
e.Program('foo', Разделить('m1.c m2.c m3.c'))

'#' в каталогах LIBPATH указывает, что они относятся к каталогам верхнего уровня.
каталог, поэтому они не превращаются в «Main/libA» при использовании в Main/SConscript.

Указание только «a» и «b» для имен библиотек позволяет SCons добавлять соответствующие
префикс и суффикс библиотеки для текущей платформы (например, «liba.a» в POSIX).
системы, «a.lib» в Windows).

Модификация оборудования строительство переменные от команду линии.
Следующее позволит указать компилятор C в командной строке или в
файл custom.py.

vars = переменные('custom.py')
vars.Add('CC', 'Компилятор C.')
env = среда (переменные = переменные)
Справка (vars.GenerateHelpText (env))

Пользователь может указать компилятор C в командной строке:

scons "CC=my_cc"

или в файле custom.py:

CC = 'my_cc'

или получить документацию по вариантам:

$scons-h

CC: Компилятор C.
по умолчанию: нет
фактический: куб.см

. Microsoft визуальный C + + предварительно скомпилированный Заголовки
Поскольку windows.h включает в себя все, включая кухонную раковину, может потребоваться довольно много времени, чтобы
компилировать его снова и снова для набора объектных файлов, поэтому Microsoft предоставляет
механизм для компиляции набора заголовков один раз, а затем включения ранее скомпилированного
заголовки в любом объектном файле. Эта технология называется предварительно скомпилированными заголовками. Генерал
Рецепт заключается в создании файла с именем «StdAfx.cpp», который включает один заголовок с именем
«StdAfx.h», а затем включите каждый заголовок, который вы хотите предварительно скомпилировать, в «StdAfx.h», и
наконец, включите «StdAfx.h» в качестве первого заголовка во все исходные файлы, которые вы компилируете.
к объектным файлам. Например:

StdAfx.h:

#включают
#включают

StdAfx.cpp:

#включают

Фу.cpp:

#включают

/* делаем что-нибудь */

Бар.cpp:

#включают

/* делаем что-то еще */

SПостроить:

env=окружающая среда()
env['PCHSTOP'] = 'StdAfx.h'
env['PCH'] = env.PCH('StdAfx.cpp')[0]
env.Program('MyApp', ['Foo.cpp', 'Bar.cpp'])

Для получения дополнительной информации см. документ для построителя PCH, а также PCH и PCHSTOP.
строительные переменные. Чтобы узнать о деталях предварительно скомпилированных заголовков, обратитесь к MSDN.
документация для /Yc, /Yu и /Yp.

. Microsoft визуальный C + + и, что лучший способ отладка информация
Поскольку включение отладочной информации в программы и общие библиотеки может привести к их
значительно увеличить размер, Microsoft предоставляет механизм для включения отладки
информация во внешнем файле, называемом файлом PDB. SCons поддерживает файлы PDB через
Переменная построения PDB.

SПостроить:

env=окружающая среда()
env['PDB'] = 'MyApp.pdb'
env.Program('MyApp', ['Foo.cpp', 'Bar.cpp'])

Для получения дополнительной информации см. документ для переменной построения PDB.

ОКРУЖАЮЩАЯ СРЕДА

SCONS_LIB_DIR
Задает каталог, содержащий каталог модуля SCons Python (например,
/home/areach/scons-src-0.01/src/engine).

СКОНСФЛАГИ
Строка опций, которые будут использоваться scons в дополнение к переданным в
командная строка.

Используйте scons онлайн с помощью сервисов onworks.net