clojure · eliudiaz · May 4, 2009 · May 8, 2009 · May 13, 2009 · May 14, 2009
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,8 @@
+classes/*
+*jar
+pom.xml
+clojure.iws
+clojure.ipr
+nbproject/private/
+*.zip
+dist
diff --git a/build.xml b/build.xml
@@ -9,9 +9,11 @@
   </description>
 
   <property name="src" location="src"/>
+  <property name="test" location="test"/>
   <property name="jsrc" location="${src}/jvm"/>
   <property name="cljsrc" location="${src}/clj"/>
   <property name="build" location="classes"/>
+  <property name="dist" location="dist"/>
 
   <!-- version related properties -->
   <property file="${cljsrc}/clojure/version.properties"/>
@@ -84,14 +86,22 @@
   <target name="compile-clojure" depends="compile-java"
           description="Compile Clojure sources.">
     <java classname="clojure.lang.Compile"
-          classpath="${build}:${cljsrc}">
+          classpath="${build}:${cljsrc}"
+          failonerror="true">
       <sysproperty key="clojure.compile.path" value="${build}"/>
+      <!-- <sysproperty key="clojure.compile.warn-on-reflection" value="true"/> -->
       <arg value="clojure.core"/>
       <arg value="clojure.main"/>
       <arg value="clojure.set"/>
       <arg value="clojure.xml"/>
       <arg value="clojure.zip"/>
       <arg value="clojure.inspector"/>
+      <arg value="clojure.walk"/>
+      <arg value="clojure.stacktrace"/>
+      <arg value="clojure.template"/>
+      <arg value="clojure.test"/>
+      <arg value="clojure.test.tap"/>
+      <arg value="clojure.test.junit"/>
     </java>
   </target>
 
@@ -110,6 +120,19 @@
     <copy file="${clojure_jar}" tofile="${clojure_noversion_jar}" />
   </target>
 
+  <target name="test"
+          description="Run clojure tests">
+<!--           depends="clojure"> -->
+    <java classname="clojure.main" failonerror="true">
+      <classpath>
+        <path location="${test}"/>
+        <path location="${clojure_jar}"/>
+      </classpath>
+      <arg value="-e"/>
+      <arg value="(require '(clojure [test-clojure :as main])) (main/run-ant)"/>
+    </java>
+  </target>
+
   <target name="clojure-slim" depends="compile-java"
           description="Create clojure-slim jar file (omits compiled Clojure code)">
     <jar jarfile="${slim_jar}">
@@ -144,9 +167,18 @@
   <target name="clean"
           description="Remove autogenerated files and directories.">
     <delete dir="${build}"/>
+    <delete dir="${dist}"/>
     <delete file="pom.xml"/>
   </target>
 
+  <target name="distclean" depends="clean"
+          description="Remove all generated files, including JARs.">
+    <delete verbose="true">
+      <fileset dir="${basedir}" includes="*.jar"/>
+      <fileset dir="${basedir}" includes="*.zip"/>
+    </delete>
+  </target>
+
   <target name="-setup-maven">
     <typedef resource="org/apache/maven/artifact/ant/antlib.xml" uri="urn:maven-artifact-ant"/>
   </target>
@@ -183,5 +215,22 @@
     <deploy target-dir="${stable.repo.dir}"/>
   </target>
 
-
+  <target name="dist" depends="distclean,jar"
+          description="Build distribution ZIP file">
+    <property name="distdir" value="${dist}/clojure-${clojure.version.label}"/>
+    <mkdir dir="${distdir}"/>
+    <copy todir="${distdir}" includeEmptyDirs="false">
+      <fileset dir="${basedir}">
+        <exclude name="pom.xml"/>
+        <exclude name="**/.git/**"/>
+        <exclude name="**/*.class"/>
+        <exclude name="**/*.iml"/>
+        <exclude name="**/*.ipr"/>
+        <exclude name="**/*.iws"/>
+        <exclude name="**/*.jar"/>
+      </fileset>
+    </copy>
+    <copy file="${clojure_noversion_jar}" todir="${distdir}"/>
+    <zip basedir="${dist}" destfile="clojure-${clojure.version.label}.zip"/>
+  </target>
 </project>
