aeimport - 云端在线

程序：

您的姓名

aeimport - 将外部存储库导入 Aegis

概要

进口 [ 选项...] 目录名
进口 -帮助
进口 -版本

商品描述

进口 命令用于创建一个新项目，并通过导入一个
外部存储库（例如 RCS 或 CVS）而不会丢失项目历史记录。

请注意：除非您指定版本（请参阅 -版 选项，下面）这个命令
将默认创建分支以支持版本 1.0。 如果你也发现了这个
晚了，一切都没有丢失：您可以使用 安布鲁(1)命令摆脱你的树枝
不想。

目录
项目目录，在该目录下有项目基线和历史以及状态和变化
数据被保留，此时将被创建。 如果 -目录 没有给出选项，
将在 default_project_‐ 指定的目录中创建项目目录
目录字段 配置文件(5)，或者如果没有设置在当前用户的主目录中； 在任一
与项目同名的案例。

团队
项目是使用当前用户和组作为拥有用户和组创建的。 这
当前用户是项目的管理员。 该项目没有其他
管理员（使用 埃纳（1）添加更多）。

该项目将在历史文件中找到的所有用户名安装为
开发人员、审核人员和集成人员。 这可能太宽泛了，但相当准确
复制在大多数存储库中找到的广泛开放的权限，您将想要使用
阿德（1） 错误（1）和 埃里(1) 酌情筛选此列表。

如果只找到一个名称，项目将设置为“developers_may_review = true;”
否则它将是错误的（见 埃帕特(5) 了解更多信息）。 用 环保局(1) 改变
如果你想要一个不同的设置。

项目的 umask 派生自当前用户的 umask，但修改为保证
该组成员将具有访问权限，并且只有项目所有者具有写入权限
使用权。 一般来说，最好的项目是 不能 由与任何其他人的帐户拥有
角色，因为这可以防止一整类“哎呀，我以为我在其他地方”错误。

项目的历史命令（见 配置文件(5) 有关更多信息）设置为那些
适用于RCS。 构建命令设置为“exit 0”； 你需要把它设置成一些东西
合适的。 符号链接场已打开。

指针
项目指针将被添加到搜索路径的第一个元素，或者如果没有路径
设置。 如果这不合适，请使用 -图书馆 显式设置所需的选项
地点。 见 -图书馆 选项以获取更多信息。

或者，取消设置 AEGIS_PATH 环境变量以将项目添加到全局
项目清单。

版本
您可以通过两种方式指定项目版本：

1.版本号可能隐含在项目名称中，在这种情况下版本号
数字将被剥离。 例如，“aeimport -p example.1.2”将创建一个
名为“example”的项目创建了分支编号 1，以及分支 2 的子分支 1
创建。

2.版本号可能会被明确说明，在这种情况下，它会被细分为
分行号。 例如，“aeimport -p example -version 1.2”将创建一个项目
称为“示例”，创建了分支编号 1，并创建了分支 2 的子分支 1。

在每种情况下，这些分支都可以在任何可以给出项目名称的地方命名，例如
“-p example.1”和“-p example-1.2”。 实际的标点符号并不重要。

您可以拥有任何您喜欢的版本号深度。 指定版本的两种方法
可以使用数字，并将它们组合在一起。 如果你根本不想要版本号，
使用 -版 用一个破折号作为参数，如“-version -”

如果没有明确或隐含地给出版本号，则使用 1.0 版。

项目 目录 地理位置
请注意： Aegis 还咨询底层文件系统，以确定其概念
最大文件大小。 文件系统的最大文件大小小于
最大文件名长度，文件系统获胜。 这可能会发生，例如，当您
使用 Linux UMSDOS 文件系统，或者当你安装了一个 NFS 时，一个古老的 V7
文件系统。 环境 最大文件名长度 在这些情况下到 255 不会改变
事实上，底层文件系统的限制要小得多（分别为 12 和 14）。

