You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2014/06/11 17:14:01 UTC
[jira] [Created] (DERBY-6608) Confusing language in BLOB/CLOB
Reference Manual topics
Kim Haase created DERBY-6608:
--------------------------------
Summary: Confusing language in BLOB/CLOB Reference Manual topics
Key: DERBY-6608
URL: https://issues.apache.org/jira/browse/DERBY-6608
Project: Derby
Issue Type: Bug
Components: Documentation
Affects Versions: 10.10.2.0
Reporter: Kim Haase
Priority: Minor
The BLOB topic, http://db.apache.org/derby/docs/10.10/ref/rrefblob.html, has a paragraph followed by a note stating the following:
{blockquote}
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.
{blockquote}
Why the note is necessary is not clear to me. Wouldn't it make sense to remove it and rewrite the paragraph to say,
{blockquote}
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.
{blockquote}
The CLOB topic, http://db.apache.org/derby/docs/10.10/ref/rrefclob.html, is even more confusing:
{blockquote}
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.
{blockquote}
Would it be correct to say the following?
{blockquote}
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.
{blockquote}
I'm not sure how to express what the 1024 multiples are, though. Maybe it's not necessary to do so.
--
This message was sent by Atlassian JIRA
(v6.2#6252)