4.8 KiB
Bijdragen
🎌 Čeština, Deutsch, English, Español, Français, Italiano, Kurdi, Lietuvių, Nederlands, Norsk, Polski, Português, Türkçe, Ελληνικά, العربية, 日本語, 正體中文, 简体中文, 한국어
De broncode in deze repository is handmatig gedigitalizeerd van papieren stukken. Typfouten en andere discrepanties kunnen per ongeluk zijn toegevoegd. De code zal worden aangepast om gelijk te worden gemaakt aan de gescande papieren:
Handige extensies
GitHub heeft syntax ondersteuning voor de AGC assembly taal ingebouwd. Helaas heeft jouw editor dit niet, gelukkig zijn er AGC extensies die de volgende editors kunnen voorzien van syntax ondersteuning:
- Atom†
- CodeBlocks
- Eclipse
- Kate
- ProgrammersNotepad
- Sublime Text 3†
- TextPad
- Vim
- Visual Studio Code†
- jEdit
† Ondersteunt automatische opmaak
Opmaak
Let op: GitHub en de extensies in de lijst hierboven zorgen ervoor dat je automatisch de correcte opmaak gebruikt.
- Gebruik tab indentatie
- Gebruik een tab width van 8
- Haal trailing whitespace weg
Wat controleer ik?
Elk verschil tussen de scans en de broncode in deze repository inclusief:
Commentaren
- Commentaren in de overgeschreven code moeten exact hetzelfde zijn als in de scans
- Soms betekent dit dat je expres een typfout moet overnemen of een commentaar volledig moet weghalen.
Regeleindes
- Regeleinden met
R0000
in kolom 1 moeten exact overeen komen met de scans. - Regeleinden zonder
R0000
in kolom 1 moeten slechts 1 of 2 lege regels in een rij bevatten.- Als er meer dan twee lege regels zijn, haal de extra witregels dan weg.
- Regels met
R0000
in kolom 1 tellen hierbij niet mee.
- Regels met
- In de bron scans zijn deze aangemaakt door een niet uitgeprint getal in kolom 8. Een 2 in deze kolom veroorzaakte een dubbele spatie (enkele witregel) en een 3 in deze kolom veroorzaakte een driedubbele spatie (dubbele witregel). De waarden 4-8 waren wel gedefinieerd maar nooit gebruikt. Lees hier meer over in #159
- Als er meer dan twee lege regels zijn, haal de extra witregels dan weg.
Bijvoorbeeld het volgende:
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
Zou dit moeten worden:
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
Spaties
- Spaties tussen twee karakters in de string moeten de volgende conventie gebruiken (bekijk de discussie in #316):
- Enkele spatie voor een nieuw woord.
- Dubbele spatie voor een nieuwe zin.
- Driedubbele spatie voor inspringen.
Bijvoorbeeld het volgende:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Zou dit moeten worden:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Let op
Voordat je een PR maakt zorg er alsjeblieft voor dat je wijzigingen consistent zijn met de scans!