What is the clearest way to deprecate a package in Java?

Question

I\'m working on a new codebase and migrating the system to a new framework.

There are a number of packages that I would like to deprecate, just to make it very clear

Answer 1

Use AspectJ. Create an Aspect that issues a compiler warning when the package is used:

public aspect DeprecationAspect{

    declare warning :
        call(* foo.bar..*(..)) : "Package foo.bar is deprecated";

}

(You can easily add AspectJ to your build if you use ant or maven)