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

ПРОГРАММА:

ИМЯ

aegis новый файл - добавить новые файлы, которые будут созданы при изменении

СИНТАКСИС

эгида -Новый файл имя файла... [ вариант...]
эгида -Новый файл -Список [ вариант...]
эгида -Новый файл -Помощь

ОПИСАНИЕ

Ассоциация эгида -Новый файл команда используется для добавления новых файлов к изменению. Именованные файлы будут
быть добавленным в список файлов в изменении.

Для каждого названного файла в каталоге разработки создается новый файл, если это не так.
уже существуют. Если файл уже существует, он не будет изменен.

Если вы хотите, чтобы новый исходный файл был исполняемым (например, сценарии оболочки), тогда вы
просто используйте нормальный CHMOD(1) команда. Если какой-либо из исполняемых битов файла установлен на
Aede(1) раз, когда файл запоминается как исполняемый, и все биты выполнения (за вычетом
umask проекта) будет устанавливаться последующими AECP(1) команды.

Если вы укажете каталог в командной строке, будет выполняться поиск по всему дереву каталогов.
для новых файлов. (Примечание: будет добавлено абсолютно все, включая точечные файлы и
двоичные файлы, поэтому вам нужно сначала очистить весь мусор.) Файлы под этим именем
каталог, который уже находится в изменении или в проекте, будет проигнорирован. В
имя_файла_accept и имя_файла_reject шаблоны в проекте aegis.conf файл также будет
применяться, см. aepconf(5) для получения дополнительной информации.

Каталог Пример
Бывают случаи, когда такая команда, как
$ анф fubar / *
aegis: проект "example": изменение 42: "fubar / glorp" уже в изменении
aegis: проект "пример": изменение 42: обнаружена 1 фатальная ошибка, новые файлы не добавлены
$
потерпит неудачу, как показано. Есть несколько способов справиться с этим, самый простой -
просто назовите каталог:
$ анф FUBAR
aegis: проект "пример": изменение 42: добавлен файл "fubar / smiley"
aegis: проект "пример": изменение 42: добавлен файл "fubar / frownie"
$
Вы также можете использовать найдите(1) команда для произвольно сложного выбора файлов, но вы
сначала необходимо исключить файлы, которые автоматически исключаются указанной выше командой:
$ AELCF > исключать
$ AELPF >> исключать
$ найдите FUBAR Типа f | \
GREP -v -f исключать | \
xargs эгида --новый файл -v
aegis: проект "пример": изменение 42: добавлен файл "fubar / smiley"
aegis: проект "пример": изменение 42: добавлен файл "fubar / frownie"
$
Если вы не используете список исключений, найдите(1) потребуется точная настройка для вашего
стиль каталога разработки. Если вы используете стиль символической ссылки, вам нужно будет добавить
домен найдите -nссылка 1 вариант в дополнение к найдите Типа f опцию.
$ найдите FUBAR Типа f -nссылки 1 | \
xargs эгида --новый файл -v
aegis: проект "пример": изменение 42: добавлен файл "fubar / smiley"
aegis: проект "пример": изменение 42: добавлен файл "fubar / frownie"
$
Если вы используете стиль каталога разработки с полной копией, вам придется использовать
исключить метод списка, описанный выше.

Файл Шаблоны
Когда в каталоге разработки создается новый файл, проект конфиг файл
искал шаблон для нового файла. Если шаблон найден, новый файл будет
инициализируется шаблоном, иначе он будет создан пустым. Видеть aepconf(5) подробнее
Информация.

Самая простая форма - использовать файлы шаблонов, например
файл_шаблон =
[
{
шаблон = ["* .c"];
body = "$ {read_file $ {исходный шаблон / c abs}}";
},
{
шаблон = ["тест / * /. ш"];
body = "$ {read_file $ {исходный шаблон / тест абс}}";
},
];
Как видите, файлы шаблонов являются частью исходного кода проекта, поэтому вы можете добавить
соответствующие уведомления об авторских правах и обертки, и т.д, $ источник замена находит их,
если они не являются частью текущего изменения (а обычно это не так).