如果您的开发目录（或您的整个项目）位于具有 filename 的文件系统上
限制，或者部分异构构建发生在这样的环境中，
它有助于告诉 Aegis 它们是什么（使用项目 配置 文件的字段），以便您
不要遇到项目建立在更宽容的基础上的情况
环境，但在更有限的环境中失败并出现神秘错误。

如果您的开发目录通常位于 Linux UMSDOS 文件系统上，您将
可能更好设置 dos_文件名_必需 = true，并且还改变了
开发目录模板 场地。 各种Windows的异构开发
环境也可能需要这样做。

“ PROCESS

大多数文件版本系统不使用更改集运行。 为了导入这样的
存储库中的 Aegis 有必要“发现”这些更改集。 下列
采取的步骤：

1.
目录（路径) 在命令行上给出，以及它下面的所有目录，都是
扫描适当的文件（例如，RCS 和 CVS 使用带有“,v”后缀的文件）。
读取这些文件以获取文件的历史记录。
如果您一直在使用非标准文件后缀，aeimport 将无法找到
文件。
如果您的 CVS 存储库中有多个模块，aeimport（还没有）
了解 CVSROOT/modules 文件。 将 aeimport 指向整个 CVSROOT 可能
产生出乎意料的大结果。

2.
将上一步发现的历史文件复制到
宙斯盾。 与其他一些工具不同，Aegis 每个项目都有一个存储库，而不是所有的
共享同一个存储库的项目。
这也意味着 Aegis 不会修改原始历史文件。 特别是，
如果导入产生意外结果，只需删除项目（请参阅 阿尔姆普（1）
更多信息）并重新开始。
不可能将所有历史文件都保留在 $CVSROOT 下并拥有 Aegis
指向他们。

3.
对于各个文件历史记录中提到的每个用户，都会检查时间戳
查找大约在同一时间提交的文件组。 文件已更改
相距1分钟以内被视为一组。
文件在一分钟内改变，但由不同的用户， 不能 视为一个群体。
这通常不会出现问题，因为开发人员大多单独工作。 在极少数情况下
在开发人员一起工作的情况下，只有其中一个负责提交。
在某些情况下，时间窗口可能太大，可能会出现几个非常小的变化
被视为一个更大的变更集。 在实践中，这并不常见。

4.
文件组作为已完成的更改存储在 Aegis 数据库中（即好像
通行证(1) 已经运行)。 变化的描述是所有的串联
在相关文件版本中找到的独特注释。 使用的时间戳
因为更改是组中任何文件的最新时间戳。
有时文件注释之间的小印刷错误会导致更长的时间 -
超出预期的更改说明。 这可以用 埃卡（1）或 特卡埃卡(1) 如果
想要的。 也有相反的情况：有些文件在
全部，结果描述不太有用。

5.
通过从它们所在的文件中传输 delta 名称，将标签转换为 delta 名称
附加到，附加到它们所附加的更改集。 当一个标签看起来是
附加到多个更改，它只附加到最新的更改。
通常，标签的用途与 Aegis 的 delta 编号类似。 他们是
所有（通常）应用在单个 CVS 命令中，以便特定版本可以
稍后重新创建。 但是，因为每个文件将处于不同的版本，并且
每个都将其最新版本包含在各种随机更改集中。
标签也用于其他事情。 这里给出的方法只是一个猜测，但它是
一种运行良好的方法。

aeimport 完成导入项目后，您将能够检查结果
使用 AEL 项目历史 和 AEL 更改详细信息 命令。 （看 AEL(1) 更多
信息。）

限制
aeimport 程序远非完美。 有许多已知的限制。

· 目前不支持分支。 （一旦我弄清楚如何
在松散耦合的文件中识别分支的根，我将实现它。 想法
欢迎和/或代码贡献。）

· 目前只了解RCS 和SCCS 格式。 应该是直截了当的
将来添加对其他格式的支持。 仅上述过程的第 1 步
需要注意，其余的是文件格式中性。

· 不支持 CVS 模块，但需要支持。

· 不能指定用于确定变更集的时间窗口大小。 时间会证明
这是否有必要，但它引出了一个问题：您如何知道窗口大小
您需要完全使用该选项。

· 不能将 CVS 存储库导入现有项目。 您只能创建一个新的
来自 CVS 存储库的项目。

· 不能导入远程 CVS 存储库。

配置

理解以下选项：

-目录 径
此选项可用于指定要使用的目录。 这是一个错误
如果当前用户没有适当的权限来创建目录
给出的路径。 这必须是绝对路径。

注意：如果您使用的是自动挂载器，请不要使用 `pwd` 来制作绝对
路径，它通常会给出错误的答案。

-格式 姓名
此选项可用于指定正在导入的历史记录格式。 这
理解以下格式：

RCS 发布控制系统格式已经存在了一段时间。 这是
CVS（并发版本系统）底层的格式。 这是
如果未指定格式名称，则为默认值。
请注意： 您 必须 在运行之前安装 RCS 进口 如果你使用这个
格式，因为 RCS 命令将在导入过程中运行。 这
如果未安装 RCS，导入将失败。 你可以找到一个免费软件
在 ftp.gnu.org 或本地镜像上实现。

SCCS 源代码控制系统是最早的 Unix 版本系统之一。
（我听说这是 BitKeeper 的基础格式。）
请注意： 您 必须 在运行之前安装 SCCS 进口 如果您使用
这种格式，因为 SCCS 命令将在导入过程中运行。
如果未安装 SCCS，导入将失败。 GNU兼容愚蠢
源代码控制 (CSSC) 是 SCCS 的免费软件实现，它可能是
发现于 ftp://alpha.gnu.org/gnu/CSSC/

-图书馆 绝对的
此选项可用于指定要搜索全局状态的目录
文件和用户状态文件。 （看 遗产（5）和 遗嘱(5) 更多
信息。）命令行上可能会出现几个库选项，并且
是按给定的顺序搜索。 附加到此显式搜索路径的是
指定的目录 宙斯盾路径 环境变量（冒号分隔），
以及最后， /usr/本地/lib/aegis 总是被搜索。 指定的所有路径，
无论是在命令行还是在 宙斯盾路径 环境变量，必须是
绝对。

-列表
此选项可用于获取此命令的合适主题列表。
该列表可能比预期的更笼统。

-项目 姓名
此选项可用于选择感兴趣的项目。 当没有 -项目
选项被指定， 宙斯盾项目 环境变量被咨询。 如果
不存在的，用户的 $HOME/.aegisrc 检查默认文件
项目字段（见 配置文件(5) 了解更多信息）。 如果那不存在，
当用户只在单个项目中进行更改时，项目
名称默认为该项目。 否则，这是一个错误。

-帮助
此选项可用于获取有关如何使用 进口
程序。

-版本 数
此选项可用于指定项目的版本号。 版本
数字被实现为分支。 使用单个破折号（“-”）作为参数，如果
您不希望创建任何版本分支。

参见 庇护(1) 对于所有 aegis 命令通用的选项。

所有选项都可以缩写； 缩写记录为大写字母，
所有小写​​字母和下划线 (_) 都是可选的。 您必须使用连续
可选字母的序列。

所有选项都不区分大小写，您可以将它们输入为大写或小写或
两者结合，大小写并不重要。

例如：参数“-project”、“-PROJ”和“-p”都被解释为表示
-项目 选项。 参数“-prj”不会被理解，因为连续
未提供可选字符。

选项和其他命令行参数可以在命令行上任意混合，
在功能选择器之后。

GNU 长选项名称是可以理解的。 由于所有选项名称为 进口 很长，
这意味着忽略额外的前导“-”。 这 ”--选项=折扣值"约定也是
明白了。

退出 状态

进口 命令将在出现任何错误时以 1 状态退出。 这 进口 命令
如果没有错误，只会以 0 状态退出。

环境 变数

我们 庇护(1) 获取可能影响此命令的环境变量列表。 看
配置文件(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 程序附带绝对没有保证； 有关详细信息，请使用 '进口
-版本 执照' 命令。 这是免费软件，欢迎您重新分发
在一定条件下； 有关详细信息，请使用 '进口 -版本 执照' 命令。

使用 onworks.net 服务在线使用 aeimport