From commits-return-13109-archive-asf-public=cust-asf.ponee.io@pdfbox.apache.org Thu Sep 20 20:32:52 2018 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx-eu-01.ponee.io (Postfix) with SMTP id A39C6180671 for ; Thu, 20 Sep 2018 20:32:51 +0200 (CEST) Received: (qmail 54818 invoked by uid 500); 20 Sep 2018 18:32:50 -0000 Mailing-List: contact commits-help@pdfbox.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@pdfbox.apache.org Delivered-To: mailing list commits@pdfbox.apache.org Received: (qmail 54809 invoked by uid 99); 20 Sep 2018 18:32:50 -0000 Received: from Unknown (HELO svn01-us-west.apache.org) (209.188.14.144) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 20 Sep 2018 18:32:50 +0000 Received: from svn01-us-west.apache.org (localhost [127.0.0.1]) by svn01-us-west.apache.org (ASF Mail Server at svn01-us-west.apache.org) with ESMTP id 41F613A0102 for ; Thu, 20 Sep 2018 18:32:50 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1841489 - /pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java Date: Thu, 20 Sep 2018 18:32:50 -0000 To: commits@pdfbox.apache.org From: tilman@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20180920183250.41F613A0102@svn01-us-west.apache.org> Author: tilman Date: Thu Sep 20 18:32:50 2018 New Revision: 1841489 URL: http://svn.apache.org/viewvc?rev=1841489&view=rev Log: PDFBOX-4319: improve javadoc Modified: pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java Modified: pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java URL: http://svn.apache.org/viewvc/pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java?rev=1841489&r1=1841488&r2=1841489&view=diff ============================================================================== --- pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java (original) +++ pdfbox/trunk/pdfbox/src/main/java/org/apache/pdfbox/pdmodel/PDDocument.java Thu Sep 20 18:32:50 2018 @@ -1367,9 +1367,13 @@ public class PDDocument implements Close } /** - * Returns the page at the given index. + * Returns the page at the given 0-based index. + *

+ * This method is too slow to get all the pages from a large PDF document + * (1000 pages or more). For such documents, use the iterator of + * {@link PDDocument#getPages()} instead. * - * @param pageIndex the page index + * @param pageIndex the 0-based page index * @return the page at the given index. */ public PDPage getPage(int pageIndex) // todo: REPLACE most calls to this method with BELOW method