I have to admit, the idea of raising an exception when an inner class or generally a $ sign is found is growing on me. I find it a bit better than obscure options, inner class entities are probably rare-ish and there does not seem to be a huge drawback into asking the user to explicitly use @Table.