aecp - 云端在线

程序：

您的姓名

aegis 复制文件 - 将文件复制到更改中

概要

庇护 -拷贝文件 [ 选项...] 文件名...
庇护 -拷贝文件 -独立的 [ 选项...] 文件名...
庇护 -拷贝文件 -列表 [ 选项...]
庇护 -拷贝文件 -帮助

商品描述

庇护 -拷贝文件 命令用于将文件复制到更改中。 命名的文件将
从基线复制到开发目录，并添加到列表中
更改中的文件。 记住从基线复制的文件版本。

此命令可用于将测试复制到更改中，而不仅仅是源文件。 测试是
就像任何其他源文件一样对待，并受到相同的过程。

警告：如果开发目录中有同名文件，它们将被
被这个命令覆盖。

您还可以命名目录。 命名目录中的所有源文件，以及所有
它们下面的目录，将从基线复制到开发目录中，
并添加到更改中的文件列表中。

显式复制文件时，如果文件已经是更改的一部分，则会出错。
当您命名一个目录时，该目录下项目中的所有源文件
被复制，除了已经在更改中的任何内容。 如果没有一个是错误的
可以使用由目录隐式命名的文件。

如果要将复制的源文件更改为可执行文件（例如，shell 脚本）
那么你只需使用正常的 CHMOD(1) 命令； 相反，使其不可执行。
如果文件的任何可执行位设置为 伊蚊(1) 文件被记住的时间
可执行和所有执行位（减去项目的 umask）将由后续设置
欧共体(1) 命令。

文件 名字 解释
aegis 程序将尝试从文件名中确定项目文件名
在命令行中给出。 所有文件名都作为相对文件名存储在 aegis 项目中
到基线目录树的根。 开发目录和
集成目录是这个基线目录的影子，所以这些相对名称
也在这里申请。 命令行中命名的文件首先转换为绝对路径
如有必要。 然后将它们与基线路径、开发目录进行比较
path 和集成目录路径，以确定相对于基线的名称。 这是
如果命名的文件在这些目录树之一之外，则会出现错误。

-BASE_Relative 选项可用于将相对文件名解释为
相对于基线路径； 绝对文件名仍将与各种
路径以确定基线相对名称。

相对文件名首选项 在用户配置文件中可以用来修改
这种默认行为。 看 配置文件(5) 了解更多信息。

工艺 侧 效果
此命令将取消任何构建或测试注册，因为添加另一个文件
在逻辑上使它们无效。 如果添加了项目配置文件，任何差异
注册也将被取消。

当列出更改文件时 (庇护 -列表 更改文件 -TERse) 复制的文件将
出现在列表中。 当项目文件与明确的更改编号一起列出时
(庇护 -列表 项目_文件 -TERse -改变 N) 没有任何更改的文件，包括
复制的文件，将出现在简洁列表中。 这两个功能在以下情况下非常有用
从 DMT 中调用 aegis 以生成源文件列表。

“ 基准线 LOCK

基线锁用于确保基线保持一致状态
需要读取基线中文件内容的命令的持续时间。

要求基线一致的命令（包括 AEB（1）
欧共体（1）和 AED(1) 命令) 取基线 读 锁。 这是一个非排他锁，所以
变化的同步发展不会受到阻碍。

修改基线的命令， 通行证(1)、取基线 写 锁。 这个
是排他锁，强制 通行证(1) 阻塞直到没有活动的基线读取
锁。

上述开发命令之一可能会阻塞，直到进行中
庇护 -Integrate_PASS 完成。 这通常是短期的，而项目
历史被更新。 延迟是必不可少的，以便这些命令收到一致的
基线视图。 没有其他集成命令会导致上述发展
命令阻止。

当使用 aegis 的分支功能时，会在
分支基线以及每个“父”基线。 但是，基线写入
（独占）锁只在分支基线上使用； “父”基线只是
读取（非独占）锁定。

测试 相关性

“aegis -Test -SUGgest”命令可用于让 aegis 建议合适的回归
根据更改中的源文件对更改进行测试。 这自动
将测试工作集中在相关测试上，减少回归测试的数量
有必要确信您没有引入错误。

