##========================================================================
## POD DOCUMENTATION, auto-generated by podextract.perl

##========================================================================
## NAME
=pod

=head1 NAME

DiaColloDB::Upgrade::v0_10_x2t - DiaColloDB utilities: auto-magic upgrade: v0.10.x: x-tuples (+date) to t-tuples (-date)

=cut

##========================================================================
## SYNOPSIS
=pod

=head1 SYNOPSIS

 ##========================================================================
 ## PRELIMINARIES
 
 use DiaColloDB::Upgrade::v0_10_x2t;
 
 ##========================================================================
 ## API
 
 $version = $CLASS_OR_OBJECT->toversion();
 $bool    = $up->upgrade();
 
 ##========================================================================
 ## Backup & Revert
 
 $bool  = $up->backup();
 @files = $up->revert_created();
 @files = $up->revert_updated();
 

=cut

##========================================================================
## DESCRIPTION
=pod

=head1 DESCRIPTION

DiaColloDB::Upgrade::v0_10_x2t
provides a L<DiaColloDB::Upgrade|DiaColloDB::Upgrade>-compliant
package for upgrading a
L<DiaColloDB|DiaColloDB> database directory in-place.

Upgrade actions performed:

=over 4

=item *

converts date-inclusive "x-tuple" enum C<xenum>
to date-free attributes-only term-tuple ("t-tuple") enum C<tenum>.

=item *

maps attribute multimap target IDs from "x-tuples" to "t-tuples".

=item *

updates db header pack-template keys ("pack_x*" -E<gt> "pack_t*")

=item *

updates native relation DBs C<xf>, C<cof>.

=back

=cut

##----------------------------------------------------------------
## DESCRIPTION: DiaColloDB::Upgrade::v0_10_x2t: API
=pod

=head2 API

=over 4

=item toversion

 $version = $CLASS_OR_OBJECT->toversion();

Returns default target version;
here C<"0.10.000">.

=item upgrade

 $bool = $up->upgrade();

Performs upgrade in-place on the local L<DiaColloDB|DiaColloDB> index in C<$up-E<gt>{dbdir}>, returns true on success.

=back

=cut

##----------------------------------------------------------------
## DESCRIPTION: DiaColloDB::Upgrade::v0_04_dlimits: Backups & Rollback
=pod

=head2 Backups & Rollback

=over 4

=item backup

 $bool = $up->backup();

Backup any files we expect to change during L<upgrade|/upgrade>() to C<$up-E<gt>L<backupdir|DiaColloDB::Upgrade::Base/backupdir>()>.

=item revert_created

 @files = $up->revert_created();

Returns list of files created by this upgrade, for use with default L<DiaColloDB::Upgrade::Base::revert|DiaColloDB::Upgrade::Base/revert>().

=item revert_updated

 @files = $up->revert_updated();

Returns list of files updated by this upgrade, for use with default L<DiaColloDB::Upgrade::Base::revert|DiaColloDB::Upgrade::Base/revert>().

=back

=cut

##========================================================================
## END POD DOCUMENTATION, auto-generated by podextract.perl

##======================================================================
## Footer
##======================================================================
=pod

=head1 AUTHOR

Bryan Jurish E<lt>moocow@cpan.orgE<gt>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Bryan Jurish

This package is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.14.2 or,
at your option, any later version of Perl 5 you may have available.

=head1 SEE ALSO

L<dcdb-upgrade.perl(1)|dcdb-ugprade.perl>,
L<DiaColloDB::Upgrade::Base(3pm)|DiaColloDB::Upgrade::Base>,
L<DiaColloDB::Upgrade(3pm)|DiaColloDB::Upgrade>,
L<DiaColloDB(3pm)|DiaColloDB>,
L<perl(1)|perl>,
...


=cut
