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

ПРОГРАММА:

ИМЯ

aegis copy file - скопировать файл в изменение

СИНТАКСИС

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

ОПИСАНИЕ

The эгида -Копировать файл Команда используется для копирования файла в изменение. Именованные файлы будут
скопировать из базовой линии в каталог разработки и добавить в список
файлы в смене. Запоминается версия файлов, скопированных из базового уровня.

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

Предупреждение: если в каталоге разработки есть файлы с таким же именем, они будут
перезаписано этой командой.

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

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

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

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

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

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

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

Когда файлы изменений перечислены (эгида -Список Изменить_файлы -TERse) скопированные файлы будут
появятся в списке. Когда файлы проекта указаны с явным номером изменения
(эгида -Список Project_Files -TERse -Изменять N) ни один из файлов изменений, включая
скопированные файлы появятся в кратком списке. Эти две функции очень полезны, когда
вызов aegis из DMT для генерации списка исходных файлов.

БАЗОВЫЙ Блокировки

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

Команды, требующие согласованности базовой линии (в том числе AEB(1)
AECP(1) и дирхамов(1) команды) берут базовую линию читать замок. Это неисключительная блокировка, поэтому
одновременное развитие изменений не затруднено.

Команда, изменяющая базовую линию, эипасс(1), берет базовую линию записывать замок. Этот
эксклюзивная блокировка, заставляющая эипасс(1) блокировать до тех пор, пока не будет прочитано активное базовое состояние
замки.

Возможно, что одна из вышеперечисленных команд разработки будет заблокирована до тех пор, пока не будет выполняться
эгида -Integrate_PASS завершает. Обычно это непродолжительное время, пока проект
история обновлена. Задержка важна для того, чтобы эти команды получали согласованный
вид базовой линии. Никакая другая команда интеграции не вызовет вышеуказанного развития
команды для блокировки.

Когда используется функция ветки aegis, блокировка чтения (неисключительная) берется на
базовая линия ветви, а также каждая из «родительских» базовых линий. Тем не менее, базовый уровень записи
(исключительная) блокировка применяется только к базовой линии ветви; "родительские" базовые показатели - это только
чтение (неисключительное) заблокировано.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

-DELta номер
Эта опция может использоваться для указания определенной дельты в истории проекта, чтобы
скопируйте файл из, а не самую последнюю версию. Если дельта была
дали имя (см. Aedn(1) как) вы можете использовать имя дельты вместо дельты
количество. Если указанная дельта не существует, это ошибка. Дельта-числа
начать с 1 и увеличивать; дельта 0 - это особый случай, означающий «когда ветвь
начал".

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

-DELta_From_Change номер
Эта опция может использоваться для указания дельты конкретного проекта от его изменения.
номер.

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

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

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

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

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

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

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

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

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

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

-REScind
Эта опция может использоваться для отмены (отката) завершенного изменения. Изменение на
rescind (откат) указывается обычным способом с одним из параметров --delta
настройки.

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

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

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

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

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

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

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

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

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

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

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

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

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

ОШИБКИ

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

ВЫХОД статус

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

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

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

ПРИМЕРЫ

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

Копировать Цнлостным Проект
Чтобы скопировать весь проект в свое изменение, используйте команду
AECP.
Завершающая точка является частью команды и означает «текущий каталог и все остальное.
под ним ". Это работает для любого каталога в дереве исходных текстов проекта, если вы хотите
более селективный.

Производить Ранее Проект Версия
Вы хотите точно воспроизвести исходники для более ранней версии вашего проекта,
вам нужно знать номер edelta (используйте АЕЛ история проекта найти). Тогда используйте это
команда:
aecp-дельта n .
в котором n - дельта-число из истории проекта. Опять же, конечная точка является частью
команда. Используя $ версия замена (см. Aesub(5) для получения дополнительной информации) вы
можете встроить этот дельта-номер в вашу программу перед ее распространением.

Вместо этого также можно указать номер предыдущего изменения, используя эту команду:
aecp -дельта-от-изменения n .
в котором n интересующее число изменений. Опять же, конечная точка является частью
команда.

расторгать a Изменить
Когда вам нужно отменить (отменить) завершенное изменение, вероятно, это были некоторые
время назад, поэтому вам нужно знать дельта-число или номер изменения. Используйте эту команду:
aecp-дельта n -отменить.
в котором n - интересующее дельта-число. Все остальные варианты -delta также работают, поэтому
если вы знаете номер изменения, вы можете более избирательно выбирать, какие файлы копировать:
aecp -дельта-от-изменения n `эгида -l cf -ter -c n`
в котором n интересующее число изменений. Это копирует только файлы, которые были в
оскорбительное изменение.

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