From 90521dd63913aafc08eabbe2f4f8e0806cfeecb9 Mon Sep 17 00:00:00 2001 From: pchintalapudi <34727397+pchintalapudi@users.noreply.github.com> Date: Mon, 19 Jun 2023 03:54:21 +0000 Subject: [PATCH] Emphasize the default base of multiversioning in the documentation, and discourage the implicit default base (#50211) --- doc/src/devdocs/sysimg.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/src/devdocs/sysimg.md b/doc/src/devdocs/sysimg.md index 6706e30ce97b1..40fcd3fa602f8 100644 --- a/doc/src/devdocs/sysimg.md +++ b/doc/src/devdocs/sysimg.md @@ -42,6 +42,9 @@ All features supported by LLVM are supported and a feature can be disabled with (`+` prefix is also allowed and ignored to be consistent with LLVM syntax). Additionally, a few special features are supported to control the function cloning behavior. +!!! note + It is good practice to specify either `clone_all` or `base()` for every target apart from the first one. This makes it explicit which targets have all functions cloned, and which targets are based on other targets. If this is not done, the default behavior is to not clone every function, and to use the first target's function definition as the fallback when not cloning a function. + 1. `clone_all` By default, only functions that are the most likely to benefit from