Uploaded image for project: 'Groovy'
  1. Groovy
  2. GROOVY-3507

Class comment nominated for the most useless comment of the year

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 1.6
    • 1.6.4, 1.7-beta-1
    • SQL processing
    • None

    Description

      A snippet from the JavaDoc.

      java.lang.Object
      groovy.sql.Sql

      class Sql
      extends Object

      Represents an extent of objects

      That is the whole class documentation and it repeats the obvious.
      What's the relation to JDBC?
      What do the methods have in common, where are the differences?
      Are there extensions?

      I would not write my name on such a class, my next boss might read it.

      Attachments

        Activity

          People

            paulk Paul King
            pinus Haug Bürger
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: