Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
doc: Port to hotdoc
  • Loading branch information
thiblahute committed May 13, 2019
1 parent cf6ed57 commit 27ba8d2
Show file tree
Hide file tree
Showing 68 changed files with 19,530 additions and 17 deletions.
1 change: 1 addition & 0 deletions docs/gst_api_version.in
@@ -0,0 +1 @@
@GST_API_VERSION@
6 changes: 6 additions & 0 deletions docs/index.md
@@ -0,0 +1,6 @@
---
short-description: GStreamer Base Plugins API reference.
...

# GStreamer Base Plugins

5 changes: 5 additions & 0 deletions docs/libs/allocators/index.md
@@ -0,0 +1,5 @@
# Allocators Library

This library should be linked to by getting cflags and libs from
gstreamer-plugins-base-{{ gst_api_version.md }}.pc and adding
-lgstallocators-{{ gst_api_version.md }} to the library flags.
1 change: 1 addition & 0 deletions docs/libs/allocators/sitemap.txt
@@ -0,0 +1 @@
gi-index
8 changes: 8 additions & 0 deletions docs/libs/app/index.md
@@ -0,0 +1,8 @@
# App Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}pc` and adding
-lgstapp-{{ gst_api_version.md }} to the library flags.

To use it the functionality, insert an `appsrc` or `appsink` element
into a pipeline and call the appropriate functions on the element.
1 change: 1 addition & 0 deletions docs/libs/app/sitemap.txt
@@ -0,0 +1 @@
gi-index
6 changes: 6 additions & 0 deletions docs/libs/audio/index.md
@@ -0,0 +1,6 @@
# Audio Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstaudio-{{ gst_api_version.md }}` to the library flags.

1 change: 1 addition & 0 deletions docs/libs/audio/sitemap.txt
@@ -0,0 +1 @@
gi-index
1 change: 1 addition & 0 deletions docs/libs/ext/sitemap.txt
@@ -0,0 +1 @@
gi-index
8 changes: 8 additions & 0 deletions docs/libs/fft/index.md
@@ -0,0 +1,8 @@
# FFT Library

