pad: More explicitly explain how to post errors on GST_FLOW_ERROR

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/568>

diff --git a/gst/gstpad.h b/gst/gstpad.h
index 1b4f29f..8cc896d 100644 (file)
--- a/gst/gstpad.h
+++ b/gst/gstpad.h
@@ -137,8 +137,8 @@ typedef enum {
  * @GST_FLOW_EOS:                Pad is EOS.
  * @GST_FLOW_NOT_NEGOTIATED:    Pad is not negotiated.
  * @GST_FLOW_ERROR:             Some (fatal) error occurred. Element generating
- *                               this error should post an error message with more
- *                               details.
+ *                               this error should post an error message using
+ *                               GST_ELEMENT_ERROR() with more details.
  * @GST_FLOW_NOT_SUPPORTED:     This operation is not supported.
  * @GST_FLOW_CUSTOM_SUCCESS:    Elements can use values starting from
  *                               this (and higher) to define custom success