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

Clarify logging API spec examples

XMLWordPrintable

      I'm converting this email request from Ken Arnold into a bug report:

      http://java.sun.com/j2se/1.4.1/docs/guide/util/logging/overview.html

      (*) The name tags all seem to be unmatched, as in '<a name="foo">'
      instead of '<a name="foo"></a>'. This seems to confuse a couple of
      browsers (including mine).

      (*) The example code does not follow standard style (e.g., no space
      before '{' or after ',')

      (*) The "Simple Use" does something truly evil: it catches Error, which
      signals unrecoverable problems and should be caught only by experts, and
      not really even them. It should catch Exception. This is done in other
      examples, too.

      (*) 1.10 has is missing a space after the first comma in the first
      bullet pp

      (*) In 2.2, the use of "%t" is completely unexplained.

            sspitsyn Serguei Spitsyn
            shommel Scott Hommel (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: