Skip to content

Commit

Permalink
updating doco in preperation for 1.0 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
chirino committed Jul 22, 2010
1 parent 350e0f9 commit 3a90c22
Show file tree
Hide file tree
Showing 6 changed files with 60 additions and 16 deletions.
63 changes: 52 additions & 11 deletions hawtdispatch-website/src/download.page
Expand Up @@ -7,27 +7,33 @@ sort_info: 5
# {project_name:}
Download it today!

--- name:content
--- name:content pipeline:tags,markdown

<div class="left" markdown="1">
# Download
</div>
<div class="right" markdown="1">
You can download **{project_name:}** from the [Snapshot Maven Repository](http://repo.fusesource.com/nexus/content/repositories/snapshots/) in the [{project_name:} area](http://repo.fusesource.com/nexus/content/repositories/snapshots/org/fusesource/hawtdispatch/).
You can download **{project_name:}** from the [Maven Repository](http://repo.fusesource.com/nexus/content/repositories/public/) in the [{project_name:} area](http://repo.fusesource.com/nexus/content/repositories/public/org/fusesource/{project_id:}/).

<!--
Download a distribution:
Download the jar:

* [1.0-SNAPSHOT zip](http://repo.fusesource.com/nexus/service/local/artifact/maven/redirect?r=snapshots&g=org.fusesource.hawtdispatch&a=hawtdispatch-distro&v=1.0-SNAPSHOT&e=zip&c=windows-bin) or [tar.gz](http://repo.fusesource.com/nexus/service/local/artifact/maven/redirect?r=snapshots&g=org.fusesource.hawtdispatch&a=hawtdispatch-distro&v=1.0-SNAPSHOT&e=tar.gz&c=unix-bin)
-->
* [{project_id:} {release_version:} jar](http://repo.fusesource.com/nexus/content/repositories/public/org/fusesource/{project_id:}/{project_id:}/{release_version:}/{project_id:}-{release_version:}.jar)
* [{project_id:}-scala {release_version:} jar](http://repo.fusesource.com/nexus/content/repositories/public/org/fusesource/{project_id:}/{project_id:}-scala/{release_version:}/{project_id:}-scala-{release_version:}.jar)

## Snapshots

You can download a recent snapshot from the [Snapshot Maven Repository](http://repo.fusesource.com/nexus/content/repositories/snapshots/) in the [{project_name:} area](http://repo.fusesource.com/nexus/content/repositories/snapshots/org/fusesource/{project_id:}/).

* [{project_id:} {snapshot_version:} jar](http://repo.fusesource.com/nexus/service/local/artifact/maven/redirect?r=snapshots&g=org.fusesource.{project_id:}&a={project_id:}&v={snapshot_version:}&e=jar)
* [{project_id:}-scala {snapshot_version:} jar](http://repo.fusesource.com/nexus/service/local/artifact/maven/redirect?r=snapshots&g=org.fusesource.{project_id:}&a={project_id:}-scala&v={snapshot_version:}&e=jar)

</div>

<div class="left" markdown="1">
# Maven
</div>
<div class="right" markdown="1">
If you build your project using [Maven](http://maven.apache.org/) then just add the following to your *pom.xml*
If you build your project using [Maven](http://maven.apache.org/) then just add one of the following dependencies to your *pom.xml*
</div>
<div class="right">
{coderay:: xml}<dependency>
Expand All @@ -36,12 +42,46 @@ If you build your project using [Maven](http://maven.apache.org/) then just add
<version>${{project_id:}-version}</version>
</dependency>
{coderay}

</div>
<div class="right">
{coderay:: xml}<dependency>
<groupId>org.fusesource.{project_id:}</groupId>
<artifactId>{project_id:}-scala</artifactId>
<version>${{project_id:}-version}</version>
</dependency>
{coderay}
</div>

<div class="right" markdown="1">
The releases should be synchronized to the [central maven repository](http://repo1.maven.org/maven2/org/fusesource/{project_id:}/) so you should not need to add a maven repository to your pom.xml.

However if a release has not yet made it to the central repository or you want to add a repository for completeness, add the following to your *pom.xml*
</div>
<div class="right">
{pygmentize:: xml} <repositories>
<repository>
<id>fusesource.m2</id>
<name>FuseSource Public Repository</name>
<url>http://repo.fusesource.com/nexus/content/repositories/public</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
{pygmentize}
</div>

<div class="right" markdown="1">
You should ensure you have the {project_name:} Snapshot Maven repository defined in your *pom.xml*</div>
## Snapshots

If you want to use a **snapshot version** you should ensure you have the {project_name:} Snapshot Maven repository defined in your *pom.xml*
</div>
<div class="right">
{coderay:: xml} <repositories>
{pygmentize:: xml} <repositories>
<repository>
<id>fusesource.snapshots</id>
<name>FuseSource Snapshot Repository</name>
Expand All @@ -54,14 +94,15 @@ You should ensure you have the {project_name:} Snapshot Maven repository defined
</releases>
</repository>
</repositories>
{coderay}
{pygmentize}
</div>


<div class="left" markdown="1">
# Building
</div>

<div class="right" markdown="1">
If you prefer you can try checking out [the source code](source.html) and then [build it](building.html)
If you prefer you can try building from [the source code](source.html) and [building it](building.html)
</div>

4 changes: 3 additions & 1 deletion hawtdispatch-website/src/index.md
Expand Up @@ -346,4 +346,6 @@ queue.release
## References
* [Echo Server Example](http://github.com/chirino/hawtdispatch/blob/master/hawtdispatch-example/src/main/scala/org/fusesource/hawtdispatch/example/EchoServer.scala#L34) Source code for a simple TCP based echo server.
* [STOMP Broker Example](stomp-example.html) Overview of a more complex networking server example.
* [Full API]({api_dir:}/package-summary.html)
* [Java API]({api_dir:}/package-summary.html)
* [Scala API]({scala_api_dir:}/index.html)

3 changes: 2 additions & 1 deletion hawtdispatch-website/src/index.page
Expand Up @@ -2,7 +2,8 @@
title: HawtDispatch
in_menu: true
sort_info: 1
api_dir: http://hawtdispatch.fusesource.org/maven/1.0-SNAPSHOT/hawtdispatch/apidocs/org/fusesource/hawtdispatch
api_dir: http://hawtdispatch.fusesource.org/maven/1.0/hawtdispatch/apidocs/org/fusesource/hawtdispatch
scala_api_dir: http://hawtdispatch.fusesource.org/maven/1.0/hawtdispatch-scala/scaladocs
--- name:overview pipeline:haml,tags

%h1 {project_name:}
Expand Down
2 changes: 1 addition & 1 deletion hawtdispatch-website/src/metainfo
Expand Up @@ -25,7 +25,7 @@
project_wiki_url: 'http://wiki.github.com/chirino/hawtdispatch/'
project_logo: "/images/project-logo.png"
release_version: '1.0'
snapshot_version: '1.0-SNAPSHOT'
snapshot_version: '1.1-SNAPSHOT'

# -------------------------------------------------------------------
# TODO it would be nice to define these in terms of the project_id variable!
Expand Down
2 changes: 1 addition & 1 deletion hawtdispatch-website/src/virtual
Expand Up @@ -21,5 +21,5 @@ in_menu: false
title: API
in_menu: true
sort_info: 100
url: http://hawtdispatch.fusesource.org/maven/1.0-SNAPSHOT/hawtdispatch/apidocs/index.html
url: http://hawtdispatch.fusesource.org/maven/1.0/hawtdispatch/apidocs/index.html

2 changes: 1 addition & 1 deletion readme.md
Expand Up @@ -17,7 +17,7 @@ development.
## Resources

* [Developer Guide](http://hawtdispatch.fusesource.org)
* [API Reference](http://hawtdispatch.fusesource.org/maven/1.0-SNAPSHOT/hawtdispatch/apidocs/org/fusesource/hawtdispatch/package-summary.html)
* [API Reference](http://hawtdispatch.fusesource.org/maven/1.0/hawtdispatch/apidocs/org/fusesource/hawtdispatch/package-summary.html)

## Building from Source

Expand Down

0 comments on commit 3a90c22

Please sign in to comment.