view release on metacpan or  search on metacpan

lib/Acme/MetaSyntactic/compass.pm  view on Meta::CPAN

package Acme::MetaSyntactic::compass;

use strict;
use warnings;
no  warnings 'syntax';

use Acme::MetaSyntactic::MultiList;
our @ISA = qw [Acme::MetaSyntactic::MultiList];

our $VERSION = '2012052202';
__PACKAGE__ -> init ();

1;

=head1 NAME

Acme::MetaSyntactic::compass - Boxing the Compass

=head1 DESCRIPTION

The compass rose can be subdivided into 32 points, using the four
cardinal directions (north, east, south, and west) as the basis.
The naming of the 32 points is known as I<< boxing the compass >>.

In the Middle ages, sailors in the Mediterranean Sea used a system
based on eight winds, also subdividing their compass rose into 32 points.

This module provides the following sub themes:

=over 1

=item C<< direction/cardinal >>

The four main directions: north, east, south and west.

=item C<< direction/ordinal >>

The four direction halfway the cardinal directions: northeast, southeast,
southwest and northwest.

=item C<< direction >> aka C<< winds/principal >>

The eight best known compass points; a combination of the two subthemes
above.

=item C<< winds/half >>

The eight compass points found between the principal winds. From 
north_northeast to south_southwest and back.

=item C<< winds/quarter >>

The sixteen compass points found between the half winds and the quarter
winds. From north_by_east to south_by_west and back.

=item C<< winds >>

All 32 compass points.

=item C<< traditional/base >>

The eight winds used in the Middle ages: Tramontana, Greco, Levante, Scirocco,
Ostro, Libeccio, Ponente, and Maestro.

=item C<< traditional/half >>

The eight winds that fall halfway the base winds. From Greco_Tramontana to
Ostro_Libeccio and back.

=item C<< traditional/quarter >>

The sixteen winds that fall between the half winds and the base winds.
From Quarto_di_Tramontana_verso_Greco to Quarto_di_Ostro_verso_Libeccio
and back.

=item C<< traditional >>

All 32 traditional compass points.

=back

This module is part of the set of C<< Acme::MetaSyntactic >> themes
found in the C<< Acme::MetaSyntactic::Themes::Abigail >> package.

=head1 SEE ALSO

L<Acme::MetaSyntactic>, L<Acme::MetaSyntactic::MultiList>.

=head1 AUTHOR

Abigail, L<< mailto:cpan@abigail.be >>.

=head1 COPYRIGHT and LICENSE

Copyright (C) 2012 by Abigail.

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),   
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions: