Creating RPM with Conflicting Files

[Florian Festi]

You can split the new package into two parts the main and the doc 
package. Then make the main package require the *file* in question. The 
doc package would contain the doc files but conflict with the old package.

So if the old package is not installed the doc package is required 
otherwise not. You could also just make the doc package optional. But 
I'd still advise to add a manual conflict to the old package so the 
depsolver can issue an error early.

Florian