Merge branch 'develop' into master.

Author: nicolaiparlog

.settings/org.eclipse.jdt.ui.prefs

@@ -78,7 +78,7 @@ sp_cleanup.always_use_this_for_non_static_field_access=false
 sp_cleanup.always_use_this_for_non_static_method_access=false
 sp_cleanup.convert_functional_interfaces=true
 sp_cleanup.convert_to_enhanced_for_loop=false
-sp_cleanup.correct_indentation=true
+sp_cleanup.correct_indentation=false
 sp_cleanup.format_source_code=true
 sp_cleanup.format_source_code_changes_only=false
 sp_cleanup.insert_inferred_type_arguments=false

GPL3.0

@@ -1,21 +1,54 @@
 # LibFX
 
-This is the place where we tell you, who we are, what this project is all about and why you really need it!
+**[LibFX](http://libfx.codefx.org)** has no strict goal for a feature set. It collects functionality I created for my use in other projects but are abstract enough to be generally helpful. Many will revolve around JavaFX (hence the name).
 
-## Who?
+This somewhat vague sentiment does not translate to quality! The code is clean, which especially includes thorough testing. It is also extensively documented and contains many examples. Bugs will be addressed quickly and feature requests as well as forks and pull requests are welcome.
 
-Well, we must disappoint you: there is no "we". Currently it's only me, Nicolai. ;)
+## Features
 
-## What?
+These features are present in the latest release:
 
-And the answer to _What?_ might also be underwhelming as I can't really tell you what will come of this. It will at least involve _JavaFX_ (hence the name) and some collections. In general, I've got two things in mind:
-* I wanna search my projects for reusable chunks of code. Whatever I find will be redesigned, tested, well-documented and finally published here.
-* I've got some ideas of things I'd like to implement and see where it takes me.
+* [Nestings](https://github.com/CodeFX-org/LibFX/wiki/Nestings): using all the power of JavaFX' properties for nested object aggregations
 
-Features will be developed in feature branches so this master might remain empty for a while. Check out the other branches to see what is being developed.
+## Documentation
 
-## Why?
+The best documentation are the tests. But understandably nobody wants to dig into them just to understand what the classes do so there are also examples and extensive Javadoc. The best way to get to know a feature is to check out the corresponding article in the [wiki](https://github.com/CodeFX-org/LibFX/wiki). It will include a high level explanation as well as links to demos and the best entry point into the documentation. The Javadoc of the current version is published [here](http://libfx.codefx.org/javadoc).
 
-So why should you use this? Yes, why indeed...
+If anything is missing or an explanation proves to be unhelpful, contact me (see below).
 
-Until this very hazy text changes, you should not use this code as-is. Check it out, look at it, get some ideas, change it, use it, ... go crazy with it! (But remember, it's licensed under GPL.) At some point, a part of the code will become stable and there will be releases - at least that's the hope. ;)
+## License
+
+License details can be found in the *LICENSE* file in the project's root folder. The information provided there is binding but the gist is: **LibFX** is licensed under the GPL but if that does not suit your licensing model, other arrangements are possible (contact me; see below).
+
+## Releases
+
+Releases are published [here](https://github.com/CodeFX-org/LibFX/releases). The release notes also contain the Maven coordinates for each version available in Maven Central.
+
+## Development
+
+Some information about how this library is developed:
+
+* The [issue tracker](https://github.com/CodeFX-org/LibFX/issues) is actively used so it is the place to report bugs and request features.
+* As per [GIT branching model](http://nvie.com/posts/a-successful-git-branching-model/) features are developed in feature branches. If you are curious, you can check out some branches to see what is being worked on.
+* This is a [Maven](http://maven.apache.org/) project, so in case you want to check out the code, make sure your IDE knows about Maven.
+
+## Infrastructure
+
+The best starting point to everything regarding **LibFX** is [libfx.codefx.org](http://libfx.codefx.org).
+
+The library has its home on [GitHub](https://github.com/CodeFX-org/LibFX) where the following features are especially noteworthy:
+* the [issue tracker](https://github.com/CodeFX-org/LibFX/issues), which is actively used for development
+* the [wiki](https://github.com/CodeFX-org/LibFX/wiki), where all features are introduced with their own article
+
+I have a blog at [codefx.org](http://blog.codefx.org) where I might occasionally blog about **LibFX**. Those posts are filed under [their own tag](http://blog.codefx.org/tag/libfx/).
+
+I use Eclipse and my project settings (like compiler warnings, formatter and save actions) can be found in the repository folder **.settings**. I do this to make it easier for contributors to cope with my obsession for warning free and consistently formatted code.
+
+## Contact
+
+Nicolai Parlog <br>
+CodeFX
+
+Web: http://codefx.org <br>
+Mail: [email protected] <br>
+Key: http://keys.gnupg.net/pks/lookup?op=vindex&search=0xA47A795BA5BF8326 <br>

LICENSE

@@ -2,27 +2,65 @@
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
 
+	<!-- PROJECT COORDINATES -->
+
 	<groupId>org.codefx.libfx</groupId>
 	<artifactId>LibFX</artifactId>
-	<version>0.1.0</version>
+	<version>0.1.1</version>
 	<packaging>jar</packaging>
 
+	<!-- PROJECT META INFORMATION -->
+
 	<name>LibFX</name>
-	<url>http://libfx.codefx.org</url>
 	<description>LibFX provides utility classes for JavaFX.</description>
+	<url>http://libfx.codefx.org</url>
+
 	<scm>
 		<url>https://github.com/CodeFX-org/LibFX</url>
+		<connection>scm:git:git://github.com/CodeFX-org/LibFX.git</connection>
 	</scm>
+
 	<issueManagement>
 		<url>https://github.com/CodeFX-org/LibFX/issues</url>
 		<system>GitHub</system>
 	</issueManagement>
 
+	<distributionManagement>
+		<snapshotRepository>
+			<id>ossrh</id>
+			<url>https://oss.sonatype.org/content/repositories/snapshots</url>
+		</snapshotRepository>
+	</distributionManagement>
+
+	<licenses>
+		<license>
+			<name>GNU General Public License, Version 3.0</name>
+			<url>http://www.gnu.org/licenses/gpl-3.0.txt</url>
+			<distribution>repo</distribution>
+			<comments>Dual licensing under a license without copyleft effect is possible. Contact [email protected].</comments>
+		</license>
+	</licenses>
+
+	<!-- ORGANIZATION META INFORMATION -->
+
 	<organization>
 		<name>CodeFX</name>
 		<url>http://codefx.org</url>
 	</organization>
 
+	<developers>
+		<developer>
+			<id>nipa</id>
+			<name>Nicolai Parlog</name>
+			<email>[email protected]</email>
+			<organization>CodeFX</organization>
+			<organizationUrl>http://codefx.org</organizationUrl>
+			<timezone>+1</timezone>
+		</developer>
+	</developers>
+
+	<!-- BUILD -->
+
 	<properties>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 	</properties>
@@ -44,6 +82,7 @@
 
 	<build>
 		<resources>
+			<!-- exclude the demo folder from the build process -->
 			<resource>
 				<directory>src/demo/java</directory>
 				<excludes>
@@ -53,6 +92,7 @@
 		</resources>
 		<plugins>
 			<plugin>
+				<!-- specify using Java 8 -->
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-compiler-plugin</artifactId>
 				<version>3.1</version>
@@ -62,6 +102,7 @@
 				</configuration>
 			</plugin>
 			<plugin>
+				<!-- create sources.jar -->
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-source-plugin</artifactId>
 				<version>2.3</version>
@@ -75,6 +116,7 @@
 				</executions>
 			</plugin>
 			<plugin>
+				<!-- create javadoc.jar -->
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
 				<version>2.9.1</version>
@@ -87,6 +129,33 @@
 					</execution>
 				</executions>
 			</plugin>
+			<plugin>
+				<!-- sign all jars and pom -->
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-gpg-plugin</artifactId>
+				<version>1.5</version>
+				<executions>
+					<execution>
+						<id>sign-artifacts</id>
+						<phase>verify</phase>
+						<goals>
+							<goal>sign</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
+			<plugin>
+				<!-- deploy to sonatype OSSRH -->
+				<groupId>org.sonatype.plugins</groupId>
+				<artifactId>nexus-staging-maven-plugin</artifactId>
+				<version>1.6.2</version>
+				<extensions>true</extensions>
+				<configuration>
+					<serverId>ossrh</serverId>
+					<nexusUrl>https://oss.sonatype.org/</nexusUrl>
+					<autoReleaseAfterClose>false</autoReleaseAfterClose>
+				</configuration>
+			</plugin>
 		</plugins>
 	</build>