NAME
DBIO::Deprecated - Registry of CPAN redirect stubs for renamed/retired DBIO modules
VERSION
version 0.900001
DESCRIPTION
DBIO::Deprecated is the permanent home for "tombstone" redirect stub modules: when a DBIO module gets renamed or retired, the old module name stays indexed on PAUSE forever against the last release that shipped it -- PAUSE has no delete. Anyone still running cpanm Old::Module::Name would keep installing that stale, superseded code with no hint a replacement exists.
This is not only a cross-distribution problem. PAUSE indexes per module name, not per distribution: it resolves each module name to whichever shipped release -- of any distribution, including a later release of the same one -- carries the highest $VERSION for that name. A module that moves to a different CPAN distribution orphans its old name exactly the same way a module that is renamed or deleted within its own distribution's later releases does: either way, the old name simply stops appearing in anything newer, and PAUSE keeps pointing at the last release that had it.
This distribution fixes that with the standard CPAN redirect-takeover pattern: it ships a small stub package under the OLD module name, with an explicit $VERSION set strictly higher than the last CPAN release that shipped that name. PAUSE then indexes this distribution as canonical for the old name. The stub does nothing at runtime except die immediately on load -- naming the replacement module and distribution when there is one, or saying plainly that the module was removed with no replacement -- so cpanm Old::Module::Name (or a cpanfile pinning it) now installs a clear, actionable message instead of silently reinstalling dead code.
This dist itself (DBIO::Deprecated, this module) has no runtime behaviour of its own -- it is a documentation landing page and the dzil main module. Each tombstone module is self-contained and carries no dependency on DBIO core.
For the step-by-step procedure to add a new tombstone when a future rename or removal happens -- including how to audit the family for orphaned module names -- see the dbio-deprecated skill (.claude/skills/dbio-deprecated/SKILL.md in this repo; packaged into the sharedir at build time).
CURRENT TOMBSTONES
Old module Redirects to New distribution
--------------------------------------------------------------------------------------------------------------------------
From dbio-mysql-ev (old dist DBIO-MySQL-Async, last released 0.900000):
DBIO::MySQL::Async DBIO::MySQL::EV DBIO-MySQL-EV
DBIO::MySQL::Async::Pool DBIO::MySQL::EV::Pool DBIO-MySQL-EV
DBIO::MySQL::Async::QueryExecutor DBIO::MySQL::EV::QueryExecutor DBIO-MySQL-EV
DBIO::MySQL::Async::Storage DBIO::MySQL::EV::Storage DBIO-MySQL-EV
DBIO::MySQL::Async::TransactionContext DBIO::MySQL::EV::TransactionContext DBIO-MySQL-EV
From dbio-postgresql-ev (old dist DBIO-PostgreSQL-Async, last released 0.900000):
DBIO::PostgreSQL::Async DBIO::PostgreSQL::EV DBIO-PostgreSQL-EV
DBIO::PostgreSQL::Async::ConnectInfo DBIO::PostgreSQL::EV::ConnectInfo DBIO-PostgreSQL-EV
DBIO::PostgreSQL::Async::Pool DBIO::PostgreSQL::EV::Pool DBIO-PostgreSQL-EV
DBIO::PostgreSQL::Async::Storage DBIO::PostgreSQL::EV::Storage DBIO-PostgreSQL-EV
DBIO::PostgreSQL::Async::TransactionContext DBIO::PostgreSQL::EV::TransactionContext DBIO-PostgreSQL-EV
From dbio core (dist DBIO, last released with these names 0.900000):
DBIO::Test::Future DBIO::Future::Immediate DBIO
DBIO::StartupCheck (removed, no replacement) --
From dbio-dzil (dist Dist-Zilla-PluginBundle-DBIO, same-distribution rename, last released 0.900001):
Dist::Zilla::Plugin::DBIO::SetCopyrightHolder Dist::Zilla::Plugin::DBIO::SetMeta Dist-Zilla-PluginBundle-DBIOSEE ALSO
DBIO::MySQL::EV, DBIO::PostgreSQL::EV, DBIO::Future::Immediate, Dist::Zilla::Plugin::DBIO::SetMeta, DBIO
AUTHOR
DBIO Authors
COPYRIGHT AND LICENSE
Copyright (C) 2026 DBIO Authors
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.