测试相关性由“aegis -Integrate_Pass”命令生成，该命令
将变更中的每个测试与变更中的每个源文件相关联。 因此，每个
源文件累积了过去与其关联的测试列表。
这不像代码覆盖率分析那么精确，但在以下情况下是一个合理的近似值
实践。

欧共体（1）和 恩夫(1) 命令用于将文件与更改相关联。 虽然他们
不主动执行关联，这些是使用的文件 通行证（1）和
AET(1) 确定哪些源文件与哪些测试相关联。

测试 相关 准确性
假设测试相关性是准确的并且测试是均匀的
分布在整个功能空间中，将有一个小于 1/号 一个机会
“aegis -Test -SUGgest”尚未运行相关测试 数“ 命令。 一个小的
噪声量被添加到测试权重中，因此有时会出现意想不到的事情
经过测试，并且不会每次都运行相同的测试。

通过确保：

· 每次更改都应重点关注，不得包含无偿的文件。 这个
避免虚假的相关性。

· 每一项新功能都应该在单独的更改中添加，而不是
几个在一起。 这将测试与功能密切相关。

· 每个错误都应该在单独的更改中修复，而不是几个一起更改。 这个
将测试与功能强相关。

· 如果移动文件，测试相关性将丢失。 这是因为相关性是由
名称。

测试与源文件准确关联的最佳方式是
包含一个测试以及与被测功能相关的那些文件。 也
许多虚假文件会削弱测试相关性的有用性。

通知
复制文件命令 在项目中 配置 文件运行，如果设置。 这 项目文件_-
命令 也会运行，如果设置了，并且最近有集成。 看
配置文件(5) 了解更多信息。

文件 操作 调整
当此命令运行时，它首先根据项目文件检查更改文件。 如果
有不一致的地方，文件动作会做如下调整：

create 如果正在创建一个文件，但集成了另一个更改集，它也
创建文件，仍在开发的更改集中的文件操作将是
调整为“修改”。

修改 如果正在修改文件，但集成了另一个更改集，该更改集将删除
文件，仍在开发的更改集中的文件操作将是
调整为“创造”。

remove 如果正在删除一个文件，但集成了另一个更改集，该更改集将删除
文件，该文件将从仍在开发的更改集中删除。

配置

理解以下选项：

-BASE_Relative
此选项可用于导致相对文件名被视为相对于
源树的基础。 看 配置文件(5) 对应用户
偏好。

-CUrrent_Relative
此选项可用于导致相对文件名被视为相对于
当前目录。 这通常是默认设置。 看 配置文件（5）
相应的用户偏好。

-分支 数
此选项可用于为源文件指定不同的分支，而不是
比基线。 （也可以看看 -树干 选项。 请注意：该 -分支 选项
不带项目名称，只带分支号后缀。

-祖父母
此选项可用于指定祖父分支（从
当前分支）用于原始文件，而不是基线。 （-祖父母
选项与“-branch ..”选项相同。）

-改变 数
此选项可用于指定项目中的特定更改。 看
庇护(1) 有关此选项的完整说明。

-三角洲 数
此选项可用于指定项目历史中的特定增量以
复制文件，而不是最新版本。 如果 delta 已经
给定一个名字（见 艾登(1) 对于如何)，您可以使用 delta 名称而不是 delta
数字。 如果指定的增量不存在，则会出错。 三角洲数字
从1开始增加； delta 0 是一个特例，意思是“当分支
开始”。

-DELta_Date 绳子
此选项可用于指定项目的特定日期和时间
要从中复制文件的历史记录，而不是最新版本。 它是一个
如果指定的字符串不能解释为有效的日期和时间，则出错。
如果需要使用空格，请引用该字符串。

-DELta_From_Change 数
此选项可用于从其更改中指定特定的项目增量
数。

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

-独立的
此选项用于指定副本将独立于任何
特别的变化。 这些文件将相对于当前目录进行复制。

-保持
此选项可用于保留通常已删除或
由命令代替。 默认为用户的 删除文件首选项 如果不
指定，见 配置文件(5) 了解更多信息。

