first stab at reorganizing docs for pad

Original commit message from CVS:
first stab at reorganizing docs for pad

docs/gst/gstreamer-sections.txt

@@ -1122,32 +1122,146 @@ xmlNodePtr
 <FILE>gstpad</FILE>
 <TITLE>GstPad</TITLE>
 GstPad
-GST_PAD_LINK_FAILED
+
-GST_PAD_LINK_SUCCESSFUL
-GstPadActivateFunction
-GstPadActivateModeFunction
-GstPadBlockCallback
-GstPadChainFunction
-GstPadEventFunction
-GstPadCheckGetRangeFunction
-GstPadGetRangeFunction
-GstPadQueryFunction
-GstPadIntLinkFunction
-GstPadQueryTypeFunction
-GstPadLinkFunction
-GstPadUnlinkFunction
-GstPadAcceptCapsFunction
-GstPadFixateCapsFunction
-GstPadGetCapsFunction
-GstPadSetCapsFunction
-GstPadBufferAllocFunction
-GstPadDispatcherFunction
 GstPadDirection
 GstPadFlags
 GstPadLinkReturn
+GST_PAD_LINK_FAILED
+GST_PAD_LINK_SUCCESSFUL
 GstFlowReturn
 GstActivateMode
 
+<SUBSECTION Application> 
+gst_pad_get_name
+gst_pad_get_direction
+gst_pad_get_parent
+gst_pad_get_parent_element
+gst_pad_get_pad_template
+
+gst_pad_link
+gst_pad_unlink
+gst_pad_is_linked
+gst_pad_can_link
+
+gst_pad_get_caps
+gst_pad_get_allowed_caps
+gst_pad_get_negotiated_caps
+gst_pad_get_pad_template_caps
+gst_pad_set_caps
+
+gst_pad_get_peer
+gst_pad_peer_get_caps
+gst_pad_use_fixed_caps
+
+gst_pad_is_active
+
+gst_pad_set_blocked
+gst_pad_set_blocked_async
+GstPadBlockCallback
+gst_pad_is_blocked
+
+gst_pad_add_data_probe
+gst_pad_add_buffer_probe
+gst_pad_add_event_probe
+gst_pad_remove_data_probe
+gst_pad_remove_buffer_probe
+gst_pad_remove_event_probe
+
+<SUBSECTION Element>
+gst_pad_new
+gst_pad_new_from_template
+
+gst_pad_alloc_buffer
+gst_pad_set_bufferalloc_function
+GstPadBufferAllocFunction
+
+gst_pad_set_chain_function
+GstPadChainFunction
+
+gst_pad_set_checkgetrange_function
+GstPadCheckGetRangeFunction
+
+gst_pad_get_range
+gst_pad_set_getrange_function
+GstPadGetRangeFunction
+
+gst_pad_set_event_function
+GstPadEventFunction
+
+gst_pad_set_link_function
+GstPadLinkFunction
+gst_pad_set_unlink_function
+GstPadUnlinkFunction
+
+gst_pad_accept_caps
+gst_pad_set_acceptcaps_function
+GstPadAcceptCapsFunction
+
+gst_pad_set_getcaps_function
+GstPadGetCapsFunction
+gst_pad_proxy_getcaps
+
+gst_pad_set_setcaps_function
+GstPadSetCapsFunction
+gst_pad_proxy_setcaps
+
+gst_pad_fixate_caps
+gst_pad_set_fixatecaps_function
+GstPadFixateCapsFunction
+
+gst_pad_get_fixed_caps_func
+
+gst_pad_peer_accept_caps
+
+gst_pad_set_activate_function
+GstPadActivateFunction
+
+gst_pad_set_activatepush_function
+gst_pad_set_activatepull_function
+GstPadActivateModeFunction
+
+gst_pad_push
+gst_pad_push_event
+gst_pad_check_pull_range
+gst_pad_pull_range
+gst_pad_activate_pull
+gst_pad_activate_push
+gst_pad_send_event
+gst_pad_event_default
+
+gst_pad_query
+gst_pad_query_default
+gst_pad_query_position
+gst_pad_query_convert
+gst_pad_set_query_function
+GstPadQueryFunction
+gst_pad_set_query_type_function
+GstPadQueryTypeFunction
+gst_pad_get_query_types
+gst_pad_get_query_types_default
+
+gst_pad_set_internal_link_function
+GstPadIntLinkFunction
+gst_pad_get_internal_links
+gst_pad_get_internal_links_default
+gst_pad_load_and_link
+
+gst_pad_dispatcher
+GstPadDispatcherFunction
+
+gst_pad_set_element_private
+gst_pad_get_element_private
+
+
+<SUBSECTION Core>
+gst_pad_chain
+
+gst_pad_start_task
+gst_pad_pause_task
+gst_pad_stop_task
+
+gst_pad_set_active
+
 GST_PREROLL_BROADCAST
 GST_PREROLL_GET_COND
 GST_PREROLL_GET_LOCK