Сами файлы шаблонов содержат подстановки. В $ filename замена
доступен и содержит имя создаваемого файла. Этим можно манипулировать в
различными способами при конструировании соответствующего содержимого файла. Видеть Aesub(5) подробнее
информация о заменах.

Также можно запустить команду для создания нового файла. Вы можете сделать это вместо
указание основной строки, а именно:
файл_шаблон =
[
{
шаблон = ["*"];
body_command = "perl $ {source template.pl abs} $ filename";
},
];
Команда запускается с текущим каталогом, установленным в верхнюю часть каталога разработки.
Если команда не может создать файл, это ошибка. Вы можете смешивать и сочетать два
методы, тело строка и body_command, если ты хочешь.

Файл Фамилия ограничения
Доступен ряд элементов управления, ограничивающих форму имен файлов проекта. Все
эти элементы управления можно найти в файле конфигурации проекта, см. aepconf(5) подробнее
Информация. Здесь кратко описаны наиболее важные из них:

максимальное_имя_файла_длина = целое число;
Это поле используется для ограничения длины имен файлов. Все новые файлы могут не иметь
компоненты пути длиннее этого. По умолчанию 255, если не установлено. Для максимального
Переносимость, вы должны установить это на 14.

posix_filename_charset = логический;
Это поле можно использовать для ограничения символов, разрешенных в именах файлов, только теми
явно разрешено POSIX. По умолчанию ложный если не установлен, то есть все, что у вас
операционная система допускает, за исключением пробелов и символов с высоким битом.
Для максимальной переносимости вы должны установить это на правда.

dos_filename_required = логическое;
Это поле можно использовать для ограничения имен файлов, чтобы они соответствовали DOS 8 + 3.
пределы имени файла и набор символов имени файла DOS. По умолчанию ложный если не
комплект.

windows_filename_required = логический;
Это поле можно использовать для ограничения имен файлов, чтобы они соответствовали стандарту Windows98.
и WindowsNT ограничения имен файлов и набор символов. По умолчанию ложный если не установлен.

shell_safe_filenames = логический;
Это поле можно использовать для ограничения имен файлов, чтобы они не содержали оболочку
специальные символы. По умолчанию правда если не установлен. Если в этом поле установлено значение ложный,
вам нужно будет использовать $ {quote} подстановка имен файлов в командах, чтобы
убедитесь, что имена файлов, содержащие специальные символы оболочки, не содержат непреднамеренных
побочные эффекты. Странные символы в именах файлов также могут сбить с толку вашу зависимость.
инструмент для обслуживания.

allow_white_space_in_filenames = логический;
Это поле может использоваться, чтобы разрешить использование символов пробела в именах файлов. Это будет
разрешить использование следующих символов в именах файлов: backspace (BS, \ b, 0x08),
горизонтальная табуляция (HT, \ t, 0x09), новая строка (NL, \ n, 0x0A), вертикальная табуляция (VT, \ v,
0x0B), подача формы (FF, \ f, 0x0C) и возврат каретки (CR, \ r, 0x0D). По умолчанию
false, если не установлен.

Обратите внимание, что это поле не отменяет другие фильтры имен файлов. Это будет
необходимо явно установить Shell_safe_filenames = ложный также. Это будет
необходимо установить dos_filename_required = ложный (по умолчанию). Это будет
необходимо установить posix_filename_charset = ложный (по умолчанию).

Пользователь должен очень внимательно использовать замену $ {quote} для всего файла.
имена в командах в конфигурации проекта. И даже тогда замены
которые ожидают, что список имен файлов, разделенных пробелами, будет иметь неопределенные результаты.

allow_non_ascii_filenames = логическое;
Это поле может использоваться, чтобы разрешить имена файлов с символами, не печатаемыми в формате ascii, в
их. Обычно это означает кодировку UTF8 или какую-либо международную кодировку.
Если не задано, по умолчанию используется значение false.

Обратите внимание, что это поле не отменяет другие фильтры имен файлов. Это будет
необходимо явно установить Shell_safe_filenames = ложный также. Это будет
необходимо установить dos_filename_required = ложный (по умолчанию). Это будет
необходимо установить posix_filename_charset = ложный (по умолчанию).

filename_pattern_accept = [строка];
Это поле используется для указания списка шаблонов допустимых имен файлов.
По умолчанию "*", если не установлен.

