Add new function to inline a list of calls in a goto_program

[remi-delmas-3000]

This PR a new function in goto_inline.h and a new method in goto_inline_class.h that
allows to inline a specified set of calls inside a target goto program.

The use case for this is the inlining of function calls in short snippets of goto programs generated during function and loop contract instrumentation, that contain dynamic frame initialisation statements or havoc statements.

The existing inlining functions only allow to inline all calls found in the whole body of a goto function, and do not allow to inline calls inside a small program snippet like needed for contract instrumentation.

The new functions will be exercised/tested as part of the new loop contracts PR #7541.

• Each commit message has a non-empty body, explaining why the change was made.
• Methods or procedures I have added are documented, following the guidelines provided in CODING_STANDARD.md.
• The feature or user visible behaviour I have added or modified has been documented in the User Guide in doc/cprover-manual/
• Regression or unit tests are included, or existing tests cover the modified code (in this case I have detailed which ones those are in the commit message).
• My commit message includes data points confirming performance improvements (if claimed).
• My PR is restricted to a single feature or bugfix.
• White-space or formatting changes outside the feature-related changed lines are in commits of their own.

[martin-cs]

Seems reasonable enough. It feels like the whole goto_inline infrastructure could do with a tidy up and refactor but that's out of scope for this PR. I get what you are saying about testing but would it be useful to have a unit test for this?

[TGWDB]

Seems reasonable enough. It feels like the whole goto_inline infrastructure could do with a tidy up and refactor but that's out of scope for this PR. I get what you are saying about testing but would it be useful to have a unit test for this?

Second the desire for some kind of unit testing.

[tautschnig]

Approving module required Doxygen fixes (see CI job).

[remi-delmas-3000]

@peterschrammel @TGWDB I added a unit test for the new function.