[gst-devel] [patch] bug#103843 : gstreamer docs connect->link update

Leif Johnson leif at ambient.2y.net
Thu Jan 23 09:01:04 CET 2003


Hi folks -

I whipped out regexxer today and ruthlessly replaced connect
with link in the gstreamer docs (and connection with link,
disconnect with unlink, etc.). I am pretty sure I avoided
replacing the g_signal_connect (and such-like) instances.
Attached is a patch against the current HEAD branch.

If everyone thinks this is ok, I could commit the changes to
both the HEAD and BRANCH-RELEASE-0_6 branches. But a commit
will also entail moving two files in doc/manual/, namely :

connected-elements.fig -> linked-elements.fig
connections.xml -> links.xml

I don't know how moving these files will affect an
inter-branch merge later on, ideally it will work but I've
never tried this myself. Just say the word on what I should
do ... cheers !

leif

p.s. Just for my enlightenment, in the future should I post
things like this straight to Bugzilla ? I decided to post to
the list because of the freeze and potential tree management
issues.

--
Leif Morgan Johnson . http://ambient.2y.net/leif/
IAESTE trainee      . http://www.iaeste.org/
Salomon Automation  . http://www.salomon.at/
-------------- next part --------------
? docs/manual/connected-elements.fig
? docs/manual/connections.xml
Index: docs/faq/using.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/faq/using.xml,v
retrieving revision 1.5
diff -u -u -r1.5 using.xml
--- docs/faq/using.xml	12 Dec 2002 16:51:45 -0000	1.5
+++ docs/faq/using.xml	23 Jan 2003 16:49:06 -0000
@@ -53,7 +53,7 @@
       <answer>
         <para>
 You can test this by trying to play a sine tone.  For this, you need to
-connect the sinesrc plug-in to an output plug-in that matches your hardware.
+link the sinesrc plug-in to an output plug-in that matches your hardware.
 A (non-complete) list of output plug-ins for audio is
 <itemizedlist>
 <listitem><para>osssink for OSS output</para></listitem>
Index: docs/gst/gstreamer-sections.txt
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/gstreamer-sections.txt,v
retrieving revision 1.61
diff -u -u -r1.61 gstreamer-sections.txt
--- docs/gst/gstreamer-sections.txt	2 Jan 2003 18:56:05 -0000	1.61
+++ docs/gst/gstreamer-sections.txt	23 Jan 2003 16:49:06 -0000
@@ -139,8 +139,8 @@
 gst_scheduler_yield
 gst_scheduler_interrupt
 gst_scheduler_error
-gst_scheduler_pad_connect
-gst_scheduler_pad_disconnect
+gst_scheduler_pad_link
+gst_scheduler_pad_unlink
 gst_scheduler_pad_select
 gst_scheduler_add_scheduler
 gst_scheduler_remove_scheduler
@@ -454,14 +454,14 @@
 gst_element_get_pad_template_list
 gst_element_class_add_pad_template
 
-gst_element_connect
-gst_element_connect_many
-gst_element_connect_filtered
-gst_element_connect_pads
-gst_element_connect_pads_filtered
-gst_element_disconnect
-gst_element_disconnect_many
-gst_element_disconnect_pads
+gst_element_link
+gst_element_link_many
+gst_element_link_filtered
+gst_element_link_pads
+gst_element_link_pads_filtered
+gst_element_unlink
+gst_element_unlink_many
+gst_element_unlink_pads
 gst_element_get_compatible_pad
 gst_element_get_compatible_pad_filtered
 gst_element_get_compatible_pad_template
@@ -835,7 +835,7 @@
 GST_PAD_CAN_PULL
 GST_PAD_IS_SINK
 GST_PAD_IS_SRC
-GST_PAD_IS_CONNECTED
+GST_PAD_IS_LINKED
 GST_PAD_IS_ACTIVE
 GST_PAD_IS_USABLE
 
@@ -846,8 +846,8 @@
 GstPadGetCapsFunction
 
 GstPadEventFunction
-GstPadConnectFunction
-GstPadConnectReturn
+GstPadLinkFunction
+GstPadLinkReturn
 GstPadConvertFunction
 GstPadDispatcherFunction
 GstPadIntConnFunction
@@ -872,7 +872,7 @@
 gst_pad_set_chain_function
 gst_pad_set_get_function
 gst_pad_set_bufferpool_function
-gst_pad_set_connect_function
+gst_pad_set_link_function
 gst_pad_set_getcaps_function
 gst_pad_try_set_caps
 gst_pad_get_caps
@@ -888,18 +888,18 @@
 gst_pad_remove_ghost_pad
 gst_pad_get_ghost_pad_list
 gst_pad_get_peer
-gst_pad_connect
-gst_pad_connect_filtered
-gst_pad_reconnect_filtered
-gst_pad_try_reconnect_filtered
-gst_pad_disconnect
-gst_pad_can_connect
-gst_pad_can_connect_filtered
+gst_pad_link
+gst_pad_link_filtered
+gst_pad_relink_filtered
+gst_pad_try_relink_filtered
+gst_pad_unlink
+gst_pad_can_link
+gst_pad_can_link_filtered
 gst_pad_push
 gst_pad_pull
 gst_pad_get_bufferpool
-gst_pad_load_and_connect
-gst_pad_proxy_connect
+gst_pad_load_and_link
+gst_pad_proxy_link
 gst_pad_get_pad_template
 gst_pad_get_pad_template_caps
 gst_pad_get_allowed_caps
@@ -925,9 +925,9 @@
 gst_pad_get_formats_default
 gst_pad_set_formats_function
 
-gst_pad_get_internal_connections
-gst_pad_get_internal_connections_default
-gst_pad_set_internal_connection_function
+gst_pad_get_internal_links
+gst_pad_get_internal_links_default
+gst_pad_set_internal_link_function
 
 gst_pad_set_query_function
 gst_pad_query
@@ -957,7 +957,7 @@
 GST_RPAD_EVENTFUNC
 GST_RPAD_EVENTHANDLER
 GST_RPAD_GETHANDLER
-GST_RPAD_CONNECTFUNC
+GST_RPAD_LINKFUNC
 GST_RPAD_GETCAPSFUNC
 GST_RPAD_CONVERTFUNC
 GST_RPAD_INTCONNFUNC
@@ -1003,8 +1003,8 @@
 GST_IS_GHOST_PAD_CLASS
 GST_IS_GHOST_PAD_FAST
 gst_ghost_pad_get_type
