aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2019-06-24 14:02:26 -0700
committerJussi Pakkanen <jpakkane@gmail.com>2019-06-25 00:02:26 +0300
commite2039da5d99dc8fe4255069ef8ab14459766bf2d (patch)
treec6598d9778cd27a8d172ab2eac8ae745deeb986c /docs
parent42bef8d418a8f981889a54e6e4b120f6243e54bc (diff)
downloadmeson-e2039da5d99dc8fe4255069ef8ab14459766bf2d.zip
meson-e2039da5d99dc8fe4255069ef8ab14459766bf2d.tar.gz
meson-e2039da5d99dc8fe4255069ef8ab14459766bf2d.tar.bz2
Split attribute visibility
* c_function_attributes: remove 'protected' from 'visibility' This doesn't exist on macos with the apple compiler, which always causes failures. Fixes #5530 * compilers: Add split visibility checks to has_function_attribute These check for a single visibility at a time, rather than all four at once. This allows for finer grained searches, and should make using these checks safer across operating systems.
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Reference-tables.md12
-rw-r--r--docs/markdown/snippets/split-visibility-attributes.md14
2 files changed, 25 insertions, 1 deletions
diff --git a/docs/markdown/Reference-tables.md b/docs/markdown/Reference-tables.md
index 682e508..84ce06f 100644
--- a/docs/markdown/Reference-tables.md
+++ b/docs/markdown/Reference-tables.md
@@ -182,12 +182,22 @@ which are supported by GCC, Clang, and other compilers.
| returns_nonnull |
| unused |
| used |
-| visibility |
+| visibility* |
+| visibility:default† |
+| visibility:hidden† |
+| visibility:internal† |
+| visibility:protected†|
| warning |
| warn_unused_result |
| weak |
| weakreaf |
+\* *Changed in 0.52.0* the "visibility" target no longer includes
+"protected", which is not present in Apple's clang.
+
+† *New in 0.52.0* These split visibility attributes are preferred to the plain
+"visibility" as they provide narrower checks.
+
### MSVC __declspec
These values are supported using the MSVC style `__declspec` annotation,
diff --git a/docs/markdown/snippets/split-visibility-attributes.md b/docs/markdown/snippets/split-visibility-attributes.md
new file mode 100644
index 0000000..e8cd152
--- /dev/null
+++ b/docs/markdown/snippets/split-visibility-attributes.md
@@ -0,0 +1,14 @@
+## Splitting of Compiler.get_function_attribute('visibility')
+
+On macOS there is no `protected` visibility, which results in the visbility
+check always failing. 0.52.0 introduces two changes to improve this situation:
+
+1. the "visibility" check no longer includes "protected"
+2. a new set of "split" checks are introduced which check for a single
+ attribute instead of all attributes.
+
+These new attributes are:
+* visibility:default
+* visibility:hidden
+* visibility:internal
+* visibility:protected \ No newline at end of file