[poppler] glib/Makefile.am glib/poppler-annot.cc glib/poppler-attachment.h glib/poppler-document.cc glib/poppler-media.h glib/poppler-page.cc

Carlos Garcia Campos carlosgc at kemper.freedesktop.org
Fri Jan 20 06:22:27 PST 2012


 glib/Makefile.am          |    4 +++-
 glib/poppler-annot.cc     |    8 ++++----
 glib/poppler-attachment.h |    7 ++++---
 glib/poppler-document.cc  |    6 ++++--
 glib/poppler-media.h      |    7 ++++---
 glib/poppler-page.cc      |   23 +++++++++++++++--------
 6 files changed, 34 insertions(+), 21 deletions(-)

New commits:
commit 4765c3289635fe4fb006e7df4f83d7056eb42855
Author: Evan Nemerson <evan at coeus-group.com>
Date:   Sun Jan 15 11:02:50 2012 -0800

    glib: various minor introspection and documentation improvements
    
    Bug 44790

diff --git a/glib/Makefile.am b/glib/Makefile.am
index 67116fc..54e4085 100644
--- a/glib/Makefile.am
+++ b/glib/Makefile.am
@@ -91,12 +91,14 @@ INTROSPECTION_GIRS =
 INTROSPECTION_SCANNER_ARGS = --add-include-path=$(srcdir)
 INTROSPECTION_COMPILER_ARGS = --includedir=$(srcdir)
 
-introspection_files = $(libpoppler_glib_la_SOURCES) $(poppler_glib_include_HEADERS)
+introspection_files = $(libpoppler_glib_la_SOURCES) $(poppler_glib_include_HEADERS) $(nodist_poppler_glib_include_HEADERS)
 Poppler-0.18.gir: libpoppler-glib.la
 Poppler_0_18_gir_INCLUDES = GObject-2.0 cairo-1.0
 Poppler_0_18_gir_CFLAGS = $(INCLUDES) -I$(top_builddir)
 Poppler_0_18_gir_LIBS = libpoppler-glib.la
 Poppler_0_18_gir_FILES = $(addprefix $(srcdir)/, $(introspection_files))
+Poppler_0_18_gir_SCANNERFLAGS = --c-include poppler.h
+Poppler_0_18_gir_EXPORT_PACKAGES = poppler-glib
 
 INTROSPECTION_GIRS += Poppler-0.18.gir
 
diff --git a/glib/poppler-annot.cc b/glib/poppler-annot.cc
index a69644d..2f9ef9c 100644
--- a/glib/poppler-annot.cc
+++ b/glib/poppler-annot.cc
@@ -1167,7 +1167,7 @@ poppler_annot_free_text_get_quadding (PopplerAnnotFreeText *poppler_annot)
  * line attached to the @poppler_annot.
  *
  * Return value: a new allocated #PopplerCalloutLine if the annot has a callout
- *               line, NULL in other case. It must be freed with g_free() when
+ *               line, %NULL in other case. It must be freed with g_free() when
  *               done.
  **/
 PopplerAnnotCalloutLine *
@@ -1211,7 +1211,7 @@ poppler_annot_free_text_get_callout_line (PopplerAnnotFreeText *poppler_annot)
  * Creates a #PopplerAttachment for the file of the file attachment annotation @annot.
  * The #PopplerAttachment must be unrefed with g_object_unref by the caller.
  *
- * Return value: @PopplerAttachment
+ * Return value: (transfer full): @PopplerAttachment
  *
  * Since: 0.14
  **/
