GNOME Bugzilla – Bug 309158
gst_pad_set_link_function could be better documented
Last modified: 2005-07-20 19:54:12 UTC
Version details: Debian package Documentation of this function says: "Sets the given link function for the pad. It will be called when the pad is linked or relinked with caps." I don't really understand this one. What does "with caps" mean? Does that mean that the link function won't be called when linking with plain gst_pad_link or gst_element_link? This is what was said about this on the IRC channel: <kaol> I've called gst_pad_set_link_function () in my sink element's init, why won't the link function get called when I do gst_element_link ()? <Company> because the link function is called during negotiation, not during linking <Company> looks like a misnamer there I wish I could suggest what to say in the documentation instead, but I don't really understand what's going on in here.
In 0.9, it is renamed to _set_setcaps_function(), which pretty much implies its function. That's what "with caps" means. It won't be called on gst_element_link(), but after gst_element_link() completes, as soon as the format has been negotiated between this pad and its peerpad. We can't rename it, and the "with caps" implies somewhat what it does, which is good enough for 0.8.x. Therefore, marking WONTFIX.