i'm currently in the process of splitting a package i'm co-maintaining
into several sub-packages.
unfortunately i experience some problems with test upgrades, which i
would like to solve.
the original package "gem" has been split into "gem" and "gem-doc".
"gem-doc" contains documentation, that is also of (limited) use if the
main package "gem" is not installed.
i read [1] and tried to follow it closely, so i end up with a
debian/controls file:
<snip>
Package: gem
Recommends: gem-doc
[...]
Package: gem-doc
Section: doc
Recommends: gem
Replaces: gem (<< 0.93)
Breaks: gem (<< 0.93)
</snip>
obviously, 0.93 is the new version with the split packages (the old
one is 0.92)