Initial community commit

Src/external_dependencies/openmpt-trunk/include/premake/website/docs/path.join.md

@@ -0,0 +1,36 @@
+Joins two path portions together into a single path.
+
+```lua
+path.join("leading", "trailing", ...)
+```
+
+If trailing is an absolute path, then the leading portion is ignored, and the absolute path is returned instead (see below for examples).
+
+
+### Parameters ###
+
+`leading` is the beginning portion of the path; `trailing` is a portion to be merged. Multiple arguments may be specified, which will be joined in the order provided.
+
+
+### Return Value ###
+
+A merged path.
+
+
+### Availability ###
+
+Premake 4.0 or later.
+
+
+### Examples ###
+
+```lua
+-- returns "MyWorkspace/MyProject"
+p = path.join("MyWorkspace", "MyProject")
+
+-- returns "/usr/bin", because the trailing path is absolute
+p = path.join("MyWorkspace", "/usr/bin")
+
+-- tokens are assumed to be absolute; this returns "$(ProjectDir)"
+p = path.join("MyWorkspace", "$(ProjectDir)")
+```