1.. SPDX-License-Identifier: GPL-2.0 2 3========================================= 4Subsistema de Devicetree e Open Firmware 5========================================= 6 7Outros documentos sobre o processo 8---------------------------------- 9 10Consulte os documentos em Documentation/devicetree/bindings/ para saber como 11escrever bindings de Devicetree corretamente e como enviar patches. 12 13Revisão e tratamento de patches 14------------------------------- 15 16Os patches sob responsabilidade dos mantenedores de Devicetree são processados 17de formas distintas, conforme o tipo de patch: 18 191. Código central de drivers OF, por exemplo, drivers/of/: 20 os patches são revisados e aplicados pelos mantenedores de DT. 21 222. Bindings de Devicetree: 23 os patches são revisados pelos mantenedores de DT, mas devem ser aplicados 24 pelos mantenedores do subsistema, exceto em alguns casos. Consulte também 25 *Para mantenedores do kernel* em 26 Documentation/devicetree/bindings/submitting-patches.rst. 27 283. DTS e drivers: 29 os mantenedores de DT podem fazer comentários, mas, em geral, não se espera 30 uma revisão. Os DTS devem passar nas verificações de esquema 31 (dtbs_check) ou, ao menos, não gerar novos avisos. 32 33Patchwork 34~~~~~~~~~ 35 36Os mantenedores de Devicetree revisam patches usando o Patchwork; portanto, o 37status atual de um patch pode ser consultado por lá. Em submissões típicas de 38drivers, o Patchwork recebe toda a série de patches, mas normalmente apenas 39alguns patches são bindings de Devicetree e, assim, revisados pelos 40mantenedores de DT. 41 42Explicação dos status do Patchwork: 43 44 - **New**: ainda não processado pelo conjunto de ferramentas de automação. 45 - **Needs ACK**: aguardando revisão dos mantenedores de DT. 46 - **Handled Elsewhere**: patch não relacionado a DT; não será revisado aqui. 47 - **RFC**: o patch provavelmente foi ignorado por ser um RFC incompleto. 48 - **Changes Requested**: o patch foi revisado e os mantenedores de DT esperam 49 alterações. 50 - **Accepted**: o patch foi revisado e aplicado pelos mantenedores de DT em 51 sua árvore. 52 - **Not Applicable**: o patch foi revisado e provavelmente está em boas 53 condições, com uma tag *Reviewed-by* ou *Acked-by* fornecida, mas os 54 mantenedores de DT esperam que outra pessoa o aplique. 55 56Nova revisão e pings de patches 57~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 58 59Devido ao alto volume de e-mails, os mantenedores de Devicetree não leem todas 60as mensagens que recebem; em vez disso, eles dependem do Patchwork durante o 61processo de revisão. Além disso, muitas vezes deixam de lado patches que já 62foram revisados. 63 64Como resultado, os mantenedores podem não perceber: 65 661. Perguntas sobre patches já revisados. 672. Pings, por exemplo, quando um patch foi revisado pelos mantenedores de DT, 68 mas ainda não foi aplicado pelos mantenedores do subsistema. 69 70Esses casos podem ser tratados das seguintes formas: 71 721. Enviando um ping aos mantenedores de DT no canal de IRC. 732. Removendo a tag *Acked-by* ou *Reviewed-by* do mantenedor de DT ao enviar 74 uma nova versão da série de patches, junto com uma explicação no changelog 75 do patch sobre o motivo da remoção da tag e o que se espera dos mantenedores 76 de DT. 77