-GST_TYPE_PAD_CONNECT_RETURN
-gst_pad_connect_return_get_type
+GST_TYPE_PAD_LINK_RETURN
+gst_pad_link_return_get_type
 GST_TYPE_PAD_DIRECTION
 gst_pad_direction_get_type
 GST_TYPE_PAD_FLAGS
Index: docs/gst/tmpl/gstautoplug.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstautoplug.sgml,v
retrieving revision 1.16
diff -u -u -r1.16 gstautoplug.sgml
--- docs/gst/tmpl/gstautoplug.sgml	14 Dec 2002 13:02:14 -0000	1.16
+++ docs/gst/tmpl/gstautoplug.sgml	23 Jan 2003 16:49:06 -0000
@@ -2,13 +2,13 @@
 GstAutoplug
 
 <!-- ##### SECTION Short_Description ##### -->
-Automatically create and connect elements
+Automatically create and link elements
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 GstAutoplug is an abstract class that is used for constructing and 
-connecting elements. Two types of autopluggers exist: renderer ones and non
-renderer ones. the renderer autopluggers will not have any src pads while the
+linking elements. Two types of autopluggers exist: renderer ones and non
+renderer ones. The renderer autopluggers will not have any src pads while the
 non renderer ones do.
 </para>
 
@@ -19,8 +19,8 @@
 (see #GstStaticAutoplug and #GstStaticAutoplugRender).
 </para>
 <para>
-If the autoplugger supports the RENDERER API, use gst_autoplug_to_renderers() call to
-create a bin that connectes the src caps to the specified rendrer elements. You can 
+If the autoplugger supports the RENDERER API, use gst_autoplug_to_renderers() to
+create a bin that links the src caps to the specified renderer elements. You can 
 then add the bin to a pipeline and run it.
 
   <programlisting>
@@ -44,13 +44,13 @@
 				       sink,
 				       NULL);
 
-  /* add the element to a bin and connect the sink pad */
+  /* add the element to a bin and link the sink pad */
   ...
   </programlisting>
 </para>
 <para>
-If the autoplugger supports the CAPS API, use gst_autoplug_to_caps() call to
-connect the src caps to the destination caps. The created bin will have src pads 
+If the autoplugger supports the CAPS API, use gst_autoplug_to_caps() to
+link the src caps to the destination caps. The created bin will have src caps 
 compatible with the provided sink caps.
 
   <programlisting>
@@ -74,7 +74,7 @@
 				  ),
 				  NULL);
 
-  /* add the element to a bin and connect the src/sink pads */
+  /* add the element to a bin and link the src/sink pads */
   ...
   </programlisting>
 </para>
Index: docs/gst/tmpl/gstcaps.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstcaps.sgml,v
retrieving revision 1.25
diff -u -u -r1.25 gstcaps.sgml
--- docs/gst/tmpl/gstcaps.sgml	14 Dec 2002 16:32:28 -0000	1.25
+++ docs/gst/tmpl/gstcaps.sgml	23 Jan 2003 16:49:06 -0000
@@ -98,10 +98,10 @@
 </programlisting>
 </para>
 <para>
-If you want to check if a connection between source and destination caps
+If you want to check if a link between source and destination caps
 is always possible, use gst_caps_is_always_compatible(), which returns
 a boolean.
-If you want to check if a connection between source and destination caps
+If you want to check if a link between source and destination caps
 might be possible, use gst_caps_intersect(), which returns an intersection
 of the capabilities.
 </para>
Index: docs/gst/tmpl/gstelement.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstelement.sgml,v
retrieving revision 1.49
diff -u -u -r1.49 gstelement.sgml
--- docs/gst/tmpl/gstelement.sgml	30 Dec 2002 17:54:00 -0000	1.49
+++ docs/gst/tmpl/gstelement.sgml	23 Jan 2003 16:49:06 -0000
@@ -20,8 +20,8 @@
 </para>
 
 <para>
