Add basic READMEs

This commit is contained in:
Dave Syer 2013-07-19 10:53:13 +01:00
parent 8fdfe245ca
commit 90c942387f
7 changed files with 48 additions and 18 deletions

View File

@ -44,7 +44,7 @@ An `alias` can be used for the Spring Zero command line tool:
$ alias spr="java -jar ~/.m2/repository/org/springframework/zero/spring-cli/0.5.0.BUILD-SNAPSHOT/spring-cli-0.5.0.BUILD-SNAPSHOT.jar"
_Also see [CONTRIBUTING.md](/CONTRIBUTING.md) if you want to submit pull requests._
_Also see [docs/CONTRIBUTING](docs/CONTRIBUTING.md) if you want to submit pull requests._
## Quick Start Example
@ -102,7 +102,7 @@ The 'spring' command line application compiles and runs Groovy source, making it
easy to write the absolute minimum of code to get an application running. Spring CLI
can also watch files, automatically recompiling and restarting when they change.
*See [spring-cli/README.md](spring-cli/README.md).*
*See [spring-cli/README](spring-cli/README.md).*
### Spring Bootstrap
@ -115,7 +115,7 @@ Features include:
* Embedded web applications with a choice of container (Tomcat or Jetty for now)
* First class externalized configuration support
_See [spring-bootstrap/README.md](spring-bootstrap/README.md)._
_See [spring-bootstrap/README](spring-bootstrap/README.md)._
### Spring Autoconfigure
@ -128,7 +128,7 @@ classpath. For example, If a 'HSQLDB' is on the classpath the user probably want
in-memory database to be defined. Auto-configuration will back away as the user starts
to define their own beans.
_See [spring-autoconfigure/README.md](spring-autoconfigure/README.md)._
_See [spring-autoconfigure/README](spring-autoconfigure/README.md)._
### Spring Actuator
@ -138,7 +138,7 @@ writing a JSON web service then it will provide a server, security, logging, ext
configuration, management endpoints, an audit abstraction, and more. If you want to
switch off the built in features, or extend or replace them, it makes that really easy as well.
_See [spring-actuator/README.md](spring-actuator/README.md)._
_See [spring-actuator/README](spring-actuator/README.md)._
### Spring Starters
@ -148,7 +148,7 @@ that you need without having to hunt through sample code and copy paste loads of
dependency descriptors. For example, if you want to get started using Spring and JPA for
database access just include one dependency in your project, and you are good to go.
_See [spring-starters/README.md](spring-starters/README.md)._
_See [spring-starters/README](spring-starters/README.md)._
### Packaging
@ -157,16 +157,16 @@ The [spring-launcher](spring-launcher/) and
to package you application for release. Applications can be released as a single jar
file that can simply be launched using `java -jar`.
_See [spring-launcher/README.md](spring-launcher/README.md) &
[spring-package-maven-plugin/README.md](spring-package-maven-plugin/README.md)._
_See [spring-launcher/README](spring-launcher/README.md) &
[spring-package-maven-plugin/README](spring-package-maven-plugin/README.md)._
## Samples
Groovy samples for use with the command line application are available in
[spring-cli/samples](spring-cli/samples/). To run the CLI samples type
[spring-cli/samples](spring-cli/samples/#). To run the CLI samples type
`spr run <sample>.groovy` from samples directory.
Java samples are available in [spring-zero-sample](spring-zero-samples/) and should
Java samples are available in [spring-zero-sample](spring-zero-samples/#) and should
be build with maven and run use `java -jar target/<sample>.jar`. The following java
samples are provided:

View File

@ -62,9 +62,11 @@ Maven is well supported by most Java IDEs. Refer to you vendor documentation.
### Integration tests
The sample application are used as integration tests during the build. Due to the
fact that they make use of the `spring-package-maven-plugin` they cannot be called
directly, and so instead are launched via the `maven-invoker-plugin`. If you encounter
build failures running the integration tests, check the `build.log` file in the appropriate
sample directory.
The sample application are used as integration tests during the build
(when you `mvn install`). Due to the fact that they make use of the
`spring-package-maven-plugin` they cannot be called directly, and so
instead are launched via the `maven-invoker-plugin`. If you encounter
build failures running the integration tests, check the `build.log`
file in the appropriate sample directory.

View File

@ -1 +1,5 @@
# Spring Launcher
A very thin Java main for executable JAR and WAR
archives. `JarLauncher` and `WarLauncher` know how to access classpath
resources and dependencies in nested jar files.

View File

@ -1 +1,22 @@
# Spring Package Maven Plugin
A maven plugin for building executable JAR and WAR files. To use it
configure your project to build a JAR or WAR (as appropriate) in the
normal way, using the `maven-jar-plugin` or `maven-war-plugin`, and
then add the Spring plugin to your `<build><plugins>` section
`pom.xml`
```xml
<plugin>
<groupId>org.springframework.zero</groupId>
<artifactId>spring-package-maven-plugin</artifactId>
<version>{{project.version}}</version>
<executions>
<execution>
<goals>
<goal>package</goal>
</goals>
</execution>
</executions>
</plugin>
```

View File

@ -1 +1,4 @@
# Spring Starters
Aggregated dependencies for starter projects with an opinionated
choice of Spring and related useful technologies.

View File

@ -40,7 +40,7 @@
<configuration>
<useDefaultDelimiters>false</useDefaultDelimiters>
<delimiters>
<delimiter>#{*}</delimiter>
<delimiter>@{*}</delimiter>
</delimiters>
<resources>
<resource>

View File

@ -13,7 +13,7 @@
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<spring.version>4.0.0.BUILD-SNAPSHOT</spring.version>
<spring.zero.version>#{project.version}</spring.zero.version>
<spring.zero.version>@{project.version}</spring.zero.version>
</properties>
<prerequisites>
<maven>3.0</maven>