Merge pull request #208 from wp-cli/copilot/improve-precise-flag-description

Author: swissspidy

src/Search_Replace_Command.php

@@ -183,8 +183,10 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 * specify multiple columns.
 	 *
 	 * [--precise]
-	 * : Force the use of PHP (instead of SQL) which is more thorough,
-	 * but slower.
+	 * : Force the use of PHP (instead of SQL) for all columns. By default, the command
+	 * uses fast SQL queries, but automatically switches to PHP for columns containing
+	 * serialized data. Use this flag to ensure PHP processes all columns, which is
+	 * slower but handles complex serialized data structures more reliably.
 	 *
 	 * [--recurse-objects]
 	 * : Enable recursing into objects to replace strings. Defaults to true;
@@ -248,6 +250,9 @@ class Search_Replace_Command extends WP_CLI_Command {
 	 *     # Search/replace to a SQL file without transforming the database
 	 *     $ wp search-replace foo bar --export=database.sql
 	 *
+	 *     # Use precise mode for complex serialized data
+	 *     $ wp search-replace 'oldurl.com' 'newurl.com' --precise
+	 *
 	 *     # Bash script: Search/replace production to development url (multisite compatible)
 	 *     #!/bin/bash
 	 *     if $(wp --url=http://example.com core is-installed --network); then