Error formatting macro: pagetree: java.lang.NullPointerException
Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version. Compare with Current  |   View Page History

This document is a work in progress! Please feel free to edit it.

= TODO =

  • Add documentation around the interesting tickets in this list
  • Remove less interesting tickets that don't have more docs
  • Comb through Git history and document the stuff not captured by tickets

Changes to Clojure in Version 1.3 Beta

= CONTENTS =

0 Still In Process
1 Deprecated and Removed Features
1.1 Earmuffed Vars Are No Longer Automatically Considered Dynamic.
1.2 ISeq No Longer Inherits From Sequential
1.3 Disallow recur across try
1.4 Removed
1.X More info needed
2 New/Improved Features in clojure.core
2.1 Enhanced Primitive Support
2.2 better exception reporting
2.3 ancillary namespaces no longer auto-load on startup:
2.4 Code Path for Using Vars is Now Much Faster for the Common Case
2.5 clojure.reflect/reflect
2.6 clojure.data/diff
2.7 with-redefs macro (useful for stubbing)
2.8 print-table
2.9 normalized unchecked-* fn names
2.10 added unchecked-math support
2.11 fixes to binding conveyance (and agent)
2.12 pprint respects print-length
2.13 into-array now coerces numeric types
2.14 Java's line.separator property for newline
2.15 compilation and deployment via Maven
2.16 improved startup time
2.17 internal keyword map uses weak refs
2.18 fix perf on some numeric overloads
2.19 ^:const defs
2.20 Message Bearing Assert
2.21 Error Checking for defmulti Options
2.22 Promises are Lock Free
2.23 Removed Checked Exceptions
2.24 vector-of Takes Multiple Arguments
2.25 every-pred and some-fn Combinators
2.26 deref with timeout
2.27 realized?
2.28 Functions Only Get Metadata Support Code When Metadata Explicitly Supplied When Defined
2.29 Allow definterface/gen-interface to Accept Array Type Hints
2.30 Better Error Messages
2.31 Walk Support for sorted-by Collections
2.32 string.join Enhanced to Work with Sets
2.33 clojure.test-helper
2.34 Newline outputs platform-specific newline sequence
2.35 nil? inlined
2.36 init-proxy and update-proxy return proxy
2.37 doc & find-doc moved to REPL
2.38 clojure.java.shell/sh accepts as input anything that clojure.java.io/copy does
2.X More Info Needed
3 New Namespaces
4 Functions with Improved Performance
5 Bug Fixes
6 JIRA issues

= 0 Still In Process =

  • CLJ-184 n-ary bit functions, also inlining of n-ary bit and math operations
  • CLJ-371 dynamic defrecord definitions trumped by AOT versions in classpath
  • CLJ-374 print/read syntax for defrecords
  • CLJ-666 Add support for Big* numeric types to Reflector
  • CLJ-671 Recur mismatch causes infinite loop in compiler
  • CLJ-772 bit ops to have primitive semantics by default, no conditionals, direct mapping to JVM primitive ops

= 1 Deprecated and Removed Features =

== 1.1 Earmuffed Vars Are No Longer Automatically Considered Dynamic. ==

(def fred)
=> Warning: fred not declared dynamic and thus is not dynamically rebindable, but its name suggests otherwise. Please either indicate ^:dynamic ** or change the name.

== 1.2 ISeq No Longer Inherits From Sequential ==

This allows anything that implements ISeq from being exclusively in the map or set equality partition.

== 1.3 Disallow recur across try ==

A compile-time exception is thrown if you attempt to recur across a try

(fn x (try (recur 1)))
=> CompilerException

== 1.4 Removed Bit Operation support for boxed numbers ==

Bit Operations map directly to primitive operations

== 1.X More info needed ==

  • CLJ-182 Symbol.create is now Symbol.intern
  • CLJ-278 replicate could be marked deprecated

= 2 New/Improved Features in clojure.core =

== 2.1 Enhanced Primitive Support ==

Full details here: http://dev.clojure.org/display/doc/Enhanced+Primitive+Support)

== 2.2 Better Exception Reporting ==

Full details here: http://dev.clojure.org/display/design/Error+Handling

== 2.3 Ancillary Namespaces No Longer Auto-Load on Startup ==

The following namespaces are no longer loaded on startup: clojure.set, clojure.xml, clojure.zip

== 2.4 Code Path for Using Vars is Now Much Faster for the Common Case ==

== 2.5 clojure.reflect/reflect ==

Full details here: http://dev.clojure.org/display/design/Reflection+API

