GNU Radio 社区贡献

维护者

GNU Radio 的维护者:

代码标准

所有的代码捐助者应当遵守 GNU Coding Standards 以及在 README.hacking 对 C++ 代码标准的修正。

版权

在我们能够接受你的完美的代码捐助之前，我们需要对FSF的版权知识做些功课。在此（ here）你可以发现对此的描述。
这些内容可以被浓缩为如下：
  • 如果你为 GNU Radio 写了些新代码或补丁代码也乐于捐助，你应当给 patch-gnuradio@… 列表邮件，或者给 GNU Radio 维护者之一索求相关的表格。在这个阶段我们可能询问你一些额外问题。
  • 你将通过邮件收到一个简短的表格，填好后邮件回FSF.
  • FSF 一旦收到此邮件，他们将会邮寄你一些有关版权（的功课）的文件，签完字后寄回给他们。
  • 只要 FSF 把你的签字文件一归档，我们便把你的改动（贡献）体现在代码库内。
  • 个别的很小的改动（小于 10 行的代码）可以直接被我们接受而不必做这些（版权功课）。

递交补丁

每个补丁文件都必须具有（下列）一些相关信息，然后我们才能够恰当的评估它。
  • 对程序瑕疵（bug）的描述以及你的补丁如何处理这些错误的。如果是添加新的特性，描述这些特性和你是如何实现这些特性的。带有测试的补丁是受到特别欢迎的。
  • ChangeLog 的条目是纯文本，参看一些 ChangeLog 的文档感受一下格式和内容。
  • 补丁文件。
  • 如果你的改动增添了一些新的特性，请提供文档as a patch to the texinfo docs。
请把你的补丁通过邮件发往 patch-gnuradio@… 邮件列表。

你一旦提交你的补丁，有人便会告诉你下一步如何去做。如果补丁很小，直接发往列表即可。附件一定要以 MIME 文本格式，或者直接复制粘贴到邮件中。uuencoded 编码格式的补丁，或者没法被某个特定的 MIME 编码阅读的补丁都将会给 GNU Radio 开发者阅读和实施你的补丁带来困难。如果你的补丁文件很大（好几百个 KB），请试图将你的文件上传到 savannah （诸如在线文档存储之类）后只需给出链接便可。

持续性地捐赠高质量的代码者可能会给予直接访问版本管理器（subversion）的权利。

递交程序瑕疵（Bug）报告

有一个专门用来提交程序瑕疵（Bug)报告的列表： bug-gnuradiuo@..., 使得开发者能够追踪那些被提交的报告。如果你发现 GNU Radio 的什么瑕疵，请尽可能以一个完整的报告发送到此列表。理想的情况是，在你的报告中应当包括运行 congfig.guess 时、运行 ./configure 时得到的文本、更进一步，如果可能的话，用 diff -u5 把你的能够解决问题补丁（同以前的）对比一下。如果可能的话，发送一个小的脚本（展示）如果没有补丁时出错，打过补丁后便正常。这样一来，我们便可以在发行版本中测试从而使错误不再出现。








注：Contribute to GNU Radio （原文出处，翻译整理仅供参考!）