Return-Path: X-Original-To: apmail-openjpa-commits-archive@www.apache.org Delivered-To: apmail-openjpa-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id E09B4DA64 for ; Mon, 10 Dec 2012 22:09:00 +0000 (UTC) Received: (qmail 75084 invoked by uid 500); 10 Dec 2012 22:09:00 -0000 Delivered-To: apmail-openjpa-commits-archive@openjpa.apache.org Received: (qmail 75068 invoked by uid 500); 10 Dec 2012 22:09:00 -0000 Mailing-List: contact commits-help@openjpa.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@openjpa.apache.org Delivered-To: mailing list commits@openjpa.apache.org Received: (qmail 75060 invoked by uid 99); 10 Dec 2012 22:09:00 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 10 Dec 2012 22:09:00 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 10 Dec 2012 22:08:57 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 4308B23888E7; Mon, 10 Dec 2012 22:08:36 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1419830 - /openjpa/site/trunk/content/quick-start.mdtext Date: Mon, 10 Dec 2012 22:08:36 -0000 To: commits@openjpa.apache.org From: kwsutter@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20121210220836.4308B23888E7@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: kwsutter Date: Mon Dec 10 22:08:35 2012 New Revision: 1419830 URL: http://svn.apache.org/viewvc?rev=1419830&view=rev Log: Clarifying text in Quick Start for Entity Enhancement Modified: openjpa/site/trunk/content/quick-start.mdtext Modified: openjpa/site/trunk/content/quick-start.mdtext URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/quick-start.mdtext?rev=1419830&r1=1419829&r2=1419830&view=diff ============================================================================== --- openjpa/site/trunk/content/quick-start.mdtext (original) +++ openjpa/site/trunk/content/quick-start.mdtext Mon Dec 10 22:08:35 2012 @@ -1,84 +1,84 @@ -Title: Quick Start - - - -Quick Start Guide -============================= - -We know it can be hard to find the right help sometimes and search engines -can be overwhelming, so we will try to put the most commonly asked for -topics with some overview and links to more in-depth resources here for you -to checkout, before wasting your time searching through our [Documentation](documentation.html) - and [Mailing Lists] - for help. - - - - -## Runtime Dependencies - -To use OpenJPA as a stand-alone Java component or with a lightweight -non-Java EE framework, please refer to the following [Build and Runtime Dependencies](build-and-runtime-dependencies.html) - page for the supported levels of Java SE. - -To use OpenJPA in a Java EE application server, please refer to the -following [Integration](integration.html) - page for the known platforms that either include OpenJPA or have been -tested with OpenJPA. - - - -## JPA Examples - -OpenJPA provides some simple examples as part of the binary distribution on -the [Downloads](downloads.html) - page. The following [Samples] - page provides quick start instructions on how to build and run these -samples, along with pointers to other JPA samples from the Apache Geronimo -project. - - - -## Enhancing Entities - -The JPA spec requires some type of monitoring of Entity objects, but the -spec does not define how to implement this monitoring. Some JPA providers -auto-generate new subclasses or proxy objects that front the user's Entity -objects at *runtime*, while others use byte-code weaving technologies to -enhance the actual Entity class objects at __build time__. OpenJPA supports -both [enhancement](entity-enhancement.html) - methods, but strongly suggests only using the __build time__ enhancement. -The following [Entity Enhancement] - page includes more details on both enhancement types, along with examples -on how to setup *build time* enhancement in ANT, Maven and Eclipse -environments. - - - -## Tools - -OpenJPA provides several design-time and runtime tools, to perform such -tasks as entity enhancement, schema mapping, generating metamodel classes -and to help migrate from other JPA providers. Please checkout the [Tools](tools.html) - page for more details. - - - -## FAQ - -Some common questions concerning the history, architecture and usage of -OpenJPA can be found on the [FAQ](faq.html) - page. - - - -## Take the Red Pill - -If you want to dive into the rabbit-hole (Hey, It's open source!), then -checkout the [Found a Bug](found-a-bug.html) - page, which covers everything from posting questions to our mailing lists, -to getting the source code and building it, and creating bug patches.... - - - - +Title: Quick Start + + + +Quick Start Guide +============================= + +We know it can be hard to find the right help sometimes and search engines +can be overwhelming, so we will try to put the most commonly asked for +topics with some overview and links to more in-depth resources here for you +to checkout, before wasting your time searching through our [Documentation](documentation.html) + and [Mailing Lists] + for help. + + + + +## Runtime Dependencies + +To use OpenJPA as a stand-alone Java component or with a lightweight +non-Java EE framework, please refer to the following [Build and Runtime Dependencies](build-and-runtime-dependencies.html) + page for the supported levels of Java SE. + +To use OpenJPA in a Java EE application server, please refer to the +following [Integration](integration.html) + page for the known platforms that either include OpenJPA or have been +tested with OpenJPA. + + + +## JPA Examples + +OpenJPA provides some simple examples as part of the binary distribution on +the [Downloads](downloads.html) + page. The following [Samples] + page provides quick start instructions on how to build and run these +samples, along with pointers to other JPA samples from the Apache Geronimo +project. + + + +## Enhancing Entities + +The JPA spec requires some type of monitoring of Entity objects, but the +spec does not define how to implement this monitoring. Some JPA providers +dynamically generate new subclasses or proxy objects that front the user's Entity +objects, while others use *byte-code weaving* technologies to +enhance the actual Entity class objects. OpenJPA supports +both [enhancement](entity-enhancement.html) + methods, but strongly suggests using the *byte-code weaving* enhancement. +The following [Entity Enhancement](entity-enhancement.html) + page includes more details on both enhancement types, along with examples +on how to setup *build time* enhancement in ANT, Maven and Eclipse +environments. + + + +## Tools + +OpenJPA provides several design-time and runtime tools, to perform such +tasks as entity enhancement, schema mapping, generating metamodel classes +and to help migrate from other JPA providers. Please checkout the [Tools](tools.html) + page for more details. + + + +## FAQ + +Some common questions concerning the history, architecture and usage of +OpenJPA can be found on the [FAQ](faq.html) + page. + + + +## Take the Red Pill + +If you want to dive into the rabbit-hole (Hey, It's open source!), then +checkout the [Found a Bug](found-a-bug.html) + page, which covers everything from posting questions to our mailing lists, +to getting the source code and building it, and creating bug patches.... + + + +