diff options
author | Emmanuele Bassi <ebassi@gnome.org> | 2021-05-20 20:56:14 +0100 |
---|---|---|
committer | Carlos Garnacho <carlosg@gnome.org> | 2021-05-22 13:29:59 +0200 |
commit | 5d4cc95dad9c3faa0172fb9b0cd9f65e7b542ac8 (patch) | |
tree | 3dea0618690569d53fce27ccf9ee5b3d7dc05f2e /docs | |
parent | 32a9dd6e43844d880646c040b6ec7837d698d9bb (diff) | |
download | libmediaart-5d4cc95dad9c3faa0172fb9b0cd9f65e7b542ac8.tar.gz |
docs: Overhaul the build
- Use the ignore_headers argument instead of passing it to gtkdoc-scan
ourselves
- Ignore the symbol decorator for the public API
- Specify the default include
- Hide the media_art_process_get_type() function
- Build the types file, so that gtk-doc will recognise GObject types
- Add gtkdoc-check to the test suite, so that undocumented API slips
through
Diffstat (limited to 'docs')
-rw-r--r-- | docs/libmediaart-sections.txt | 5 | ||||
-rw-r--r-- | docs/meson.build | 14 |
2 files changed, 15 insertions, 4 deletions
diff --git a/docs/libmediaart-sections.txt b/docs/libmediaart-sections.txt index eb94ed2..db9d7cc 100644 --- a/docs/libmediaart-sections.txt +++ b/docs/libmediaart-sections.txt @@ -16,8 +16,6 @@ MediaArtError MediaArtProcessFlags MediaArtProcess MediaArtProcessClass -media_art_error_quark -media_art_process_get_type media_art_process_new media_art_process_uri media_art_process_uri_async @@ -28,6 +26,7 @@ media_art_process_file_finish media_art_process_buffer media_art_process_buffer_async media_art_process_buffer_finish +media_art_error_quark <SUBSECTION Standard> MEDIA_ART_IS_PROCESS MEDIA_ART_IS_PROCESS_CLASS @@ -35,6 +34,8 @@ MEDIA_ART_PROCESS MEDIA_ART_PROCESS_CLASS MEDIA_ART_PROCESS_GET_CLASS MEDIA_ART_TYPE_PROCESS +<SUBSECTION Private> +media_art_process_get_type </SECTION> <SECTION> diff --git a/docs/meson.build b/docs/meson.build index fce7248..2b6cf36 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -7,14 +7,24 @@ if get_option('gtk_doc') 'marshal.h', ] + ignored_decorators = [ + '_LIBMEDIAART_EXTERN', + ] + gnome.gtkdoc('libmediaart', namespace: 'media_art', src_dir: include_directories('../libmediaart'), main_xml: 'libmediaart-docs.xml', + ignore_headers: ignored_headers, scan_args: [ - '--ignore-headers=' + ' '.join(ignored_headers), + '--rebuild-types', + '--ignore-decorators=' + '|'.join(ignored_decorators), + ], + mkdb_args: [ + '--default-include=libmediaart/mediaart.h', ], content_files: ['overview.xml'], dependencies: libmediaart_dep, - install: true) + install: true, + check: true) endif |