1 files changed, 50 insertions, 0 deletions
diff --git a/docs/target.md b/docs/target.md
new file mode 100644
index 00000000..6b5b088d
--- /dev/null
+++ b/docs/target.md
@@ -0,0 +1,50 @@
+
+Target Overrides
+================
+
+Mrustc supports a few targets out of the box (of varying levels of usablity), these are listed in
+`src/trans/target.cpp`. If the built-in targets aren't suitable, a custom target can be specified with the help of a
+custom target toml file.
+
+To specify a target when running `mrustc` (or `minicaro`), pass `--target <triple>` or `--target
+./path/to/target.toml` (the presence of a slash, backwards or forwards, is what determines if the target is treated as
+a custom target file.
+
+
+Custom target format
+--------------------
+
+Recreation of the `arm-linux-gnu` target
+```toml
+[target]
+family = "unix"
+os-name = "linux"
+env-name = "gnu"
+arch = "arm"
+
+[backend.c]
+variant = "gnu"
+target = "arm-linux-gnu"
+```
+
+Recreation of the `i586-windows-gnu` target (with architecture)
+```toml
+[target]
+family = "windows"
+os-name = "windows"
+env-name = "gnu"
+
+[backend.c]
+variant = "gnu"
+target = "mingw32"
+
+[arch]
+name = "x86"
+pointer-bits = 32
+is-big-endian = false
+has-atomic-u8 = true
+has-atomic-u16 = true
+has-atomic-u32 = true
+has-atomic-u64 = false
+has-atomic-ptr = true
+```