Merge pull request #5 from wp-cli/3927-docs

Further clarify accepted args for `wp user list`

Author: schlessera

src/User_Command.php

@@ -47,13 +47,16 @@ public function __construct() {
 	/**
 	 * List users.
 	 *
+	 * Display WordPress users based on all arguments supported by
+	 * [WP_User_Query()](https://developer.wordpress.org/reference/classes/wp_user_query/prepare_query/).
+	 *
 	 * ## OPTIONS
 	 *
 	 * [--role=<role>]
 	 * : Only display users with a certain role.
 	 *
 	 * [--<field>=<value>]
-	 * : Control output by one or more arguments of get_users().
+	 * : Control output by one or more arguments of WP_User_Query().
 	 *
 	 * [--network]
 	 * : List all users in the network for multisite.
@@ -118,6 +121,9 @@ public function __construct() {
 	 *     $ wp user list --fields=display_name,user_email --format=json
 	 *     [{"display_name":"supervisor","user_email":"[email protected]"}]
 	 *
+	 *     # List users ordered by the 'last_activity' meta value.
+	 *     $ wp user list --meta_key=last_activity --orderby=meta_value_num
+	 *
 	 * @subcommand list
 	 */
 	public function list_( $args, $assoc_args ) {