aenf - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

aegis new file - додати нові файли, які будуть створені шляхом зміни

СИНТАКСИС

егіда -Новий_файл ім'я файлу... [ варіант...]
егіда -Новий_файл -Список [ варіант...]
егіда -Новий_файл -Допоможіть

ОПИС

Команда егіда -Новий_файл Команда використовується для додавання нових файлів до змін. Названі файли будуть
буде додано до списку файлів у зміні.

Для кожного названого файлу створюється новий файл у каталозі розробки, якщо це не так
вже існують. Якщо файл уже існує, він не буде змінений.

Якщо ви хочете, щоб новий вихідний файл був виконуваним (наприклад, сценарії оболонки), тоді ви
просто використовуйте звичайний CHMOD(1) команда. Якщо будь-який з виконуваних бітів файлу встановлений на
aede(1) час, коли файл запам'ятовується як виконуваний і всі виконувані біти (мінус
umask проекту) буде встановлено наступним aecp(1) команди.

Якщо назвати каталог у командному рядку, буде здійснено пошук у всьому дереві каталогів
для нових файлів. (Примітка: буде додано абсолютно все, включаючи файли з точками і
двійкові файли, тому спочатку потрібно очистити будь-який непотріб.) Файли під цим ім’ям
каталог, який уже міститься в зміні або в проекті, буде ігноруватися. The
file_name_accept та file_name_reject шаблони в проекті aegis.conf файл також буде
застосовуватися див aepconf(5) для отримання додаткової інформації.

Каталог Приклад
Бувають випадки, коли така команда, як
$ aenf fubar/*
aegis: проект "приклад": зміна 42: "fubar/glorp" вже в зміні
aegis: проект "приклад": зміна 42: виявлено 1 фатальну помилку, нові файли не додано
$
не вийде, як показано. Є кілька способів впоратися з цим, найпростіший
просто назвіть каталог:
$ aenf фубар
aegis: проект "приклад": зміна 42: додано файл "fubar/smiley".
aegis: проект "приклад": зміна 42: додано файл "fubar/frownie".
$
Ви також можете використовувати знаходити(1) команда для довільно складного вибору файлів, але ви
спочатку потрібно виключити файли, які вищенаведена команда виключає автоматично:
$ aelcf > виключати
$ aelpf >> виключати
$ знаходити фубар -типу f | \
GREP -v -f виключати | \
ксарг егіда --новий файл -v
aegis: проект "приклад": зміна 42: додано файл "fubar/smiley".
aegis: проект "приклад": зміна 42: додано файл "fubar/frownie".
$
Якщо ви не використовуєте список виключень, знаходити(1) команда потребує точного налаштування
стиль каталогу розробки. Якщо ви використовуєте стиль символічного посилання, вам потрібно буде додати
знаходити -nпосилання 1 варіант на додаток до знаходити -типу f варіант.
$ знаходити фубар -типу f -nпосилання 1 | \
ксарг егіда --новий файл -v
aegis: проект "приклад": зміна 42: додано файл "fubar/smiley".
aegis: проект "приклад": зміна 42: додано файл "fubar/frownie".
$
Якщо ви використовуєте стиль каталогу розробки повної копії, вам доведеться використовувати файл
метод виключення списку, вище.

філе шаблони
Коли новий файл створюється в каталозі розробки проекту конфиг файл є
шукав шаблон для нового файлу. Якщо шаблон знайдено, новий файл буде
ініціалізовано шаблоном, інакше він буде створений порожнім. Побачити aepconf(5) більше
інформація.

Найпростішою формою є використання файлів шаблонів, наприклад
файл_шаблон =
[
{
шаблон = [ "*.c" ];
body = "${read_file ${source template/c abs}}";
},
{
шаблон = [ "test/*/.sh" ];
body = "${read_file ${source template/test abs}}";
},
];
Як бачите, файли шаблонів є частиною джерела проекту, тому ви можете додати файл
відповідні повідомлення про авторські права та обгортки, і т.д., $source заміна визначає їх розташування,
якщо вони не є частиною поточної зміни (а зазвичай це не так).

Самі файли шаблонів містять заміни. The $filename заміна є
доступний і містить ім’я файлу, що створюється. Цим можна маніпулювати в
різними способами побудови відповідного вмісту файлу. Побачити aesub(5) більше
інформація про заміни.

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

