[jira] [Updated] (OPENJPA-2047) Document the impact of Persistence Aware classes

["Jacob Nowosatka (Updated) (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/OPENJPA-2047?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Jacob Nowosatka updated OPENJPA-2047:
-------------------------------------

    Attachment: OPENJPA-2027.patch

This patch removes the "WARN" message in favor of a single "INFO" message that lists all the persistence-aware classes.

Persistence-aware classes are actually described in the documentation (Chapter 5: Persistence Classes, Section 2.1: Enhancing at build time) - "You can also run it over classes that are not persistence-capable, in which case it will treat the class as persistence-aware. Persistence-aware classes can directly manipulate the persistent fields of persistence-capable classes."
                
> Document the impact of Persistence Aware classes
> ------------------------------------------------
>
>                 Key: OPENJPA-2047
>                 URL: https://issues.apache.org/jira/browse/OPENJPA-2047
>             Project: OpenJPA
>          Issue Type: Improvement
>          Components: docs
>    Affects Versions: 1.2.2, 2.1.1
>            Reporter: Michael Dick
>         Attachments: OPENJPA-2027.patch
>
>
> The PCEnhancer makes non entity classes "persistence aware", but we never explain what that means in the manual.
> The answer can be found in the JDO specification, but we should document it in our manual as well. Many users may not be familiar with JDO or OpenJPA's JDO background. To those users the warning message issued by the PCEnhancer can be confusing, or a cause for alarm. 
> As a first pass we should add this information to the users manual. It would also be good to improve the logging of the PCEnhancer. In most cases the warning message is harmless, and should be treated as an INFO message (or better yet, we can issue a single message that lists all the persistence aware classes). 

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira