File Coverage

blib/lib/Acme/MetaSyntactic/compass.pm
Criterion Covered Total %
statement 12 12 100.0
branch n/a
condition n/a
subroutine 4 4 100.0
pod n/a
total 16 16 100.0


line stmt bran cond sub pod time code
1             package Acme::MetaSyntactic::compass;
2              
3 1     1   98984 use strict;
  1         7  
  1         49  
4 1     1   8 use warnings;
  1         2  
  1         60  
5 1     1   5 no warnings 'syntax';
  1         3  
  1         47  
6              
7 1     1   6 use Acme::MetaSyntactic::MultiList;
  1         2  
  1         98  
8             our @ISA = qw [Acme::MetaSyntactic::MultiList];
9              
10             our $VERSION = '2012052202';
11             __PACKAGE__ -> init ();
12              
13             1;
14              
15             =head1 NAME
16              
17             Acme::MetaSyntactic::compass - Boxing the Compass
18              
19             =head1 DESCRIPTION
20              
21             The compass rose can be subdivided into 32 points, using the four
22             cardinal directions (north, east, south, and west) as the basis.
23             The naming of the 32 points is known as I<< boxing the compass >>.
24              
25             In the Middle ages, sailors in the Mediterranean Sea used a system
26             based on eight winds, also subdividing their compass rose into 32 points.
27              
28             This module provides the following sub themes:
29              
30             =over 1
31              
32             =item C<< direction/cardinal >>
33              
34             The four main directions: north, east, south and west.
35              
36             =item C<< direction/ordinal >>
37              
38             The four direction halfway the cardinal directions: northeast, southeast,
39             southwest and northwest.
40              
41             =item C<< direction >> aka C<< winds/principal >>
42              
43             The eight best known compass points; a combination of the two subthemes
44             above.
45              
46             =item C<< winds/half >>
47              
48             The eight compass points found between the principal winds. From
49             north_northeast to south_southwest and back.
50              
51             =item C<< winds/quarter >>
52              
53             The sixteen compass points found between the half winds and the quarter
54             winds. From north_by_east to south_by_west and back.
55              
56             =item C<< winds >>
57              
58             All 32 compass points.
59              
60             =item C<< traditional/base >>
61              
62             The eight winds used in the Middle ages: Tramontana, Greco, Levante, Scirocco,
63             Ostro, Libeccio, Ponente, and Maestro.
64              
65             =item C<< traditional/half >>
66              
67             The eight winds that fall halfway the base winds. From Greco_Tramontana to
68             Ostro_Libeccio and back.
69              
70             =item C<< traditional/quarter >>
71              
72             The sixteen winds that fall between the half winds and the base winds.
73             From Quarto_di_Tramontana_verso_Greco to Quarto_di_Ostro_verso_Libeccio
74             and back.
75              
76             =item C<< traditional >>
77              
78             All 32 traditional compass points.
79              
80             =back
81              
82             This module is part of the set of C<< Acme::MetaSyntactic >> themes
83             found in the C<< Acme::MetaSyntactic::Themes::Abigail >> package.
84              
85             =head1 SEE ALSO
86              
87             L, L.
88              
89             =head1 AUTHOR
90              
91             Abigail, L<< mailto:cpan@abigail.be >>.
92              
93             =head1 COPYRIGHT and LICENSE
94              
95             Copyright (C) 2012 by Abigail.
96              
97             Permission is hereby granted, free of charge, to any person obtaining a
98             copy of this software and associated documentation files (the "Software"),
99             to deal in the Software without restriction, including without limitation
100             the rights to use, copy, modify, merge, publish, distribute, sublicense,
101             and/or sell copies of the Software, and to permit persons to whom the
102             Software is furnished to do so, subject to the following conditions:
103              
104             The above copyright notice and this permission notice shall be included
105             in all copies or substantial portions of the Software.
106              
107             THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
108             IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
109             FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
110             THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
111             WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
112             OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
113             THE SOFTWARE.
114              
115              
116             =cut
117              
118             __DATA__