From ba7b50a1045e6a57710137dd856e031ca5e96566 Mon Sep 17 00:00:00 2001 From: Jon Turney Date: Sat, 11 Apr 2020 13:56:51 +0100 Subject: [PATCH] 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. --- docs/markdown/Reference-manual.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index ab7605dda..b3792e734 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -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.