Mike Gerwitz

Activist for User Freedom

aboutsummaryrefslogtreecommitdiffstats
blob: 7661888193b7a4de73a6e9c5bf4e64418b0a03e7 (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
<?xml version="1.0"?>
<!--
  Copyright (C) 2018 R-T Specialty, LLC.

  This file is part of tame-core.

  tame-core is free software: you can redistribute it and/or modify it
  under the terms of the GNU General Public License as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.
-->
<package xmlns="http://www.lovullo.com/rater"
         xmlns:c="http://www.lovullo.com/calc"
         xmlns:t="http://www.lovullo.com/rater/apply-template"
         core="true"
         title="Definition Conventions">


  \ref{_naming-convention_} defines a naming convention for a parameter that
    is enforced at compile-time.
  Conventions may have prefixes, suffixes, or both.
  If violated,
    the compiler will abort in error.

  <template name="_naming-convention_"
            desc="Error about naming convention violation">
    <param name="@name@"   desc="Given name" />
    <param name="@prefix@" desc="Required prefix" />
    <param name="@suffix@" desc="Required suffix" />

    <if name="@prefix@">
      <unless name="@name@" prefix="@prefix@">
        <error>
          naming convention violation:
          `<param-value name="@name@" />' must be prefixed with
          `<param-value name="@prefix@" />'.
        </error>
      </unless>
    </if>

    <if name="@suffix@">
      <unless name="@name@" suffix="@suffix@">
        <error>
          naming convention violation:
          `<param-value name="@name@" />' must be suffixed with
          `<param-value name="@suffix@" />'.
        </error>
      </unless>
    </if>
  </template>
</package>