Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-6476924

Need to standardize usage for "event dispatch thread" in API documentation

    Details

    • Type: Enhancement
    • Status: Open
    • Priority: P5
    • Resolution: Unresolved
    • Affects Version/s: 7
    • Fix Version/s: tbd
    • Component/s: client-libs
    • Labels:
    • Subcomponent:
    • Understanding:
      Cause Known
    • CPU:
      other
    • OS:
      generic

      Description

      In the Swing API spec, the event dispatch thread is often called the event *dispatching* thread. There are further variations as to capitalization, hyphenation, and the use of "a" versus "the". Except for the last issue (see below), these are not significant technical communication problems; I think everybody know what's referred to. However, such stylistic variations look very unprofessional.

      Suggested standard: "dispatching" is unacceptable, because of SwingWorker.isDispatchThread(). Beyond that, my own intuition says "all lower case, no hyphens". (A professional copy editor might disagree; I don't have that kind of background.) But what specific usage we choose is less important than picking one and using it consistently.

      About definite versus indefinite article: This is not just a language geek's quibble. Swing is a single-threaded library built on AWT, a multi-threaded library. Ignoring this fact carries a high risk of introducing concurrency bugs. To emphasize and clarify this fact, we must always say "*the* Swing event dispatch thread" but "*a* AWT event dispatch thread".

        Attachments

          Activity

            People

            • Assignee:
              serb Sergey Bylokhov
              Reporter:
              irabinovsunw Isaac Rabinovitch (Inactive)
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Imported:
                Indexed: