Improve documentation for wp-includes/option.php

[leogermani]

In the update_option documentation, since the $autoload parameter is added, the sentence below is incorrect:

If the option does not exist, then the option will be added with the option value, with an $autoload value of 'yes'.

Actually it will be added with whatever was passed to the $autoload parameter, 'yes' being only the default value.

This ticket/patch proposes a new text for the function description and for the documentation of the $autoload argument.

[desrosj]

Thanks for this, @leogermani. Are you interested in creating a patch?

[leogermani]

Here it is:

​https://github.com/leogermani/WordPress/pull/1

This is the first time I submit a patch with a pull request (I've heard it's possible). Do I need to do anything else?

[leogermani]

Apparently I was wrong and I still need to manually upload the patch.

[SergeyBiryukov]

The current $autoload parameter description seems clear enough:

For existing options, $autoload can only be updated using update_option() if $value is also changed. Accepts 'yes'|true to enable or 'no'|false to disable. For non-existent options, the default value is 'yes'. Default null.

Related: [31628], [31640].

Let's just remove the inaccurate statement about the 'yes' value for new options.

[SergeyBiryukov]

In 47373:

Docs: In update_option(), remove an inaccurate statement about the $autoload value for new options.

If the option does not exist, it will be created with whatever was passed to the $autoload parameter, 'yes' being only the default value.

Props leogermani.
Fixes #48357.