diff --git a/.idea/copyright/profiles_settings.xml b/.idea/copyright/profiles_settings.xml
new file mode 100644
index 000000000..e7bedf337
--- /dev/null
+++ b/.idea/copyright/profiles_settings.xml
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/.idea/encodings.xml b/.idea/encodings.xml
new file mode 100644
index 000000000..97626ba45
--- /dev/null
+++ b/.idea/encodings.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
new file mode 100644
index 000000000..04a92ab1d
--- /dev/null
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -0,0 +1,11 @@
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/profiles_settings.xml b/.idea/inspectionProfiles/profiles_settings.xml
new file mode 100644
index 000000000..3b312839b
--- /dev/null
+++ b/.idea/inspectionProfiles/profiles_settings.xml
@@ -0,0 +1,7 @@
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/gradle_wrapper.xml b/.idea/libraries/gradle_wrapper.xml
new file mode 100644
index 000000000..9063eaf07
--- /dev/null
+++ b/.idea/libraries/gradle_wrapper.xml
@@ -0,0 +1,9 @@
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/libraries/tasks.xml b/.idea/libraries/tasks.xml
new file mode 100644
index 000000000..28567c398
--- /dev/null
+++ b/.idea/libraries/tasks.xml
@@ -0,0 +1,10 @@
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/misc.xml b/.idea/misc.xml
index 92473e0ea..46567025c 100644
--- a/.idea/misc.xml
+++ b/.idea/misc.xml
@@ -3,7 +3,5 @@
-
-
-
+
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
index b83e25d94..670ab43df 100644
--- a/.idea/modules.xml
+++ b/.idea/modules.xml
@@ -2,6 +2,7 @@
+
diff --git a/.idea/runConfigurations/simple_language_plugin.xml b/.idea/runConfigurations/simple_language_plugin.xml
index 894c8063a..c72beef52 100644
--- a/.idea/runConfigurations/simple_language_plugin.xml
+++ b/.idea/runConfigurations/simple_language_plugin.xml
@@ -3,7 +3,6 @@
-
\ No newline at end of file
diff --git a/.idea/runConfigurations/simple_language_plugin_tests.xml b/.idea/runConfigurations/simple_language_plugin_tests.xml
index f42142bb0..1f3b270fd 100644
--- a/.idea/runConfigurations/simple_language_plugin_tests.xml
+++ b/.idea/runConfigurations/simple_language_plugin_tests.xml
@@ -1,5 +1,6 @@
+
diff --git a/.idea/uiDesigner.xml b/.idea/uiDesigner.xml
new file mode 100644
index 000000000..e96534fb2
--- /dev/null
+++ b/.idea/uiDesigner.xml
@@ -0,0 +1,124 @@
+
+
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+
+
+
+ -
+
+
+
+
+
+ -
+
+
+
+
+
+ -
+
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+ -
+
+
+
+
+ -
+
+
+ -
+
+
+
+
+
\ No newline at end of file
diff --git a/_SUMMARY.md b/_SUMMARY.md
index a9fb262f7..9550ba652 100644
--- a/_SUMMARY.md
+++ b/_SUMMARY.md
@@ -96,6 +96,8 @@
* [PHP Open API](phpstorm/php_open_api.md)
* [Existing Third Party Plugins](phpstorm/existing_plugins.md)
* [Tutorials](tutorials.md)
+ * [Build System Support](tutorials/build_system.md)
+ * [1. Prerequisites](tutorials/build_system/prerequisites.md)
* [Custom Language Support](tutorials/custom_language_support_tutorial.md)
* [1. Prerequisites](tutorials/custom_language_support/prerequisites.md)
* [2. Language and File Type](tutorials/custom_language_support/language_and_filetype.md)
diff --git a/code_samples/gradle_plugin_demo/.gitignore b/code_samples/gradle_plugin_demo/.gitignore
new file mode 100644
index 000000000..8388aebc6
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.gitignore
@@ -0,0 +1,11 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Gradle template
+.gradle
+build/
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
+!gradle-wrapper.jar
+
diff --git a/code_samples/gradle_plugin_demo/.idea/.name b/code_samples/gradle_plugin_demo/.idea/.name
new file mode 100644
index 000000000..98fe802cd
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/.name
@@ -0,0 +1 @@
+gradle_plugin_demo
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/compiler.xml b/code_samples/gradle_plugin_demo/.idea/compiler.xml
new file mode 100644
index 000000000..a85231498
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/compiler.xml
@@ -0,0 +1,23 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/encodings.xml b/code_samples/gradle_plugin_demo/.idea/encodings.xml
new file mode 100644
index 000000000..97626ba45
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/encodings.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/gradle.xml b/code_samples/gradle_plugin_demo/.idea/gradle.xml
new file mode 100644
index 000000000..da780f060
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/gradle.xml
@@ -0,0 +1,23 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/misc.xml b/code_samples/gradle_plugin_demo/.idea/misc.xml
new file mode 100644
index 000000000..5f8ff0664
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/misc.xml
@@ -0,0 +1,19 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/modules.xml b/code_samples/gradle_plugin_demo/.idea/modules.xml
new file mode 100644
index 000000000..58d26865e
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/modules.xml
@@ -0,0 +1,8 @@
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/.idea/workspace.xml b/code_samples/gradle_plugin_demo/.idea/workspace.xml
new file mode 100644
index 000000000..83cd15fd1
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/.idea/workspace.xml
@@ -0,0 +1,1028 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 1448451439359
+
+ 1448451439359
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ No facets are configured
+
+
+
+
+
+
+
+ sass-stdlib
+
+
+
+
+
+
+
+ IntelliJ IDEA IU-143.381.42
+
+
+
+
+
+
+
+ gradle-plugin-demo
+
+
+
+
+
+
+
+ Gradle: com.jetbrains:annotations:15.0.1
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/build.gradle b/code_samples/gradle_plugin_demo/build.gradle
new file mode 100644
index 000000000..33e6bee8d
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/build.gradle
@@ -0,0 +1,31 @@
+buildscript {
+ repositories {
+ mavenCentral()
+ }
+}
+
+plugins {
+ id "org.jetbrains.intellij" version "0.0.20"
+}
+
+apply plugin: 'idea'
+apply plugin: 'org.jetbrains.intellij'
+apply plugin: 'java'
+
+compileJava {
+ sourceCompatibility = 1.8
+ targetCompatibility = 1.8
+}
+
+intellij {
+ version '15.0.1'
+ plugins 'coverage'
+ pluginName 'gradle_plugin_demo'
+}
+
+group 'org.jetbrains'
+version '0.0.1-SNAPSHOT'
+
+repositories {
+ mavenCentral ()
+}
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.jar b/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 000000000..30d399d8d
Binary files /dev/null and b/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.properties b/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 000000000..39e4717cb
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,6 @@
+#Wed Nov 25 06:09:06 EST 2015
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.5-bin.zip
diff --git a/code_samples/gradle_plugin_demo/gradle_plugin_demo.iml b/code_samples/gradle_plugin_demo/gradle_plugin_demo.iml
new file mode 100644
index 000000000..d0b492653
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/gradle_plugin_demo.iml
@@ -0,0 +1,126 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/gradlew b/code_samples/gradle_plugin_demo/gradlew
new file mode 100644
index 000000000..91a7e269e
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/gradlew
@@ -0,0 +1,164 @@
+#!/usr/bin/env bash
+
+##############################################################################
+##
+## Gradle start up script for UN*X
+##
+##############################################################################
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS=""
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn ( ) {
+ echo "$*"
+}
+
+die ( ) {
+ echo
+ echo "$*"
+ echo
+ exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+case "`uname`" in
+ CYGWIN* )
+ cygwin=true
+ ;;
+ Darwin* )
+ darwin=true
+ ;;
+ MINGW* )
+ msys=true
+ ;;
+esac
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched.
+if $cygwin ; then
+ [ -n "$JAVA_HOME" ] && JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
+fi
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+ ls=`ls -ld "$PRG"`
+ link=`expr "$ls" : '.*-> \(.*\)$'`
+ if expr "$link" : '/.*' > /dev/null; then
+ PRG="$link"
+ else
+ PRG=`dirname "$PRG"`"/$link"
+ fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >&-
+APP_HOME="`pwd -P`"
+cd "$SAVED" >&-
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD="$JAVA_HOME/jre/sh/java"
+ else
+ JAVACMD="$JAVA_HOME/bin/java"
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD="java"
+ which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then
+ MAX_FD_LIMIT=`ulimit -H -n`
+ if [ $? -eq 0 ] ; then
+ if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+ MAX_FD="$MAX_FD_LIMIT"
+ fi
+ ulimit -n $MAX_FD
+ if [ $? -ne 0 ] ; then
+ warn "Could not set maximum file descriptor limit: $MAX_FD"
+ fi
+ else
+ warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+ fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+ GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin ; then
+ APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+ CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+ # We build the pattern for arguments to be converted via cygpath
+ ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+ SEP=""
+ for dir in $ROOTDIRSRAW ; do
+ ROOTDIRS="$ROOTDIRS$SEP$dir"
+ SEP="|"
+ done
+ OURCYGPATTERN="(^($ROOTDIRS))"
+ # Add a user-defined pattern to the cygpath arguments
+ if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+ OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+ fi
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ i=0
+ for arg in "$@" ; do
+ CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+ CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
+
+ if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
+ eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+ else
+ eval `echo args$i`="\"$arg\""
+ fi
+ i=$((i+1))
+ done
+ case $i in
+ (0) set -- ;;
+ (1) set -- "$args0" ;;
+ (2) set -- "$args0" "$args1" ;;
+ (3) set -- "$args0" "$args1" "$args2" ;;
+ (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+ (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+ (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+ (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+ (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+ (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+ esac
+fi
+
+# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules
+function splitJvmOpts() {
+ JVM_OPTS=("$@")
+}
+eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS
+JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME"
+
+exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@"
diff --git a/code_samples/gradle_plugin_demo/gradlew.bat b/code_samples/gradle_plugin_demo/gradlew.bat
new file mode 100644
index 000000000..8a0b282aa
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/gradlew.bat
@@ -0,0 +1,90 @@
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS=
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windowz variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+if "%@eval[2+2]" == "4" goto 4NT_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+goto execute
+
+:4NT_args
+@rem Get arguments from the 4NT Shell from JP Software
+set CMD_LINE_ARGS=%$
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/code_samples/gradle_plugin_demo/src/main/java/HelloAction.java b/code_samples/gradle_plugin_demo/src/main/java/HelloAction.java
new file mode 100644
index 000000000..b0462638a
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/src/main/java/HelloAction.java
@@ -0,0 +1,19 @@
+import com.intellij.openapi.actionSystem.AnAction;
+import com.intellij.openapi.actionSystem.AnActionEvent;
+import com.intellij.openapi.actionSystem.PlatformDataKeys;
+import com.intellij.openapi.project.Project;
+import com.intellij.openapi.ui.Messages;
+
+/**
+ * Created by breandan on 11/25/2015.
+ */
+public class HelloAction extends AnAction {
+ public HelloAction() {
+ super("Hello");
+ }
+
+ public void actionPerformed(AnActionEvent event) {
+ Project project = event.getData(PlatformDataKeys.PROJECT);
+ Messages.showMessageDialog(project, "Hello world!", "Greeting", Messages.getInformationIcon());
+ }
+}
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/src/main/main.iml b/code_samples/gradle_plugin_demo/src/main/main.iml
new file mode 100644
index 000000000..908ad4f52
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/src/main/main.iml
@@ -0,0 +1,11 @@
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/code_samples/gradle_plugin_demo/src/main/resources/META-INF/plugin.xml b/code_samples/gradle_plugin_demo/src/main/resources/META-INF/plugin.xml
new file mode 100644
index 000000000..6ff607a5a
--- /dev/null
+++ b/code_samples/gradle_plugin_demo/src/main/resources/META-INF/plugin.xml
@@ -0,0 +1,41 @@
+
+ org.jetbrains
+ gradle_plugin_demo
+ 0.0.1
+ dummy
+
+
+ ]]>
+
+
+ ]]>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/tutorials/build_system.md b/tutorials/build_system.md
new file mode 100644
index 000000000..bd9549e15
--- /dev/null
+++ b/tutorials/build_system.md
@@ -0,0 +1,7 @@
+---
+title: Building plugins with the Gradle
+---
+
+When building a plugin on the IntelliJ Platform SDK, occasionally major version upgrades may cause breaking API changes. In order to prevent this from occurring unexpectedly, we recommend using Gradle with the [gradle-intellij-plugin](https://github.com/JetBrains/gradle-intellij-plugin). This Gradle plugin allows you to build plugins for the IntelliJ Platform using a specific IntelliJ Platform SDK. Furthermore, it codifies a reproducible build process for compiling a plugin, to running it inside your IDE, and finally publishing it on the plugin repo, within an explicit build script which is managed by the Gradle build system. The following tutorial refers to materials that can be found in the included [gradle_plugin_demo](https://github.com/JetBrains/intellij-sdk-docs/tree/master/code_samples/gradle_plugin_demo). Below are a series of steps to configure Gradle support.
+
+* [1. Prerequisites](build_system/prerequisites.md)
diff --git a/tutorials/build_system/img/gradle_directory_structure.png b/tutorials/build_system/img/gradle_directory_structure.png
new file mode 100644
index 000000000..0b3b0d2fb
Binary files /dev/null and b/tutorials/build_system/img/gradle_directory_structure.png differ
diff --git a/tutorials/build_system/img/gradle_run_config.png b/tutorials/build_system/img/gradle_run_config.png
new file mode 100644
index 000000000..378c69006
Binary files /dev/null and b/tutorials/build_system/img/gradle_run_config.png differ
diff --git a/tutorials/build_system/img/gradle_tool_window.png b/tutorials/build_system/img/gradle_tool_window.png
new file mode 100644
index 000000000..618ab6d37
Binary files /dev/null and b/tutorials/build_system/img/gradle_tool_window.png differ
diff --git a/tutorials/build_system/img/launched.png b/tutorials/build_system/img/launched.png
new file mode 100644
index 000000000..fc7f7ef31
Binary files /dev/null and b/tutorials/build_system/img/launched.png differ
diff --git a/tutorials/build_system/img/step0_gradle_enabled.png b/tutorials/build_system/img/step0_gradle_enabled.png
new file mode 100644
index 000000000..aa3366600
Binary files /dev/null and b/tutorials/build_system/img/step0_gradle_enabled.png differ
diff --git a/tutorials/build_system/img/step1_new_gradle_project.png b/tutorials/build_system/img/step1_new_gradle_project.png
new file mode 100644
index 000000000..9a2c965d4
Binary files /dev/null and b/tutorials/build_system/img/step1_new_gradle_project.png differ
diff --git a/tutorials/build_system/img/step2_group_artifact_version.png b/tutorials/build_system/img/step2_group_artifact_version.png
new file mode 100644
index 000000000..3ff81d906
Binary files /dev/null and b/tutorials/build_system/img/step2_group_artifact_version.png differ
diff --git a/tutorials/build_system/img/step3_gradle_config.png b/tutorials/build_system/img/step3_gradle_config.png
new file mode 100644
index 000000000..2c800a4b1
Binary files /dev/null and b/tutorials/build_system/img/step3_gradle_config.png differ
diff --git a/tutorials/build_system/prerequisites.md b/tutorials/build_system/prerequisites.md
new file mode 100644
index 000000000..dbb31af3d
--- /dev/null
+++ b/tutorials/build_system/prerequisites.md
@@ -0,0 +1,148 @@
+---
+title: Prerequisites
+---
+
+Adding Gradle build support to an IntelliJ Platform Plugin requires a recent distribution the Gradle build system and IntelliJ IDEA.
+
+### 1.0. Download and install Gradle
+
+Download and install Gradle, following the instructions provided in the [Gradle User Guide](https://docs.gradle.org/current/userguide/installation.html).
+
+### 1.1. Download and install IntelliJ IDEA
+
+Download and install either IntelliJ IDEA Ultimate or the IntelliJ IDEA Community Edition.
+
+### 1.2. Ensure the Gradle plugin is enabled
+
+The Gradle plugin is required if you want to add a [Gradle Run Configuration](https://www.jetbrains.com/idea/help/create-run-debug-configuration-for-gradle-tasks.html) to IntelliJ IDEA. You can verify the Gradle plugin is enabled by visiting **Settings | Plugins | Gradle**.
+
+
+
+### 1.3. Create a new Gradle project
+
+There are two ways to add Gradle support to an existing project. Both will require adding a `build.gradle` file under the root directory, with at least the following contents:
+
+```groovy
+buildscript {
+ repositories {
+ mavenCentral()
+ }
+}
+
+plugins {
+ id "org.jetbrains.intellij" version "0.0.20"
+}
+
+apply plugin: 'idea'
+apply plugin: 'org.jetbrains.intellij'
+apply plugin: 'java'
+
+intellij {
+ version '15.0.1'
+ plugins 'coverage'
+ pluginName 'plugin_name_goes_here'
+}
+```
+
+To add Gradle support to an existing project, copy the above Gradle buildscript into your `build.gradle` file, and with the Gradle executable on your system `PATH`, execute the following command on your system command line:
+
+```
+gradle cleanIdea
+```
+
+This will clean any existing IntelliJ IDEA configuration files and generate a new Gradle build configuration recognized by IntelliJ IDEA. Once your project refreshes, you should be able to view and click the Gradle tool window displayed under **View | Tool Windows | Gradle**. This indicates that IntelliJ IDEA recognizes the Gradle facet.
+
+The second method to add Gradle support is by creating a new project from scratch in IntelliJ IDEA and copying over any existing sources. This may be the preferred option in case Gradle is not able to convert an existing project. To do so, create a new project in IntelliJ IDEA by opening **File | New... | Project**, and select Gradle from the dialog box:
+
+
+
+The Project Creation Wizard will now guide you through the Gradle project creation process. You will need to specify a Group ID, Artifact ID, and Version:
+
+
+
+Finally, make sure Gradle is using the correct JVM. This should be the same version as the corresponding 64- or 32-bit Gradle distribution from [Step 1.0](#download-and-install-gradle):
+
+
+
+Now, add the above script to your `build.gradle` file, overwriting any existing contents.
+
+### 1.3. Running a simple plugin
+
+Create the following directory structure:
+
+
+
+```java
+import com.intellij.openapi.actionSystem.AnAction;
+import com.intellij.openapi.actionSystem.AnActionEvent;
+import com.intellij.openapi.actionSystem.PlatformDataKeys;
+import com.intellij.openapi.project.Project;
+import com.intellij.openapi.ui.Messages;
+
+public class HelloAction extends AnAction {
+ public HelloAction() {
+ super("Hello");
+ }
+
+ public void actionPerformed(AnActionEvent event) {
+ Project project = event.getData(PlatformDataKeys.PROJECT);
+ Messages.showMessageDialog(project, "Hello world!", "Greeting", Messages.getInformationIcon());
+ }
+}
+```
+
+```xml
+
+ org.jetbrains
+ gradle_plugin_demo
+ 0.0.1
+ dummy
+
+
+ ]]>
+
+
+ ]]>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+Add a new Gradle Run Configuration, configured like so:
+
+
+
+Launch the new Gradle Run Configuration. From the Run Window, there should be some output.
+
+
+
+Finally, when the IDE launches, there should be a new menu to the right of **Help**. Your plugin has launched!
+
+[Top](/tutorials/build_system.md)
\ No newline at end of file