diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 86ad15e03..0cc6771a7 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -820,11 +820,18 @@ static with only one option.
 
 The keyword arguments for this are the same as for [`executable`](#executable) with the following additions:
 
+- `name_prefix` the string that will be used as the prefix for the
+  target output filename by overriding the default (only used for
+  libraries). By default this is `lib` on all platforms and compilers
+  except with MSVC where it is omitted to follow convention.
 - `name_suffix` the string that will be used as the suffix for the
-  target by overriding the default (only used for libraries). By
-  default this is `lib` on all platforms and compilers except with
-  MSVC where it is omitted and set to `a` to avoid potential name clash
-  with shared libraries (which also generates `lib` files).
+  target output filename by overriding the default (see also:
+  [executable()](#executable)). By default, for shared libraries this
+  is `dylib` on macOS, `dll` on Windows, and `so` everywhere else.
+  For static libraries, it is `a` everywhere. By convention MSVC
+  static libraries use the `lib` suffix, but we use `a` to avoid a
+  potential name clash with shared libraries which also generate
+  `xxx.lib` import files.
 - `rust_crate_type` specifies the crate type for Rust
   libraries. Defaults to `dylib` for shared libraries and `rlib` for
   static libraries.