філе ІМ'Я Недоліки
Існує ряд доступних елементів керування, щоб обмежити форму імен файлів проекту. Всі
ці елементи керування можна знайти у файлі конфігурації проекту, див aepconf(5) більше
інформації. Найважливіші коротко описані тут:

максимальна довжина_файлу = ціле число;
Це поле використовується для обмеження довжини імен файлів. Усі нові файли можуть не мати
компоненти шляху довші за це. За замовчуванням 255, якщо не встановлено. Для максимуму
портативності, вам слід встановити для цього значення 14.

posix_filename_charset = логічний;
Це поле можна використовувати, щоб обмежити символи, дозволені в іменах файлів
явно дозволено POSIX. За замовчуванням false якщо не встановлено, означає будь-який ваш
операційна система допускає, за винятком пробілів і символів з високим бітовим значенням.
Для максимальної переносимості слід встановити це значення правда.

dos_filename_required = логічний;
Це поле можна використовувати для обмеження назв файлів, щоб вони відповідали DOS 8+3
обмеження імені файлу та набір символів імені файлу DOS. За замовчуванням false if not
встановлений.

windows_filename_required = логічний;
Це поле може використовуватися для обмеження назв файлів, щоб вони відповідали Windows98
і WindowsNT обмеження імен файлів і набір символів. За замовчуванням false якщо не встановлено.

shell_safe_filenaname = логічний;
Це поле може використовуватися для обмеження назв файлів, щоб вони не містили оболонку
спеціальні символи. За замовчуванням правда якщо не встановлено. Якщо для цього поля встановлено значення false,
вам потрібно буде використовувати ${quote} підміна навколо імен файлів у командах, to
переконайтеся, що імена файлів, що містять спеціальні символи оболонки, не мають ненавмисних
побічні ефекти. Дивні символи в іменах файлів також можуть заплутати вашу залежність
інструмент для обслуговування.

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_filemes = false також. Це буде
необхідно встановити dos_filename_required = false (за замовчуванням) також. Це буде
необхідно встановити posix_filename_charset = false (за замовчуванням) також.

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

allow_non_ascii_filename = логічний;
Це поле може використовуватися, щоб дозволити введення імен файлів із символами, які не друкуються у форматі ASCII
їх. Зазвичай це означає UTF8 або якийсь міжнародний набір символів.
За замовчуванням значення false, якщо не встановлено.

Зауважте, що це поле не замінює інші фільтри імен файлів. Це буде
необхідно вказати явно shell_safe_filemes = false також. Це буде
необхідно встановити dos_filename_required = false (за замовчуванням) також. Це буде
необхідно встановити posix_filename_charset = false (за замовчуванням) також.

filename_pattern_accept = [ рядок ];
Це поле використовується для визначення списку шаблонів прийнятних імен файлів.
За замовчуванням «*», якщо не встановлено.

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

будь ласка Примітка: Aegis також звертається до базової файлової системи, щоб визначити її поняття
максимальний розмір файлу. Де максимальний розмір файлу файлової системи менше ніж
максимальна довжина назви_файлу, виграє файлова система. Це може статися, наприклад, коли ви
за допомогою файлової системи Linux UMSDOS або якщо у вас змонтовано старовинну версію V7
файлова система. Налаштування максимальна довжина назви_файлу до 255 у цих випадках не змінює
той факт, що основні обмеження файлових систем набагато менші (12 і 14 відповідно).

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

Якщо ваші каталоги розробки зазвичай знаходяться у файловій системі Linux UMSDOS, ви б
мабуть, краще налаштувати dos_filename_required = правда, а також зміна
Шаблон_каталогу_розробки поле. Неоднорідна розробка з різними Windows
середовище також може вимагати цього.

філе ІМ'Я Інтерпретація
Програма aegis спробує визначити імена файлів проекту за іменами файлів
задано в командному рядку. Усі імена файлів зберігаються в проектах aegis як відносні
до кореня базового дерева каталогів. Каталог розробки та
інтеграційний каталог є тінями цього базового каталогу, а тому ці відносні імена
застосувати і тут. Файли, названі в командному рядку, спочатку перетворюються на абсолютні шляхи
якщо необхідно. Потім вони порівнюються з базовим шляхом, каталогом розробки
шлях і шлях до каталогу інтеграції, щоб визначити назву, відносну до базової лінії. це є
помилка, якщо названий файл знаходиться за межами одного з цих дерев каталогів.

