NAME

calx - Display calendar

VERSION

This document describes version 0.002 of calx (from Perl distribution App-calx), released on 2019-02-13.

SYNOPSIS

# show calendar for the current month, with dates from Calendar::Dates::ID::Holiday
% calx -c ID::Holiday

# show calendar for the current month, with dates from Calendar::Dates::ID::Holiday and Calendar::Dates::SG::Holiday
% calx -c ID::Holiday -c SD::Holiday

# show calendar for the whole year
% calx 2019 -c ID::Holiday

# show calendar for a certain month and year
% calx 2 2019 -c ID::Holiday

DESCRIPTION

This command provides a subset of cal functionality for displaying ASCII calendar on the command-line. It currently starts the week at Monday and highlights (and lists) dates from one or more Calendar::Dates::* modules.

OPTIONS

% calx [opts] [[month] year]

Most options follow cal. Not all options from cal are supported/recognized. Some options are specific to calx.

-1

Show a single month of calendar (the default).

-3

Show three months of calendar (previous, current, next).

-h

Turn off highlighting of today.

-y

Show one year (12 months) of calendar (the default if only year is specified).

-c MODULE+

Get dates from a Calendar::Dates module (value is name of module without the "Calendar::Dates::" prefix). Can be specified multiple times.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-calx.

SOURCE

Source repository is at https://github.com/perlancar/perl-App-calx.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-calx

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

cal Unix utility

Calendar::Dates

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019 by perlancar@cpan.org.

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