Author: gbadner Date: 2008-05-02 19:25:33 -0400 (Fri, 02 May 2008) New Revision: 14639 Modified: core/branches/Branch_3_2_4_SP1_CP/readme.txt Log: HIBERNATE-88 : Updated readme.txt with installation instructions and expected test failures Modified: core/branches/Branch_3_2_4_SP1_CP/readme.txt =================================================================== --- core/branches/Branch_3_2_4_SP1_CP/readme.txt 2008-05-02 22:07:59 UTC (rev 14638) +++ core/branches/Branch_3_2_4_SP1_CP/readme.txt 2008-05-02 23:25:33 UTC (rev 14639) @@ -12,24 +12,52 @@ Required jars are distributed in the lib subdirectory. +Install Apache Ant 1.7.0 (http://ant.apache.org/) and set ANT_HOME +environment variable. +Install JUnit 3.8.1 (http://www.junit.org/) and copy junit.jar to +$ANT_HOME/lib. + + Get Up And Running Quick ------------------------ Demo: (1) copy your JDBC driver to the lib directory (2) edit etc/hibernate.properties - (3) run "ant eg" or "build eg" + (3) run "ant eg" or "build eg" using JDK 1.5 (4) browse the sourcecode in eg/org/hibernate/auction Tests: (1) copy your JDBC driver to the lib directory (2) edit etc/hibernate.properties - (3) run "ant junitreport-dist" or "build junitreport-dist" + (3) run "ant junitreport-dist" or "build junitreport-dist" using JDK 1.5; + to ignore "FailureExpected" failures (see note below), run + "ant junitreport-dist -Dhibernate.test.validatefailureexpected=true" (4) see build/test-reports/index.html +Note: The unit tests are expected to have 6 failures and 8 errors in: +Ehcache tests (Ehcache is not provided in this distribution): +org.hibernate.test.cache.ehcache.EhCacheTest.testQueryCacheInvalidation +org.hibernate.test.cache.ehcache.EhCacheTest.testEmptySecondLevelCacheEntry +org.hibernate.test.cache.ehcache.EhCacheTest.testStaleWritesLeaveCacheConsistent + +"FailureExpected" tests (known issues to be addressed in the future): +org.hibernate.test.hql.ASTParserLoadingTest.testParameterTypeMismatchFailureExpected +org.hibernate.test.hql.CriteriaHQLAlignmentTest.testCriteriaAggregationReturnTypeFailureExpected +org.hibernate.test.hql.HQLTest.testEmptyInListFailureExpected +org.hibernate.test.hql.HQLTest.testMaxindexHqlFuncttestMultipleElementAccessorOperatorsFailureExpectedionInElementAccessorFailureExpected +org.hibernate.test.hql.HQLTest.testMultipleElementAccessorOperatorsFailureExpected +org.hibernate.test.hql.HQLTest.testKeyManyToOneJoinFailureExpected +org.hibernate.test.hql.HQLTest.testDuplicateExplicitJoinFailureExpected +org.hibernate.test.keymanytoone.bidir.component.EagerKeyManyToOneTest.testLoadEntityWithEagerFetchingToKeyManyToOneReferenceBackToSelfFailureExpected +org.hibernate.test.legacy.SQLLoaderTest.testReturnPropertyComponentRenameFailureExpected +org.hibernate.test.readonly.ReadOnlyTest.testReadOnlyOnProxiesFailureExpected +org.hibernate.test.sql.hand.query.NativeSQLQueriesTest.testCompositeIdJoinsFailureExpected + + Product Support and License Website Links ----------------------------------------- Support Processes