aboutsummaryrefslogtreecommitdiff
path: root/paludis/dep_spec_annotations.se
blob: 82f67d527550553d5aaa51bd16596f2df5715f68 (plain)
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
#!/usr/bin/env bash
# vim: set sw=4 sts=4 et ft=sh :

make_enum_DepSpecAnnotationRole()
{
    prefix dsar

    key dsar_none                             "No particular role"

    key dsar_general_description              "A description"
    key dsar_general_url                      "A url"
    key dsar_general_note                     "A note"
    key dsar_general_lang                     "A language"
    key dsar_general_date                     "A date"
    key dsar_general_author                   "An author"
    key dsar_general_token                    "A token"
    key dsar_general_defined_in               "Defined in"

    # update find_blocker_role_in_annotations when adding here
    key dsar_blocker_manual                   "Blocker, resolve manually"
    key dsar_blocker_uninstall_blocked_after  "Blocker, uninstall blocked after"
    key dsar_blocker_uninstall_blocked_before "Blocker, uninstall blocked before"
    key dsar_blocker_upgrade_blocked_before   "Blocker, upgrade blocked before"
    key dsar_blocker_weak                     "Blocker, weak (generally implicit)"
    key dsar_blocker_strong                   "Blocker, strong (generally implicit)"

    key dsar_myoptions_requires               "MYOPTIONS, requires"
    key dsar_myoptions_n_at_least_one         "MYOPTIONS, at least one"
    key dsar_myoptions_n_at_most_one          "MYOPTIONS, at most one"
    key dsar_myoptions_n_exactly_one          "MYOPTIONS, exactly one"

    key dsar_suggestions_group_name           "Group name for suggestions"

    want_destringify

    doxygen_comment << "END"
        /**
         * Role for a DepSpecAnnotation.
         *
         * \ingroup g_dep_spec
         * \since 0.58
         */
END
}

make_enum_DepSpecAnnotationKind()
{
    prefix dsak

    key dsak_literal         "Specified literally"
    key dsak_synthetic       "Synthetic (e.g. for 0ish blockers)"
    key dsak_expanded        "Expanded from a *key"
    key dsak_expandable      "This is a *key"

    want_destringify

    doxygen_comment << "END"
        /**
         * What kind of annotation a DepSpecAnnotation is.
         *
         * Note that dsas_expandable annotations should generally be ignored
         * for logic purposes, and that dsas_expanded should generally be
         * ignored for display purposes.
         *
         * \ingroup g_dep_spec
         * \since 0.59
         */
END
}