The gstfft library is based on
[kissfft](http://sourceforge.net/projects/kissfft) by Mark Borgerding.

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstfft-{{ gst_api_version.md }}` to the library flags.
1 change: 1 addition & 0 deletions docs/libs/fft/sitemap.txt
@@ -0,0 +1 @@
gi-index
7 changes: 7 additions & 0 deletions docs/libs/pbutils/index.md
@@ -0,0 +1,7 @@
# Base Utils Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstpbutils-{{ gst_api_version.md }}` to the library
flags.

3 changes: 3 additions & 0 deletions docs/libs/pbutils/sitemap.txt
@@ -0,0 +1,3 @@
gi-index
pbutils.h
encoding-profile.h
5 changes: 5 additions & 0 deletions docs/libs/riff/index.md
@@ -0,0 +1,5 @@
# Riff Media Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstriff-{{ gst_api_version.md }}` to the library flags.
1 change: 1 addition & 0 deletions docs/libs/riff/sitemap.txt
@@ -0,0 +1 @@
c-index
5 changes: 5 additions & 0 deletions docs/libs/rtp/index.md
@@ -0,0 +1,5 @@
# RTP Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstrtp-{{ gst_api_version.md }}` to the library flags.
1 change: 1 addition & 0 deletions docs/libs/rtp/sitemap.txt
@@ -0,0 +1 @@
gi-index
5 changes: 5 additions & 0 deletions docs/libs/rtsp/index.md
@@ -0,0 +1,5 @@
# RTSP Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstrtsp-{{ gst_api_version.md }}` to the library flags.
1 change: 1 addition & 0 deletions docs/libs/rtsp/sitemap.txt
@@ -0,0 +1 @@
gi-index
6 changes: 6 additions & 0 deletions docs/libs/sdp/index.md
@@ -0,0 +1,6 @@
# SDP Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstsdp-{{ gst_api_version.md }}` to the library flags.

1 change: 1 addition & 0 deletions docs/libs/sdp/sitemap.txt
@@ -0,0 +1 @@
gi-index
6 changes: 6 additions & 0 deletions docs/libs/tag/index.md
@@ -0,0 +1,6 @@
# Tag Support Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgsttag-{{ gst_api_version.md }}` to the library flags.

1 change: 1 addition & 0 deletions docs/libs/tag/sitemap.txt
@@ -0,0 +1 @@
gi-index
5 changes: 5 additions & 0 deletions docs/libs/video/index.md
@@ -0,0 +1,5 @@
# Video Library

This library should be linked to by getting cflags and libs from
`gstreamer-plugins-base-{{ gst_api_version.md }}.pc` and adding
`-lgstvideo-{{ gst_api_version.md }}` to the library flags.
1 change: 1 addition & 0 deletions docs/libs/video/sitemap.txt
@@ -0,0 +1 @@
gi-index
173 changes: 173 additions & 0 deletions docs/meson.build
@@ -0,0 +1,173 @@
build_hotdoc = false

if meson.is_cross_build()
if get_option('doc').enabled()
error('Documentation enabled but building the doc while cross building is not supported yet.')
endif

message('Documentation not built as building it while cross building is not supported yet.')
subdir_done()
endif

required_hotdoc_extensions = ['gi-extension', 'gst-extension']
if gst_dep.type_name() == 'internal'
gst_proj = subproject('gstreamer')
plugins_cache_generator = gst_proj.get_variable('plugins_cache_generator')
else
plugins_cache_generator = find_program(join_paths(gst_dep.get_pkgconfig_variable('libexecdir'), 'gstreamer-' + api_version, 'gst-plugins-doc-cache-generator'),
required: false)
endif

plugins_cache = join_paths(meson.current_source_dir(), 'plugins', 'gst_plugins_cache.json')
if plugins_cache_generator.found()
plugins_doc_dep = custom_target('base-plugins-doc-cache',
build_by_default: true,
command: [plugins_cache_generator, plugins_cache, '@OUTPUT@', '@INPUT@'],
input: plugins,
output: 'gst_plugins_cache.json',
)
else
warning('GStreamer plugin inspector for documentation not found, can\'t update the cache')
endif

hotdoc_p = find_program('hotdoc', required: get_option('doc'))
if not hotdoc_p.found()
message('Hotdoc not found, not building the documentation')
subdir_done()
endif

hotdoc = import('hotdoc')
foreach extension: required_hotdoc_extensions
if not hotdoc.has_extensions(extension)
if get_option('doc').enabled()
error('Documentation enabled but @0@ missing'.format(extension))
endif

message('@0@ extension not found, not building documentation'.format(extension))
subdir_done()
endif
endforeach

if not build_gir
if get_option('doc').enabled()
error('Documentation enabled but introspection not built.')
endif

message('Introspection not built, can\'t build the documentation')
subdir_done()
endif

build_hotdoc = true
docconf = configuration_data()
docconf.set('GST_API_VERSION', api_version)

version_entities = configure_file(input : 'version.in',
output : 'gst_api_version.md',
configuration : docconf)

libs_excludes = []
foreach h: ['pbutils-private.h', 'gsttageditingprivate.h', 'id3v2.h',
'kiss_fft_f32.h', 'kiss_fft_f64.h', 'kiss_fftr_f32.h', 'kiss_fftr_f64.h',
'kiss_fftr_s16.h', 'kiss_fftr_s32.h', 'kiss_fft_s16.h', 'kiss_fft_s32.h',
'_kiss_fft_guts_f32.h', '_kiss_fft_guts_f64.h', '_kiss_fft_guts_s16.h',
'_kiss_fft_guts_s16.h', '_kiss_fft_guts_s32.h', '_kiss_fft_guts_s32.h',
'pbutils-marshal.h', 'audio-resampler-private.h', '*orc-dist.*',
'*-neon.h', 'audio-resampler-macros.[ch]', '*-prelude.h'
]

libs_excludes += [join_paths(meson.current_source_dir(), '..', 'gst-libs/gst/*/', h)]
endforeach

libs = [
['allocators', allocators_gir, allocators_dep],
['app', app_gir, app_dep],
['audio', audio_gir, audio_dep],
# FIXME! ['fft', fft_gir, fft_dep],
['pbutils', pbutils_gir, pbutils_dep],
['rtp', rtp_gir, rtp_dep],
['rtsp', rtsp_gir, rtsp_dep],
['sdp', sdp_gir, sdp_dep],
['tag', tag_gir, tag_dep],
['video', video_gir, video_dep],
]

if build_gstgl
libs + [['gl', gl_gir, gstgl_dep]]
endif

libs_doc = []
foreach lib: libs
name = lib[0]
gir = lib[1]
deps = [lib[2], gir]
libs_doc += [hotdoc.generate_doc('gst-plugins-base-' + name,
project_version: api_version,
gi_c_sources: [join_paths('../gst-libs/gst', name, '*.[hc]')],
gi_sources: gir[0].full_path(),
gi_c_source_filters: libs_excludes,
gi_c_source_roots: [join_paths(meson.current_source_dir(), '../gst-libs/gst/' + name), ],
sitemap: 'libs/' + name + '/sitemap.txt',
index: 'libs/' + name + '/index.md',
gi_index: 'libs/' + name + '/index.md',
gi_smart_index: true,
gi_order_generated_subpages: true,
dependencies: deps,
install: false,
)]
endforeach

if not hotdoc.has_extensions('c-extension')
if get_option('doc').enabled()
error('Documentation enabled but c-extension missing')
endif
message('c-extension not found, not building documentation')
else
libs_doc += [hotdoc.generate_doc('gst-plugins-base-riff',
project_version: api_version,
c_sources: ['../gst-libs/gst/riff/*.[hc]'],
c_source_filters: libs_excludes,
sitemap: 'libs/riff/sitemap.txt',
index: 'libs/riff/index.md',
c_index: 'libs/riff/index.md',
c_smart_index: true,
c_order_generated_subpages: true,
dependencies: [gst_base_dep, riff_dep],
install: false,
disable_incremental_build: true,
)]
endif

plugins_doc = []
sitemap = 'all_index.md\n'

list_plugin_res = run_command(python3, '-c',
'''
import sys
import json
with open("@0@") as f:
print(':'.join(json.load(f).keys()), end='')
'''.format(plugins_cache))

assert(list_plugin_res.returncode() == 0,
'Could not list plugins from @0@\n@1@\n@1@'.format(plugins_cache, list_plugin_res.stdout(), list_plugin_res.stderr()))


foreach plugin_name: list_plugin_res.stdout().split(':')
plugins_doc += [hotdoc.generate_doc(plugin_name,
project_version: api_version,
sitemap: 'plugins/sitemap.txt',
index: 'plugins/index.md',
gst_index: 'plugins/index.md',
gst_smart_index: true,
gst_c_sources: ['../sys/*/*.[ch]',
'../ext/*/*.[ch]',
'../gst/*/*.[ch]',
],
dependencies: [gst_dep, plugins],
gst_order_generated_subpages: true,
gst_cache_file: plugins_cache,
gst_plugin_name: plugin_name,
)]
sitemap += ' @0@-doc.json\n'.format(plugin_name)
endforeach
5 changes: 5 additions & 0 deletions docs/plugins/all_index.md
@@ -0,0 +1,5 @@
---
short-description: Plugins from gst-plugins-base
...

# Plugins

0 comments on commit 27ba8d2

Please sign in to comment.