@@ -41,19 +41,64 @@ public function migrate( $args, $assoc_args ) {
4141 * ## OPTIONS
4242 *
4343 * <profile>
44- * : ID of the profile to use for the migration.
44+ * : Name of the new profile to create
45+ *
46+ * [--remote-wordpress=<value>]
47+ * : Remote WordPress location to migrate database from.
48+ *
49+ * This is the first part the whole token you are told to copy from
50+ * the /wp-admin/ backend of Migrate DB under Settings, before the newline.
51+ *
52+ * [--token=<value>]
53+ * : Token from WordPress location to migrate database from.
54+ *
55+ * This is the second part the whole token you are told to copy from
56+ * the /wp-admin/ backend of Migrate DB under Settings, after the newline.
57+ *
58+ * [--migrate-tables=<CSV of tables to migrate>]
59+ * : Comma separated list of tables to migrate from the remote WordPress to locally.
60+ *
61+ * If you set this to `outlandish` it will migrate the tables we would typically expect from WordPress.
62+ *
63+ * [--exclude-post-types=<CSV of tables to migrate>]
64+ * : Comma separated list of post types to exclude from migrate from the remote WordPress to locally.
65+ *
66+ * [--<WP-Migrate-Profile-Option-As-Kebab-Case>=<true|false>]
67+ * : Set any Migrate DB option in this profile.
4568 *
4669 * ## EXAMPLES
4770 *
48- * wp wpsdb create-profile 1
71+ * wp wpsdb create-profile Staging --remote-wordpress https://wordpress.example \
72+ * --token CUOu2t5kaVienGLUxAGhN4bvWh1FXqJA
73+ *
74+ * Setup a profile with the defaults called Staging.
75+ *
76+ *
77+ * wp wpsdb create-profile Staging --remote-wordpress https://wordpress.example \
78+ * --token CUOu2t5kaVienGLUxAGhN4bvWh1FXqJA \
79+ * --migrate-tables=wp_posts
80+ *
81+ * Setup a profile with the defaults called Staging that only migrates the wp_posts table.
82+ *
83+ *
84+ * wp wpsdb create-profile Staging --remote-wordpress https://wordpress.example \
85+ * --token CUOu2t5kaVienGLUxAGhN4bvWh1FXqJA \
86+ * --exclude-post-types=page
87+ *
88+ * Setup a profile with the defaults called Staging that excludes WordPress page post types.
89+ *
90+ *
91+ * wp wpsdb create-profile Staging --remote-wordpress https://wordpress.example \
92+ * --token CUOu2t5kaVienGLUxAGhN4bvWh1FXqJA \
93+ * --create_backup=true
94+ *
95+ * Setup a profile with the defaults called Staging that creates backups when migrations are run.
4996 *
5097 * @synopsis <profile>
5198 *
5299 * @since 1.0
100+ * @subcommand create-profile
53101 */
54- /**
55- * @subcommand create-profile
56- */
57102public function create_profile ($ args$ assoc_args
58103$ name$ args0 ];
59104