After further consideration and discussion, it seems that including all the related information is more important than not reducing the prominence in the synopsis of the subcommand that is described in the
The fix for this issue requires the following changes to the man page for each asadmin subcommand:
- In Synopsis, prefix the subcommand with asadmin [asadmin-options] just like the usage statement.
- In Options, add an explain for asadmin-options that cross-refers to asadmin(1M) and suggests running asadmin help as an alternative.
- In See Also, move the cross-reference to asadmin(1M) to above the references to section 1 man pages.