anchor.diff:  Task library documentation: link:doc/tasks.adoc[tasks]
   
   [[configuration]]
  -= configuration
  += how it works
  +
  +You configure a boot-gae application by writing a `build.boot` file
  +and some `edn` files.  For example, you specify servlets in
  +`servlets.edn`, which looks like this:
  +
  +[source,clojure]
  +----
  +{:servlets [{:ns greetings.hello
  +             :name "hello-servlet"
  +             :display {:name "Awesome Hello Servlet"}
  +             :desc {:text "blah blah"}
  +             :urls ["/hello/*" "/foo/*"]
  +             :params [{:name "greeting" :val "Hello"}]
  +             :load-on-startup {:order 3}}
  +  ...]}
  +----
  +
  +boot-gae tasks will use these files to automate just about everything:
  +
  +* xml configuration files (web.xml and appengine-web.xml
  +* servlet and filter stub class files
  +* a "reloader" filter that supports quasi-REPL responsiveness
  +
  +NOTE: Currently only the
  +https://cloud.google.com/appengine/docs/about-the-standard-environment[Standard
  +Environment] is supported.  The
  +https://cloud.google.com/appengine/docs/flexible/[Flexible
  +Environment] is not supported.
  +
  +GAE applications can be built as stand-alone, servlet-based apps, or
  +as a service-based app composed of multiple services.  `boot-gae`
  +supports both styles.  See the documentation of
  +https://github.com/migae/boot-gae-examples[boot-gae-examples] for
  +details.
  +
  +
  +== configuration
   
   [[dependencies]]
   ==== dependencies
  -
  -WARNING: The GAE java SDK is in the vicinity of 200 MB as of version
  -1.9.37, so the first time you run `boot` with that as a dependency it
  -may take a _long_ time (like 5-10 minutes or more depending on your
  -network connection etc.)  Currently `boot` does not have a download
  -progress indicator, so it may appear to hang.  You can monitor
  -progress by running `$ boot -vv help` .
   
   At a minimum, the `build.boot` file for a GAE webapp must include a
   dependency for Clojure, for the Appengine Java SDK, and for boot-gae.
  
positive.code: 
  
  [[services]]
  === microservices
  
  Naming and versioning of services is a bit mysterious.
  
  
negative.code: * <<testing,testing>>
  * <<deployment,deployment>>
  * <<modules,modules>>
  * <<services,microservices>>
  * <<debugging,debugging>>
  * <<troubleshooting,troubleshooting>>
  * <<todo,todo>>
  