Fix argument passing to rake routes

[vipulnsward]

• rake tasks need to be prepended with -- , so as to make sure they are not parsed by rake.
• Fixes routes task to take a note of this and parse arguments accordingly
• Fixed related documentation and usage all around

Fixes #23561

[prathamesh-sonpatki]

r? @kaspth

[kaspth]

Users shouldn't have to do this. We should make --controller work directly.

[vipulnsward]

@kaspth routes has been a rake task before. To still use it that way, we will need to let it remain a rake task, to be backward compatible.
As mentioned rake tasks need the -- switch for custom arguments. So to support this in existing task, we need to use it with this switch.

Other option is we drop the rake task support and convert this to a rails command.

[kaspth]

-g and -c works without --, right?

@dhh how does having to pass -- for long style arguments look to you? E.g. rails routes -- --controller carts

[dhh]

You have to do -- twice? That doesn't work for me at all. May even be worse than passing ENVs like Rake did.

[dhh]

To be more productive. If we can't do long-version nicely, maybe just don't do long version at all? -g and -c seem fine to me.

[kaspth]

Yeah, I was thinking that too. Would be a better compromise than automatically trying to insert -- for instance. @vipulnsward can you update this to remove the long style args?

[vipulnsward]

Ok, updated to remove long arguments. Short args work as expected.

[kaspth]

Can't we have a space between -c and CONTROLLER?

[vipulnsward]

Done.

[kaspth]

Sweet!

[vipulnsward]

🍠