Merge branch 'master' of git://github.com/dknacht/Box2D into dknacht-master

Author: erincatto

Box2D/Building.md

@@ -0,0 +1,27 @@
+# Building Box2D
+
+The Box2D library is easy to build. I recommend adding the source files in the Box2D folder into your build system or project files for your IDE. The Box2D library is portable, so you should not need to configure it for your platform.
+
+Building the testbed is optional and may not work on your platform. I use [premake5](https://premake.github.io/) to generate projects for the testbed. You can get premake5 here: https://premake.github.io/.
+
+I support premake working well for [Visual Studio](https://www.visualstudio.com) on Windows 10 and [Xcode](https://developer.apple.com/xcode/) on MacOS. I appreciate contributions to get premake working on other platforms.
+
+### Visual Studio
+Here are the steps for Visual Studio 2017:
+- Command line: `premake5 vs2017`
+- Open the resulting `Box2D.sln` (should be in `Build/vs2017`)
+- Set Testbed as the startup project
+- In the Testbed debugging properties, set the Working Directory to `..\Testbed`
+- Press <kbd>F5</kbd> to build and run the Testbed
+
+### Xcode
+Here are the steps for Xcode:
+- Command line: `premake5 xcode4`
+- Open the resulting project file (should be `Build/xcode4`)
+- Set the Testbed as the current Scheme
+- Edit the Testbed Scheme, in the Run Options, use a custom working directory
+- Set the Testbed directory as the working directory
+- Press <kbd>Command</kbd>-<kbd>R</kbd> to build and run the Testbed
+
+Thanks,
+Erin

Box2D/Building.txt

@@ -0,0 +1,5 @@
+### Version 2.3.0
+- Polygon creation now computes the convex hull. Vertices no longer need to be ordered.
+- The convex hull code will merge vertices closer than dm_linearSlop. This may lead to failure on very small polygons.
+- Added b2MotorJoint.
+- Bug fixes.

Box2D/CHANGELOG.md

@@ -0,0 +1,7 @@
+![Box2D Logo](http://box2d.org/images/icon.gif)
+
+# Box2D Contributions
+
+This folder contains user contributions.
+
+Contributions are **not** supported by the Box2D project. Contributions *may not* compile or function correctly.

Box2D/Changes.txt

@@ -6,7 +6,7 @@
 
 For help with Box2D, please visit http://www.box2d.org. There is a forum there where you may post your questions.
 
-Please see `Building.txt` to learn how to build Box2D and run the testbed.
+Please see [Building.md](https://github.com/erincatto/Box2D/blob/master/Box2D/Building.md) to learn how to build Box2D and run the testbed.
 
 ## Demos
 
@@ -59,10 +59,13 @@ Please do not submit pull requests with new features. Instead, please file an is
 - Mouse picking and the bomb!
 - CMake build system files
 
-### Documentation
-- User manual
-- Doxygen document with code comments
-- Active user forum
+## Documentation
+You can find documentation related to the project in the [documentation page](http://box2d.org/documentation/) and in the [documentation folder](https://github.com/erincatto/Box2D/tree/master/Box2D/Documentation) in GitHub
+- [User manual](http://box2d.org/manual.pdf)
+- [Doxygen document](https://github.com/erincatto/Box2D/blob/master/Box2D/Documentation/Doxyfile) with code comments
+- [Active user forum](http://box2d.org/forum/)
+
+You can also visit the project wiki where you will find the [FAQ](https://github.com/erincatto/Box2D/wiki/FAQ)'s page
 
 ## License