Команда -Base_RElative Опція може використовуватися, щоб інтерпретувати відносні імена файлів як
відносно базового шляху; абсолютні імена файлів все одно порівнюватимуться з різними
шляхи, щоб визначити назву, що відповідає базовій лінії.

Команда відносне_назва_файлу_налаштування у файлі конфігурації користувача можна використовувати для зміни
ця поведінка за замовчуванням. Побачити aeuconf(5) для отримання додаткової інформації.

Зміна тип of a філе
Якщо ви хочете змінити тип файлу (скажімо, з тестового на вихідний файл, або віце
Versa) ви можете зробити це як дві зміни, спершу використавши аерм(1) за одну зміну, а потім
використання aenf(1) або aent(1) у другій зміні, або ви можете поєднати обидва кроки в одному
змінити. Не забудьте використовувати аерм -зараз білий варіант або ви отримаєте найдивнішу новинку
шаблон файлу.

філе дію Регулювання
Коли ця команда виконується, вона спочатку перевіряє файли змін з файлами проекту. Якщо
є невідповідності, дії з файлом будуть відкориговані таким чином:

create Якщо файл створюється, але інтегровано інший набір змін, який також
створює файл, дія з файлом у наборі змін, що все ще розробляється
налаштований на «змінити».

modify Якщо файл модифікується, але інтегровано інший набір змін, який видаляє
файлу буде дія файлу в наборі змін, що все ще розробляється
налаштований на «створювати».

видалити Якщо файл видаляється, але інтегровано інший набір змін, який видаляє
файлу, файл буде вилучено з набору змін, який все ще розробляється.

повідомлення
Команда new_file_command у файлі конфігурації проекту запускається, якщо встановлено. The проект_‐
file_command також запускається, якщо встановлено, і якщо нещодавно була інтеграція. Побачити
aepconf(5) для отримання додаткової інформації.

TEST КОРЕЛЯЦІЇ

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

Тестові кореляції генеруються командою “aegis -Integrate_Pass”, яка
пов’язує кожен тест у зміні з кожним вихідним файлом у зміні. Таким чином, кожен
вихідний файл накопичує список тестів, які були пов’язані з ним у минулому.
Це не так точно, як аналіз покриття коду, але є розумним наближенням
практиці.

Команда aecp(1) і aenf(1) команди використовуються для зв'язування файлів зі зміною. Поки вони
не виконують активно асоціації, це файли, які використовуються aeipass(1) і
aet(1) щоб визначити, які вихідні файли пов'язані з якими тестами.

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

Точність кореляції тесту можна підвищити, переконавшись, що:

· Кожна зміна має бути чітко сфокусованою, без зайвих включень файлів. Це
уникає помилкових кореляцій.

· Кожен елемент нової функціональності слід додавати в окремі зміни, а не
кілька разом. Це тісно корелює тести з функціональністю.

· Кожну помилку слід виправляти окремо, а не декілька разом. Це
тісно корелює тести з функціональністю.

· Тестові кореляції будуть втрачені, якщо файли будуть переміщені. Це тому, що кореляції за
ім'я.

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

ВАРІАНТИ

Зрозуміли наступні варіанти

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

-Base_RElative
Цей параметр може використовуватися для того, щоб відносні імена файлів розглядалися відносно
основа вихідного дерева. Побачити aeuconf(5) для відповідного користувача
перевагу.

-Current_RELATE
Цей параметр може використовуватися для того, щоб відносні імена файлів розглядалися відносно
поточний каталог. Зазвичай це значення за замовчуванням. Побачити aeuconf(5) для
відповідні переваги користувача.

-Змінити номер
Ця опція може використовуватися для вказівки певної зміни в проекті. Побачити
егіда(1) для повного опису цієї опції.

-Конфігуровано
Цей параметр можна використовувати, щоб указати, що файл є проектом Aegis
файл конфігурації. Викликається файл конфігурації проекту за замовчуванням aegis.conf,
однак можна використовувати будь-яке ім'я файлу. Ви також можете використовувати більше одного файлу,
розділення вмісту на кілька файлів, усі вони мають бути такого типу.

-Допоможіть
Цей параметр можна використовувати для отримання додаткової інформації про те, як користуватися егіда
програми.

- Тримайте
Цей параметр можна використовувати для збереження файлів та/або каталогів, які зазвичай видаляються або
замінено командою. За замовчуванням для користувача delete_file_preference if not
зазначений, див aeuconf(5) для отримання додаткової інформації.

-Ні_Зберігати
Цей параметр може використовуватися, щоб гарантувати, що файли та/або каталоги будуть видалені
або замінено командою. За замовчуванням для користувача delete_file_preference if not
зазначений, див aeuconf(5) для отримання додаткової інформації.

-Список
Цей параметр можна використовувати для отримання списку відповідних тем для цієї команди.
Список може бути більш загальним, ніж очікувалося.

-Not_Logging
Цей параметр можна використовувати, щоб вимкнути автоматичне ведення журналу виводу та помилок
файл. Це часто корисно, коли кілька команд aegis об'єднані в оболонку
сценарій

-Проект ім'я
Цю опцію можна використовувати для вибору проекту, який цікавить. Коли ні -Проект
вказано опцію, AEGIS_PROJECT консультується зі змінною середовища. Якщо
якого не існує, користувача $HOME/.aegisrc файл перевіряється на наявність за замовчуванням
Поле проекту (див aeuconf(5) для отримання додаткової інформації). Якщо цього не існує,
коли користувач працює лише над змінами в межах одного проекту, проекту
Ім'я за замовчуванням відповідає цьому проекту. Інакше це помилка.

-ШАБЛОН
Цей параметр може використовуватися, щоб вказати, що новий шаблон файлу слід використовувати навіть
якщо файл уже існує.

-No_TEMplate
Цей параметр може використовуватися, щоб вказати, що новий шаблон файлу не слід використовувати,
навіть якщо файл не існує (буде створено будь-який порожній файл).

-TERse
Ця опція може використовуватися для того, щоб списки створювали мінімум
інформації. Зазвичай це корисно для сценаріїв оболонки.

-Детальніше
Ця опція може бути використана, щоб змусити aegis виробляти більше результатів. За замовчуванням aegis
видає лише помилки. При використанні з -Список варіант цей варіант
викликає додавання заголовків стовпців.

-Почекай Цей параметр можна використовувати, щоб вимагати від команд Aegis очікування блокування доступу, якщо
їх неможливо отримати відразу. За замовчуванням для користувача lock_wait_preference
якщо не вказано, див aeuconf(5) для отримання додаткової інформації.

-Ні_чекай
Цей параметр можна використовувати, щоб вимагати, щоб команди Aegis видавали фатальну помилку під час доступу
замки неможливо отримати відразу. За замовчуванням для користувача
lock_wait_preference якщо не вказано, див aeuconf(5) для отримання додаткової інформації.

Дивіться також егіда(1) для параметрів, загальних для всіх команд aegis.

Усі варіанти можуть бути скороченими; абревіатура задокументована як великі літери,
усі малі літери та символи підкреслення (_) є необов’язковими. Ви повинні використовувати послідовний
послідовності необов'язкових букв.

Усі параметри не чутливі до регістру, ви можете вводити їх у верхньому чи нижньому регістрі чи a
поєднання обох, регістр не важливий.

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

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

Довгі назви параметрів GNU зрозумілі. Оскільки всі назви параметрів для егіда довгі,
це означає ігнорування додаткового провідного '-'. "--варіант=значення"конвенція також
зрозумів.

РЕКОМЕНДУЄТЬСЯ ALIAS

Рекомендований псевдонім для цієї команди
csh% псевдонім aenf 'aegis -nf \!* -v'
sh$ aenf(){aegis -nf "$@" -v}

ПОМИЛКИ

Це помилка, якщо зміна не в буття розвиненою стан.
Якщо зміна не призначена поточному користувачеві, це помилка.
Це помилка, якщо файл уже є частиною змін.
Це помилка, якщо файл вже є частиною базової лінії.
Якщо файли, названі в командному рядку, не є звичайними файлами, це помилка
каталогів. (Якщо вам потрібні символічні посилання або спеціальні файли, створіть їх під час складання.)

EXIT СТАТУС

Команда егіда команда вийде зі статусом 1 у разі будь-якої помилки. The егіда буде тільки команда
вийти зі статусом 0, якщо немає помилок.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

Читати егіда(1) для списку змінних середовища, які можуть вплинути на цю команду. Побачити
aepconf(5) для файлу конфігурації проекту конкретний_проект поле для встановлення
змінні середовища для всіх команд, що виконуються Aegis.

Використовуйте aenf онлайн за допомогою служб onworks.net