== 2.6 clojure.data/diff ==

Optimization for diffing equal objects

Short-circuit return when a and b are equal; performance optimization

(diff {:fred :ethel} {:fred :ethel})
=> fred :ethel}

  • CLJ-448 structural diff

== 2.7 with-redefs macro ==

Useful for stubbing

== 2.8 print-table ==

== 2.9 normalized unchecked-* fn names ==

== 2.10 added unchecked-math support ==

  • CLJ-441 Add unchecked coercions

== 2.11 fixes to binding conveyance (and agent) ==

== 2.12 pprint respects print-length ==

== 2.13 into-array now coerces numeric types ==

== 2.14 Java's line.separator property for newline ==

== 2.15 compilation and deployment via Maven ==

== 2.16 improved startup time ==

== 2.17 internal keyword map uses weak refs ==

== 2.18 fix perf on some numeric overloads ==

CLJ-380

== 2.19 ^:const defs ==

^:const lets you name primitive values with speedier reference.

(def constants
{:pi 3.14
:e 2.71})

(def ^:const pi (:pi constants))
(def ^:const e (:e constants))

The overhead of looking up :e and :pi in the map happens at compile time, as (:pi constants) and (:e constants) are evaluated when their parent def forms are evaluated.

== 2.20 Message Bearing Assert ==

Assert can take a second argument which will be printed when the assert fails

(assert (= 1 2) "1 is not equal to 2")
=> AssertionError Assert failed: 1 is not equal to 2

== 2.21 Error Checking for defmulti Options ==

defmulti will check to verify that its options are valid. For example, the following code will throw an example:

(defmulti fred :ethel :lucy :ricky)
=> IllegalArgumentException

== 2.22 Promises are Lock Free ==

This is a performance enhancement by using compare-and-set! instead of locking.

== 2.23 Removed Checked Exceptions ==

Clojure does not throw checked exceptions

== 2.24 vector-of Takes Multiple Args ==

vector-of takes multiple args used to populate the array

(vector-of :int 1 2 3)
=> 1 2 3

== 2.25 every-pred and some-fn Combinators ==

every-pred takes a set of predicates and returns a function f that returns true if all of its composing predicates return a logical true value against all of its arguments, else it returns false.

((every-pred even?) 2 4 6)
=> true

((every-pred even?) 2 4 5)
=>false

some-fn takes a set of predicates and returns a function f that returns the first logical true value returned by one of its composing predicates against any of its arguments, else it returns logical false.

((some-fn even?) 2 4 5)
=> true
((some-fn odd?) 2 4 6)
=> false

== 2.26 deref with timeout ==

deref now takes a timeout option - when given with a blocking reference, will return the timeout-val if the timeout (in milliseconds) is reached before value is available.

(deref (promise) 10 :ethel)
=> :ethel

== 2.27 realized? ==

Returns true if a value has been produced for a promise, delay, future or lazy sequence.

(let x (range 5)
(println (realized? x))
(first x)
(println (realized? x)))
=> false
=> true

== 2.28 Functions Only Get Metadata Support Code When Metadata Explicitly Supplied When Defined ==

Optimization to not include metadata support code on functions that don't need it.

== 2.29 Allow definterface/gen-interface to Accept Array Type Hints ==

Performance optimization to allow type hinting on interfaces.

== 2.30 Better Error Messages ==

Better error messages:

  • When calling macros with arity
  • For Invalid Map Literals
  • For alias function if using unknown namespace
  • In the REPL

== 2.31 Walk Support for sorted-by Collections

Walk modified to work on sorted-by collections

let x (sorted-set-by > 1 2 3) (walk inc reverse x))
=> (2 3 4)

== 2.32 string.join Enhanced to Work with Sets ==

Just like join works on other collections

(join " and " #{:fred :ethel :lucy})
=> ":lucy and :fred and :ethel"

== 2.33 clojure.test-helper ==

All test helpers moved into clojure.test-helper

== 2.34 Newline outputs platform-specific newline sequence ==

Newline sequence is output as \r\n on Windows now.

== 2.35 nil? inlined ==

Performance optimization

== 2.36 init-proxy and update-proxy return proxy ==

Now you can chain calls on the proxy

== 2.37 doc & find-doc moved to REPL ==

Adds special form docs to the REPL

== 2.38 clojure.java.shell/sh accepts as input anything that clojure.java.io/copy does

This adds InputStream, Reader, File, byte[] to the list of inputs for clojure.java.shell/sh

== 2.39 print-table

Prints a collection of maps in a textual table.

(print-table fred :barney fred "ethel"} {:fred "wilma" :barney "betty"})
=> ===============
:fred | :barney
===============
ethel |
wilma | betty
===============

