Changes between Version 7 and Version 8 of Nl:DevelopersGuide/StyleGuide
- Timestamp:
- 2016-01-30T12:28:26+01:00 (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Nl:DevelopersGuide/StyleGuide
v7 v8 1 [[TranslatedPages(revision=2 8)]]1 [[TranslatedPages(revision=29)]] 2 2 = Richtlijnen voor ontwikkelen = 3 3 … … 10 10 * Documenteer uw code '''uitvoerig'''. Veel mensen zullen u daar dankbaar voor zijn :) 11 11 * voeg gekrulde haken toe voor elke {{{if}}}, tenzij die wordt gevolgd door een {{{return}}} (of misschien een {{{throw}}}) 12 * controleer uw wijzigingen vóór patch/commit: `ant checkstyle` en controleer `checkstyle-josm.xml`; indien u vindt dat het uitvoeren van checkstyle te lang duurt voor alle bestanden, voer het dan alleen uit op de gewijzigde bestanden: 13 14 {{{ 15 svn diff --summarize | awk '{ print $2 }' | xargs java -jar tools/checkstyle/checkstyle-6.14.1-all.jar -c tools/checkstyle/josm_checks.xml 16 # or 17 git diff --name-only | xargs java -jar tools/checkstyle/checkstyle-6.14.1-all.jar -c tools/checkstyle/josm_checks.xml 18 }}} 12 19 13 20 == Hoe uw javadoc er uit zou moeten zien == … … 17 24 * {{{@since}}} kan worden weggelaten voor publieke methoden en velden die tegelijkertijd met de klasse worden geïntroduceerd, vooropgesteld dat zij niet zijn gewijzigd en de klasse juist is gedocumenteerd. 18 25 * {{{@throws}}} heeft de voorkeur boven {{{@exception}}} 26 * controleer uw wijzigingen vóór patch/commit door het genereren van javadoc: `ant javadoc`, blader door de uitvoerberichten; indien u vindt dat het uitvoeren van javadoc te lang duurt voor alle bestanden, voer het dan alleen uit op de gewijzigde bestanden: 27 28 {{{ 29 svn diff --summarize | awk '{ print $2 }' | xargs javadoc -d javadoc 30 # or 31 git diff --name-only | xargs javadoc -d javadoc 32 }}} 19 33 20 34 === Eclipse configureren === … … 30 44 == Internationalisatie == 31 45 32 * zorg er voor dat {{{tr(...)}}} gebruikt voor alle gelokaliseerde tekenreeksen 33 {{{ 46 * zorg er voor dat {{{tr(...)}}} gebruikt voor alle gelokaliseerde tekenreeksen 47 {{{ 34 48 import import static org.openstreetmap.josm.tools.I18n.tr; 35 49 … … 55 69 '''MAAR''' 56 70 {{{new JLabel(tr("Mijn label {0}",labelId));}}} 57 71 58 72 Enige uitzondering: {{{+}}} kan worden gebruikt om lange regels van niet-variabele teksten af te breken. 59 73 60 74 * Bij het gebruiken van een apostrof, zijn de volgende regels van toepassing: 61 75 62 76 Voor alle {{{tr}}} is de apostrof speciaal. (Zoals de backslash in C)[[BR]] 63 77 Hij moet worden geëscaped door een andere apostrof:
