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. 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.

...