From 2b09f5ea1e8ed7b66ce306aac6d64f961249cbf0 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 7 Apr 2024 12:15:01 -0400 Subject: [PATCH] dmabuf: Reshuffle docs slightly Move related parts together, for easier understanding. --- gdk/gdkdmabuftexturebuilder.c | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/gdk/gdkdmabuftexturebuilder.c b/gdk/gdkdmabuftexturebuilder.c index b895a32dc5..6508d9c2cf 100644 --- a/gdk/gdkdmabuftexturebuilder.c +++ b/gdk/gdkdmabuftexturebuilder.c @@ -949,22 +949,20 @@ gdk_dmabuf_texture_builder_set_update_region (GdkDmabufTextureBuilder *self, * * Builds a new `GdkTexture` with the values set up in the builder. * - * It is a programming error to call this function if any mandatory - * property has not been set. + * It is a programming error to call this function if any mandatory property has not been set. * - * If the dmabuf is not supported by GTK, %NULL will be returned and @error will be set. + * Not all formats defined in the `drm_fourcc.h` header are supported. You can use + * [method@Gdk.Display.get_dmabuf_formats] to get a list of supported formats. If the + * format is not supported by GTK, %NULL will be returned and @error will be set. * * The `destroy` function gets called when the returned texture gets released. * - * It is possible to call this function multiple times to create multiple textures, - * possibly with changing properties in between. - * * It is the responsibility of the caller to keep the file descriptors for the planes * open until the created texture is no longer used, and close them afterwards (possibly * using the @destroy notify). * - * Not all formats defined in the `drm_fourcc.h` header are supported. You can use - * [method@Gdk.Display.get_dmabuf_formats] to get a list of supported formats. + * It is possible to call this function multiple times to create multiple textures, + * possibly with changing properties in between. * * Returns: (transfer full) (nullable): a newly built `GdkTexture` or `NULL` * if the format is not supported