anchor.diff:  ====
   
   
  +[[_cgcon_building-isis_configure-maven-toolchains-plugin]]
  +== Configure Maven toolchains plugin
  +
  +As noted xref:_cgcon_building-isis_installing-java-7[earlier], Apache Isis is built using Java 7, leveraging the
  +link:http://maven.apache.org/plugins/maven-toolchains-plugin/[toolchains] plugin.  This is configured by placing the
  +`toolchains.xml` file in `~/.m2` directory.
  +
  +You can use the following file as a template, adjusting paths for your platform:
  +
  +[source,xml]
  +----
  +<?xml version="1.0" encoding="UTF8"?>
  +<toolchains>
  +    <toolchain>
  +        <type>jdk</type>
  +        <provides>
  +            <version>1.8</version>
  +            <vendor>oracle</vendor>
  +        </provides>
  +        <configuration>
  +            <jdkHome>/usr/lib64/jvm/jdk1.8.0_65</jdkHome>
  +            <!--
  +            <jdkHome>c:\Program Files\Java\jdk1.8.0_65</jdkHome>
  +            -->
  +        </configuration>
  +    </toolchain>
  +    <toolchain>
  +        <type>jdk</type>
  +        <provides>
  +            <version>1.7</version>   <!--1-->
  +            <vendor>oracle</vendor>
  +        </provides>
  +        <configuration>
  +            <jdkHome>/usr/lib64/jvm/jdk1.7.0_79</jdkHome>
  +            <!--
  +            <jdkHome>c:\Program Files\Java\jdk1.7.0_79</jdkHome>
  +            -->
  +        </configuration>
  +    </toolchain>
  +</toolchains>
  +----
  +<1> The Apache Isis build is configured to search for the (`1.7, oracle`) JDK toolchain.
  +
  +
  +
  +[[_cgcon_building-isis_building-all-of-apache-isis]]
   == Building all of Apache Isis
   
   To build the source code from the command line, simply go to the root directory and type:
  
positive.code: 
  
  
  == Checking for use of internal JDK APIs
  
  Apache Isis configures the link:https://maven.apache.org/plugins-archives/maven-jdeps-plugin-3.0.0/[jdeps maven plugin] to check for any usage of internal JDK APIs.  This is in preparation for Java 9 module system (Jigsaw) which will prevent such usage of APIs.
  
negative.code: 
  
  
  [[_cgcon_building-isis_git_installation_cloning-the-apache-isis-repo]]
  ==== Cloning the Apache Isis repo
  
  First, clone the Apache Isis repo.
  