-No_Keep
此选项可用于确保删除文件和/或目录
或由命令代替。 默认为用户的 删除文件首选项 如果不
指定，见 配置文件(5) 了解更多信息。

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

-Not_Logging
此选项可用于禁用输出和错误的自动记录到
一份文件。 当多个 aegis 命令组合在一个 shell 中时，这通常很有用
脚本。

输出 文件名
此选项可用于指定从文件复制的文件的输出文件
基线。 使用此选项时，只能命名一个基线文件。 这
文件名“-”被理解为表示标准输出。 该选项不
将文件添加到更改文件集中。 没有 锁 当此选项为
使用，甚至没有基线读锁。

-覆盖
此选项可用于强制覆盖文件。 默认操作是
如果现有文件将被覆盖，则给出错误。

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

-只读
此选项可用于指定文件将用于隔离
从基线变化。 用户不打算编辑文件。 这些
必须在开发结束前取消复制文件。

-废除
此选项可用于撤销（回滚）已完成的更改。 更改为
撤消（回滚）以通常的方式指定，使用 --delta 之一
选项​​。

-TERse
此选项可用于使列表产生最少的
信息。 它通常对 shell 脚本很有用。

-树干
此选项可用于指定源文件的项目主干，而不是
比基线。 （也可以看看 -分支 选项，-trunk 选项与
“-branch -”选项。）

-详细
此选项可用于使 aegis 产生更多输出。 默认情况下
只产生错误的输出。 当与 -列表 选项这个选项
导致添加列标题。

-等待 此选项可用于要求 Aegis 命令等待访问锁定，如果
它们不能立即获得。 默认为用户的 锁等待偏好
如果未指定，请参阅 配置文件(5) 了解更多信息。

-No_Wait
此选项可用于要求 Aegis 命令在访问时发出致命错误
不能立即获得锁。 默认为用户的
锁等待偏好 如果未指定，请参阅 配置文件(5) 了解更多信息。

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

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

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

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

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

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

推荐 别名

此命令的推荐别名是
csh% 别名 aecp 'aegis -cp \!* -v'
sh$ aecp(){aegis -cp "$@" -v}

错误

如果更改不在 作为 发达 州。
如果未将更改分配给当前用户，则会出现错误。
如果文件已经在更改中并且 -覆盖 选项不是
指定的。

退出 状态

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

环境 变数

我们 庇护(1) 获取可能影响此命令的环境变量列表。 看
配置文件(5)为项目配置文件的 项目特定 字段如何设置
Aegis 执行的所有命令的环境变量。

示例

下面是一些简单的例子。 请记住，大多数命令都是相对于当前的
目录，即使这些示例假设您处于开发的基础
目录树。

复制 全 项目
要将整个项目复制到您的更改中，请使用命令
.
尾随点是命令的一部分，它表示“当前目录和所有内容
在它下面”。这适用于项目源代码树中的任何目录，如果你想成为
更有选择性。

生产 此前 项目 版本
您希望完全复制项目早期版本的源代码，
您需要知道 edelta 编号（使用 AEL 项目历史 找到它）。 然后用这个
命令：
aecp-delta n .
哪里 n 是项目历史记录中的增量数。 再次，尾随点是的一部分
命令。 通过使用 $版本 替代（见 亚瑟(5) 了解更多信息）您
可以在分发它之前将此增量编号嵌入到您的程序中。

也可以使用以下命令提供以前的更改编号：
aecp -变化增量 n .
哪里 n 是利息的变化数。 同样，尾随点是
命令。

废除 a 更改
当您需要撤销（退出）已完成的更改时，可能需要一些
前一段时间，所以你需要知道增量号或更改号。 使用这个命令：
aecp-delta n -撤销。
哪里 n 是兴趣的增量数。 所有其他 -delta 变体也可以工作，所以
如果您知道更改编号，则可以更有选择性地选择要复制的文件：
aecp -变化增量 n `宙斯盾-l cf-ter-c n`
哪里 n 是利息的变化数。 这只会复制位于
冒犯的变化。

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