为SWUpdate做贡献 ======================== 欢迎贡献!请按以下指引进行贡献。 贡献检查列表 ---------------------- 这些主要是一般性建议,在很多自由/开源项目中都是通用的。 - 使用git管理你的更改[*推荐*] - 尽可能遵循内核代码风格[*推荐*] 然而,有些规则并没有内核中那么严格。 如果能增加代码的可读性,最大行长度可以扩展到80字符以上。 - 将所需的版权头部信息添加到引入的每个新文件[**必要要求**] - 在所有补丁中添加签名信息(signed-off)[**必要要求**] - 用于证明"开发者的原始证明", 请参阅下文 - 当你并非独立工作时,请向你的雇主确认这些信息! - 增加你的补丁的版本,如果有后续版本需要的话 [*推荐*] - 在提交信息下添加 "Change from Vx" 描述,以跟踪补丁的历史 - 建议使用优秀的 "patman" 工具管理补丁。这是U-Boot项目的一部分(tools/patman), 但它也可以用于其他项目。 - 检查以确认你的补丁没有破坏构建[**必要要求**] - 在 `configs/` 目录下有一组配置文件 请对目录中的所有文件运行构建,以确保SWUpdate仍然可以从与你的配置不同的配置中构建。 - 将补丁发送到邮件列表[**必要要求**] - 使用 `git format-patch` 生成你的patch - 如果可能的话,使用 `git send-email` . 则可以避免可能由发件人带来的破坏 - 如果补丁是针对Yocto的meta层,则添加前缀[meta-swupdate] - 将patch添加在正文,不要使用附件 - 不接受 HTML 邮件! - 不要使用github Pull Request。本项目不使用github设施。 评审只在一个地方进行:邮件列表。github的PR将被忽略。 补丁由patchwork跟踪(参考 http://jk.ozlabs.org/projects/patchwork/). 你可以在此查看补丁状态 http://patchwork.ozlabs.org/project/swupdate/list. 开发者的代码签名证明1.1 ------------------------------------- 当用如下形式对一个此项目的patch进行signing-off Signed-off-by: Random J Developer 请使用你的真实名字(不要使用假名或匿名进行贡献),并意味着你声明了: 通过对本项目的做出贡献,我证明: (a) 贡献的全部或部分由我创建,我有权按照文件中所示的开源许可提交文件;或 (b) 贡献基于我所知的在适当的开源许可下涵盖的以前的工作, 并且我有权在该许可下提交该工作的修改,无论该修改是全部还是部分由我 在同一开源许可下创建的(除非我被允许在不同的许可下提交),如文件中所示;或 (c) 这个贡献是由另一个人直接提供给我的,他证明了(a)、(b)或(c),而我并没有修改它。 (d) 我理解并同意本项目及其贡献是公开的,且该贡献的记录(包括我随其提交的所有个人信息, 包括我的签名)将无限期地保留,并可能根据本项目或涉及的开源许可重新分发。