From 5093213c129695e311d4c7672887a7148bbe9494 Mon Sep 17 00:00:00 2001 From: Havoc Pennington Date: Thu, 12 Apr 2012 21:38:34 -0400 Subject: [PATCH] NEWS.md updates --- NEWS.md | 39 +++++++++++++++++++++------------------ 1 file changed, 21 insertions(+), 18 deletions(-) diff --git a/NEWS.md b/NEWS.md index bfa9c1ea..76d0d463 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,34 +1,37 @@ # 0.NEXT.0: Sometime - - the serialization format has changed to one that's extensible + - the *serialization format has changed* to one that's extensible and lets the library evolve without breaking serialization all the time. The new format is also much more compact. However, this change is incompatible with old serializations, if you rely on that. The hope is to avoid serialization breakage in the future now that the format is not the default Java one (which was a direct dump of all the implementation details). - - serializing an unresolved Config (one that hasn't had + - *serializing an unresolved Config* (one that hasn't had resolve() called on it) is no longer supported, you will get NotSerializableException if you try. - - supports self-referential substitutions, such as + - ConfigValue.render() now supports ConfigRenderOptions which + means you can get a *no-whitespace no-comments plain JSON + rendering* of a ConfigValue + - supports *self-referential substitutions*, such as `path=${path}":/bin"`, by "looking backward" to the previous value of `path` - - supports concatenating arrays and merging objects within a - single value. So you can do `path=${path} [ "/bin" ]` for + - supports *concatenating arrays and merging objects within a + single value*. So you can do `path=${path} [ "/bin" ]` for example. See README and spec for more details. - - supports `+=` where `path+="/bin"` expands to `path=${?path} - [ "/bin" ]` - - supports `include url("http://example.com/")`, `include - file("/my/file.conf")`, and `include classpath("whatever")`. - This syntax forces treatment as URL, file, or classpath - resource. - - supports `include "http://example.com/whatever.conf"` (if an - include is a valid URL, it's loaded as such). This is - incompatible with prior versions, if you have a filename that - is also a valid URL, it would have loaded previously but now - it will not. Use the `include file("")` syntax to force - treatment as a file. - - class loaders are now recursively inherited through include + - supports *array append* `+=` where `path+="/bin"` expands to + `path=${?path} [ "/bin" ]` + - supports *specifying type of include* `include + url("http://example.com/")`, `include file("/my/file.conf")`, + and `include classpath("whatever")`. This syntax forces + treatment as URL, file, or classpath resource. + - supports *including URLs* `include + "http://example.com/whatever.conf"` (if an include is a valid + URL, it's loaded as such). This is incompatible with prior + versions, if you have a filename that is also a valid URL, it + would have loaded previously but now it will not. Use the + `include file("")` syntax to force treatment as a file. + - *class loaders are now recursively inherited* through include statements; previously, even if you set a custom class loader when parsing a file, it would not be used for parsing a classpath resource included from the file.