filename_pattern_reject = [строка];
Это поле используется для указания списка шаблонов недопустимых имен файлов.

Пожалуйста, Примечание: Aegis также обращается к базовой файловой системе, чтобы определить ее понятие
максимальный размер файла. Если максимальный размер файла файловой системы меньше, чем
максимальная_имя_файла_длина, файловая система выигрывает. Это может произойти, например, когда вы
с использованием файловой системы Linux UMSDOS или когда у вас есть NFS, смонтированная на древнем V7
файловая система. Параметр максимальная_имя_файла_длина до 255 в этих случаях не меняет
Дело в том, что ограничения для базовых файловых систем намного меньше (12 и 14 соответственно).

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

Если ваши каталоги разработки обычно находятся в файловой системе Linux UMSDOS, вы должны
наверное, лучше было бы устроить dos_filename_required = правда, а также изменение
development_directory_template поле. Гетерогенная разработка с различными окнами
окружающая среда также может потребовать этого.

Файл Фамилия Интерпретация
Программа aegis попытается определить имена файлов проекта по именам файлов.
задано в командной строке. Все имена файлов хранятся в проектах aegis как относительные.
в корень базового дерева каталогов. Каталог разработки и
каталог интеграции - это тени этого базового каталога, поэтому эти относительные имена
применяются и здесь. Файлы, названные в командной строке, сначала преобразуются в абсолютные пути
если необходимо. Затем они сравниваются с базовым путем, каталогом разработки.
путь и путь к каталогу интеграции, чтобы определить имя, относящееся к базовой линии. это
ошибка, если указанный файл находится за пределами одного из этих деревьев каталогов.

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

Ассоциация относительное_имя_файла_предпочтение в файле конфигурации пользователя может использоваться для изменения
это поведение по умолчанию. Видеть aeuconf(5) для получения дополнительной информации.

Изменение домен Тип of a Файл
Если вы хотите изменить тип файла (скажем, с тестового на исходный файл или вице
Versa) вы можете сделать это как два изменения, сначала используя Aerm(1) с одной заменой, а затем
через анф(1) или Aent(1) во втором изменении, или вы можете объединить оба шага в одном
изменение. Не забудьте использовать Aerm -ночь вариант или вы получите самый необычный новый
шаблон файла.

Файл Действие Регулировка
Когда эта команда запускается, она сначала проверяет файлы изменений на файлы проектов. Если
есть несоответствия, действия с файлом будут скорректированы следующим образом:

create Если файл создается, но интегрирован другой набор изменений, который также
создает файл, действие файла в наборе изменений, который все еще разрабатывается, будет
настроен на "доработку".

изменить Если файл модифицируется, но интегрирован другой набор изменений, который удаляет
файл, действие файла в наборе изменений, который все еще разрабатывается, будет
настроен на "создать".

remove Если файл удаляется, но интегрирован другой набор изменений, который удаляет
файл, файл будет удален из набора изменений, который все еще разрабатывается.

Уведомления
Ассоциация новая_файловая_команда в файле конфигурации проекта запускается, если установлен. В проект_-
file_command также запускается, если он установлен, и если недавно была произведена интеграция. Видеть
aepconf(5) для получения дополнительной информации.

ИСПЫТАНИЕ СООТВЕТСТВИЕ

Команда «aegis -Test -SUGgest» может использоваться для того, чтобы программа aegis предлагала подходящую регрессию.
проверяет ваше изменение на основе исходных файлов в вашем изменении. Это автоматически
фокусирует усилия по тестированию на соответствующих тестах, сокращая количество регрессионных тестов
необходимо, чтобы быть уверенным, что вы не ввели ошибку.

Тестовые корреляции генерируются командой «aegis -Integrate_Pass», которая
связывает каждый тест в изменении с каждым исходным файлом в изменении. Таким образом, каждый
Исходный файл накапливает список тестов, которые были связаны с ним в прошлом.
Это не так точно, как анализ покрытия кода, но является разумным приближением в
практика.

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

