Add documentation for OS/2 support

2 files changed, 29 insertions, 0 deletions

diff --git a/docs/markdown/Reference-tables.md b/docs/markdown/Reference-tables.md
index 0bb10e5e0..9ac24a43c 100644
--- a/docs/markdown/Reference-tables.md
+++ b/docs/markdown/Reference-tables.md
@@ -175,6 +175,7 @@ These are provided by the `.system()` method call.
 | openbsd             | |
 | windows             | Native Windows (not Cygwin or MSYS2) |
 | sunos               | illumos and Solaris |
+| os/2                | OS/2 |
 
 Any string not listed above is not guaranteed to remain stable in
 future releases.
diff --git a/docs/markdown/snippets/add_os2.md b/docs/markdown/snippets/add_os2.md
new file mode 100644
index 000000000..4539ce59c
--- /dev/null
+++ b/docs/markdown/snippets/add_os2.md
@@ -0,0 +1,28 @@
+## Added OS/2 support
+
+Meson now supports OS/2 system. Especially, `shortname` kwarg and
+`os2_emxomf` builtin option are introduced.
+
+`shortname` is used to specify a short DLL name fitting to a 8.3 rule.
+
+```meson
+lib = library('foo_library',
+    ...
+    shortname: 'foo',
+    ...
+)
+```
+
+This will generate `foo.dll` not `foo_library.dll` on OS/2. If
+`shortname` is not used, `foo_libr.dll` which is truncated up to 8
+characters is generated.
+
+`os2_emxomf` is used to generate OMF files with OMF tool-chains.
+
+```
+meson setup --os2-emxomf builddir
+```
+
+This will generate OMF object files and `.lib` library files. If
+`--os2-emxomf` is not used, AOUT object files and `.a` library files are
+generated.