Add field_formatter_settings module to backdrop_merged_modules()

[quicksketch]

Description of the bug
Follow-up to #1376, where Field Formatter Settings was merged into core.

We need to uninstall the contrib version of Field Formatter Settings when upgrading to Backdrop 1.13.0

Steps To Reproduce
To reproduce the behavior:

1. Install Backdrop 1.12.6
2. Install https://github.com/backdrop-contrib/field_formatter_settings via UI or manually.
3. Upgrade to Backdrop 1.x latest (or Backdrop 1.13.0-preview), be sure to run update.php
4. Manage fields on a content types.

Actual behavior

• You may get function already defined error for field_formatter_settings_get_instance_display_settings().

Expected behavior

• Field Formatter Settings module should be uninstalled during the update and should not be possible to re-enable in the UI.

We should also add @since to all the new functions added in https://github.com/backdrop/backdrop/pull/2493/files. Sometimes that difficult to do during development because we don't know when the feature will be merged, so let's use this opportunity to include @since 1.13.0 now that we know it's version.

---

PR: backdrop/backdrop#2644

[opi]

Should we copy/paste https://github.com/backdrop/backdrop/pull/2564/files (Issue #3485: Add options_element in backdrop_merged_modules()) ?

I left a comment on this merged PR: https://github.com/backdrop/backdrop/pull/2564/files#r280312750

[quicksketch]

Yeah, just copying what we have before is probably what we want here. As with Options Element, this should probably go in field.install.

[opi]

PR backdrop/backdrop#2644 roughly tested with following steps

cd path/to/backdrop
git checkout 1.12.6
drush dl field_formatter_settings && drush en -y field_formatter_settings
git checkout opi/3742-add-field_formatter_settings-to-backdrop_merged_modules
drush updb
drush pm-list | grep field_formatter_settings

The last drush command shows that field_formatter_settings contrib module is now disabled.

Note the this PR has a separated commit with documentation update, about adding @since info to new hooks and function.

[herbdool]

RTBC

[laryn]

FYI I've made a new release of the contrib version that has a dependency on system being less than 1.13. (dependencies[] = system (<1.13))

[opi]

Thank you both ❤️

[klonos]

...wondering if it's worth moving the code we are reusing into a backdrop_remove_merged_modules() function, and then calling that from the update hooks (we are going to be merging more modules as time goes by - and repetition of the very exact code hurts my eyes 😅).

[quicksketch]

That's a great idea @klonos! We have a set of utility-like functions in includes/update.inc that includes things like update_variable_get() and update_module_enable(). Creating an update_module_uninstall() or even update_module_uninstall_merged_module() could get rid of redundancy.

[quicksketch]

I don't want to hold this up, so we can consolidate those similar places in a follow-up issue.

I've merged backdrop/backdrop#2644 into 1.x for 1.13.0 (and the preview release). Thanks @opi, @herbdool, @laryn, and @klonos!

[klonos]

That's a great idea @klonos! ...I don't want to hold this up

#3760 😉