搜索

[24703] 2016-02-10_如何给GNU项目贡献代码

文档创建者：s7ckTeam
浏览次数：1
最后更新：2025-01-18
2016-02-10_如何给GNU项目贡献代码 如 何 给   G N U   项 目 贡 献 代 码 作 者 ： l u 4 n x   L i n u x 中 国   2 0 1 6 - 0 2 - 1 0 转 载 自 ： h t t p : / / w w w . s h e l l c o d e s . o r g / P r o g r a m m i n g / % E 5 % A 6 % 8 2 % E 4 % B D % 9 5 % E 7 % B B % 9 9 G N U % E 9 % A 1 % B 9 % E 7 % 9 B % A E % E 8 % B 4 % A 1 % E 7 % 8 C % A E % E 4 % B B % A 3 % E 7 % A 0 % 8 1 . h t m l   作 者 ：   l u 4 n x 想 为 开 源 项 目 贡 献 你 的 代 码 吗 ？ 这 里 告 诉 你 该 如 何 入 手 。 本 文 以   E m a c s   项 目 为 例 。 1 、 、 订 阅 邮 件 列 表 订 阅 邮 件 列 表 G N U   的 项 目 都 通 过 邮 件 列 表 和 全 世 界 的 贡 献 者 交 流 ， 所 以 你 应 该 先 去   h t t p s : / / l i s t s . g n u . o r g / m a i l m a n / l i s t i n f o   找 到 相 应 项 目 的 邮 件 列 表 。 一 般 建 议 加 入   b u g   和   d e v e l   两 个 邮 件 列 表 。 比 如   E m a c s ， 找 到   E m a c s - d e v e l   和   b u g - g n u - e m a c s   邮 件 列 表 并 订 阅 ， 前 者 用 于 讨 论 改 进 、 提 新 的   f e a t u r e 等 ， 后 者 用 于 反 馈   b u g 、 提 交   p a t c h 。 邮 件 列 表 的 邮 件 量 一 般 都 比 较 大 ， 尤 其 是 加 入 了 多 个 项 目 的 邮 件 列 表 后 ， 不 仅 信 息 多 ， 还 很 杂 乱 ， 所 以 建 议 ： 1 、 、   建 立 文 件 夹 ， 如 图 ， 建 立 文 件 夹 ， 如 图 ， Q Q   邮 箱 ： 邮 箱 ： 2 、 、   做 收 信 规 则 ， 根 据 收 件 人 规 则 把 邮 件 移 动 到 相 应 的 文 件 夹 中 。 如 图 ， 做 收 信 规 则 ， 根 据 收 件 人 规 则 把 邮 件 移 动 到 相 应 的 文 件 夹 中 。 如 图 ， Q Q   邮 箱 ： 邮 箱 ：
2 、 、 修 改 代 码 修 改 代 码 G N U   项 目 有 自 己 的 代 码 仓 库 ， 在 这 里 ： h t t p s : / / s a v a n n a h . g n u . o r g /   。 找 到   E m a c s   的   G i t   仓 库 ： h t t p : / / g i t . s a v a n n a h . g n u . o r g / c g i t / e m a c s . g i t 然 后 把 代 码 拉 回 本 地 ： E m a c s   有 很 多 分 支 ， 目 前 的 开 发 主 要 在   e m a c s - 2 5   这 个 分 支 上 进 行 ， 所 以 上 面 命 令 我 是 从   e m a c s - 2 5   分 支 上 拉 取 的 代 码 。 一 段 时 间 后 维 护 者 会 把 代 码 合 并 到   m a s t e r   分 支 中 。 如 果 之 前 已 经 拉 过 代 码 了 ， 在 修 改 前 记 得   p u l l   一 次 来 保 持 代 码 是 最 新 的 ： 不 要 在 当 前 分 支 上 修 改 代 码 ， 理 由 有 很 多 ， 比 如 官 方 不 一 定 接 受 你 的   p a t c h 。 而 是 对 每 修 一 个   b u g   都 新 建 一 个 分 支 ： 这 行 命 令 我 新 建 了 一 个 叫 “ t r a m p - s h - a d d - d o a s ” 的 分 支 ， 取 名 要 有 含 义 ， 尤 其 是 你 在 要 修 复 多 个   b u g   时 好 区 分 。 这 个 名 字 的 含 义 是 为 了 在 t r a m p - s h   里 增 加   d o a s   命 令 的 支 持 。 接 下 来 是 漫 长 的 编 码 阶 段 ， 主 要 注 意 两 点 ： 1 .   编 码 风 格 统 一 ， 最 简 单 的 方 法 就 是 看 看 同 文 件 里 别 人 是 怎 么 写 的 ， 他 的 缩 进 、 命 名 、 花 括 号 位 置 等 等 。 2 .   不 要 去 修 改 无 关 的 代 码 ， 比 如 去 动 了 其 他 位 置 的 缩 进 等 等 。 不 然 维 护 者 会 很 疑 惑 。 代 码 写 完 后 ， c o m m i t   一 下 ： 1 .   $   g i t   c l o n e   g i t : / / g i t . s v . g n u . o r g / e m a c s . g i t   - b   e m a c s - 2 5 1 .   $   g i t   p u l l 1 .   $   g i t   c h e c k o u t   - b   t r a m p - s h - a d d - d o a s   - - t r a c k   e m a c s - 2 5 1 .   $   g i t   c o m m i t   - a
写 一 段 好 的   c o m m i t   也 很 重 要 ， 最 简 单 的 方 法 就 是 执 行   g i t   l o g ， 看 别 人 怎 么 写 的 。 一 般   c o m m i t   的 第 一 行 写 清 楚 你 本 次 修 改 是 做 了 什 么 ， 再 空 一 行 ， 逐 行 列 出 增 加 、 修 改 的 函 数 和 变 量 等 ， 让 开 发 者 一 目 了 然 ， 比 如 ： 3 .   5 .   提 交   c o m m i t   后 ， 执 行 以 下 命 令 生 成 一 个   p a t c h   文 件 ： 这 行 命 令 会 把 当 前 分 支 修 改 的 内 容 和   e m a c s - 2 5   分 支 做   d i f f ， 然 后 在 当 前 目 录 下 生 成 一 个   d i f f   文 件 ， 如 ： 0 0 0 1 - A d d - s u p p o r t - f o r - d o a s - c o m m a n d . p a t c h 。 生 成 的   p a t c h   文 件 是 需 要 发 到 邮 件 列 表 里 ， 相 关 文 件 的 维 护 者 会 跟 你 沟 通 并 合 并 到 代 码 仓 库 中 的 ， 和   G i t h u b   上 直 接 发   P u l l   R e q u e s t   来 比 ， 就 没 那 么 幸 福 了 。 最 后 ， 把 补 丁 发 送 到 邮 件 列 表 去 （ 这 里 或 许 你 需 要 配 置 一 下   G i t   的 发 送 邮 件 ， 请 自 行 找 资 料 ） ： 之 后   G N U   的   b u g   跟 踪 系 统 会 确 认 你 的   b u g ， 并 给 你 提 交 的   b u g   分 配 一 个   I D ， 然 后 自 动 回 复 一 封 邮 件 给 你 ： 1 .   $   g i t   c o m m i t   - a 1 .   A u t h o r :   X i   L u   < l x @ s h e l l c o d e s . o r g > 2 .   D a t e :       F r i   D e c   1 1   1 0 : 5 2 : 0 8   2 0 1 5   + 0 2 0 0 4 .           I n i t i a l   s u p p o r t   f o r   R u b y   i n   ' e t a g s ' 6 .           *   l i b - s r c / e t a g s . c   < R u b y _ s u f f i x e s > :   N e w   v a r i a b l e . 7 .           ( l a n g _ n a m e s ) :   A d d   a n   e n t r y   f o r   R u b y . 8 .           ( R u b y _ f u n c t i o n s ) :   N e w   f u n c t i o n .     ( B u g # 2 2 1 1 6 ) 1 .   $   g i t   f o r m a t - p a t c h   e m a c s - 2 5 1 .   g i t   s e n d - e m a i l   - - t o = b u g - g n u - e m a c s @ g n u . o r g   补 丁 文 件 1   补 丁 文 件 2   补 丁 文 件 . .
然 后 就 等 待 相 关 维 护 者 回 复 邮 件 与 你 沟 通 。 在 和 开 发 者 沟 通 时 就 事 论 事 ， 不 要 说 无 关 的 废 话 。 另 外 一 定 要 注 意 回 复 邮 件 的 风 格 ， 社 区 一 般 使 用 的   B o t t o m - p o s t i n g （ 下 回 复 ） 风 格 ， 实 际 上 很 多 开 源 软 件 都 是 用 的   B o t t o m - p o s t i n g   风 格 的 。 如 果 这 方 面 你 不 熟 悉 ， 请 参 考 维 基 百 科 学 习 一 下 ：   h t t p s : / / z h . w i k i p e d i a . o r g / w i k i / % E 5 % 9 B % 9 E % E 5 % B 8 % 9 6 % E 9 % A 3 % 8 E % E 6 % A 0 % B C   。 Q Q   邮 箱 网 页 版 是 不 支 持 下 回 复 的 ， 最 好 用 邮 件 客 户 端 来 回 复 ， 一 般 邮 件 客 户 端 是 可 以 设 置 成   B o t t o m - p o s t i n g   风 格 的 ， 请   G o o g l e   自 行 查 阅 设 置 方 法 。 开 发 者 和 你 进 一 步 沟 通 ， 完 毕 之 后 会 关 闭 这 个   b u g ， 并 把 代 码 合 并 到 仓 库 中 去 。 你 的 代 码 在 合 并 到 仓 库 之 前 可 能 还 会 有 一 道 障 碍 ， 直 到 清 除 障 碍 后 代 码 才 可 以 进 入 仓 库 — — 签 协 议 。 3 、 、 签 署 协 议 文 件 签 署 协 议 文 件 如 果 你 贡 献 的 代 码 超 过 1 5 行 （ 见 ： h t t p s : / / w w w . g n u . o r g / p r e p / m a i n t a i n / h t m l _ n o d e / L e g a l l y - S i g n i f i c a n t . h t m l ） ， 是 需 要 和   F S F （ 自 由 软 件 基 金 会 ） 签 纸 质 协 议 的 。 签 协 议 的 主 要 目 的 是 证 明 代 码 由 你 所 写 ， 没 有 侵 犯 到 其 他 版 权 ， 并 且 版 权 归 给   F S F 。 如 果 你 提 交 的 代 码 确 实 需 要 签 文 件 ， 开 发 者 会 邮 件 回 你 一 个 申 请 表 模 板 ， 让 你 按 模 板 内 容 填 写 一 封 申 请 邮 件 给   F S F   来 申 请 签 协 议 文 件 的 。 模 板 内 容 如 下 （ 注 ： “ # ” 是 我 自 行 添 加 的 注 解 ） ： 3 .   5 .   1 .   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2 .   R E Q U E S T :   S E N D   F O R M   F O R   P A S T   A N D   F U T U R E   C H A N G E S 4 .   [ W h a t   i s   t h e   n a m e   o f   t h e   p r o g r a m   o r   p a c k a g e   y o u ' r e   c o n t r i b u t i n g   t o ? ] 6 .   #   你 贡 献 的 项 目 名 称 ， 比 如 E m a c s 。
8 .   1 1 .   1 3 .   1 6 .   1 9 .   2 1 .   2 3 .   2 5 .   2 7 .   2 9 .   3 1 .   3 3 .   3 5 .   3 8 .   7 .   #   注 意 一 个 项 目 只 能 签 一 份 协 议 ， 如 果 你 这 里 写 多 个 项 目 ， 就 需 要 签 多 份 协 议 。 9 .   [ D i d   y o u   c o p y   a n y   f i l e s   o r   t e x t   w r i t t e n   b y   s o m e o n e   e l s e   i n   t h e s e   c h a n g e s ? 1 0 .   E v e n   i f   t h a t   m a t e r i a l   i s   f r e e   s o f t w a r e ,   w e   n e e d   t o   k n o w   a b o u t   i t . ] 1 2 .   #   解 释 你 贡 献 的 代 码 里 是 否 用 了 其 他 项 目 代 码 ， 如 果 有 就 列 一 下 。 1 4 .   [ D o   y o u   h a v e   a n   e m p l o y e r   w h o   m i g h t   h a v e   a   b a s i s   t o   c l a i m   t o   o w n 1 5 .   y o u r   c h a n g e s ?     D o   y o u   a t t e n d   a   s c h o o l   w h i c h   m i g h t   m a k e   s u c h   a   c l a i m ? ] 1 7 .   #   是 不 是 以 你 个 人 名 义 来 提 交 代 码 的 ， 是 的 话 就 写 n o 。 1 8 .   #   如 果 是 公 司 名 义 ， 好 像 需 要 公 司 和 F S F 再 签 协 议 ， 这 个 流 程 我 不 熟 悉 。 2 0 .   [ F o r   t h e   c o p y r i g h t   r e g i s t r a t i o n ,   w h a t   c o u n t r y   a r e   y o u   a   c i t i z e n   o f ? ] 2 2 .   #   一 般 就 写 C h i n a 。 2 4 .   [ W h a t   y e a r   w e r e   y o u   b o r n ? ] 2 6 .   #   你 生 日 。 2 8 .   [ P l e a s e   w r i t e   y o u r   e m a i l   a d d r e s s   h e r e . ] 3 0 .   #   你 邮 件 地 址 。 3 2 .   [ P l e a s e   w r i t e   y o u r   p o s t a l   a d d r e s s   h e r e . ] 3 4 .   #   通 信 地 址 ， 需 要 写 详 细 点 。 3 6 .   [ W h i c h   f i l e s   h a v e   y o u   c h a n g e d   s o   f a r ,   a n d   w h i c h   n e w   f i l e s   h a v e   y o u   w r i t t e n 3 7 .   s o   f a r ? ] 3 9 .   #   你 改 变 了 哪 些 文 件 ， 列 出 来 。
把 这 封 邮 件 发 给   c o p y r i g h t - c l e r k @ f s f . o r g ，   邮 件 标 题 是 你 真 实 的 姓 名 邮 件 标 题 是 你 真 实 的 姓 名   ， 邮 件 内 容 就 是 上 面 模 板 填 写 后 的 内 容 。 然 后   F S F   会 审 核 你 的 申 请 ， 一 般 需 要 几 天 。 审 核 通 过 后 他 们 会 给 你 发 一 封 邮 件 ， 让 你 将 附 件 的   P D F   文 件 打 印 下 来 ， 然 后 签 字 ， 签 上 你 的 名 字 （ 不 要 用 中 文 ） ， 以 及 写 好 日 期 （ 日 期 的 月 份 需 要 用 英 文 ， 不 要 用 数 字 ， 如 ： 2 0 1 5   D e c e m b e r   3 0 ） 。 接 下 来 ， 把 签 完 的 纸 质 协 议 寄 到 美 国 去 。 你 可 以 去 淘 宝 找   D H L   快 递 代 收 ， D H L   大 概 3 天 就 到 了 ， 费 用 大 概 是 ￥ 1 4 0 ～ ￥ 1 6 0 之 间 。 他 们 收 到 你 的 纸 质 协 议 后 也 会 签 字 ， 需 要 等 几 天 ， 具 体 周 期 视 他 们 处 理 情 况 而 定 ， 如 果 你 等 了 两 周 都 还 没 回 你 ， 那 么 你 可 以 回 邮 件 问 问 怎 么 回 事 ， 比 如 我 的 就 正 好 遇 到 圣 诞 节 放 假 。 最 后 ， 他 们 会 把 签 字 后 的 扫 描 件 以   P D F   格 式 发 送 到 你 的 邮 箱 ， 整 个 过 程 算 是 结 束 了 。 如 果 你 换 了 工 作 ， 也 请 告 知 他 们 ， 有 可 能 会 涉 及 到 协 议 重 签 ， 比 如 你 到 了 新 公 司 ， 给 他 们 提 交 的 代 码 不 再 是 个 人 性 质 。 H a p p y   H a c k i n g 。 4 、 、 感 谢 感 谢 X u e   F u q i a o 、 E l i   Z a r e t s k i i 转 载 自 ： h t t p : / / w w w . s h e l l c o d e s . o r g / P r o g r a m m i n g / % E 5 % A 6 % 8 2 % E 4 % B D % 9 5 % E 7 % B B % 9 9 G N U % E 9 % A 1 % B 9 % E 7 % 9 B % A E % E 8 % B 4 % A 1 % E 7 % 8 C % A E % E 4 % B B % A 3 % E 7 % A 0 % 8 1 . h t m l   作 者 ：   l u 4 n x 推 荐 文 章 推 荐 文 章 I D 点 击 标 题 或 输 入 文 章   I D   直 达 该 文 章 3 4 0 史 上 最 复 杂 的 验 证 邮 件 地 址 的 正 则 表 达 式 4 2 2 L F S   中 文 版 手 册 发 布 ： 如 何 打 造 自 己 的   L i n u x   发 行 版 8 7 4 黑 客 和 开 源 革 命 之 间 的 关 系 1 1 2 6 为 什 么 优 秀 开 发 者 进 入 G o o g l e 后 就 不 参 与 开 源 了 ？ 3 4 1 6 R u b y   o n   R a i l s   发 明 人 的 告 白 ： 当 我 变 成 百 万 富 翁 的 那 天 ， 我 得 到 了 什 么 呢 ？ 将 文 章 分 享 给 朋 友 是 对 我 们 最 好 的 赞 赏 ！ 阅 读 原 文

回复

举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

使用Markdown编辑器编辑 使用富文本编辑器编辑

Archiver| 手机版| 小黑屋|
Powered by Discuz! X3.4 Copyright © 2001-2020, Tencent Cloud. 商业源码建议获取授权，如侵犯您的权益，请联系客服处理