中文portage规范
随着中文 portage 的不断断壮大,和开发人员的增加,我想推出这个规范是十分迫切的。不然整个开发就会陷入混乱,问题更会接踵而至,给维护和管理带来极大的的不便;特别是对于后来者!一、基本原则:
- 1. 不对用户作出强制的设置和安装可能用户不想装或者没有必要装的包,保持 gentoo 一贯的给用户极大的定制空间的优势。
- 2. 在更好的支持中文的同时,要兼顾其他语言,保证补丁的一般性。
- 3. ebuild 制作要符合官方规范和本规范。
- 4. 可以吸收一些官方没有的软件包,但是此软件必须具有普篇性。
- 5. 所有补丁和软件必须合乎法律、法规,任何触犯法律、法规的部分由其提供者负全责,中文 portage 小组以及其他成员不承担任何责任。
- 6. 中文 portage 小组不对使用本 portage 造成的一切损失负责。
二、细则:
- 1. 由于大家使用同一个帐号,所以提交更改的时候请注明身份,格式如下:
类别$详细内容$by 提交者fixbug$ can not input chinese in the text box $by xiaosuo
- 2. 由于 ChangeLog 为官方所有,所以没有任何理由更改,一切日志都由相应目录下的 glcChangeLog 记录,请在提交更改的同时按规范填写。
- 3. 本 portage 的 patch 一般都放在 file 的子目录 glc 下,这样能给升级带来方便。
- 4. 所有与此 portage 相关的东西都由 USE=glc 定制,换言之,除非用户将 glc 加入 USE 中否则此 portage 和官方的没有任何分别。
- 5. 如果一个 glc 补丁依赖于另外一个软件的 glc 补丁(尽量不要出现此类情况),请在 ebuild 中写明,并且对于可能出现编译错误时给出更人性化的提示(可以在 pkg_setup 函数中给出说明)。
- 6. 对 ebuild 修改处请加入相关说明,另外还可以加入相应的修改理由
#Gentoo Linux Chinese Portage Group#http://gentoo.linuxsir.org
- 7. 对官方补丁的任何 hack 都要用另外的补丁替代(补丁要放入files/glc),不能在 ebuild 中去掉,这样不尽是不礼貌的而且可能带来麻烦。同样如果 ebuild 中的语句与中文 portage 造成冲突,请注释掉相应语句,而不应删除。
- 8. 所有补丁的加入和升级都应该用 glcChangeLog 详细记录。
- 9. 所有经测试没有问题的补丁都要及时向软件的提供方或者是 gentoo 的官方提交,我们的目标就是不再需要专人维护中文 portage,消灭中文portage。
这是小锁兄起草的中文 portage 规范,大家来一起修改吧。