@@ -1266,7 +1266,7 @@ POPPLER_DEFINE_BOXED_TYPE (PopplerAnnotCalloutLine, poppler_annot_callout_line,
  *
  * Creates a new empty #PopplerAnnotCalloutLine.
  *
- * Return value: a new allocated #PopplerAnnotCalloutLine, NULL in other case.
+ * Return value: a new allocated #PopplerAnnotCalloutLine, %NULL in other case.
  *               It must be freed when done.
  **/
 PopplerAnnotCalloutLine *
@@ -1282,7 +1282,7 @@ poppler_annot_callout_line_new (void)
  * It does copy @callout to a new #PopplerAnnotCalloutLine.
  *
  * Return value: a new allocated #PopplerAnnotCalloutLine as exact copy of
- *               @callout, NULL in other case. It must be freed when done.
+ *               @callout, %NULL in other case. It must be freed when done.
  **/
 PopplerAnnotCalloutLine *
 poppler_annot_callout_line_copy (PopplerAnnotCalloutLine *callout)
diff --git a/glib/poppler-attachment.h b/glib/poppler-attachment.h
index 7d24c4a..e87971e 100644
--- a/glib/poppler-attachment.h
+++ b/glib/poppler-attachment.h
@@ -34,10 +34,11 @@ G_BEGIN_DECLS
 
 /**
  * PopplerAttachmentSaveFunc:
- * @buf: buffer containing bytes to be written.
+ * @buf: (array length=count) (element-type guint8): buffer containing
+ *   bytes to be written.
  * @count: number of bytes in @buf.
- * @data: user data passed to poppler_attachment_save_to_callback()
- * @error: GError to set on error, or NULL
+ * @data: (closure): user data passed to poppler_attachment_save_to_callback()
+ * @error: GError to set on error, or %NULL
  *
  * Specifies the type of the function passed to
  * poppler_attachment_save_to_callback().  It is called once for each block of
diff --git a/glib/poppler-document.cc b/glib/poppler-document.cc
index 745bc9b..4dd5519 100644
--- a/glib/poppler-document.cc
+++ b/glib/poppler-document.cc
@@ -2323,7 +2323,8 @@ poppler_layers_iter_get_title (PopplerLayersIter *iter)
  * Returns the #PopplerLayer associated with @iter.  It must be freed with
  * poppler_layer_free().
  * 
- * Return value: a new #PopplerLayer, or %NULL if there isn't any layer associated with @iter
+ * Return value: (transfer full): a new #PopplerLayer, or %NULL if
+ * there isn't any layer associated with @iter
  *
  * Since: 0.12
  **/
@@ -2496,7 +2497,8 @@ poppler_ps_file_free (PopplerPSFile *ps_file)
  * Returns the #PopplerFormField for the given @id. It must be freed with
  * g_object_unref()
  *
- * Return value: a new #PopplerFormField or NULL if not found
+ * Return value: (transfer full): a new #PopplerFormField or %NULL if
+ * not found
  **/
 PopplerFormField *
 poppler_document_get_form_field (PopplerDocument *document,
diff --git a/glib/poppler-media.h b/glib/poppler-media.h
index c8ad222..f324e1b 100644
--- a/glib/poppler-media.h
+++ b/glib/poppler-media.h
@@ -33,10 +33,11 @@ G_BEGIN_DECLS
 
 /**
  * PopplerMediaSaveFunc:
- * @buf: buffer containing bytes to be written.
+ * @buf: (array length=count) (element-type guint8): buffer containing
+ *   bytes to be written.
  * @count: number of bytes in @buf.
- * @data: user data passed to poppler_media_save_to_callback()
- * @error: GError to set on error, or NULL
+ * @data: (closure): user data passed to poppler_media_save_to_callback()
+ * @error: GError to set on error, or %NULL
  *
  * Specifies the type of the function passed to
  * poppler_media_save_to_callback().  It is called once for each block of
diff --git a/glib/poppler-page.cc b/glib/poppler-page.cc
index 9850d44..b5e03f1 100644
--- a/glib/poppler-page.cc
+++ b/glib/poppler-page.cc
@@ -175,7 +175,7 @@ poppler_page_get_duration (PopplerPage *page)
  *
  * Returns the transition effect of @page
  *
- * Return value: a #PopplerPageTransition or NULL.
+ * Return value: a #PopplerPageTransition or %NULL.
  **/
 PopplerPageTransition *
 poppler_page_get_transition (PopplerPage *page)
@@ -691,7 +691,8 @@ poppler_page_get_selection_region (PopplerPage           *page,
 
 /**
  * poppler_page_selection_region_free:
- * @region: a #GList of #PopplerRectangle
+ * @region: (element-type PopplerRectangle): a #GList of
+ *   #PopplerRectangle
  *
  * Frees @region
  *
@@ -1030,7 +1031,8 @@ poppler_page_get_image (PopplerPage *page,
 
 /**
  * poppler_page_free_image_mapping:
- * @list: A list of #PopplerImageMapping<!-- -->s
+ * @list: (element-type PopplerImageMapping): A list of
+ *   #PopplerImageMapping<!-- -->s
  *
  * Frees a list of #PopplerImageMapping<!-- -->s allocated by
  * poppler_page_get_image_mapping().
@@ -1209,7 +1211,9 @@ poppler_page_get_link_mapping (PopplerPage *page)
 
 /**
  * poppler_page_free_link_mapping:
- * @list: A list of #PopplerLinkMapping<!-- -->s
+
+ * @list: (element-type PopplerLinkMapping): A list of
+ *   #PopplerLinkMapping<!-- -->s
  * 
  * Frees a list of #PopplerLinkMapping<!-- -->s allocated by
  * poppler_page_get_link_mapping().  It also frees the #PopplerAction<!-- -->s
@@ -1277,7 +1281,8 @@ poppler_page_get_form_field_mapping (PopplerPage *page)
 
 /**
  * poppler_page_free_form_field_mapping:
- * @list: A list of #PopplerFormFieldMapping<!-- -->s
+ * @list: (element-type PopplerFormFieldMapping): A list of
+ *   #PopplerFormFieldMapping<!-- -->s
  *
  * Frees a list of #PopplerFormFieldMapping<!-- -->s allocated by
  * poppler_page_get_form_field_mapping().
@@ -1396,7 +1401,8 @@ poppler_page_get_annot_mapping (PopplerPage *page)
 
 /**
  * poppler_page_free_annot_mapping:
- * @list: A list of #PopplerAnnotMapping<!-- -->s
+ * @list: (element-type PopplerAnnotMapping): A list of
+ *   #PopplerAnnotMapping<!-- -->s
  *
  * Frees a list of #PopplerAnnotMapping<!-- -->s allocated by
  * poppler_page_get_annot_mapping().  It also frees the #PopplerAnnot<!-- -->s
@@ -2007,8 +2013,9 @@ poppler_page_get_text_layout (PopplerPage       *page,
 }
 
 /**
- * poppler_page_free_text_attributes;
- * @list: A list of #PopplerTextAttributes<!-- -->s
+ * poppler_page_free_text_attributes:
+ * @list: (element-type PopplerTextAttributes): A list of
+ *   #PopplerTextAttributes<!-- -->s
  *
  * Frees a list of #PopplerTextAttributes<!-- -->s allocated by
  * poppler_page_get_text_attributes().


More information about the poppler mailing list