Explain the purpose of the --precise flag

[johnbillion]

The description of the --precise flag suggests that default results are not precise. Is this the case?

I think the description of this flag needs to be improved, and possibly an example added to the Examples section demonstrating when it should be used.

[schlessera]

My best guess is that some occurrences of the pattern to search might be hidden by escaping or serialization, and you'd need to iterate over the dataset with PHP and transform the data before looking for the pattern to match them. A pure SQL query will miss these.

[roborourke]

Could it be aliased to --use-php instead?

[tomjn]

Current doc for easy reference:

https://github.com/wp-cli/search-replace-command/blob/master/src/Search_Replace_Command.php#L90-L92

	 * [--precise]
	 * : Force the use of PHP (instead of SQL) which is more thorough,
	 * but slower.

It's directly read into the php_only variable:

		$php_only              = \WP_CLI\Utils\get_flag_value( $assoc_args, 'precise' );

https://github.com/wp-cli/search-replace-command/blob/master/src/Search_Replace_Command.php#L171