Difference between pages "Coding Standards/pt-br" and "Portage Tree"

< Coding Standards(Difference between pages)
(Profanity)
 
 
Line 1: Line 1:
== Padrão de Codificação Básica Em Um Nutshell ==
+
This page describes the Funtoo Linux distributed Portage tree, which contains all the ebuilds of the Funtoo Linux distribution.
  
* empacotamento de palavra (word wrap) de até 160 caracteres
+
== Community-Extensible and Distributed ==
* utilize tabs, não espaços, para endentação
+
* utilize um tamanho de tab de 4 caracteres (o tamanho de tab pode ser ajustado, mas isso afeta quando você alcançar o limite de empacotamento mágico de 160 caracteres)
+
* comentários em linhas separadas, no mesmo nível de recuo como código (seções podem ser marcadas por comentários 'outdented')
+
  
== Empacotamento de Palavra (Word Wrap) ==
+
Daniel Robbins has recently added the ability for the Portage tree to be extended and improved by the community. This allows Funtoo Linux users to contribute ebuilds of interest very easily, by simply committing their ebuilds to their own git-based portage repository. Your updated ebuilds are then auto-merged into the mainline Funtoo Portage tree every 4 hours. If you are interested in contributing to the Funtoo Linux Portage tree, please post an email to the [http://groups.google.com/group/funtoo-dev funtoo-dev mailing list] describing your overlay and its contents and we will consider the request.
  
Editores modernos fazem um bom trabalho exibindo linhas de texto muito longas, e exibições modernas tem resolução o suficiente para exibições muito superior do que 80 caracteres por linha, mesmo em resolução 1024x768. Você não deve definitivamente dividir pedaço de código elegante de linha única somente pelo argumento de manter a coisa toda sob 80 caracteres. Isso é especialmente ruim se você pegar, digamos, uma linha de 100 caracteres e dividi-la em ''mais'' do que duas linhas somente pelo argumento de mantê-lo sob 80 caracteres de largura. Mas você precisa ou quer usar múltiplas linhas para manter seu código legível, mais poder para você. Somente não faça isso para manter "com compatibilidade com cartão de 80 colunas Apple IIe" por qualquer rasão. Isso é simplesmente bobagem.
+
== Mini-Manifest Tree ==
  
== Tabulações vs. Espaços ==
+
Funtoo Linux provides two Portage tree repositories, available at the following location:
  
Tabulações e espaços tinham uma luta. Tabulações venciam. Eles são mais fáceis de lidar e permite endentação configurável para aqueles que necessitam disso. Eu não me importo com o que alguns outro grupo ou organização diga que convenção seja. Se você não quiser utilizar tabs por que você quer que todos os seus comentários de final de linha apareçam bonitos belamente, então eu tenho uma solução: não utilize comentários de final de linha (veja a próxima seção) e você ficará bem.
+
* http://github.com/funtoo/ports-2012
  
== Commentários ==
+
The first tree is a full Portage tree with full Manifests and ChangeLogs, and includes branches for Funtoo Linux as well as Gentoo Linux. The second tree is a minimized tree that contains only the unified Funtoo Linux Portage tree, all the ebuilds in the first tree, but contains "mini" Manifests (that only contain distfile digests) and has ChangeLogs removed. The first tree is used by Funtoo Linux internallly while the second tree is intended to be used by end-users, since it is much smaller.
  
Adicione comentários que proporcionam alguma ideia sobre seu código, e que ajude a proporcionar contexto. Também, por que nós utilizamos tabs, posicionam comentários em suas próprias linhas, separam do código fonte, idealmente separados por uma linha em branco acima e abaixo ao menos que você esteja comentando em verboso cada linha de código. Isso também encoraja a comentários mais longos, mais descritivos que possam abranger múltiplas linhas. Se você abranger múltiplas linhas, utilize uma margem direita consistente de 160 caracteres. Comentários lhe ajudam a entender seu código quando você voltar a ele um ano depois, então está adicionando comentários descritivos para si mesmo o tanto o quanto para outros. Inclua informação que você acharia prestativa se você tivesse um caso repentino de amnésia. Eles são especialmente importantes para o software livre e de código aberto que precisam ser mantidos por várias pessoas ao longo dos anos.
+
== How the Tree is Built ==
  
== Profanação ==
+
New versions of the Funtoo Linux Portage tree are generated every 12 hours using a special merge script that combines the Gentoo Portage tree with the Funtoo Linux funtoo-overlay as well as other 3rd-party overlays. The overlays currently being merged are:
  
Não insira qualquer profanação nos comentários do código fonte ou nos nomes de variáveis. Isso somente te faz parecer não profissional, bobo e incompetente.
+
* http://github.com/funtoo/portage (gentoo.org branch)
 +
* http://github.com/funtoo/funtoo-overlay (all ebuilds replacing those in Gentoo, including some eclass and profile patches)
 +
* http://github.com/slashbeast/foo-overlay (all ebuilds being added, with two ebuilds replacing an upstream Gentoo version)
 +
* http://github.com/adessemond/bar-overlay (all ebuilds replacing those in Gentoo)
 +
* http://github.com/funtoo/flora [[Flora]] (all ebuilds being added, with no ebuilds replacing upstream Gentoo versions)
  
 +
This list is likely to expand in the future.
  
[[Category:QA]]
+
The script used to merge the Portage overlays can be viewed here:
 +
 
 +
https://github.com/funtoo/funtoo-overlay/blob/master/funtoo/scripts/merge.py
 +
 
 +
If you are interested in contributing ebuilds to Funtoo Linux, please contact us on the [http://groups.google.com/group/funtoo-dev funtoo-dev mailing list].
 +
 
 +
[[Category:Portage]]
 +
[[Category:Funtoo features]]

Revision as of 04:06, December 28, 2014

This page describes the Funtoo Linux distributed Portage tree, which contains all the ebuilds of the Funtoo Linux distribution.

Community-Extensible and Distributed

Daniel Robbins has recently added the ability for the Portage tree to be extended and improved by the community. This allows Funtoo Linux users to contribute ebuilds of interest very easily, by simply committing their ebuilds to their own git-based portage repository. Your updated ebuilds are then auto-merged into the mainline Funtoo Portage tree every 4 hours. If you are interested in contributing to the Funtoo Linux Portage tree, please post an email to the funtoo-dev mailing list describing your overlay and its contents and we will consider the request.

Mini-Manifest Tree

Funtoo Linux provides two Portage tree repositories, available at the following location:

The first tree is a full Portage tree with full Manifests and ChangeLogs, and includes branches for Funtoo Linux as well as Gentoo Linux. The second tree is a minimized tree that contains only the unified Funtoo Linux Portage tree, all the ebuilds in the first tree, but contains "mini" Manifests (that only contain distfile digests) and has ChangeLogs removed. The first tree is used by Funtoo Linux internallly while the second tree is intended to be used by end-users, since it is much smaller.

How the Tree is Built

New versions of the Funtoo Linux Portage tree are generated every 12 hours using a special merge script that combines the Gentoo Portage tree with the Funtoo Linux funtoo-overlay as well as other 3rd-party overlays. The overlays currently being merged are:

This list is likely to expand in the future.

The script used to merge the Portage overlays can be viewed here:

https://github.com/funtoo/funtoo-overlay/blob/master/funtoo/scripts/merge.py

If you are interested in contributing ebuilds to Funtoo Linux, please contact us on the funtoo-dev mailing list.