Bug 79798

Summary: Various glib documentation patches
Product: poppler Reporter: Hib Eris <hib>
Component: glib frontendAssignee: poppler-bugs <poppler-bugs>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: medium CC: hib
Version: unspecified   
Hardware: All   
OS: All   
Whiteboard:
i915 platform: i915 features:
Attachments: [glib] doc: Move PopplerColor documentation to it's own section
[glib] doc: Move poppler_get_{version, backend} documentation to features section
[glib] doc: Move PopplerError to PopplerDocument section
[glib] doc: Move PopplerPrintFlags to PopplerPage section
[glib] doc: Move PopplerFindFlags to PopplerPage section
[glib] doc: Add poppler_annot_set_flags() to documentation
[glib] doc: Fix typo
[glib] doc: Add missing POPPLER_TYPE_POINT
[glib] doc: Add PopplerBackend documentation
[glib] doc: Use <emphasis> instead of <em>
[glib] doc: Document PopplerFindFlags:POPPLER_FIND_DEFAULT
[glib] doc: Move PopplerError to PopplerDocument section
[glib] doc: Move poppler_date_parse to utility functions section
For download convenience, all patches in one file

Description Hib Eris 2014-06-08 14:24:19 UTC

    
Comment 1 Hib Eris 2014-06-08 14:24:23 UTC
Created attachment 100661 [details] [review]
[glib] doc: Move PopplerColor documentation to it's own section
Comment 2 Hib Eris 2014-06-08 14:24:27 UTC
Created attachment 100662 [details] [review]
[glib] doc: Move poppler_get_{version, backend} documentation to features section
Comment 3 Hib Eris 2014-06-08 14:24:30 UTC
Created attachment 100663 [details] [review]
[glib] doc: Move PopplerError to PopplerDocument section
Comment 4 Hib Eris 2014-06-08 14:24:33 UTC
Created attachment 100664 [details] [review]
[glib] doc: Move PopplerPrintFlags to PopplerPage section
Comment 5 Hib Eris 2014-06-08 14:24:36 UTC
Created attachment 100665 [details] [review]
[glib] doc: Move PopplerFindFlags to PopplerPage section

And also add the missing POPPLER_TYPE_FIND_FLAGS and poppler_find_flags_get_type.
Comment 6 Hib Eris 2014-06-08 14:24:39 UTC
Created attachment 100666 [details] [review]
[glib] doc: Add poppler_annot_set_flags() to documentation
Comment 7 Hib Eris 2014-06-08 14:24:42 UTC
Created attachment 100667 [details] [review]
[glib] doc: Fix typo
Comment 8 Hib Eris 2014-06-08 14:24:45 UTC
Created attachment 100668 [details] [review]
[glib] doc: Add missing POPPLER_TYPE_POINT

And while we are here, also move poppler_point_get_type() and
poppler_quadrilateral_get_type() to private subsection.
Comment 9 Hib Eris 2014-06-08 14:24:47 UTC
Created attachment 100669 [details] [review]
[glib] doc: Add PopplerBackend documentation
Comment 10 Hib Eris 2014-06-08 14:24:50 UTC
Created attachment 100670 [details] [review]
[glib] doc: Use <emphasis> instead of <em>

Fixes:
  DOC   Building HTML
Element em in namespace '' encountered in para, but no template matches.
Comment 11 Hib Eris 2014-06-08 14:24:54 UTC
Created attachment 100671 [details] [review]
[glib] doc: Document PopplerFindFlags:POPPLER_FIND_DEFAULT

Fixes warning:
  DOC   Building XML
../../glib/poppler.h:157: warning: Value description for
PopplerFindFlags::POPPLER_FIND_DEFAULT is missing in source code comment
block.
Comment 12 Hib Eris 2014-06-08 15:12:52 UTC
Created attachment 100675 [details] [review]
[glib] doc: Move PopplerError to PopplerDocument section
Comment 13 Hib Eris 2014-06-08 15:16:47 UTC
Created attachment 100676 [details] [review]
[glib] doc: Move poppler_date_parse to utility functions section
Comment 14 Hib Eris 2014-06-08 15:23:11 UTC
Created attachment 100677 [details] [review]
For download convenience, all patches in one file

For applying with 'git am'.
Comment 15 Hib Eris 2014-06-09 11:39:38 UTC
You can fetch these patches from my public git repository with:

git fetch git@gitorious.org:hiberis/poppler.git bfo-79798 && git checkout -b bfo-79798 FETCH_HEAD
Comment 16 Hib Eris 2014-06-09 11:45:35 UTC
(In reply to comment #15)
> You can fetch these patches from my public git repository with:
> 
> git fetch git@gitorious.org:hiberis/poppler.git bfo-79798 && git checkout -b
> bfo-79798 FETCH_HEAD

Whoops, that should be:

git fetch git://gitorious.org/hiberis/poppler.git bfo-79798 && git checkout -b bfo-79798 FETCH_HEAD
Comment 17 Carlos Garcia Campos 2014-06-09 13:15:31 UTC
Comment on attachment 100675 [details] [review]
[glib] doc: Move PopplerError to PopplerDocument section

Review of attachment 100675 [details] [review]:
-----------------------------------------------------------------

I'm not sure about this one, while it's tru that it's only used for document related errors, it's still PopplerError and not PopplerDocumentError, it might be expanded in the future for other errors. I've pushed all other patches to git master. Thanks!
Comment 18 Hib Eris 2014-06-09 15:30:56 UTC
(In reply to comment #17)
> Comment on attachment 100675 [details] [review] [review]
> [glib] doc: Move PopplerError to PopplerDocument section
> 
> Review of attachment 100675 [details] [review] [review]:
> -----------------------------------------------------------------
> 
> I'm not sure about this one, while it's tru that it's only used for document
> related errors, it's still PopplerError and not PopplerDocumentError, it
> might be expanded in the future for other errors. I've pushed all other
> patches to git master. Thanks!

How about moving it to it's own section then? I've provided a patch to do that in 
#79837 .
Comment 19 Hib Eris 2014-06-09 15:31:31 UTC
How about moving it to it's own section then? I've provided a patch to do that in 
bug 79837.
Comment 20 Carlos Garcia Campos 2015-12-03 10:03:08 UTC
I pushed all the patches in bug #79837, if there's anything pending, please reopen the bug.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.