Permalink
Browse files

Some documentation updates for this experimental code.

  • Loading branch information...
1 parent e7c0aa8 commit a44cefb178de2ee0f6831fb61518cd210a8cd65d @gcv committed Dec 31, 2012
Showing with 36 additions and 11 deletions.
  1. +8 −0 HISTORY.md
  2. +22 −8 README.md
  3. +6 −3 TODO.org
View
@@ -1,3 +1,11 @@
+## 0.5.1-SNAPSHOT (not yet released)
+
+* Basic support for App Engine SDK 1.7.4.
+* Switched to Leiningen 2. It is now required for projects using
+ appengine-magic.
+* Removed support for versions of Clojure prior to 1.4.
+
+
## 0.5.0 (2012-03-19)
* Basic support for App Engine SDK 1.6.3.1. Added servlet LocalApiProxy property
View
@@ -22,11 +22,27 @@ Please read the project's HISTORY file to learn what changed in recent releases.
+## Current Status
+
+The code on this branch adds experimental support for App Engine SDK 1.7.4 and
+Leiningen 2.0. A stable older version is available
+[at the v0.5.0 tag](https://github.com/gcv/appengine-magic/tree/v0.5.0).
+
+
+### TODO for a stable 0.5.1 release
+
+* fix the `appengine-prepare` Leiningen task (see code comments)
+* fix the strange startup error related to the blob store
+* fix the `_ah/admin` console — some links do not work
+* retest all supported App Engine services — server push (at least) is broken
+
+
+
## Dependencies
* Clojure 1.4.0
-* Leiningen 1.7.0
-* Google App Engine SDK 1.6.3.1
+* Leiningen 2.0
+* Google App Engine SDK 1.7.4
@@ -102,8 +118,8 @@ functionality.
`core.clj` file created by Leiningen. You need to do this so that
appengine-magic can create a default file which correctly invokes the
`def-appengine-app` macro.
-3. Edit `project.clj`: add `[appengine-magic "0.5.0"]` to your
- `:dev-dependencies` (not `:dependencies`).
+3. Edit `project.clj`: add `[appengine-magic "0.5.1-SNAPSHOT"]` to both your
+ `:dependencies` and `:plugins`.
4. `lein deps`. This fetches appengine-magic, and makes its Leiningen plugin
tasks available. If you already have the App Engine SDK installed locally,
and do not wish to wait for Maven to download it again as a dependency, you
@@ -125,10 +141,6 @@ resulting project, but do take a careful look at it. In particular, you should
avoid checking in `war/WEB-INF/lib/` or `war/WEB-INF/classes/`: let Leiningen
take care of managing those directories.
-NB: When editing the Leiningen `project.clj` file, do not point `:compile-path`
-or `:library-path` to `war/WEB-INF/classes/` and `war/WEB-INF/lib/`. This will
-interfere with deployment.
-
### Development process
@@ -944,6 +956,8 @@ console, you'll see the polling requests.
The following Google services are not yet tested in the REPL environment:
+- Anything added in App Engine SDK 1.6.0
+- Anything added in App Engine SDK 1.7.0
- Asynchronous Memcache API requests (from App Engine SDK 1.6.0)
- Pull queues (from App Engine SDK 1.5.0)
- Deferred API (from App Engine SDK 1.4.3)
View
@@ -1,6 +1,5 @@
* Version 0.5.1
-*** Clojure 1.4
-*** Latest SDK support
+*** Latest SDK support (in progress)
*** Eliminate appengine-magic.core/in-appengine-interactive-mode?
- send a message to the clojure-web-dev mailing list, requesting beta testing
- close out tickets requesting IntelliJ and CCW support
@@ -21,9 +20,13 @@
*** Investigate MapReduce (for migrations, if nothing else)
+* Version 0.5.2
+*** Some App Engine 1.6 features
+*** Some App Engine 1.7 features
+
+
* Version 0.6.0 (or 1.0.0)
*** docstrings
-*** User-level Leiningen plugin (for a smoother appengine-new task)?
*** Finish implementing the App Engine interface
- [ ] Compositing in the Images API
- [ ] Metadata queries

0 comments on commit a44cefb

Please sign in to comment.