Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-6608

Confusing language in BLOB/CLOB Reference Manual topics

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Open
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: 10.10.2.0
    • Fix Version/s: None
    • Component/s: Documentation
    • Labels:
      None

      Description

      The BLOB topic, http://db.apache.org/derby/docs/10.10/ref/rrefblob.html, has a paragraph followed by a note stating the following:

      The length is given in bytes for BLOB unless one of the suffixes K, M, or G is given, relating to the multiples of 1024, 1024*1024, 1024*1024*1024 respectively.

      Note: Length is specified in bytes for BLOB.

      Why the note is necessary is not clear to me. Wouldn't it make sense to remove it and rewrite the paragraph to say,

      The length is specified in bytes for BLOB unless one of the suffixes K, M, or G is given, relating to the multiples of 1024, 1024*1024, 1024*1024*1024 respectively. If a suffix is specified, the length is in kilobytes, megabytes, or gigabytes.

      The CLOB topic, http://db.apache.org/derby/docs/10.10/ref/rrefclob.html, is even more confusing:

      The length is given in number characters for both CLOB, unless one of the suffixes K, M, or G is given, relating to the multiples of 1024, 1024*1024, 1024*1024*1024 respectively.

      Length is specified in characters (unicode) for CLOB.

      Would it be correct to say the following?

      The length is specified in numeric Unicode characters for CLOB unless one of the suffixes K, M, or G is given, relating to the multiples of 1024, 1024*1024, 1024*1024*1024 respectively.

      I'm not sure how to express what the 1024 multiples are, though. Maybe it's not necessary to do so.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              chaase3 Camilla Haase
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated: