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

ПРОГРАММА:

ИМЯ

aeimport - импортировать иностранный репозиторий в Aegis

СИНТАКСИС

аэропорт [ вариант...] имя_директории
аэропорт -Помощь
аэропорт -Версия

ОПИСАНИЕ

The аэропорт команда используется для создания нового проекта и заполнения его путем импорта
зарубежный репозиторий (например, RCS или CVS) без потери истории проекта.

Обратите внимание: если вы не укажете версию (см. -версия вариант ниже) эта команда
по умолчанию будет создавать ветки для поддержки версии 1.0. Если вы это тоже обнаружили
поздно, еще не все потеряно: вы можете использовать Aenbru(1) команда избавиться от ветвей, которые вы
не хотел.

Каталог
Каталог проекта, в котором находятся базовый план и история проекта, а также состояние и изменение.
данные хранятся, будут созданы в это время. Если -КАТАЛОГ вариант не указан,
каталог проекта будет создан в каталоге, указанном в default_project_‐
поле каталога aeuconf(5), или если он не установлен в домашнем каталоге текущего пользователя; в любом
корпус с тем же названием, что и проект.

Персонал
Проект создается с текущим пользователем и группой в качестве пользователя и группы-владельца. В
текущий пользователь является администратором проекта. У проекта нет другого
администраторы (используйте Аэна(1) добавить больше).

В проекте все имена пользователей, найденные в файлах истории (см. Удар), будут установлены как
разработчики, обозреватели и интеграторы. Возможно, это слишком широко, но довольно точно
воспроизводит широко открытые разрешения, имеющиеся в большинстве репозиториев, и вы захотите использовать
Aerd(1) Aerrv(1) и Aeri(1) по мере необходимости, чтобы отсеять этот список.

Если найдено только одно имя, для проекта будет установлено значение «developers_may_review = true;»
иначе он будет ложным (см. эпатр(5) для получения дополнительной информации). Использовать Aepa(1) изменить
это, если вам нужен другой параметр.

Umask проекта является производным от umask текущего пользователя, но изменен, чтобы гарантировать
что члены группы будут иметь доступ, и только владелец проекта сможет писать
доступ. В общем, лучшее из проекта - это принадлежит учетной записи с любым другим
роль, поскольку это предотвращает целый класс ошибок типа «ой, я думал, что был где-то еще».

Команды истории проекта (см. aepconf(5) для получения дополнительной информации) установлены на те
подходит для RCS. Для команды сборки установлено значение «exit 0»; вам нужно установить это на что-то
подходящее. Включена ферма символьных ссылок.

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

В качестве альтернативы отключите переменную среды AEGIS_PATH, чтобы добавить проект в глобальную
список проектов.

Версия
Вы можете указать версию проекта двумя способами:

1. Номер версии может быть неявным в названии проекта, и в этом случае версия
числа будут удалены. Например, «aeimport -p example.1.2» создаст
проект под названием «пример» с созданной ветвью номер 1 и дочерней ветвью 2 ветки 1
создано.

2. Номер версии может быть указан явно, и в этом случае он будет разделен на
номера отделений. Например, «aeimport -p example -version 1.2» создаст проект
называется «пример» с созданной ветвью номер 1 и созданной подветвью 2 ветви 1.

В любом случае эти ветви могут быть названы везде, где может быть указано имя проекта, например
«-P example.1» и «-p example-1.2». Фактический знак препинания не имеет значения.

У вас может быть любая глубина номеров версий, которая вам нравится. Оба метода указания версии
могут использоваться числа, и они будут объединены. Если вы не хотите вообще никаких номеров версий,
используют -версия с одним тире в качестве аргумента, как в «-версия -»

Если номер версии не указан явно или неявно, используется версия 1.0.

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

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

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

ПРОЦЕСС ПРОЕКТИРОВАНИЯ

Большинство систем версий файлов не работают с наборами изменений. Чтобы импортировать такие
репозиториев в Aegis необходимо «обнаружить» эти наборы изменений. Следующий
предпринимаются шаги:

1.
Каталог (путь), указанные в командной строке, и все каталоги под ней, являются
проверяется на наличие подходящих файлов (например, RCS и CVS используют файлы с суффиксом «, v»).
Эти файлы читаются для получения истории файла.
Если вы использовали нестандартный файловый суффикс, aeimport не сможет найти
файлы.
Если в вашем репозитории CVS более одного модуля, aeimport (пока) не
понять файл CVSROOT / modules. Указание aeimport на всю вашу CVSROOT может
дают неожиданно большой результат.

2.
Файлы истории, обнаруженные на предыдущем шаге, копируются в папку, используемую
Иджис. В отличие от некоторых других инструментов, у Aegis есть репозиторий для каждого проекта, а не для всех
проекты, использующие один и тот же репозиторий.
Это также означает, что Aegis не будет изменять исходные файлы истории. Особенно,
если импорт дает неожиданные результаты, просто удалите проект (см. Aermpr(1) для
больше информации) и начать заново.
Невозможно оставить все файлы истории, скажем, в $ CVSROOT и иметь Aegis.
укажите на них.

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

4.
Группы файлов сохраняются в базе данных Aegis как завершенные изменения (т. Е. Как если бы
эипасс(1) уже запущен). Описание изменения - это объединение всех
найденные уникальные комментарии прикреплены к соответствующим версиям файлов. Используемая отметка времени
для изменения это самая последняя отметка времени любого файла в группе.
Бывают случаи, когда небольшие опечатки между комментариями к файлам приводят к увеличению времени ожидания.
описания изменений, чем ожидалось. Это можно исправить с помощью Aeca(1) или ткаека(1) если
желанный. Бывают случаи, когда верно и обратное: некоторые файлы не имеют комментариев на
все, и итоговое описание бесполезно.

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

После того, как aeimport завершит импорт проекта, вы сможете проверить результаты.
используя АЕЛ проект_история и АЕЛ изменить_детали команды. (Видеть АЕЛ(1) подробнее
Информация.)

ограничения
Программа аэроимпорта далека от совершенства. Есть ряд известных ограничений.

· В настоящее время ветвление не поддерживается. (Как только я пойму, как
различать корень ветки в слабосвязанных файлах, я это реализую. Идеи
и / или кода приветствуются.)

· В настоящее время понимаются только форматы RCS и SCCS. Это должно быть прямо
добавим поддержку дополнительных форматов в будущем. Только шаг 1 описанного выше процесса
требует внимания, в остальном формат файла нейтрален.

· Нет поддержки модулей CVS, и она должна быть.

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

· Вы не можете импортировать репозиторий CVS в существующий проект. Вы можете создать только новый
проект из репозитория CVS.

· Вы не можете импортировать удаленный репозиторий CVS.

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

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

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

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

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

Формат RCS Release Control System существует довольно давно. это
формат, лежащий в основе CVS (Система одновременных версий). Это
по умолчанию, если имя формата не указано.
Примечание: обязательно установите RCS перед запуском аэропорт если вы используете это
формат, потому что команды RCS будут выполняться во время процесса импорта. В
импорт завершится неудачно, если RCS не установлен. Вы можете найти бесплатное ПО
реализация на ftp.gnu.org или на локальном зеркале.

SCCS Source Code Control System - одна из самых ранних систем версий Unix.
(Мне сказали, что это формат, лежащий в основе BitKeeper.)
Примечание: обязательно установите SCCS перед запуском аэропорт если вы используете
этот формат, потому что команды SCCS будут выполняться во время процесса импорта.
Импорт завершится неудачно, если SCCS не установлен. Глупость совместимости с GNU
Source Control (CSSC) - это бесплатная реализация SCCS, и она может быть
найдено по адресу ftp://alpha.gnu.org/gnu/CSSC/

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

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

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

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

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

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

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

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

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

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

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

ВЫХОД статус

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

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

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

АВТОРСКИЕ ПРАВА

aeimport версия 4.24.3.D001
Авторское право (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Питер Миллер

Программа aeimport поставляется СОВЕРШЕННО БЕЗ ГАРАНТИЙ; для получения подробной информации используйте "аэропорт
-Версия Лицензиякоманда. Это бесплатное программное обеспечение, и вы можете его распространять.
при определенных условиях; для получения подробной информации используйте "аэропорт -Версия Лицензиякоманда.

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