== 2.X More Info Needed ==

  • CLJ-249 Add "starting at <line>" to EOF while reading exceptions
  • CLJ-263 Add an optional environment argument to #'resolve and ns-resolve
  • CLJ-276 Add non-interning keyword lookup function
  • CLJ-280 def should support an optional doc-string
  • CLJ-285 Make it easier to discover the source of compiler exceptions when two files have the same name in different directories
  • CLJ-315 Add support for running -main namespace from clojure.main without AOT
  • CLJ-364 Make PersistentQueue Counted
  • CLJ-378 Set thread names on agent thread pools
  • CLJ-380 bit-and missing long parameters overload
  • CLJ-425 stop early-loading ancillary libraries
  • CLJ-429 revamp ant build
  • CLJ-439 Automatic type translation from Integer to Long
  • CLJ-443 Add zero-arity body to comp function
  • CLJ-435 Reflection
  • CLJ-460 promote interrupt handling to clojure.repl
  • CLJ-665 Add mechanism to temporarily replace root bindings of vars

= 5 Bug Fixes =

  • CLJ-8 detect and report cyclic load dependencies
    • Patch restore detection of cyclic load dependencies
  • CLJ-292 LazySeq.sval() nests RuntimeExceptions
    • Patch causes only the original RuntimeException to be thrown
  • CLJ-390 sends from agent error-handlers should be allowed
    • Patch allows agent error-handler to send successfully
  • CLJ-432 deftype does not work if containing ns contains dashes
    • Patch munges namespaces with dashes properly
  • CLJ-433 munge should not munge $ (which isJavaIdentifierPart), should munge ' (which is not)
  • CLJ-435 stackoverflow exception in printing meta with :type
  • CLJ-678 into-array should work with all primitive types
  • CLJ-680 printing promises should not block
    • Patch allows printing of promises without blocking
  • CLJ-682 cl-format: ~w throws an exception when not wrapped in a pretty-writer
    • Patch fixes the following bug in cl-format with ~w:
  • CLJ-693 VerifyError with symbol metadata, macros, and defrecord
  • CLJ-702 case gives NPE when used with nil
    • Patch allows nil to be used with case
  • CLJ-734 starting scope of let bindings seems incorrect from jdi perspective
    • Patch fixes local variables table to have the correct code index for let bindings.
  • CLJ-739 version.properties file is not closed
    • Patch properly closes version.properties file
  • CLJ-751 cl-format: ~( thows an exception with an empty string
    • Patch fixes the following bug in cl-format when format is nil
      (cl-format nil "Sad~a)" "")
      => NullPointerException
  • CLJ-780 race condition in reference cache on Java 5
  • Map.Entry instances can have null values prior to Java 6. This patch provides a workaround.
  • floats were being boxed as Doubles, now they are boxed as Floats
  • several "holding onto head" fixes
  • Stop top-level defs from hanging onto the head of an expression that uses a lazy seq
  • Stop multimethods from holding onto heads of their arguments
  • CLJ-8 GC Issue 3: Re-enable detection of circular loads
  • CLJ-139 defmulti should not add {:tag 'clojure.lang.MultiFn} to multimethod metatdata
  • CLJ-235 clojure.test fixtures don't work with test-ns-hook
  • CLJ-282 Replace references to duck-streams in clojure.test comments to io
  • CLJ-286 out being used as java.io.PrintWriter
  • CLJ-292 LazySeq.sval() nests RuntimeExceptions
  • CLJ-305 out has a misleading docstring
  • CLJ-368 Redefining a function that uses a redifined macro, picks up old macro defintion
  • CLJ-421 clojure tests can fail because of a race in the pprint tests
  • CLJ-430 clojure.java.io URL Coercion throws java.lang.ClassCastException
  • CLJ-437 Bugs in clojure.set/subset? and superset? for sets with false/nil elements
  • CLJ-444 Infinite recursion in Keyword.intern leads to stack overflow
  • CLJ-447 biginteger fn misses a case for clojure.lang.BigInt
  • CLJ-462 clojure.core/slurp docstring out of date
  • CLJ-465 with-local-vars broken after changes to make dynamic off by default
  • CLJ-684 agent self-send test heisenfailing
  • CLJ-695 pprint does not respect print-length
  • CLJ-749 reference a definterface in file that declares it

= 6 JIRA Issues =

The complete list of JIRA issues is here: http://dev.clojure.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=10052

Labels: