Tag getSubmittedValue as externally supported

diff --git a/CRM/Core/Form.php b/CRM/Core/Form.php
index 07e15afea710258f2d75119cc0381c301e232773..66a1622f2a5288cc51606a70ac9e188a553fb3c0 100644 (file)
--- a/CRM/Core/Form.php
+++ b/CRM/Core/Form.php
@@ -202,6 +202,10 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
    * to combine fields from the various screens & save the resulting 'submitted_values'
    * to the UserJob.
    *
+   * @api This function will not change in a minor release and is supported for
+   * use outside of core. This annotation / external support for properties
+   * is only given where there is specific test cover.
+   *
    * @return array
    */
   public function getSubmittedValues(): array {
@@ -219,6 +223,10 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
    * Contribution_Main and Contribution_Confirm) accessible you can override
    * this function as CRM_Import_Forms does.
    *
+   * @api This function will not change in a minor release and is supported for
+   * use outside of core. This annotation / external support for properties
+   * is only given where there is specific test cover.
+   *
    * @return string[]
    */
   protected function getSubmittableFields(): array {
@@ -3000,6 +3008,8 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
    * they have permission to (setContactID does do that) and can be used to check if the user is
    * accessing their own record.
    *
+   * @deprecated use getAuthenticatedContactID()
+   *
    * @return int|false
    * @throws \CRM_Core_Exception
    */
@@ -3016,14 +3026,20 @@ class CRM_Core_Form extends HTML_QuickForm_Page {
   }
 
   /**
-   * Get values submitted by the user.
+   * Get value submitted by the user.
    *
    * These values have been validated against the fields added to the form.
    * https://pear.php.net/manual/en/package.html.html-quickform.html-quickform.exportvalues.php
    *
+   * Any money processing has also been done.
+   *
    * @param string $fieldName
    *
    * @return mixed|null
+   *
+   * @api This function will not change in a minor release and is supported for
+   * use outside of core. This annotation / external support for properties
+   * is only given where there is specific test cover.
    */
   public function getSubmittedValue(string $fieldName) {
     if (empty($this->exportedValues)) {