From 9c00f7eaca04a080f5f085303eff55e0d39ad741 Mon Sep 17 00:00:00 2001 From: Cedric Beust Date: Tue, 14 Jun 2016 22:45:55 -0800 Subject: [PATCH 1/3] Document native(). --- documentation/index.html | 59 ++++++++++++++++++++++++---------------- 1 file changed, 36 insertions(+), 23 deletions(-) diff --git a/documentation/index.html b/documentation/index.html index a88a412..6b3fe5e 100644 --- a/documentation/index.html +++ b/documentation/index.html @@ -216,6 +216,31 @@ dependencies { } +

Dependency versions

+

+ Kobalt lets you specify Maven coordinates in one line, such as "org.testng:testng:6.9.10". Note that Kobalt uses the Maven Coordinates defined in the Maven specification, which are a little bit different from the ones that Gradle uses. +

+

+ The standard format for such coordinates, as explained in the link above, is: +

+
+groupId:artifactId:packaging:classifier:version
+

+ packaging (e.g. "jar") and classifier (usually an arbitrary name) are optional and can be omitted. If version + is omitted, Kobalt will resolve the artifact to its latest version from all the specified repos. + Most of the time, you will only specify groupId, artifactId and version, but if you ever need to specify additional components such as packaging (sometimes referred to as "extension") or classifier, + please take note that these should appear before the version number. +

+

+ Here are a few examples of valid Maven coordinates: +

+
+# No version, resolves to the latest
+org.testng:testng:
+
+# Specifies an extension and a qualifier
+com.badlogicgames.gdx:gdx-platform:jar:natives-desktop:1.9.2
+

Dependency types

@@ -232,33 +257,21 @@ dependencies {

Exclude the given dependencies from the classpath. You can either specify a versioned id (e.g. "groupId:artifactId:version") or a versionless one ("groupId:artifactId:").
+
native
+
Used to define native dependencies.
-

Dependency versions

+
Native dependencies

-Kobalt lets you specify Maven coordinates in one line, such as "org.testng:testng:6.9.10". Note that Kobalt uses the Maven Coordinates defined in the Maven specification, which are a little bit different from the ones that Gradle uses. + Native dependencies will only be used when you invoke the run task on your project:

-

- The standard format for such coordinates, as explained in the link above, is: -

-
-groupId:artifactId:packaging:classifier:version
-

- packaging and classifier are optional and can be omitted. If version - is omitted, Kobalt will resolve the artifact to its latest version from all the specified repos. - Most of the time, you will only specify groupId, artifactId and version, but if you ever need to specify additional components such as packaging (sometimes referred to as "extension") or classifier, - please take note that these should appear before the version number. -

-

- Here are a few examples of valid Maven coordinates: -

-
-# No version, resolves to the latest
-org.testng:testng:
-
-# Specifies an extension and a qualifier
-com.badlogicgames.gdx:gdx-platform:jar:natives-desktop:1.9.2
- +
+dependencies {
+    native("org.lwjgl.lwjgl:lwjgl-platform:jar:natives-windows:2.9.3",
+           "org.lwjgl.lwjgl:lwjgl-platform:jar:natives-linux:2.9.3",
+           "org.lwjgl.lwjgl:lwjgl-platform:jar:natives-osx:2.9.3"
+        )
+    }

Settings

You can define settings that will apply to all your Kobalt builds by creating From d12d7f91e9dcabce7131f47a601017b4382b3a44 Mon Sep 17 00:00:00 2001 From: Cedric Beust Date: Wed, 15 Jun 2016 01:03:07 -0800 Subject: [PATCH 2/3] Clarify dependencies. --- plug-in-development/index.html | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/plug-in-development/index.html b/plug-in-development/index.html index 13d014d..27b2562 100644 --- a/plug-in-development/index.html +++ b/plug-in-development/index.html @@ -474,9 +474,8 @@ The @Task annotation accepts the following attributes:

Orderings, controlled by "runBefore" and "runAfter" merely specify an ordering - but do not pull new tasks in. This is how you tell Kobalt "In case task X is run, run my task before it - (or after)". But if task X doesn't run, your task will not be run either (unless it's explicitly requested - by the user). + but do not pull new tasks in. This is how you tell Kobalt "In case task the user asks for my task to run, + here is when it should be invoked", but your task will run only if it's explicitly invoked by the user.

Here are a few different scenarios to illustrate how the three attributes work for the task example: From 3876816788de1b135049355813f23f9e13fc6afa Mon Sep 17 00:00:00 2001 From: Cedric Beust Date: Wed, 15 Jun 2016 01:05:59 -0800 Subject: [PATCH 3/3] Extra word --- plug-in-development/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/plug-in-development/index.html b/plug-in-development/index.html index 27b2562..75aafde 100644 --- a/plug-in-development/index.html +++ b/plug-in-development/index.html @@ -474,7 +474,7 @@ The @Task annotation accepts the following attributes:

Orderings, controlled by "runBefore" and "runAfter" merely specify an ordering - but do not pull new tasks in. This is how you tell Kobalt "In case task the user asks for my task to run, + but do not pull new tasks in. This is how you tell Kobalt "In case the user asks for my task to run, here is when it should be invoked", but your task will run only if it's explicitly invoked by the user.