5.6 KiB
Contribuindo
🌐 Azerbaijani, bahasa Indonesia, Català، Čeština, Dansk, Deutsch, English, Español, Français, Galego, Italiano, Kurdi, Kurdî, Lietuvių, Mongolia, Nederlands, Norsk, Polski, Português, Svenska, tiếng Việt, Türkçe, Ελληνικά, Українська، العربية, हिन्दी, 한국어, 日本語, 正體中文, 简体中文
O código-fonte neste repositório foi digitado manualmente a partir de impressões em papel, logo alguns erros de digitação e discrepâncias foram introduzidos acidentalmente. O código deve ser modificado para se tornar consistente com as seguintes digitalizações:
O seguinte site é facilmente navegável com impressões digitalizadas de Comanche e Luminary: https://28gpc.csb.app/
Extensões úteis
GitHub possui suporte de sintaxe nativo para a linguagem assembly AGC. Infelizmente, seu editor de texto não o terá. Portanto, existem extensões para a linguagem AGC que providenciam destaque de sintaxe para os seguintes editores:
- Atom†
- CodeBlocks
- Eclipse
- Kate
- ProgrammersNotepad
- Sublime Text 3†
- TextPad
- Vim
- Visual Studio Code†
- jEdit
† Suporta formatação automática
Formatando
Nota: GitHub e as três extensões listadas acima garantirão que você estará usando a formatação correta automaticamente.
- Use indentação por tab
- Use largura de tab em 8
- Diminua o espaço em branco à direita
O que devo conferir?
Quaisquer discrepâncias entre as digitalizações e o código-fonte neste repositório, incluindo:
Comentários
- Comentários no código transcrito devem corresponder exatamente às digitalizações
- Isso pode envolver criar um erro de digitação deliberadamente ou remover/adicionar um comentário inteiro.
Quebra de linha
- Quebras de linha com
R0000
na coluna 1 devem corresponder exatamente às digitalizações. - Quebras de linha sem
R0000
na coluna 1 devem conter apenas uma ou duas linhas em branco em sequência.- Se existem mais de duas quebras de linha em branco, remova as quebras de linha extras.
- Linhas com
R0000
na coluna 1 não contam para este propósito.
- Linhas com
- As imagens fonte foram criadas por meio de um dígito não-impresso na coluna 8. Um 2 forçava um espaço duplo (linha em branco única) e um 3 forçava um espaço triplo (linha em branco dupla). Os valores de 4 até 8 foram definidos porém nunca usados. Leia mais sobre em #159
- Se existem mais de duas quebras de linha em branco, remova as quebras de linha extras.
Por exemplo, o seguinte código:
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
Deve tornar-se:
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
Espaços
- Espaços entre dois caracteres na cadeia de caracteres devem respeitar a seguinte convenção (veja a discussão em #316):
- Espaço único para novas palavras.
- Espaço duplo para novas sentenças.
- Espaço triplo para indentações.
Por exemplo, o seguinte código:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Deve tornar-se:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Notas
Antes de realizar um PR, por favor, certifique-se que suas mudanças estejam consistentes com as digitalizações!