Return-Path: Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: (qmail 19022 invoked from network); 28 Apr 2009 21:31:57 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 28 Apr 2009 21:31:57 -0000 Received: (qmail 27696 invoked by uid 500); 28 Apr 2009 21:31:57 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 27624 invoked by uid 500); 28 Apr 2009 21:31:56 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 27483 invoked by uid 99); 28 Apr 2009 21:31:56 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 28 Apr 2009 21:31:56 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.140] (HELO brutus.apache.org) (140.211.11.140) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 28 Apr 2009 21:31:54 +0000 Received: from brutus (localhost [127.0.0.1]) by brutus.apache.org (Postfix) with ESMTP id 61FB9234C004 for ; Tue, 28 Apr 2009 14:31:33 -0700 (PDT) Message-ID: <548856770.1240954293400.JavaMail.jira@brutus> Date: Tue, 28 Apr 2009 14:31:33 -0700 (PDT) From: "Tiago R. Espinha (JIRA)" To: derby-dev@db.apache.org Subject: [jira] Updated: (DERBY-4192) OFFSET and FETCH FIRST documentation improvement In-Reply-To: <643740982.1240850850302.JavaMail.jira@brutus> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 X-Virus-Checked: Checked by ClamAV on apache.org [ https://issues.apache.org/jira/browse/DERBY-4192?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Tiago R. Espinha updated DERBY-4192: ------------------------------------ Attachment: derby-4192.patch I'm attaching a fix for this issue. I've added a small note below the examples, but it is my first time with this type of documentation, so please check if everything is well structured. > OFFSET and FETCH FIRST documentation improvement > ------------------------------------------------ > > Key: DERBY-4192 > URL: https://issues.apache.org/jira/browse/DERBY-4192 > Project: Derby > Issue Type: Improvement > Affects Versions: 10.5.1.1 > Reporter: Tiago R. Espinha > Assignee: Tiago R. Espinha > Priority: Minor > Attachments: derby-4192.patch > > > I have a suggestion regarding the documentation for the OFFSET and FETCH FIRST documentation. On these documents, we have three SQL examples on the usage of these clauses. I suggest that we add a brief description of what each clause does. > This might help the users to have a better understanding at first of how the said clauses work. > Here are the examples with a possible description: > -- This query fetches the first row from T > SELECT * FROM T FETCH FIRST ROW ONLY; > -- This query skips the first 10 rows and fetches the following 10. > -- It will fetch rows 11 through 20 (inclusive) from the table T, sorted by I > SELECT * FROM T ORDER BY I OFFSET 10 ROWS FETCH NEXT 10 ROWS ONLY; > -- This query skips the first 100 rows from T. > -- If the table has less than 101 records, then an empty result set is returned. > SELECT * FROM T OFFSET 100 ROWS; -- This message is automatically generated by JIRA. - You can reply to this email to add a comment to the issue online.