Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

...

  1. Documents
    • Requirements
  2. UML

Implementation

Java

  1. Coding standards
  2. Java
  3. Other languages
  4. CVS
  5. Exception handling
  6. I18N & L10N aka G11N
  7. Java
  8. Other
  9. Preferences
    • Defaults
    • Changeable by users
  10. Third-party libraries
  11. Java
  12. Other
  13. UI

Other languages

Testing

  1. Target
  2. Unit tests

Documentation

  1. Comments
  2. Help

Release

  1. Plugin
  2. Feature
  3. Product

...




Implementation


Java Coding Standards

...

  • Package names start with edu.stanford.slac.

...

Java Exception Handling

  • You should never throw/catch a generic exception (an instance of Exception, Throwable, or Error).
  • Exceptions resulting from AIDA/EPICS data errors should be logged via Err.

...

Java G11N Practices

...

How To Release A New Plugin

  • Increment the version of your pluginReset target to DEFAULT.
  • Check out all features SEAL/CSS plugin projects from CVS into your Workspace.
  • Delete features from the target directory. (but NOT the plugins!) Note: This is a very wrong step that seems to originate from an Eclipse bug in how features are built against a target.
  • Increment the version of each updated feature.
  • Remove plugins/features from the update site.
  • Export RELEASE feature to SEAL update site (Export... => Plug-in Development => Deployable features)
  • Check out the "update.seal" project from CVS.
  • Update the names and versions of the features in site.xml.
  • Export site.xml to SEAL update site. (Export => General => File System)
  • Start SEAL in "admin"- mode.
  • Update SEAL.
  • Build product using "seal.applications" (note: the order of the features matters!)
  • Test your product.
  • Copy the product to /afs/slac/g/lcls/physics/seal.new/product and update the "current" link.
  • Build JavaDoc. (optional)
  • Commit all changes to CVS.Remove all old plugins from the installation site
  • Reload your Plug-in Development target.
  • Remove all unnecessary projects from your workspace.Reload your Plug-in Development target.

...