anchor.diff:  
   
   
  -== In the webapp's `persistor_datanucleus.properties`
  +=== In the webapp's `persistor_datanucleus.properties`
   
   in `src/main/webapp/WEB-INF/`,
   
  
positive.code: ----
  
  
  == In `dom/pom.xml`,
  
  under `<build>/<plugins>`, remove:
  
  
negative.code: isis.persistor.datanucleus.impl.datanucleus.identifier.case=MixedCase
  ----
  
  
  == Upgrading to Java 8 (1.9.0-SNAPSHOT and later)
  
  Apache Isis 1.9.0-SNAPSHOT is the first version to support Java 8.  You can continue to use Java 7, but if you want to move to Java 8 then there are several small changes to be made.
  
  === In the parent `pom.xml`
  
  under `<build>/<pluginManagement>/<plugins>`, add (or update) maven-enforcer-plugin:
  
  [source,xml]
  ----
  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.1</version>
      <configuration>
          <source>1.8</source>
          <target>1.8</target>
          <compilerArgument>-parameters</compilerArgument>
      </configuration>
      <executions>
          <execution>
              <id>source</id>
              <phase>compile</phase>
          </execution>
          <execution>
              <id>test</id>
              <phase>test-compile</phase>
          </execution>
      </executions>
  </plugin>
  ----
  
  [TIP]
  ====
  The `-parameters` argument causes the Java compiler to capture the names of method parameters in the `.class` files.  Isis can be configured to use this, thereby avoiding the requirement to annotate every parameter with `@ParameterLayout(named=...)` or `@Named()`.  The necessary configuration is provided in an http://github.com/isisaddons/isis-metamodel-paraname8}[Isis addons' paraname8]  metamodel extension (non-ASF).
  ====
  
  We also recommend that you add the `maven-enforcer-plugin` (if not used already).  Again, this resides under `<build>/<pluginManagement>/<plugins>`:
  
  [source,xml]
  ----
  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-enforcer-plugin</artifactId>
      <version>1.3.1</version>
      <configuration>
          <rules>
              <requireMavenVersion>
                  <version>[3.2.1,)</version>
              </requireMavenVersion>
              <requireJavaVersion>
                  <version>[1.8.0,)</version>
              </requireJavaVersion>
              <requirePluginVersions>
                  <message>All plugin versions must be defined!</message>
                  <banLatest>true</banLatest>
                  <banRelease>true</banRelease>
              </requirePluginVersions>
              <DependencyConvergence />
          </rules>
      </configuration>
      <executions>
          <execution>
              <id>validate-enforce</id>
              <phase>validate</phase>
              <goals>
                  <goal>enforce</goal>
              </goals>
          </execution>
      </executions>
  </plugin>
  ----
  