summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/markdown/Reference-tables.md1
-rw-r--r--docs/markdown/snippets/add_os2.md28
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.