Пусконаладка Корреляция точность
Предполагая, что корреляции тестирования точны и что тесты
распределенных по функциональному пространству, будет меньше, чем 1 / номер шанс, что
соответствующий тест не проводился программой «aegis -Test -SUGgest. номерКоманда. Маленький
количество шума добавляется к весовому тесту, поэтому иногда возникают неожиданные вещи.
проверено, и одни и те же тесты не запускаются каждый раз.

Точность корреляции теста можно повысить, если:

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

· Каждый элемент новой функциональности следует добавлять в отдельное изменение, а не
несколько вместе. Это сильно коррелирует между тестами и функциональностью.

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

· Тестовые корреляции будут потеряны при перемещении файлов. Это потому, что корреляции
имя.

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

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Подразумеваются следующие варианты

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

-BAse_RElative
Эта опция может использоваться для того, чтобы относительные имена файлов считались относительно
основание исходного дерева. Видеть aeuconf(5) для соответствующего пользователя
предпочтение.

-CUrrent_RElative
Эта опция может использоваться для того, чтобы относительные имена файлов считались относительно
текущий каталог. Обычно это значение по умолчанию. Видеть aeuconf(5) для
соответствующие предпочтения пользователя.

-Изменять номер
Этот параметр можно использовать для указания конкретного изменения в проекте. Видеть
эгида(1) для полного описания этой опции.

- НАСТРОЕННЫЙ
Эта опция может использоваться, чтобы указать, что файл является проектом Aegis.
конфигурационный файл. Файл конфигурации проекта по умолчанию называется aegis.conf,
однако можно использовать любое имя файла. Вы также можете использовать более одного файла,
разделение содержимого на несколько файлов, каждый из которых должен быть этого типа.

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

-Держать
Эта опция может использоваться для сохранения файлов и / или каталогов, которые обычно удаляются или
заменяется командой. По умолчанию для пользователя delete_file_preference если не
указано, см. aeuconf(5) для получения дополнительной информации.

-No_Keep
Эта опция может использоваться, чтобы гарантировать, что файлы и / или каталоги удалены.
или заменяется командой. По умолчанию для пользователя delete_file_preference если не
указано, см. aeuconf(5) для получения дополнительной информации.

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

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

-Проект имя
Эта опция может быть использована для выбора интересующего проекта. Когда нет -Проект
опция указана, ЭГИС_ПРОЕКТ переменная среды консультируется. Если
которого не существует, пользователь $ HOME / .aegisrc файл проверяется на предмет дефолта
поле проекта (см. aeuconf(5) для получения дополнительной информации). Если этого не существует,
когда пользователь работает только над изменениями в рамках одного проекта, проект
имя по умолчанию для этого проекта. В противном случае это ошибка.

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

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

-TERse
Эта опция может использоваться для того, чтобы списки отображали минимум
Информация. Обычно это полезно для сценариев оболочки.

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

-Ждать Эта опция может использоваться для того, чтобы команды Aegis ожидали блокировки доступа, если
их нельзя получить сразу. По умолчанию для пользователя lock_wait_preference
если не указано, см. aeuconf(5) для получения дополнительной информации.

-Нет, подождите
Эта опция может использоваться для того, чтобы команды Aegis выдавали фатальную ошибку, если доступ
замки нельзя получить сразу. По умолчанию для пользователя
lock_wait_preference если не указано, см. aeuconf(5) для получения дополнительной информации.

Смотрите также эгида(1) для параметров, общих для всех команд aegis.

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

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

Например: аргументы «-project», «-PROJ» и «-p» интерпретируются как означающие
-Проект вариант. Аргумент "-prj" не будет понят, потому что последовательные
необязательные символы не были предоставлены.

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

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

Рекомендуемые ALIAS

Рекомендуемый псевдоним для этой команды:
csh% псевдоним aenf 'aegis -nf \! * -v'
sh $ aenf () {aegis -nf "$ @" -v}

ОШИБКИ

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

ВЫХОД статус

Ассоциация эгида команда завершит работу со статусом 1 при любой ошибке. В эгида команда будет только
выйти со статусом 0, если ошибок нет.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

Читать эгида(1) для списка переменных среды, которые могут повлиять на эту команду. Видеть
aepconf(5) для файла конфигурации проекта проект_специфический поле для установки
переменные среды для всех команд, выполняемых Aegis.

Используйте aenf в Интернете с помощью сервисов onworks.net