On Sun, 2014-01-05 at 23:13 -0800, Adam Williamson wrote:
I don't see what needs elaborating. I'm not aware that the 11th commandment is "Every Subcommand Must Be Documented, Even Ones You Just Put In So People Still Using Syntax From The Old Tool You're Replacing Won't Have A Problem". If that's the only reason a synonym of a documented subcommand exists, what's the point of documenting it? Anyone who needs it doesn't need documentation to find it - that's the *point*, if they were going to read the documentation, they'd know the *new* subcommand - and anyone who reads the documentation doesn't stand to gain anything from learning that a subcommand has a synonym for backwards compatibility purposes. So, why go to the trouble?
One thing I find a bit inconsistent, though, is that the manpage documents "dnf erase", but "dnf group remove". :) Picking one verb or the other and sticking with it seems advised.