devela 0.28.0

A development substrate of coherence.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

// devela::yard::alias
//
//! Defines maintenance aliases for item attributes.
//

crate::macro_apply_alias! {
    /* docs */

    /// Shows a cfg tree on nightly documentation.
    pub __doc_show($cfg_tree:meta) = #[cfg_attr(nightly_doc, doc(cfg($cfg_tree)))];

    /// Hides a cfg item from nightly `auto_cfg` documentation.
    //
    // <https://rust-lang.github.io/rfcs/3631-rustdoc-cfgs-handling.html>
    //
    // NOTE: `doc(auto_cfg(hide(…)))` may fail when emitted directly beside the
    // `#[cfg(…)]` from the same alias expansion. Route it through `macro_apply`
    // so rustdoc observes the hide directive as a separate attribute expansion.
    pub __doc_hide($cfg_item:meta) = #[cfg_attr(nightly_doc, doc(auto_cfg(hide($cfg_item))))];

    /* safety */

    /// Compiles an item for the safe/default implementation path.
    pub __cfg_item_safe($safe:literal, $unsafe:literal) =
        #[cfg(any(feature = $safe, not(feature = $unsafe)))];
    /// Compiles an item for the explicit unsafe implementation path.
    pub __cfg_item_unsafe($safe:literal, $unsafe:literal) =
        #[cfg(all(not(feature = $safe), feature = $unsafe))];

    /// Compiles an item for the safe/default path, and hides the safety features from docs.
    pub __cfg_item_safe_hide($safe:literal, $unsafe:literal) =
        #[cfg(any(feature = $safe, not(feature = $unsafe)))]
        #[$crate::macro_apply($crate::__doc_hide(feature = $unsafe))]
        #[$crate::macro_apply($crate::__doc_hide(feature = $safe))];
    /// Compiles an item for the explicit unsafe path, and hides the safety features from docs.
    pub __cfg_item_unsafe_hide($safe:literal, $unsafe:literal) =
        #[cfg(all(not(feature = $safe), feature = $unsafe))]
        #[$crate::macro_apply($crate::__doc_hide(feature = $unsafe))]
        #[$crate::macro_apply($crate::__doc_hide(feature = $safe))];

    /// Compiles an item for the explicit unsafe path, and shows the unsafe features in docs.
    pub __cfg_item_unsafe_show($safe:literal, $unsafe:literal) =
        #[cfg(all(not(feature = $safe), feature = $unsafe))]
        #[$crate::macro_apply($crate::__doc_show(feature = $unsafe))];

    /* ffi */

    pub(crate) _js_safe_ffi = #[cfg(any(not(feature = "unsafe_ffi"), windows))];
    pub(crate) _js_unsafe_ffi = #[cfg(all(feature = "unsafe_ffi", not(windows)))];
    pub(crate) _js_unsafe_ffi_doc =
        #[cfg(all(feature = "unsafe_ffi", not(windows)))]
        #[$crate::macro_apply($crate::__doc_show(feature = "unsafe_ffi"))];

    /* linux & std */

    // unsafe_syscall && !miri
    pub(crate) _unsafe_syscall_not_miri = #[cfg(all(feature = "unsafe_syscall", not(miri)))];

    // (_linux_abi && unsafe_syscall && !miri && supported_linux_arch)
    pub(crate) _linux_syscall = #[cfg(
        all(feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux)
    )];

    // !(_linux_abi && unsafe_syscall && !miri && supported_linux_arch)
    pub(crate) _not_linux_syscall = #[cfg(not(
        all(feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux)
    ))];

    // !std && (_linux_abi && unsafe_syscall && !miri && supported_linux_arch)
    pub(crate) _linux_syscall_not_std = #[cfg(all(
        not(feature = "std"),
        feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux
    ))];

    // std || (_linux_abi && unsafe_syscall && !miri && supported_linux_arch)
    pub(crate) _std_or_linux_syscall = #[cfg(any(
        feature = "std",
        all(feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux)
    ))];

    // std && !(_linux_abi && unsafe_syscall && !miri && supported_linux_arch)
    pub(crate) _std_not_linux_syscall = #[cfg(all(
        feature = "std",
        not(all(
            feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux
        ))
    ))];

    // !(std || (_linux_abi && unsafe_syscall && !miri && supported_linux_arch))
    pub(crate) _not_std_or_linux_syscall = #[cfg(not(any(
        feature = "std",
        all(feature = "_linux_abi", feature = "unsafe_syscall", not(miri), any_target_arch_linux)
    )))];
}