-All elements have pads (of the type #GstPad).  These pads connect to pads on
-other elements.  Buffers flow between these connected pads.
+All elements have pads (of the type #GstPad).  These pads link to pads on
+other elements.  Buffers flow between these linked pads.
 A GstElement has a GList of #GstPad structures for all their input (or sink)
 and output (or source) pads.  
 Core and plug-in writers can add and remove pads with gst_element_add_pad()
@@ -33,14 +33,14 @@
 </para>
 
 <para>
-Elements can be connected through their pads.
-If the connection is straightforward, use the gst_element_connect() 
-convenience function to connect two elements, or gst_element_connect_many() 
+Elements can be linked through their pads.
+If the link is straightforward, use the gst_element_link() 
+convenience function to link two elements, or gst_element_link_many() 
 for more elements in a row.
-Use gst_element_connect_filtered() to connect two elements constrained by
+Use gst_element_link_filtered() to link two elements constrained by
 a specified set of #GstCaps.
-For finer control, use gst_element_connect_pads() and 
-gst_element_connect_pads_filtered() to specify the pads to connect on 
+For finer control, use gst_element_link_pads() and 
+gst_element_link_pads_filtered() to specify the pads to link on 
 each element by name.
 </para>
 
@@ -90,7 +90,7 @@
 @Returns: the name of the element.
 
 
-<!-- connection -->
+<!-- link -->
 
 
 <!-- ##### MACRO gst_element_set_name ##### -->
@@ -232,7 +232,7 @@
 @templ: 
 
 
-<!-- ##### FUNCTION gst_element_connect ##### -->
+<!-- ##### FUNCTION gst_element_link ##### -->
 <para>
 
 </para>
@@ -242,7 +242,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_element_connect_many ##### -->
+<!-- ##### FUNCTION gst_element_link_many ##### -->
 <para>
 
 </para>
@@ -253,7 +253,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_element_connect_filtered ##### -->
+<!-- ##### FUNCTION gst_element_link_filtered ##### -->
 <para>
 
 </para>
@@ -264,7 +264,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_element_connect_pads ##### -->
+<!-- ##### FUNCTION gst_element_link_pads ##### -->
 <para>
 
 </para>
@@ -276,7 +276,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_element_connect_pads_filtered ##### -->
+<!-- ##### FUNCTION gst_element_link_pads_filtered ##### -->
 <para>
 
 </para>
@@ -289,7 +289,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_element_disconnect ##### -->
+<!-- ##### FUNCTION gst_element_unlink ##### -->
 <para>
 
 </para>
@@ -298,7 +298,7 @@
 @dest: 
 
 
-<!-- ##### FUNCTION gst_element_disconnect_many ##### -->
+<!-- ##### FUNCTION gst_element_unlink_many ##### -->
 <para>
 
 </para>
@@ -308,7 +308,7 @@
 @Varargs: 
 
 
-<!-- ##### FUNCTION gst_element_disconnect_pads ##### -->
+<!-- ##### FUNCTION gst_element_unlink_pads ##### -->
 <para>
 
 </para>
Index: docs/gst/tmpl/gstpad.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstpad.sgml,v
retrieving revision 1.50
diff -u -u -r1.50 gstpad.sgml
--- docs/gst/tmpl/gstpad.sgml	2 Jan 2003 18:56:07 -0000	1.50
+++ docs/gst/tmpl/gstpad.sgml	23 Jan 2003 16:49:06 -0000
@@ -2,16 +2,16 @@
 GstPad
 
 <!-- ##### SECTION Short_Description ##### -->
-The connection between Elements
+The link between Elements
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-A #GstElement is connected to other elements via "pads", which are extremely 
-light-weight generic connections points. 
+A #GstElement is linked to other elements via "pads", which are extremely 
+light-weight generic link points. 
 After two pads are retrieved from an element with gst_element_get_pad(), 
-the pads can be connected with gst_pad_connect().  (For quick connections,
-you can also use gst_element_connect(), which will make the obvious
-connection for you if it's straightforward).
+the pads can be link with gst_pad_link(). (For quick links,
+you can also use gst_element_link(), which will make the obvious
+link for you if it's straightforward.)
 </para>
 <para>
 Pads are typically created from a #GstPadTemplate with 
@@ -124,7 +124,7 @@
 <!-- ##### MACRO GST_PAD_PEER ##### -->
 <para>
 Gets the peer pad of this pad.  The peer pad is the pad on to which the parent
-element is connected through this pad.
+element is linked through this pad.
 </para>
 
 @pad: a #GstPad to get the peer pad of.
@@ -155,9 +155,9 @@
 @pad: a #GstPad to check.
 
 
-<!-- ##### MACRO GST_PAD_IS_CONNECTED ##### -->
+<!-- ##### MACRO GST_PAD_IS_LINKED ##### -->
 <para>
-Checks if the pad is connected.
+Checks if the pad is linked.
 </para>
 
 @pad: a #GstPad to check.
@@ -173,7 +173,7 @@
 
 <!-- ##### MACRO GST_PAD_IS_USABLE ##### -->
 <para>
-Checks if a pad is usable. A usable pad both connected and active.
+Checks if a pad is usable. A usable pad is both linked and active.
 </para>
 
 @pad: a #GstPad to check
@@ -234,27 +234,27 @@
 @Returns: TRUE if the pad could handle the event.
 
 
-<!-- ##### USER_FUNCTION GstPadConnectFunction ##### -->
+<!-- ##### USER_FUNCTION GstPadLinkFunction ##### -->
 <para>
-Function signature to handle a new connection on the pad.
+Function signature to handle a new link on the pad.
 </para>
 
- at pad: the #GstPad that is connected.
+ at pad: the #GstPad that is linked.
 @caps: the peer's #GstCaps.
- at Returns: the result of the connection with the specified caps.
+ at Returns: the result of the link with the specified caps.
 
 
-<!-- ##### ENUM GstPadConnectReturn ##### -->
+<!-- ##### ENUM GstPadLinkReturn ##### -->
 <para>
-The result of a pad connection.
+The result of a pad link.
 </para>
 
- at GST_PAD_CONNECT_REFUSED: the connection was refused.
- at GST_PAD_CONNECT_DELAYED: the connection was delayed, probably because the
-                          element needs more specific pad capabilitiess.
- at GST_PAD_CONNECT_OK:      the connection succeeded.
- at GST_PAD_CONNECT_DONE:    the connection succeeded, 
-                          any more attempts are not needed.
+ at GST_PAD_LINK_REFUSED: the link was refused.
+ at GST_PAD_LINK_DELAYED: the link was delayed, probably because the
+                       element needs more specific pad capabilitiess.
+ at GST_PAD_LINK_OK:      the link succeeded.
+ at GST_PAD_LINK_DONE:    the link succeeded, 
+                       any more attempts are not needed.
 
 <!-- ##### USER_FUNCTION GstPadConvertFunction ##### -->
 <para>
@@ -271,7 +271,7 @@
 
 <!-- ##### USER_FUNCTION GstPadDispatcherFunction ##### -->
 <para>
-A dispatcher function is called for all internally connected pads, see 
+A dispatcher function is called for all internally linked pads, see 
 gst_pad_dispatcher().
 </para>
 
@@ -282,11 +282,11 @@
 
 <!-- ##### USER_FUNCTION GstPadIntConnFunction ##### -->
 <para>
-The signature of the internal pad connection function.
+The signature of the internal pad link function.
 </para>
 
 @pad: The #GstPad to query.
- at Returns: a newly allocated #GList of pads that are connected to 
+ at Returns: a newly allocated #GList of pads that are linked to 
           the given pad on the inside of the parent element.  
           The caller must call g_list_free() on it after use.
 
@@ -463,13 +463,13 @@
 @bufpool: 
 
 
-<!-- ##### FUNCTION gst_pad_set_connect_function ##### -->
+<!-- ##### FUNCTION gst_pad_set_link_function ##### -->
 <para>
 
 </para>
 
 @pad: 
- at connect: 
+ at link: 
 
 
 <!-- ##### FUNCTION gst_pad_set_getcaps_function ##### -->
@@ -609,7 +609,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_connect ##### -->
+<!-- ##### FUNCTION gst_pad_link ##### -->
 <para>
 
 </para>
@@ -619,7 +619,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_connect_filtered ##### -->
+<!-- ##### FUNCTION gst_pad_link_filtered ##### -->
 <para>
 
 </para>
@@ -630,7 +630,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_reconnect_filtered ##### -->
+<!-- ##### FUNCTION gst_pad_relink_filtered ##### -->
 <para>
 
 </para>
@@ -641,7 +641,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_try_reconnect_filtered ##### -->
+<!-- ##### FUNCTION gst_pad_try_relink_filtered ##### -->
 <para>
 
 </para>
@@ -652,7 +652,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_disconnect ##### -->
+<!-- ##### FUNCTION gst_pad_unlink ##### -->
 <para>
 
 </para>
@@ -661,7 +661,7 @@
 @sinkpad: 
 
 
-<!-- ##### FUNCTION gst_pad_can_connect ##### -->
+<!-- ##### FUNCTION gst_pad_can_link ##### -->
 <para>
 
 </para>
@@ -671,7 +671,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_can_connect_filtered ##### -->
+<!-- ##### FUNCTION gst_pad_can_link_filtered ##### -->
 <para>
 
 </para>
@@ -709,7 +709,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_load_and_connect ##### -->
+<!-- ##### FUNCTION gst_pad_load_and_link ##### -->
 <para>
 
 </para>
@@ -718,7 +718,7 @@
 @parent: 
 
 
-<!-- ##### FUNCTION gst_pad_proxy_connect ##### -->
+<!-- ##### FUNCTION gst_pad_proxy_link ##### -->
 <para>
 
 </para>
@@ -932,7 +932,7 @@
 @formats: 
 
 
-<!-- ##### FUNCTION gst_pad_get_internal_connections ##### -->
+<!-- ##### FUNCTION gst_pad_get_internal_links ##### -->
 <para>
 
 </para>
@@ -941,7 +941,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_get_internal_connections_default ##### -->
+<!-- ##### FUNCTION gst_pad_get_internal_links_default ##### -->
 <para>
 
 </para>
@@ -950,7 +950,7 @@
 @Returns: 
 
 
-<!-- ##### FUNCTION gst_pad_set_internal_connection_function ##### -->
+<!-- ##### FUNCTION gst_pad_set_internal_link_function ##### -->
 <para>
 
 </para>
@@ -1075,7 +1075,7 @@
 @appfilter: 
 @getcapsfunc: 
 @direction: 
- at connectfunc: 
+ at linkfunc: 
 @peer: 
 @sched_private: 
 @chainfunc: 
@@ -1190,9 +1190,9 @@
 @pad: the real pad to query.
 
 
-<!-- ##### MACRO GST_RPAD_CONNECTFUNC ##### -->
+<!-- ##### MACRO GST_RPAD_LINKFUNC ##### -->
 <para>
-Get the connect function of the pad
+Get the link function of the pad
 </para>
 
 @pad: the pad to query
@@ -1216,7 +1216,7 @@
 
 <!-- ##### MACRO GST_RPAD_INTCONNFUNC ##### -->
 <para>
-Get the internal connection function of this pad
+Get the internal link function of this pad
 </para>
 
 @pad: the pad to query
Index: docs/gst/tmpl/gstparse.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstparse.sgml,v
retrieving revision 1.13
diff -u -u -r1.13 gstparse.sgml
--- docs/gst/tmpl/gstparse.sgml	14 Dec 2002 16:32:28 -0000	1.13
+++ docs/gst/tmpl/gstparse.sgml	23 Jan 2003 16:49:06 -0000
@@ -52,7 +52,7 @@
 @GST_PARSE_ERROR_SYNTAX: A syntax error was detected
 @GST_PARSE_ERROR_NO_SUCH_ELEMENT: The pipeline description contains a non existing element
 @GST_PARSE_ERROR_NO_SUCH_PROPERTY: The pipeline description contains a non existing element property
- at GST_PARSE_ERROR_CONNECT: A pad connection could not be made
+ at GST_PARSE_ERROR_LINK: A pad link could not be made
 
 <!-- ##### MACRO GST_PARSE_ERROR ##### -->
 <para>
Index: docs/gst/tmpl/gstreamer-unused.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstreamer-unused.sgml,v
retrieving revision 1.71
diff -u -u -r1.71 gstreamer-unused.sgml
--- docs/gst/tmpl/gstreamer-unused.sgml	2 Jan 2003 18:56:08 -0000	1.71
+++ docs/gst/tmpl/gstreamer-unused.sgml	23 Jan 2003 16:49:07 -0000
@@ -276,26 +276,26 @@
 gstconfig
 
 
-<!-- ##### SECTION ./tmpl/gstconnection.sgml:Long_Description ##### -->
+<!-- ##### SECTION ./tmpl/gstlink.sgml:Long_Description ##### -->
 <para>
-A connection is a bas class for a generic connection between
-elements. A connection is typically a bas class for queues.
+A link is a base class for a generic link between
+elements. A link is typically a base class for queues.
 
 </para>
 
 
-<!-- ##### SECTION ./tmpl/gstconnection.sgml:See_Also ##### -->
+<!-- ##### SECTION ./tmpl/gstlink.sgml:See_Also ##### -->
 <para>
 
 </para>
 
 
-<!-- ##### SECTION ./tmpl/gstconnection.sgml:Short_Description ##### -->
-Generic connection between elements.
+<!-- ##### SECTION ./tmpl/gstlink.sgml:Short_Description ##### -->
+Generic link between elements.
 
 
-<!-- ##### SECTION ./tmpl/gstconnection.sgml:Title ##### -->
-GstConnection
+<!-- ##### SECTION ./tmpl/gstlink.sgml:Title ##### -->
+GstLink
 
 
 <!-- ##### SECTION ./tmpl/gstdata_private.sgml:Long_Description ##### -->
@@ -565,7 +565,7 @@
 <!-- ##### SECTION ./tmpl/gstfilter.sgml:Long_Description ##### -->
 <para>
 Filters take data in and spit data out. They are the main Element in a filter graph.
-Filters have zero or more inputs and zero or more outputs. Filters are connected
+Filters have zero or more inputs and zero or more outputs. Filters are linked
 together to form filter graphs. A GstFilter is the base class and is not very usefull
 on its own.
 </para>
@@ -723,7 +723,7 @@
 <para>
 The trick is dealing with these structs as they pass through a pipeline,
 since they have potentially different mutability properties.  For
-instance, if you've got a mp3 decoder connected to a tee, which sends the
+instance, if you've got a mp3 decoder linked to a tee, which sends the
 buffers off to both the decoder and a spectrum analyzer (and then a
 visualization element).  The preferred setup would be where every time a
 audio/raw metadata comes down the pipe (indicating a potential change in
@@ -1238,13 +1238,13 @@
 videoraw
 
 
-<!-- ##### MACRO BCONNECTION ##### -->
+<!-- ##### MACRO BLINK ##### -->
 <para>
 
 </para>
 
 
-<!-- ##### MACRO CONNECTION ##### -->
+<!-- ##### MACRO LINK ##### -->
 <para>
 
 </para>
@@ -1348,7 +1348,7 @@
 @format: 
 @args...: 
 
-<!-- ##### MACRO FCONNECTION ##### -->
+<!-- ##### MACRO FLINK ##### -->
 <para>
 
 </para>
@@ -1771,14 +1771,14 @@
 
 @caps: The caps structure to unlock
 
-<!-- ##### MACRO GST_CONNECTION ##### -->
+<!-- ##### MACRO GST_LINK ##### -->
 <para>
 
 </para>
 
 @obj: 
 
-<!-- ##### MACRO GST_CONNECTION_CLASS ##### -->
+<!-- ##### MACRO GST_LINK_CLASS ##### -->
 <para>
 
 </para>
@@ -2197,14 +2197,14 @@
 
 @obj: 
 
-<!-- ##### MACRO GST_IS_CONNECTION ##### -->
+<!-- ##### MACRO GST_IS_LINK ##### -->
 <para>
 
 </para>
 
 @obj: 
 
-<!-- ##### MACRO GST_IS_CONNECTION_CLASS ##### -->
+<!-- ##### MACRO GST_IS_LINK_CLASS ##### -->
 <para>
 
 </para>
@@ -2668,9 +2668,9 @@
 
 @klass: 
 
-<!-- ##### MACRO GST_PAD_CONNECTED ##### -->
+<!-- ##### MACRO GST_PAD_LINKED ##### -->
 <para>
-Is this pad connected.
+Is this pad linked.
 </para>
 
 @pad: the pad to check
@@ -2981,18 +2981,18 @@
 @sched: The scheduler.
 @element: The element to lock.
 
-<!-- ##### MACRO GST_SCHEDULE_PAD_CONNECT ##### -->
+<!-- ##### MACRO GST_SCHEDULE_PAD_LINK ##### -->
 <para>
-Fast macro to connect two pads.
+Fast macro to link two pads.
 </para>
 
 @sched: The scheduler.
 @srcpad: The source pad.
 @sinkpad: The sink pad.
 
-<!-- ##### MACRO GST_SCHEDULE_PAD_DISCONNECT ##### -->
+<!-- ##### MACRO GST_SCHEDULE_PAD_UNLINK ##### -->
 <para>
-Fast macro to disconnect two pads.
+Fast macro to unlink two pads.
 </para>
 
 @sched: The scheduler.
@@ -3297,7 +3297,7 @@
 </para>
 
 
-<!-- ##### MACRO GST_TYPE_CONNECTION ##### -->
+<!-- ##### MACRO GST_TYPE_LINK ##### -->
 <para>
 
 </para>
@@ -3447,7 +3447,7 @@
 </para>
 
 
-<!-- ##### MACRO GST_TYPE_PAD_CONNECT_RETURN ##### -->
+<!-- ##### MACRO GST_TYPE_PAD_LINK_RETURN ##### -->
 <para>
 
 </para>
@@ -4398,13 +4398,13 @@
 </para>
 
 
-<!-- ##### STRUCT GstConnection ##### -->
+<!-- ##### STRUCT GstLink ##### -->
 <para>
 
 </para>
 
 
-<!-- ##### STRUCT GstConnectionClass ##### -->
+<!-- ##### STRUCT GstLinkClass ##### -->
 <para>
 
 </para>
@@ -5212,7 +5212,7 @@
 @GST_PARSE_ERROR_CREATING_ELEMENT: 
 @GST_PARSE_ERROR_NOSUCH_ELEMENT: 
 @GST_PARSE_ERROR_INTERNAL: 
- at GST_PARSE_ERROR_CONNECT: 
+ at GST_PARSE_ERROR_LINK: 
 
 <!-- ##### ENUM GstPipeFilterFlags ##### -->
 <para>
@@ -5460,7 +5460,7 @@
 </para>
 
 
-<!-- ##### TYPEDEF GstSpiderConnection ##### -->
+<!-- ##### TYPEDEF GstSpiderLink ##### -->
 <para>
 
 </para>
@@ -5963,7 +5963,7 @@
 @Domain: 
 @Directory: 
 
-<!-- ##### TYPEDEF connection_t ##### -->
+<!-- ##### TYPEDEF link_t ##### -->
 <para>
 
 </para>
@@ -6913,8 +6913,8 @@
 @parent: 
 @current_bin_type: 
 @elements: 
- at connections: 
- at connections_pending: 
+ at links: 
+ at links_pending: 
 @bins: 
 @bin: 
 
@@ -7022,7 +7022,7 @@
 
 @src: 
 
-<!-- ##### FUNCTION gst_autoplug_can_connect_sink ##### -->
+<!-- ##### FUNCTION gst_autoplug_can_link_sink ##### -->
 <para>
 
 </para>
@@ -7031,7 +7031,7 @@
 @sink: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_autoplug_can_connect_src ##### -->
+<!-- ##### FUNCTION gst_autoplug_can_link_src ##### -->
 <para>
 
 </para>
@@ -7811,11 +7811,11 @@
 @jitter: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_connection_get_type ##### -->
+<!-- ##### FUNCTION gst_link_get_type ##### -->
 =======
 
 
-<!-- ##### FUNCTION gst_connection_new ##### -->
+<!-- ##### FUNCTION gst_link_new ##### -->
 <para>
 
 </para>
@@ -7823,12 +7823,12 @@
 @name: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_connection_push ##### -->
+<!-- ##### FUNCTION gst_link_push ##### -->
 <para>
 
 </para>
 
- at connection: 
+ at link: 
 
 <!-- ##### FUNCTION gst_cpu_flags_get_type ##### -->
 <para>
@@ -7890,7 +7890,7 @@
 @first_name: 
 @Varargs: 
 
-<!-- ##### FUNCTION gst_element_connect_elements ##### -->
+<!-- ##### FUNCTION gst_element_link_elements ##### -->
 <para>
 
 </para>
@@ -7899,7 +7899,7 @@
 @dest: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_element_connect_elements_filtered ##### -->
+<!-- ##### FUNCTION gst_element_link_elements_filtered ##### -->
 <para>
 
 </para>
@@ -7909,7 +7909,7 @@
 @filtercaps: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_element_connect_elements_many ##### -->
+<!-- ##### FUNCTION gst_element_link_elements_many ##### -->
 <para>
 
 </para>
@@ -7919,7 +7919,7 @@
 @Varargs: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_element_disconnect_elements ##### -->
+<!-- ##### FUNCTION gst_element_unlink_elements ##### -->
 <para>
 
 </para>
@@ -8607,7 +8607,7 @@
 @pad: 
 @parent: 
 
-<!-- ##### FUNCTION gst_pad_connect_return_get_type ##### -->
+<!-- ##### FUNCTION gst_pad_link_return_get_type ##### -->
 <para>
 
 </para>
@@ -8943,7 +8943,7 @@
 @parent: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_pad_try_connect ##### -->
+<!-- ##### FUNCTION gst_pad_try_link ##### -->
 <para>
 
 </para>
@@ -9230,7 +9230,7 @@
 
 </para>
 
- at connection: 
+ at link: 
 
 <!-- ##### FUNCTION gst_real_pad_get_type ##### -->
 <para>
@@ -9321,7 +9321,7 @@
 @parent: 
 @Returns: 
 
-<!-- ##### FUNCTION gst_schedule_pad_connect ##### -->
+<!-- ##### FUNCTION gst_schedule_pad_link ##### -->
 <para>
 
 </para>
@@ -9330,7 +9330,7 @@
 @srcpad: 
 @sinkpad: 
 
-<!-- ##### FUNCTION gst_schedule_pad_disconnect ##### -->
+<!-- ##### FUNCTION gst_schedule_pad_unlink ##### -->
 <para>
 
 </para>
Index: docs/gst/tmpl/gstscheduler.sgml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/tmpl/gstscheduler.sgml,v
retrieving revision 1.14
diff -u -u -r1.14 gstscheduler.sgml
--- docs/gst/tmpl/gstscheduler.sgml	30 Dec 2002 17:54:02 -0000	1.14
+++ docs/gst/tmpl/gstscheduler.sgml	23 Jan 2003 16:49:07 -0000
@@ -157,7 +157,7 @@
 @element: 
 
 
-<!-- ##### FUNCTION gst_scheduler_pad_connect ##### -->
+<!-- ##### FUNCTION gst_scheduler_pad_link ##### -->
 <para>
 
 </para>
@@ -167,7 +167,7 @@
 @sinkpad: 
 
 
-<!-- ##### FUNCTION gst_scheduler_pad_disconnect ##### -->
+<!-- ##### FUNCTION gst_scheduler_pad_unlink ##### -->
 <para>
 
 </para>
Index: docs/manual/autoplugging.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/autoplugging.xml,v
retrieving revision 1.5
diff -u -u -r1.5 autoplugging.xml
--- docs/manual/autoplugging.xml	14 Sep 2002 14:13:33 -0000	1.5
+++ docs/manual/autoplugging.xml	23 Jan 2003 16:49:07 -0000
@@ -5,7 +5,7 @@
     construct complex pipelines based on source and destination capabilities.
     This feature is very useful if you want to convert type X to type Y but
     don't care about the plugins needed to accomplish this task. The 
-    autoplugger will consult the plugin repository, select and connect the
+    autoplugger will consult the plugin repository, select and link the
     elements needed for the conversion.
   </para>
   <para> 
@@ -29,7 +29,7 @@
     </para>
     <para>
       If the autoplugger supports the RENDERER API, use the
-      gst_autoplug_to_renderers() function to create a bin that connects
+      gst_autoplug_to_renderers() function to create a bin that links
       the source caps to the specified render elements. You can then add
       the bin to a pipeline and run it.
 
@@ -55,13 +55,13 @@
 	                                     sink,
 	                                     NULL);
 
-	/* add the element to a bin and connect the sink pad */
+	/* add the element to a bin and link the sink pad */
 	...
       </programlisting>
     </para>
     <para>
       If the autoplugger supports the CAPS API, use the gst_autoplug_to_caps()
-      function to connect the source caps to the destination caps. The created
+      function to link the source caps to the destination caps. The created
       bin will have source and sink pads compatible with the provided caps.
 
       <programlisting>
@@ -86,7 +86,7 @@
 	                                ),
 	                                NULL);
 
-	/* add the element to a bin and connect the src/sink pads */
+	/* add the element to a bin and link the src/sink pads */
 	...
       </programlisting>
     </para>
@@ -107,13 +107,13 @@
       <orderedlist>
         <listitem>
           <para>
-            Add the autoplugcache element to a bin and connect the sink pad
+            Add the autoplugcache element to a bin and link the sink pad
             to the source pad of an element with unknown caps.
           </para>
         </listitem>
         <listitem>
           <para>
-            Connect the source pad of the autoplugcache to the sink pad of
+            Link the source pad of the autoplugcache to the sink pad of
             the typefind element.
           </para>
         </listitem>
@@ -137,7 +137,7 @@
         <listitem>
           <para>
 	    In the cache_empty signal callback function, remove the autoplugcache and
-	    reconnect the pads.
+	    relink the pads.
           </para>
         </listitem>
       </orderedlist>
Index: docs/manual/elements.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/elements.xml,v
retrieving revision 1.8
diff -u -u -r1.8 elements.xml
--- docs/manual/elements.xml	18 Dec 2002 14:44:25 -0000	1.8
+++ docs/manual/elements.xml	23 Jan 2003 16:49:07 -0000
@@ -16,7 +16,7 @@
     <para>
       Elements, from the perspective of GStreamer, are viewed as "black boxes" 
       with a number of different aspects. One of these aspects is the presence 
-      of "pads", or connection points. This terminology arises from soldering; 
+      of "pads", or link points. This terminology arises from soldering; 
       pads are where wires can be attached.
     </para>
 
@@ -87,7 +87,7 @@
         splitter (demultiplexer). This element will parse the input data and
         extract the audio and video data. Most of these filters dynamically
         send out a signal when a new pad is created so that the application
-        programmer can connect an arbitrary element to the newly created pad.
+        programmer can link an arbitrary element to the newly created pad.
       </para>
     </sect2>
   
Index: docs/manual/goals.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/goals.xml,v
retrieving revision 1.4
diff -u -u -r1.4 goals.xml
--- docs/manual/goals.xml	6 Sep 2002 15:53:06 -0000	1.4
+++ docs/manual/goals.xml	23 Jan 2003 16:49:07 -0000
@@ -88,7 +88,7 @@
         </listitem>
         <listitem>
 	  <para>
-	    Extremely light-weight connections between plugins. Data can travel
+	    Extremely light-weight links between plugins. Data can travel
 	    the pipeline with minimal overhead. Data passing between plugins only involves
 	    a pointer dereference in a typical pipeline.
 	  </para>
Index: docs/manual/gstreamer-manual.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/gstreamer-manual.xml,v
retrieving revision 1.8
diff -u -u -r1.8 gstreamer-manual.xml
--- docs/manual/gstreamer-manual.xml	14 Sep 2002 14:13:34 -0000	1.8
+++ docs/manual/gstreamer-manual.xml	23 Jan 2003 16:49:07 -0000
@@ -11,7 +11,7 @@
 <!ENTITY INIT SYSTEM "init.xml">
 <!ENTITY ELEMENTS SYSTEM "elements.xml">
 <!ENTITY PADS SYSTEM "pads.xml">
-<!ENTITY CONNECTIONS SYSTEM "connections.xml">
+<!ENTITY LINKS SYSTEM "links.xml">
 <!ENTITY BINS SYSTEM "bins.xml">
 <!ENTITY BUFFERS SYSTEM "buffers.xml">
 <!ENTITY STATES SYSTEM "states.xml">
@@ -145,7 +145,7 @@
 
       &PADS;
 
-      &CONNECTIONS;
+      &LINKS;
 
       &BINS;
 
Index: docs/manual/intro.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/intro.xml,v
retrieving revision 1.6
diff -u -u -r1.6 intro.xml
--- docs/manual/intro.xml	14 Sep 2002 14:13:34 -0000	1.6
+++ docs/manual/intro.xml	23 Jan 2003 16:49:07 -0000
@@ -34,7 +34,7 @@
 
     <para>
       The framework is based on plugins that will provide the various codec 
-      and other functionality. The plugins can be connected and arranged in
+      and other functionality. The plugins can be linked and arranged in
       a pipeline. This pipeline defines the flow of the data. Pipelines can 
       also be edited with a GUI editor and saved as XML so that pipeline
       libraries can be made with a minimum of effort.
Index: docs/manual/outline.txt
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/outline.txt,v
retrieving revision 1.4
diff -u -u -r1.4 outline.txt
--- docs/manual/outline.txt	22 Aug 2000 21:18:18 -0000	1.4
+++ docs/manual/outline.txt	23 Jan 2003 16:49:07 -0000
@@ -28,7 +28,7 @@
    (what is it)
    (types) sink, src, filter
    (have pads)
-  connecting elements
+  linking elements
   bin
    (can contain elements)
    pipeline (a complete graph)
Index: docs/manual/programs.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/programs.xml,v
retrieving revision 1.8
diff -u -u -r1.8 programs.xml
--- docs/manual/programs.xml	14 Sep 2002 14:13:34 -0000	1.8
+++ docs/manual/programs.xml	23 Jan 2003 16:49:07 -0000
@@ -100,13 +100,13 @@
         </para>
       </sect3>          
       <sect3>
-        <title>Connections</title>
+        <title>Links</title>
         <screen>
           ... !sink ...
         </screen>
         <para>
           An exclamation point, optionally having a qualified pad name (an the name of the pad,
-          optionally preceded by the name of the element) on both sides, will connect two pads. If
+          optionally preceded by the name of the element) on both sides, will link two pads. If
           the source pad is not specified, a source pad from the immediately preceding element
           will be automatically chosen. If the sink pad is not specified, a sink pad from the next
           element to be constructed will be chosen. An attempt will be made to find compatible
Index: docs/manual/states.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/states.xml,v
retrieving revision 1.5
diff -u -u -r1.5 states.xml
--- docs/manual/states.xml	14 Sep 2002 14:13:34 -0000	1.5
+++ docs/manual/states.xml	23 Jan 2003 16:49:12 -0000
@@ -46,7 +46,7 @@
     <programlisting>
   GstElement *bin;
 
-  // create a bin, put elements in it and connect them
+  // create a bin, put elements in it and link them
   ...
   gst_element_set_state (bin, GST_STATE_PLAYING);
   ...
Index: docs/manual/threads.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/threads.xml,v
retrieving revision 1.13
diff -u -u -r1.13 threads.xml
--- docs/manual/threads.xml	9 Jan 2003 14:15:27 -0000	1.13
+++ docs/manual/threads.xml	23 Jan 2003 16:49:12 -0000
@@ -23,7 +23,7 @@
   gst_bin_add (GST_BIN (my_thread), GST_ELEMENT (funky_src));
   gst_bin_add (GST_BIN (my_thread), GST_ELEMENT (cool_effect));
 
-  /* connect the elements here... */
+  /* link the elements here... */
   ...
   
   /* start playing */
@@ -41,7 +41,7 @@
     <title>Constraints placed on the pipeline by the GstThread</title>
     <para>
       Within the pipeline, everything is the same as in any other bin. The
-      difference lies at the thread boundary, at the connection between the
+      difference lies at the thread boundary, at the link between the
       thread and the outside world (containing bin).  Since GStreamer is
       fundamentally buffer-oriented rather than byte-oriented, the natural
       solution to this problem is an element that can "buffer" the buffers
@@ -135,7 +135,7 @@
 
   /* add objects to the thread */
   gst_bin_add_many (GST_BIN (thread), filesrc, decoder, audiosink, NULL);
-  /* connect them in the logical order */
+  /* link them in the logical order */
   gst_element_link_many (filesrc, decoder, audiosink, NULL);
 
   /* start playing */
Index: docs/manual/typedetection.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/manual/typedetection.xml,v
retrieving revision 1.7
diff -u -u -r1.7 typedetection.xml
--- docs/manual/typedetection.xml	9 Jan 2003 14:15:27 -0000	1.7
+++ docs/manual/typedetection.xml	23 Jan 2003 16:49:12 -0000
@@ -103,7 +103,7 @@
   </programlisting>
   <para>
     We create a very simple pipeline with only a filesrc and the typefind
-    element in it. The sinkpad of the typefind element has been connected
+    element in it. The sinkpad of the typefind element has been linked
     to the source pad of the filesrc.
   </para>
   <para>
@@ -140,7 +140,7 @@
   <para>
     A more useful option would be to use the registry to look up an element
     that can handle this particular caps structure, or we can also use the
-    autoplugger to connect this caps structure to, for example, a videosink.
+    autoplugger to link this caps structure to, for example, a videosink.
   </para>
 
 </chapter>
Index: docs/pwg/basics_elements.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/pwg/basics_elements.xml,v
retrieving revision 1.1
diff -u -u -r1.1 basics_elements.xml
--- docs/pwg/basics_elements.xml	27 Sep 2002 18:34:32 -0000	1.1
+++ docs/pwg/basics_elements.xml	23 Jan 2003 16:49:12 -0000
@@ -16,7 +16,7 @@
   </para>
   <para>
     Elements are at the core of &GStreamer;. Without elements, &GStreamer; is
-    just a bunch of pipe fittings with nothing to connect. A large number of
+    just a bunch of pipe fittings with nothing to link. A large number of
     elements (filters, sources, and sinks) ship with &GStreamer;, but extra
     elements can also be written. The purpose of this guide is to help you
     learn to create new elements.
Index: docs/pwg/basics_types.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/pwg/basics_types.xml,v
retrieving revision 1.1
diff -u -u -r1.1 basics_types.xml
--- docs/pwg/basics_types.xml	27 Sep 2002 18:34:32 -0000	1.1
+++ docs/pwg/basics_types.xml	23 Jan 2003 16:49:12 -0000
@@ -6,7 +6,7 @@
   <para>
     A type system is used to ensure that the data passed between elements is in
     a recognised format, and that the various parameters required to fully
-    specify that format match up correctly. Each connection that is made between
+    specify that format match up correctly. Each link that is made between
     elements has a specified type. This is related, but different, to the
     metadata in buffers which describes the type of data in that particular
     buffer. See the next chapter of this document for details of the available
Index: docs/pwg/building_testapp.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/pwg/building_testapp.xml,v
retrieving revision 1.1
diff -u -u -r1.1 building_testapp.xml
--- docs/pwg/building_testapp.xml	27 Sep 2002 18:34:32 -0000	1.1
+++ docs/pwg/building_testapp.xml	23 Jan 2003 16:49:12 -0000
@@ -11,8 +11,8 @@
   </para>
 </chapter>
 
-<chapter id="cha-testapp-connect">
-  <title>Connecting the plugins</title>
+<chapter id="cha-testapp-link">
+  <title>Linking the plugins</title>
   <para>
   </para>
 </chapter>
Index: docs/pwg/intro_basics.xml
===================================================================
RCS file: /cvsroot/gstreamer/gstreamer/docs/pwg/intro_basics.xml,v
retrieving revision 1.2
diff -u -u -r1.2 intro_basics.xml
--- docs/pwg/intro_basics.xml	28 Nov 2002 08:37:12 -0000	1.2
+++ docs/pwg/intro_basics.xml	23 Jan 2003 16:49:12 -0000
@@ -18,10 +18,10 @@
       Elements are at the core of &GStreamer;. In the context of plugin
       development, an <emphasis>element</emphasis> is an object derived from the
       <classname>GstElement</classname> class. Elements provide some sort of
-      functionality when connected with other elements: For example, a source
+      functionality when linked with other elements: For example, a source
       element provides data to a stream, and a filter element acts on the data
       in a stream. Without elements, &GStreamer; is just a bunch of conceptual
-      pipe fittings with nothing to connect. A large number of elements ship
+      pipe fittings with nothing to link. A large number of elements ship
       with &GStreamer;, but extra elements can also be written.
     </para>
     <para>
@@ -37,7 +37,7 @@
       A <emphasis>filter</emphasis> is an important type of element that
       processes a stream of data. Producers and consumers of data are called
       <emphasis>source</emphasis> and <emphasis>sink</emphasis> elements,
-      respectively. Elements that connect other elements together are called
+      respectively. Elements that link other elements together are called
       <emphasis>autoplugger</emphasis> elements, and a <emphasis>bin</emphasis>
       element contains other elements. Bins are often responsible for scheduling
       the elements that they contain so that data flows smoothly.
@@ -65,27 +65,27 @@
   <sect1 id="sect1-basics-pads" xreflabel="Pads">
     <title>Pads</title>
     <para>
-      <emphasis>Pads</emphasis> are used to negotiate connections and data flow
+      <emphasis>Pads</emphasis> are used to negotiate links and data flow
       between elements in &GStreamer;. A pad can be viewed as a
       <quote>place</quote> or <quote>port</quote> on an element where
-      connections may be made with other elements. Pads have specific data
+      links may be made with other elements. Pads have specific data
       handling capabilities: A pad only knows how to give or receive certain
-      types of data. Connections are only allowed when the capabilities of two
+      types of data. Links are only allowed when the capabilities of two
       pads are compatible.
     </para>
     <para>
       An analogy may be helpful here. A pad is similar to a plug or jack on a
       physical device. Consider, for example, a home theater system consisting
-      of an amplifier, a DVD player, and a (silent) video projector. Connecting
+      of an amplifier, a DVD player, and a (silent) video projector. Linking
       the DVD player to the amplifier is allowed because both devices have audio
-      jacks, and connecting the projector to the DVD player is allowed because
-      both devices have compatible video jacks. Connections between the
+      jacks, and linking the projector to the DVD player is allowed because
+      both devices have compatible video jacks. Links between the
       projector and the amplifier may not be made because the projector and
       amplifier have different types of jacks. Pads in &GStreamer; serve the
       same purpose as the jacks in the home theater system.
     </para>
     <para>
-      For the moment, all data in &GStreamer; flows one way through a connection
+      For the moment, all data in &GStreamer; flows one way through a link
       between elements. Data flows out of one element through one or more
       <emphasis>source pads</emphasis>, and elements accept incoming data through
       one or more <emphasis>sink pads</emphasis>. Source and sink elements have
@@ -107,7 +107,7 @@
       passed from a source pad on one element to a sink pad on another element.
       <emphasis>Buffers</emphasis> are structures used to hold these chunks of
       data. Buffers can be of any size, theoretically, and they may contain any
-      sort of data that the two connected pads know how to handle. Normally, a
+      sort of data that the two linked pads know how to handle. Normally, a
       buffer contains a chunk of some sort of audio or video data that flows
       from one element to another.
     </para>
@@ -188,7 +188,7 @@
       &GStreamer; uses a type system to ensure that the data passed between
       elements is in a recognized format. The type system is also important for
       ensuring that the parameters required to fully specify a format match up
-      correctly when connecting pads between elements. Each connection that is
+      correctly when linking pads between elements. Each link that is
       made between elements has a specified type.
     </para>
 


More information about the gstreamer-devel mailing list