Refine documentation of default name_prefix
Refine documentation of the default name_prefix, so people don't get the
impression they can write logic which uses 'lib' as the default, when
they should be defaulting to '[]', to let us take care of the
complexities.
@@ -1191,9 +1191,9 @@ The keyword arguments for this are the same as for
- `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 shared libraries where it is omitted to follow
- convention.
+ libraries). By default this is `lib` on all platforms and compilers,
+ except for MSVC shared libraries where it is omitted to follow
+ convention, and Cygwin shared libraries where it is `cyg`.
- `name_suffix` the string that will be used as the suffix for the
target output filename by overriding the default (see also:
[executable()](#executable)). By default, for shared libraries this
@@ -1201,7 +1201,7 @@ The keyword arguments for this are the same as for
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.
+ import libraries with a `lib` suffix.
- `rust_crate_type` specifies the crate type for Rust
libraries. Defaults to `dylib` for shared libraries and `rlib` for
static libraries.