@@ -1165,95 +1279,6 @@ GST_STREAM_UNLOCK
 GST_STREAM_UNLOCK_FULL
 GST_FLOW_IS_FATAL
 
-gst_pad_new
-gst_pad_new_from_template
-
-gst_pad_get_name
-gst_pad_get_direction
-gst_pad_get_parent
-gst_pad_get_parent_element
-
-gst_pad_set_active
-gst_pad_is_active
-gst_pad_set_blocked
-gst_pad_set_blocked_async
-gst_pad_is_blocked
-gst_pad_set_element_private
-gst_pad_get_element_private
-gst_pad_get_pad_template
-gst_pad_set_bufferalloc_function
-gst_pad_alloc_buffer
-gst_pad_set_chain_function
-gst_pad_chain
-gst_pad_set_checkgetrange_function
-gst_pad_set_getrange_function
-gst_pad_get_range
-gst_pad_set_event_function
-gst_pad_set_unlink_function
-gst_pad_set_activate_function
-gst_pad_set_activatepull_function
-
-gst_pad_start_task
-gst_pad_pause_task
-gst_pad_stop_task
-
-gst_pad_link
-gst_pad_unlink
-gst_pad_is_linked
-gst_pad_set_link_function
-gst_pad_can_link
-
-gst_pad_accept_caps
-gst_pad_get_negotiated_caps
-gst_pad_get_caps
-gst_pad_set_caps
-gst_pad_get_pad_template_caps
-gst_pad_set_acceptcaps_function
-gst_pad_set_getcaps_function
-gst_pad_set_setcaps_function
-gst_pad_proxy_getcaps
-gst_pad_proxy_setcaps
-gst_pad_get_allowed_caps
-gst_pad_get_fixed_caps_func
-gst_pad_get_peer
-gst_pad_peer_get_caps
-gst_pad_peer_accept_caps
-gst_pad_use_fixed_caps
-gst_pad_fixate_caps
-gst_pad_set_fixatecaps_function
-
-gst_pad_set_activatepush_function
-gst_pad_push
-gst_pad_push_event
-gst_pad_check_pull_range
-gst_pad_pull_range
-gst_pad_activate_pull
-gst_pad_activate_push
-gst_pad_send_event
-gst_pad_event_default
-
-gst_pad_set_query_function
-gst_pad_set_query_type_function
-gst_pad_get_query_types
-gst_pad_get_query_types_default
-gst_pad_query
-gst_pad_query_default
-gst_pad_query_position
-gst_pad_query_convert
-
-gst_pad_set_internal_link_function
-gst_pad_get_internal_links
-gst_pad_get_internal_links_default
-gst_pad_dispatcher
-gst_pad_load_and_link
-
-gst_pad_add_data_probe
-gst_pad_add_buffer_probe
-gst_pad_add_event_probe
-gst_pad_remove_data_probe
-gst_pad_remove_buffer_probe
-gst_pad_remove_event_probe
-
 <SUBSECTION Standard>
 GstPadClass
 GST_PAD