General Rules for New Developments

From EPICSWIKI
Revision as of 22:52, 29 June 2016 by AndrewJohnson (talk | contribs) (Created page with "When adding new features to EPICS Base, the following general rules will be considered by the code reviewers: === Coding Style === * Follow the coding style of the source fi...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

When adding new features to EPICS Base, the following general rules will be considered by the code reviewers:

Coding Style

  • Follow the coding style of the source files that you are editing.
  • Use 4 spaces for indentation. Replacing tabs with spaces and cleaning up the indentation in areas where you are making changes is usually a good idea, but not required.

Automated Tests

  • New features should come with one or more automated test programs to confirm their correct operation.
  • LibCom provides an epicsUnitTest module, and for testing IOC operations there is a dbUnitTest module.

Documentation

  • Bug fixes should be described in an entry in the documentation/RELEASE_NOTES.html file.
  • API changes and new features should be mentioned in the Release Notes and may need updates to the Application Developers' Guide.