diff --git a/docs/abi/calling-convention.md b/docs/abi/calling-convention.md
index 864dfb5a..4dd21b07 100644
--- a/docs/abi/calling-convention.md
+++ b/docs/abi/calling-convention.md
@@ -80,6 +80,7 @@ and the most significant word is passed via the DE register pair
 
 The Intel 8086 calling conventions is based on the Intel 8080 calling convention,
 plus it uses the BP register in the same role as the IX register of Z80.
+The DI register is not used.
 
 #### Parameters:
 
diff --git a/docs/abi/inlining.md b/docs/abi/inlining.md
index de5a40d6..330a54a6 100644
--- a/docs/abi/inlining.md
+++ b/docs/abi/inlining.md
@@ -8,6 +8,12 @@
 
 ## Automatic inlining
 
-`-finline` command-line option
+You can control inlining behavior in several ways:
+
+* functions declared with the `inline` keyword will be inlined if possible
+
+* functions declared with the `noinline` keyword will never be inlined
+
+* the remaining functions may be inlined only if the `-finline` command-line option is enabled
+and the compiler decides the function is worth doing
 
-`inline` and `noinline` keyword