Return-Path: <commits-return-16155-archive-asf-public=cust-asf.ponee.io@brooklyn.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id 770CC200C4E
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Fri, 21 Apr 2017 10:27:16 +0200 (CEST)
Received: by cust-asf.ponee.io (Postfix)
	id 75D4F160BAF; Fri, 21 Apr 2017 08:27:16 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id C4C09160BA2
	for <archive-asf-public@cust-asf.ponee.io>; Fri, 21 Apr 2017 10:27:15 +0200 (CEST)
Received: (qmail 94294 invoked by uid 500); 21 Apr 2017 08:27:15 -0000
Mailing-List: contact commits-help@brooklyn.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@brooklyn.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@brooklyn.apache.org>
List-Post: <mailto:commits@brooklyn.apache.org>
List-Id: <commits.brooklyn.apache.org>
Reply-To: dev@brooklyn.apache.org
Delivered-To: mailing list commits@brooklyn.apache.org
Received: (qmail 94274 invoked by uid 99); 21 Apr 2017 08:27:14 -0000
Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 21 Apr 2017 08:27:14 +0000
Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33)
	id AB3BFF49EF; Fri, 21 Apr 2017 08:27:14 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: geomacy@apache.org
To: commits@brooklyn.apache.org
Date: Fri, 21 Apr 2017 08:27:14 -0000
Message-Id: <3669b01c4d7345e792d23794d95eeee8@git.apache.org>
X-Mailer: ASF-Git Admin Mailer
Subject: [1/2] brooklyn-docs git commit: Java config docs: default-value
 should be immutable
archived-at: Fri, 21 Apr 2017 08:27:16 -0000

Repository: brooklyn-docs
Updated Branches:
  refs/heads/master 2308dcae7 -> 677166b43


Java config docs: default-value should be immutable

Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/683a3ee1
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/683a3ee1
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/683a3ee1

Branch: refs/heads/master
Commit: 683a3ee1a792e9e80eb8359328cb388056cd85a0
Parents: 2308dca
Author: Aled Sage <aled.sage@gmail.com>
Authored: Wed Apr 19 13:40:37 2017 +0100
Committer: Aled Sage <aled.sage@gmail.com>
Committed: Wed Apr 19 13:45:32 2017 +0100

----------------------------------------------------------------------
 guide/blueprints/java/common-usage.md | 4 ++++
 1 file changed, 4 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/683a3ee1/guide/blueprints/java/common-usage.md
----------------------------------------------------------------------
diff --git a/guide/blueprints/java/common-usage.md b/guide/blueprints/java/common-usage.md
index ccafd9b..2c9d91b 100644
--- a/guide/blueprints/java/common-usage.md
+++ b/guide/blueprints/java/common-usage.md
@@ -39,6 +39,10 @@ public static final ConfigKey<String> ROOT_WAR = new ConfigKeys.newStringConfigK
         "WAR file to deploy as the ROOT, as URL (supporting file: and classpath: prefixes)");
 {% endhighlight %}
 
+If supplying a default value, it is important that this be immutable. Otherwise, it risks users
+of the blueprint modifying the default value, which would affect blueprints that are subsequently 
+deployed.
+
 One can optionally define a `@SetFromFlag("war")`. This defines a short-hand for configuring the
 entity. However, it should be used with caution - when using configuration set on a parent entity
 (and thus inherited), the `@SetFromFlag` short-form names are not checked. The long form defined