We should just show the preferred form in the examples.  This can come later, when we have documentation of the attributes in our commands.