Commit e10266e3 authored by Evan Nemerson's avatar Evan Nemerson Committed by Tim-Philipp Müller

docs: convert NULL, TRUE, and FALSE to %NULL, %TRUE, and %FALSE

This should help improve documentation generated for
languages other than C.

https://bugzilla.gnome.org/show_bug.cgi?id=730961
parent 88191aa8
......@@ -53,7 +53,7 @@
* </programlisting>
* </example>
*
* It's allowed to pass two NULL pointers to gst_init() in case you don't want
* It's allowed to pass two %NULL pointers to gst_init() in case you don't want
* to pass the command line args to GStreamer.
*
* You can also use GOption to initialize your own parameters as shown in
......@@ -400,7 +400,7 @@ gst_init (int *argc, char **argv[])
* Use this function to check if GStreamer has been initialized with gst_init()
* or gst_init_check().
*
* Returns: TRUE if initialization has been done, FALSE otherwise.
* Returns: %TRUE if initialization has been done, %FALSE otherwise.
*/
gboolean
gst_is_initialized (void)
......@@ -693,7 +693,7 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data,
* gstreamer as being initialized, since it is the case from a plugin point of
* view.
*
* If anything fails, it will be put back to FALSE in gst_init_check().
* If anything fails, it will be put back to %FALSE in gst_init_check().
* This allows some special plugins that would call gst_init() to not cause a
* looping effect (i.e. initializing GStreamer twice).
*/
......
......@@ -25,7 +25,7 @@
* @see_also: #GstMemory
*
* Memory is usually created by allocators with a gst_allocator_alloc()
* method call. When NULL is used as the allocator, the default allocator will
* method call. When %NULL is used as the allocator, the default allocator will
* be used.
*
* New allocators can be registered with gst_allocator_register().
......@@ -218,10 +218,10 @@ gst_allocator_register (const gchar * name, GstAllocator * allocator)
* gst_allocator_find:
* @name: (allow-none): the name of the allocator
*
* Find a previously registered allocator with @name. When @name is NULL, the
* Find a previously registered allocator with @name. When @name is %NULL, the
* default allocator will be returned.
*
* Returns: (transfer full): a #GstAllocator or NULL when the allocator with @name was not
* Returns: (transfer full): a #GstAllocator or %NULL when the allocator with @name was not
* registered. Use gst_object_unref() to release the allocator after usage.
*/
GstAllocator *
......@@ -274,13 +274,13 @@ gst_allocator_set_default (GstAllocator * allocator)
* @size big.
*
* The optional @params can specify the prefix and padding for the memory. If
* NULL is passed, no flags, no extra prefix/padding and a default alignment is
* %NULL is passed, no flags, no extra prefix/padding and a default alignment is
* used.
*
* The prefix/padding will be filled with 0 if flags contains
* #GST_MEMORY_FLAG_ZERO_PREFIXED and #GST_MEMORY_FLAG_ZERO_PADDED respectively.
*
* When @allocator is NULL, the default allocator will be used.
* When @allocator is %NULL, the default allocator will be used.
*
* The alignment in @params is given as a bitmask so that @align + 1 equals
* the amount of bytes to align to. For example, to align to 8 bytes,
......
......@@ -214,7 +214,7 @@ gst_atomic_queue_unref (GstAtomicQueue * queue)
*
* Peek the head element of the queue without removing it from the queue.
*
* Returns: (transfer none): the head element of @queue or NULL when
* Returns: (transfer none): the head element of @queue or %NULL when
* the queue is empty.
*/
gpointer
......@@ -264,7 +264,7 @@ gst_atomic_queue_peek (GstAtomicQueue * queue)
*
* Get the head element of the queue.
*
* Returns: (transfer full): the head element of @queue or NULL when
* Returns: (transfer full): the head element of @queue or %NULL when
* the queue is empty.
*/
gpointer
......
......@@ -148,8 +148,8 @@
* </variablelist>
*
* A #GstBin will by default forward any event sent to it to all sink elements.
* If all the sinks return TRUE, the bin will also return TRUE, else FALSE is
* returned. If no sinks are in the bin, the event handler will return TRUE.
* If all the sinks return %TRUE, the bin will also return %TRUE, else %FALSE is
* returned. If no sinks are in the bin, the event handler will return %TRUE.
*
* </para>
* </refsect2>
......@@ -370,7 +370,7 @@ gst_bin_class_init (GstBinClass * klass)
/**
* GstBin:async-handling:
*
* If set to #TRUE, the bin will handle asynchronous state changes.
* If set to %TRUE, the bin will handle asynchronous state changes.
* This should be used only if the bin subclass is modifying the state
* of its children on its own.
*/
......@@ -1279,7 +1279,7 @@ had_parent:
*
* MT safe.
*
* Returns: TRUE if the element could be added, FALSE if
* Returns: %TRUE if the element could be added, %FALSE if
* the bin does not want to accept the element.
*/
gboolean
......@@ -1592,7 +1592,7 @@ not_in_bin:
*
* MT safe.
*
* Returns: TRUE if the element could be removed, FALSE if
* Returns: %TRUE if the element could be removed, %FALSE if
* the bin does not want to remove the element.
*/
gboolean
......@@ -1633,7 +1633,7 @@ no_function:
*
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement, or NULL
* Returns: (transfer full): a #GstIterator of #GstElement, or %NULL
*/
GstIterator *
gst_bin_iterate_elements (GstBin * bin)
......@@ -1673,7 +1673,7 @@ iterate_child_recurse (GstIterator * it, const GValue * item)
*
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement, or NULL
* Returns: (transfer full): a #GstIterator of #GstElement, or %NULL
*/
GstIterator *
gst_bin_iterate_recurse (GstBin * bin)
......@@ -1730,7 +1730,7 @@ sink_iterator_filter (const GValue * vchild, GValue * vbin)
*
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement, or NULL
* Returns: (transfer full): a #GstIterator of #GstElement, or %NULL
*/
GstIterator *
gst_bin_iterate_sinks (GstBin * bin)
......@@ -1790,7 +1790,7 @@ src_iterator_filter (const GValue * vchild, GValue * vbin)
*
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement, or NULL
* Returns: (transfer full): a #GstIterator of #GstElement, or %NULL
*/
GstIterator *
gst_bin_iterate_sources (GstBin * bin)
......@@ -2166,7 +2166,7 @@ gst_bin_sort_iterator_new (GstBin * bin)
*
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement, or NULL
* Returns: (transfer full): a #GstIterator of #GstElement, or %NULL
*/
GstIterator *
gst_bin_iterate_sorted (GstBin * bin)
......@@ -4122,11 +4122,11 @@ compare_name (const GValue * velement, const gchar * name)
* Gets the element with the given name from a bin. This
* function recurses into child bins.
*
* Returns NULL if no element with the given name is found in the bin.
* Returns %NULL if no element with the given name is found in the bin.
*
* MT safe. Caller owns returned reference.
*
* Returns: (transfer full): the #GstElement with the given name, or NULL
* Returns: (transfer full): the #GstElement with the given name, or %NULL
*/
GstElement *
gst_bin_get_by_name (GstBin * bin, const gchar * name)
......@@ -4164,12 +4164,12 @@ gst_bin_get_by_name (GstBin * bin, const gchar * name)
* Gets the element with the given name from this bin. If the
* element is not found, a recursion is performed on the parent bin.
*
* Returns NULL if:
* Returns %NULL if:
* - no element with the given name is found in the bin
*
* MT safe. Caller owns returned reference.
*
* Returns: (transfer full): the #GstElement with the given name, or NULL
* Returns: (transfer full): the #GstElement with the given name, or %NULL
*/
GstElement *
gst_bin_get_by_name_recurse_up (GstBin * bin, const gchar * name)
......@@ -4270,7 +4270,7 @@ gst_bin_get_by_interface (GstBin * bin, GType iface)
* MT safe. Caller owns returned value.
*
* Returns: (transfer full): a #GstIterator of #GstElement for all elements
* in the bin implementing the given interface, or NULL
* in the bin implementing the given interface, or %NULL
*/
GstIterator *
gst_bin_iterate_all_by_interface (GstBin * bin, GType iface)
......
......@@ -635,22 +635,22 @@ gst_buffer_new (void)
/**
* gst_buffer_new_allocate:
* @allocator: (transfer none) (allow-none): the #GstAllocator to use, or NULL to use the
* @allocator: (transfer none) (allow-none): the #GstAllocator to use, or %NULL to use the
* default allocator
* @size: the size in bytes of the new buffer's data.
* @params: (transfer none) (allow-none): optional parameters
*
* Tries to create a newly allocated buffer with data of the given size and
* extra parameters from @allocator. If the requested amount of memory can't be
* allocated, NULL will be returned. The allocated buffer memory is not cleared.
* allocated, %NULL will be returned. The allocated buffer memory is not cleared.
*
* When @allocator is NULL, the default memory allocator will be used.
* When @allocator is %NULL, the default memory allocator will be used.
*
* Note that when @size == 0, the buffer will not have memory associated with it.
*
* MT safe.
*
* Returns: (transfer full): a new #GstBuffer, or NULL if the memory couldn't
* Returns: (transfer full): a new #GstBuffer, or %NULL if the memory couldn't
* be allocated.
*/
GstBuffer *
......@@ -1842,7 +1842,7 @@ gst_buffer_memset (GstBuffer * buffer, gsize offset, guint8 val, gsize size)
*
* MT safe.
*
* Returns: (transfer full): the new #GstBuffer or NULL if the arguments were
* Returns: (transfer full): the new #GstBuffer or %NULL if the arguments were
* invalid.
*/
GstBuffer *
......@@ -1932,7 +1932,7 @@ gst_buffer_append_region (GstBuffer * buf1, GstBuffer * buf2, gssize offset,
* @api: the #GType of an API
*
* Get the metadata for @api on buffer. When there is no such
* metadata, NULL is returned.
* metadata, %NULL is returned.
*
* Returns: (transfer none): the metadata for @api on @buffer.
*/
......
......@@ -467,9 +467,9 @@ gboolean gst_buffer_copy_into (GstBuffer *dest, GstBuffer *src
* in some cases), and the reference counts are updated appropriately (the old
* buffer is unreffed, the new is reffed).
*
* Either @nbuf or the #GstBuffer pointed to by @obuf may be NULL.
* Either @nbuf or the #GstBuffer pointed to by @obuf may be %NULL.
*
* Returns: TRUE when @obuf was different from @nbuf.
* Returns: %TRUE when @obuf was different from @nbuf.
*/
#ifdef _FOOL_GTK_DOC_
G_INLINE_FUNC gboolean gst_buffer_replace (GstBuffer **obuf, GstBuffer *nbuf);
......@@ -507,7 +507,7 @@ GstBuffer* gst_buffer_append (GstBuffer *buf1, GstBuffer *buf
* When this function returns %TRUE, the next meta will be
* returned. When %FALSE is returned, gst_buffer_foreach_meta() will return.
*
* When @meta is set to NULL, the item will be removed from the buffer.
* When @meta is set to %NULL, the item will be removed from the buffer.
*
* Returns: %FALSE when gst_buffer_foreach_meta() should stop
*/
......
......@@ -227,7 +227,7 @@ gst_buffer_list_foreach (GstBufferList * list, GstBufferListFunc func,
*
* Get the buffer at @idx.
*
* Returns: (transfer none): the buffer at @idx in @group or NULL when there
* Returns: (transfer none): the buffer at @idx in @group or %NULL when there
* is no buffer. The buffer remains valid as long as @list is valid.
*/
GstBuffer *
......
......@@ -48,7 +48,7 @@ typedef struct _GstBufferList GstBufferList;
* When this function returns %TRUE, the next buffer will be
* returned. When %FALSE is returned, gst_buffer_list_foreach() will return.
*
* When @buffer is set to NULL, the item will be removed from the bufferlist.
* When @buffer is set to %NULL, the item will be removed from the bufferlist.
* When @buffer has been made writable, the new buffer reference can be assigned
* to @buffer. This function is responsible for unreffing the old buffer when
* removing or modifying.
......
......@@ -608,7 +608,7 @@ wrong_config:
* the configuration haven't change, this function will return %TRUE. If the
* pool is active, this function will try deactivating it. Buffers allocated
* form this pool must be returned or else this function will do nothing and
* return FALSE.
* return %FALSE.
*
* @config is a #GstStructure that contains the configuration parameters for
* the pool. A default and mandatory set of parameters can be configured with
......
......@@ -291,7 +291,7 @@ gst_bus_new (void)
* Post a message on the given bus. Ownership of the message
* is taken by the bus.
*
* Returns: TRUE if the message could be posted, FALSE if the bus is flushing.
* Returns: %TRUE if the message could be posted, %FALSE if the bus is flushing.
*
* MT safe.
*/
......@@ -402,7 +402,7 @@ is_flushing:
* Check if there are pending messages on the bus that
* should be handled.
*
* Returns: TRUE if there are messages on the bus to be handled, FALSE
* Returns: %TRUE if there are messages on the bus to be handled, %FALSE
* otherwise.
*
* MT safe.
......@@ -427,7 +427,7 @@ gst_bus_have_pending (GstBus * bus)
*
* If @flushing, flush out and unref any messages queued in the bus. Releases
* references to the message origin objects. Will flush future messages until
* gst_bus_set_flushing() sets @flushing to #FALSE.
* gst_bus_set_flushing() sets @flushing to %FALSE.
*
* MT safe.
*/
......@@ -468,7 +468,7 @@ gst_bus_set_flushing (GstBus * bus, gboolean flushing)
* matching message was posted on the bus.
*
* Returns: (transfer full): a #GstMessage matching the filter in @types,
* or NULL if no matching message was found on the bus until the timeout
* or %NULL if no matching message was found on the bus until the timeout
* expired. The message is taken from the bus and needs to be unreffed
* with gst_message_unref() after usage.
*
......@@ -569,7 +569,7 @@ beach:
* posted on the bus.
*
* Returns: (transfer full): the #GstMessage that is on the bus after the
* specified timeout or NULL if the bus is empty after the timeout expired.
* specified timeout or %NULL if the bus is empty after the timeout expired.
* The message is taken from the bus and needs to be unreffed with
* gst_message_unref() after usage.
*
......@@ -595,7 +595,7 @@ gst_bus_timed_pop (GstBus * bus, GstClockTime timeout)
* enums beyond #GST_MESSAGE_EXTENDED in the @events mask.
*
* Returns: (transfer full): the next #GstMessage matching @type that is on
* the bus, or NULL if the bus is empty or there is no message matching
* the bus, or %NULL if the bus is empty or there is no message matching
* @type. The message is taken from the bus and needs to be unreffed with
* gst_message_unref() after usage.
*
......@@ -616,7 +616,7 @@ gst_bus_pop_filtered (GstBus * bus, GstMessageType types)
*
* Get a message from the bus.
*
* Returns: (transfer full): the #GstMessage that is on the bus, or NULL if the
* Returns: (transfer full): the #GstMessage that is on the bus, or %NULL if the
* bus is empty. The message is taken from the bus and needs to be unreffed
* with gst_message_unref() after usage.
*
......@@ -638,7 +638,7 @@ gst_bus_pop (GstBus * bus)
* on the bus' message queue. A reference is returned, and needs to be unreffed
* by the caller.
*
* Returns: (transfer full): the #GstMessage that is on the bus, or NULL if the
* Returns: (transfer full): the #GstMessage that is on the bus, or %NULL if the
* bus is empty.
*
* MT safe.
......@@ -675,7 +675,7 @@ gst_bus_peek (GstBus * bus)
* should handle messages asynchronously using the gst_bus watch and poll
* functions.
*
* You cannot replace an existing sync_handler. You can pass NULL to this
* You cannot replace an existing sync_handler. You can pass %NULL to this
* function, which will clear the existing handler.
*/
void
......@@ -896,7 +896,7 @@ gst_bus_add_watch_full_unlocked (GstBus * bus, gint priority,
* When @func is called, the message belongs to the caller; if you want to
* keep a copy of it, call gst_message_ref() before leaving @func.
*
* The watch can be removed using g_source_remove() or by returning FALSE
* The watch can be removed using g_source_remove() or by returning %FALSE
* from @func.
*
* MT safe.
......@@ -935,7 +935,7 @@ gst_bus_add_watch_full (GstBus * bus, gint priority,
* There can only be a single bus watch per bus, you must remove it before you
* can set a new one.
*
* The watch can be removed using g_source_remove() or by returning FALSE
* The watch can be removed using g_source_remove() or by returning %FALSE
* from @func.
*
* Returns: The event source id.
......@@ -1054,7 +1054,7 @@ poll_destroy_timeout (GstBusPollData * poll_data)
* better handled by setting up an asynchronous bus watch and doing things
* from there.
*
* Returns: (transfer full): the message that was received, or NULL if the
* Returns: (transfer full): the message that was received, or %NULL if the
* poll timed out. The message is taken from the bus and needs to be
* unreffed with gst_message_unref() after usage.
*/
......@@ -1113,7 +1113,7 @@ gst_bus_poll (GstBus * bus, GstMessageType events, GstClockTime timeout)
* A helper #GstBusFunc that can be used to convert all asynchronous messages
* into signals.
*
* Returns: TRUE
* Returns: %TRUE
*/
gboolean
gst_bus_async_signal_func (GstBus * bus, GstMessage * message, gpointer data)
......
......@@ -99,7 +99,7 @@ typedef GstBusSyncReply (*GstBusSyncHandler) (GstBus * bus, GstMessage * mess
* function so it should not be freed in the function.
*
* Note that this function is used as a GSourceFunc which means that returning
* FALSE will remove the GSource from the mainloop.
* %FALSE will remove the GSource from the mainloop.
*
* Returns: %FALSE if the event source should be removed.
*/
......
......@@ -327,7 +327,7 @@ gst_caps_new_simple (const char *media_type, const char *fieldname, ...)
* @...: additional structures to add
*
* Creates a new #GstCaps and adds all the structures listed as
* arguments. The list must be NULL-terminated. The structures
* arguments. The list must be %NULL-terminated. The structures
* are not copied; the returned #GstCaps owns the structures.
*
* Returns: (transfer full): the new #GstCaps
......@@ -351,7 +351,7 @@ gst_caps_new_full (GstStructure * struct1, ...)
* @var_args: additional structures to add
*
* Creates a new #GstCaps and adds all the structures listed as
* arguments. The list must be NULL-terminated. The structures
* arguments. The list must be %NULL-terminated. The structures
* are not copied; the returned #GstCaps owns the structures.
*
* Returns: (transfer full): the new #GstCaps
......@@ -999,7 +999,7 @@ gst_caps_set_value (GstCaps * caps, const char *field, const GValue * value)
* @varargs: additional parameters
*
* Sets fields in a #GstCaps. The arguments must be passed in the same
* manner as gst_structure_set(), and be NULL-terminated.
* manner as gst_structure_set(), and be %NULL-terminated.
*/
void
gst_caps_set_simple_valist (GstCaps * caps, const char *field, va_list varargs)
......@@ -1036,7 +1036,7 @@ gst_caps_set_simple_valist (GstCaps * caps, const char *field, va_list varargs)
* @...: additional parameters
*
* Sets fields in a #GstCaps. The arguments must be passed in the same
* manner as gst_structure_set(), and be NULL-terminated.
* manner as gst_structure_set(), and be %NULL-terminated.
*/
void
gst_caps_set_simple (GstCaps * caps, const char *field, ...)
......@@ -1059,7 +1059,7 @@ gst_caps_set_simple (GstCaps * caps, const char *field, ...)
*
* Determines if @caps represents any media format.
*
* Returns: TRUE if @caps represents any format.
* Returns: %TRUE if @caps represents any format.
*/
gboolean
gst_caps_is_any (const GstCaps * caps)
......@@ -1075,7 +1075,7 @@ gst_caps_is_any (const GstCaps * caps)
*
* Determines if @caps represents no media formats.
*
* Returns: TRUE if @caps represents no formats.
* Returns: %TRUE if @caps represents no formats.
*/
gboolean
gst_caps_is_empty (const GstCaps * caps)
......@@ -1103,7 +1103,7 @@ gst_caps_is_fixed_foreach (GQuark field_id, const GValue * value,
* one structure, and each field in the structure describes a fixed type.
* Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.
*
* Returns: TRUE if @caps is fixed
* Returns: %TRUE if @caps is fixed
*/
gboolean
gst_caps_is_fixed (const GstCaps * caps)
......@@ -1133,7 +1133,7 @@ gst_caps_is_fixed (const GstCaps * caps)
* Tests if two #GstCaps are equal. This function only works on fixed
* #GstCaps.
*
* Returns: TRUE if the arguments represent the same format
* Returns: %TRUE if the arguments represent the same format
*/
gboolean
gst_caps_is_equal_fixed (const GstCaps * caps1, const GstCaps * caps2)
......@@ -1166,7 +1166,7 @@ gst_caps_is_equal_fixed (const GstCaps * caps1, const GstCaps * caps2)
* every media format that is in the first is also contained in the
* second. That is, @caps1 is a subset of @caps2.
*
* Returns: TRUE if @caps1 is a subset of @caps2.
* Returns: %TRUE if @caps1 is a subset of @caps2.
*/
gboolean
gst_caps_is_always_compatible (const GstCaps * caps1, const GstCaps * caps2)
......@@ -1322,7 +1322,7 @@ gst_caps_is_subset_structure_full (const GstCaps * caps,
*
* Checks if the given caps represent the same set of caps.
*
* Returns: TRUE if both caps are equal.
* Returns: %TRUE if both caps are equal.
*/
gboolean
gst_caps_is_equal (const GstCaps * caps1, const GstCaps * caps2)
......@@ -1346,7 +1346,7 @@ gst_caps_is_equal (const GstCaps * caps1, const GstCaps * caps2)
*
* Checks if the given caps are exactly the same set of caps.
*
* Returns: TRUE if both caps are strictly equal.
* Returns: %TRUE if both caps are strictly equal.
*/
gboolean
gst_caps_is_strictly_equal (const GstCaps * caps1, const GstCaps * caps2)
......
......@@ -298,9 +298,9 @@ gst_caps_copy (const GstCaps * caps)
* in some cases), and the reference counts are updated appropriately (the old
* caps is unreffed, the new is reffed).
*
* Either @ncaps or the #GstCaps pointed to by @ocaps may be NULL.
* Either @ncaps or the #GstCaps pointed to by @ocaps may be %NULL.
*
* Returns: TRUE if @new_caps was different from @old_caps
* Returns: %TRUE if @new_caps was different from @old_caps
*/
#ifdef _FOOL_GTK_DOC_
G_INLINE_FUNC gboolean gst_caps_replace (GstCaps **old_caps, GstCaps *new_caps);
......@@ -323,7 +323,7 @@ gst_caps_replace (GstCaps **old_caps, GstCaps *new_caps)
* function is similar to gst_caps_replace() except that it takes ownership
* of @new_caps.
*
* Returns: TRUE if @new_caps was different from @old_caps
* Returns: %TRUE if @new_caps was different from @old_caps
*/
#ifdef _FOOL_GTK_DOC_
G_INLINE_FUNC gboolean gst_caps_take (GstCaps **old_caps, GstCaps *new_caps);
......
......@@ -203,7 +203,7 @@ gst_caps_features_new_any (void)
* @...: additional features
*
* Creates a new #GstCapsFeatures with the given features.
* The last argument must be NULL.
* The last argument must be %NULL.
*
* Free-function: gst_caps_features_free
*
......@@ -471,7 +471,7 @@ priv_gst_caps_features_append_to_gstring (const GstCapsFeatures * features,
*
* Free-function: gst_caps_features_free
*
* Returns: (transfer full): a new #GstCapsFeatures or NULL when the string could
* Returns: (transfer full): a new #GstCapsFeatures or %NULL when the string could
* not be parsed. Free with gst_caps_features_free() after use.
*
* Since: 1.2
......
......@@ -174,7 +174,7 @@ gst_child_proxy_get_children_count (GstChildProxy * parent)
*
* MT safe.
*
* Returns: TRUE if @target and @pspec could be found. FALSE otherwise. In that
* Returns: %TRUE if @target and @pspec could be found. %FALSE otherwise. In that
* case the values for @pspec and @target are not modified. Unref @target after
* usage. For plain GObjects @target is the same as @object.
*/
......@@ -274,7 +274,7 @@ not_found:
* gst_child_proxy_get_valist:
* @object: the object to query
* @first_property_name: name of the first property to get
* @var_args: return location for the first property, followed optionally by more name/return location pairs, followed by NULL
* @var_args: return location for the first property, followed optionally by more name/return location pairs, followed by %NULL
*
* Gets properties of the parent object and its children.
*/
......@@ -328,7 +328,7 @@ cant_copy:
* gst_child_proxy_get:
* @object: the parent object
* @first_property_name: name of the first property to get
* @...: return location for the first property, followed optionally by more name/return location pairs, followed by NULL
* @...: return location for the first property, followed optionally by more name/return location pairs, followed by %NULL
*
* Gets properties of the parent object and its children.
*/
......@@ -383,7 +383,7 @@ not_found:
* gst_child_proxy_set_valist:
* @object: the parent object
* @first_property_name: name of the first property to set
* @var_args: value for the first property, followed optionally by more name/value pairs, followed by NULL
* @var_args: value for the first property, followed optionally by more name/value pairs, followed by %NULL
*
* Sets properties of the parent object and its children.
*/
......@@ -440,7 +440,7 @@ cant_copy:
* gst_child_proxy_set:
* @object: the parent object
* @first_property_name: name of the first property to set
* @...: value for the first property, followed optionally by more name/value pairs, followed by NULL
* @...: value for the first property, followed optionally by more name/value pairs, followed by %NULL
*
* Sets properties of the parent object and its children.
*/
......
......@@ -130,9 +130,9 @@ gst_context_copy (const GstContext * context)
* in some cases), and the reference counts are updated appropriately (the old
* context is unreffed, the new one is reffed).
*
* Either @new_context or the #GstContext pointed to by @old_context may be NULL.
* Either @new_context or the #GstContext pointed to by @old_context may be %NULL.
*
* Returns: TRUE if @new_context was different from @old_context
* Returns: %TRUE if @new_context was different from @old_context
*/
#ifdef _FOOL_GTK_DOC_
G_INLINE_FUNC gboolean gst_context_replace (GstContext **old_context, GstContext *new_context);
......
......@@ -96,7 +96,7 @@ gst_control_source_constructor (GType type, guint n_construct_params,
*
* Gets the value for this #GstControlSource at a given timestamp.
*
* Returns: FALSE if the value couldn't be returned, TRUE otherwise.
* Returns: %FALSE if the value couldn't be returned, %TRUE otherwise.
*/
gboolean
gst_control_source_get_value (GstControlSource * self, GstClockTime timestamp,
......
......@@ -70,7 +70,7 @@ struct _GstDateTime
*
* Free-function: gst_date_time_unref
*
* Returns: (transfer full): a newly created #GstDateTime, or NULL on error
* Returns: (transfer full): a newly created #GstDateTime, or %NULL on error
*/
GstDateTime *
gst_date_time_new_from_g_date_time (GDateTime * dt)
......@@ -95,7 +95,7 @@ gst_date_time_new_from_g_date_time (GDateTime * dt)
*
* Free-function: g_date_time_unref
*
* Returns: (transfer full): a newly created #GDateTime, or NULL on error
* Returns: (transfer full): a newly created #GDateTime, or %NULL on error
*/
GDateTime *
gst_date_time_to_g_date_time (GstDateTime * datetime)
......@@ -112,8 +112,8 @@ gst_date_time_to_g_date_time (GstDateTime * datetime)
* gst_date_time_has_year:
* @datetime: a #GstDateTime
*
* Returns: TRUE if @datetime<!-- -->'s year field is set (which should always
* be the case), otherwise FALSE
* Returns: %TRUE if @datetime<!-- -->'s year field is set (which should always
* be the case), otherwise %FALSE
*/
gboolean
gst_date_time_has_year (const GstDateTime * datetime)
......@@ -127,7 +127,7 @@ gst_date_time_has_year (const GstDateTime * datetime)
* gst_date_time_has_month:
* @datetime: a #GstDateTime
*
* Returns: TRUE if @datetime<!-- -->'s month field is set, otherwise FALSE
* Returns: %TRUE if @datetime<!-- -->'s month field is set, otherwise %FALSE
*/
gboolean
gst_date_time_has_month (const GstDateTime * datetime)
......@@ -141,7 +141,7 @@ gst_date_time_has_month (const GstDateTime * datetime)
* gst_date_time_has_day:
* @datetime: a #GstDateTime
*
* Returns: TRUE if @datetime<!-- -->'s day field is set, otherwise FALSE
* Returns: %TRUE if @datetime<!-- -->'s day field is set, otherwise %FALSE
*/
gboolean
gst_date_time_has_day (const GstDateTime * datetime)
......@@ -155,8 +155,8 @@ gst_date_time_has_day (const GstDateTime * datetime)
* gst_date_time_has_time:
* @datetime: a #GstDateTime
*
* Returns: TRUE if @datetime<!-- -->'s hour and minute fields are set,
* otherwise FALSE
* Returns: %TRUE if @datetime<!-- -->'s hour and minute fields are set,