diff --git a/changes.txt b/changes.txt
@@ -0,0 +1,253 @@
+Changes to Clojure in Version 1.1 
+
+= CONTENTS =
+
+ 1 Deprecated and Removed Features
+    1.1 add-watcher, remove-watcher
+    1.2 add-classpath
+    1.3 ^ reader macro
+    1.4 clojure.parallel
+    1.5 clojure.lang.Repl, clojure.lang.Script
+ 2 New Features in clojure.core
+    2.1  Primitive Array Generators
+    2.2  Casting to Primitive Arrays
+    2.3  Chunked Sequences
+    2.4  Futures
+    2.5  Promises
+    2.6  Futures vs. Promises
+    2.7  Transients
+    2.8  User-controlled Thread Bindings
+    2.9  Ref History
+    2.10 Function pre- and postconditions
+    2.11 Miscellaneous
+ 3 New Namespaces
+    3.1  clojure.test
+    3.2  clojure.test.junit
+    3.3  clojure.stacktrace
+    3.4  clojure.walk
+    3.5  clojure.template
+ 4 Closed Tickets
+
+
+
+= 1 Deprecated and Removed Features =
+
+== 1.1 add-watcher, remove-watcher ==
+
+The functions add-watcher and remove-watcher are gone, but they can be
+implemented in terms of add-watch and remove-watch.
+
+The difference is that a "watcher" was only activated when the watched
+reference changed to a *different* state, whereas a "watch" is
+activated whenever the reference *might* have changed state.
+
+Watches are still considered an experimental feature.
+
+
+== 1.2 add-classpath ==
+
+This function can not be made to work in many environments.  Always
+use Java's built-in mechanisms to control the classpath.
+
+
+== 1.3 ^ reader macro ==
+
+The ^ reader macro has been deprecated as a shortcut for meta in the
+hopes that it can eventually replace the #^ reader macro.
+
+
+== 1.4 clojure.parallel ==
+
+The clojure.parallel namespace has been deprecated. Eventually it will
+be replaced with a faster and more idiomatic alternative based on the
+JDK7 ForkJoin library. A preview of this work is already available in
+the 'par' branch of Clojure.
+
+
+== 1.5 clojure.lang.Repl, clojure.lang.Script ==
+
+The launch classes clojure.lang.Repl and clojure.lang.Script are both
+deprecated in favor of clojure.main.  Run clojure.main with the -h
+argument for the new command-line syntax.
+
+
+
+= 2 New Features in clojure.core =
+
+== 2.1 Primitive Array Generators ==
+
+(just like int-array, double-array)
+
+  * boolean-array : New
+  * byte-array : New
+  * char-array : New
+  * short-array : New
+
+
+== 2.2 Casting To Primitive Arrays ==
+
+(just like ints, doubles)
+
+  * booleans : New
+  * bytes : New
+  * chars : New
+  * shorts : New
+
+
+== 2.3 Chunked Seqs ==
+
+Some Clojure data structures now yield chunked seqs, which, in
+addition to satisfying the normal item-at-a-time seq interface, also
+support processing data sequentially by small blocks called
+'chunks'. This can provide greater efficiency by leveraging the
+structure of the data and amortizing the overhead of sequential
+access. Some of the sequence processing functions (like map and
+filter) are now chunk-aware and leverage this efficiency.
+
+Consumption of chunked-seqs as normal seqs should be completely
+transparent. However, note that some sequence processing will occur up
+to 32 elements at a time. This could matter to you if you are relying
+on full laziness to preclude the generation of any non-consumed
+results. An interface to force single-item consumption of chunked seqs
+is still being designed. Please share any use cases where chunked
+processing has resulted in behavioral differences that matter to you
+on the Clojure Google group.
+
+The following fns should be considered implementation details subject
+to change, but can be used for experimentation with building your own
+chunked-seq functions from scratch. See map and filter as examples.
+
+  * chunk : New
+  * chunk-buffer : New
+  * chunk-append : New
+  * chunk-first : New
+  * chunk-rest : New
+  * chunk-next : New
+  * chunk-cons : New
+  * chunked-seq? : New
+
+
+== 2.4 Futures ==
+
+Futures represent asynchronous computations. They are a way to get
+code to run in another thread, and obtain the result.
+
+  * future : New
+  * future? : New
+  * future-done? : New
+  * future-cancel : New
+  * future-cancelled? : New 
+
+
+== 2.5 Promises ==
+
+A promise is a synchronization construct that can be used to deliver a
+value from one thread to another. Until the value has been delivered,
+any attempt to dereference the promise will block. It thus enables
+dataflow-style programming.
+
+  * promise : New
+  * deliver : New
+
+
+== 2.6 Futures vs. Promises ==
+
+A future is associated with a computation, whereas a promise is just a
+handoff reference.
+
+
+== 2.7 Transients ==
+
+See: http://clojure.org/transients
+
+  * transient : New
+  * persistent! : New
+  * conj! : New
+  * assoc! : New
+  * dissoc! : New
+  * pop! : New
+  * disj! : New
+
+
+== 2.8 User-Controlled Thread Bindings ==
+
+  * push-thread-bindings : New
+  * pop-thread-bindings : New
+  * get-thread-bindings : New
+  * with-bindings* : New
+  * with-bindings : New
+  * bound-fn* : New
+  * bound-fn : New
+
+
+== 2.9 Ref History ==
+
+  * ref : Updated
+  * ref-history-count : New
+  * ref-min-history : New
+  * ref-max-history : New
+
+
+== 2.10 Function pre- and postconditions ==
+
+Functions support specifying runtime pre- and postconditions.
+
+See: http://clojure.org/special_forms
+
+
+== 2.11 Miscellaneous ==
+
+  * juxt : New
+  * import : Now a macro form
+  * assert : Now with *assert* binding
+  * slurp : Now with encoding parameter
+  * with-loading-context : New
+
+
+
+= 3 New Namespaces =
+
+Complete documentation for all namespaces is in the source and API
+docs: http://richhickey.github.com/clojure/
+
+
+== 3.1 clojure.test ==
+
+The test framework formerly known as clojure.contrib.test-is.
+
+
+== 3.2 clojure.test.junit ==
+
+An extension to clojure.test for JUnit-style XML output.  This enables
+using JUnit reporting tools with clojure.test.
+
+
+== 3.3 clojure.stacktrace ==
+
+A few utility functions for printing Java stacktraces in a format that
+distinguishes between Clojure function calls and Java method calls.
+
+
+== 3.4 clojure.walk ==
+
+A simple tree walker for transforming data structures.  Similar in
+intent to clojure.zip, but less flexible.  Useful when you want to
+call a function on every value in a complex, nested data structure.
+
+Includes some examples such as stringify-keys, which replaces all
+keywords in a map with strings, and macroexpand-all, a quick-and-dirty
+macroexpansion tester.  Note: macroexpand-all is NOT 100% correct, it
+just recursively tries to macroexpand a form; it does not correctly
+interpret special forms such as let.
+
+
+== 3.5 clojure.template ==
+
+Macros that apply a "template expression" to a list of forms.  Used to
+implement the "are" macro in clojure.test.
+
+
+
+= 4 Closed Tickets =
+
+http://www.assembla.com/spaces/clojure/tickets?milestone_id=93750&tickets_report_id=5
diff --git a/clojure.iml b/clojure.iml
@@ -11,6 +11,11 @@
     <setting name="buildJar" value="true" />
     <setting name="mainClass" value="clojure.lang.Compiler" />
   </component>
+  <component name="FacetManager">
+    <facet type="Clojure" name="Clojure">
+      <configuration />
+    </facet>
+  </component>
   <component name="NewModuleRootManager" inherit-compiler-output="false">
     <output url="file://$MODULE_DIR$/classes" />
     <exclude-output />

diff --git a/pom-template.xml b/pom-template.xml
@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http//www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                             http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.clojure</groupId>
-    <artifactId>clojure-lang</artifactId>
-    <name>clojure-lang</name>
+    <artifactId>clojure</artifactId>
+    <name>clojure</name>
     <version>@clojure-version@</version>
     <url>http://clojure.org/</url>