* compare
        - tests

    * complete POD
        - explain "density" parameter

    * mark as "internal" class

= NAME

Span::Int - An object representing a single span, with a simple functional API.

= SYNOPSIS

  use Span::Int;

  $span = new( start => $start, end => $end );

= DESCRIPTION

This class represents a single span.

It is intended mostly for "internal" use by the Span class. For a more complete API, see `Span`.

= CONSTRUCTORS

- `new( start => $start, end => $end )`

- `new( start => $start, end => $end, density => 1 )`

The `start` value must be less than or equal to `end`. There is no checking.

The optional `density` parameter defines the "chunk size". The default density is "1".

= OBJECT METHODS

The following methods are available for Span::Int objects:

- `start()` / `end()`

Return the start or end value.

- size

Return the "size" of the span.

If `start` and `end` are times, then `size` is a duration.

- union

- complement

- intersects

- intersection

- stringify

- compare

= AUTHOR

Flavio S. Glock, <fglock@pucrs.br>

= COPYRIGHT

Copyright (c) 2005, Flavio S. Glock. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Perl6::Pugs

perl -MCPAN -e shell
install Perl6::Pugs