From f9d480cfe50ca1d7a0f0b5a2b8bb9932962bfbe7 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 17:07:22 +0200 Subject: Adding upstream version 3.38.6. Signed-off-by: Daniel Baumann --- docs/reference/meson.build | 5 +++ docs/reference/shell/meson.build | 51 ++++++++++++++++++++++++++ docs/reference/shell/shell-docs.sgml | 69 ++++++++++++++++++++++++++++++++++++ docs/reference/shell/version.xml.in | 1 + docs/reference/st/meson.build | 23 ++++++++++++ docs/reference/st/st-docs.sgml | 69 ++++++++++++++++++++++++++++++++++++ docs/reference/st/version.xml.in | 1 + 7 files changed, 219 insertions(+) create mode 100644 docs/reference/meson.build create mode 100644 docs/reference/shell/meson.build create mode 100644 docs/reference/shell/shell-docs.sgml create mode 100644 docs/reference/shell/version.xml.in create mode 100644 docs/reference/st/meson.build create mode 100644 docs/reference/st/st-docs.sgml create mode 100644 docs/reference/st/version.xml.in (limited to 'docs') diff --git a/docs/reference/meson.build b/docs/reference/meson.build new file mode 100644 index 0000000..77d9fde --- /dev/null +++ b/docs/reference/meson.build @@ -0,0 +1,5 @@ +version_conf = configuration_data() +version_conf.set('VERSION', meson.project_version()) + +subdir('shell') +subdir('st') diff --git a/docs/reference/shell/meson.build b/docs/reference/shell/meson.build new file mode 100644 index 0000000..5936ea3 --- /dev/null +++ b/docs/reference/shell/meson.build @@ -0,0 +1,51 @@ +private_headers = [ + 'gactionmuxer.h', + 'gactionobservable.h', + 'gactionobserver.h', + 'shell-network-agent.h', +] + +exclude_directories = [ + 'calendar-server', + 'hotplug-sniffer', + 'st', + 'tray' +] + +ifaces = [ + ['org.gnome.Shell.Screenshot', 'org.gnome.Shell.Screenshot.xml'], + ['org.gnome.ShellSearchProvider', 'org.gnome.Shell.SearchProvider.xml'], + ['org.gnome.ShellSearchProvider2', 'org.gnome.Shell.SearchProvider2.xml'] +] +foreach iface : ifaces + custom_target(iface[0] + ' docs', + input: '../../../data/dbus-interfaces/@0@.xml'.format(iface[0]), + output: 'doc-gen-' + iface[1], + command: [ + 'gdbus-codegen', + '--interface-prefix=@0@.'.format(iface[0]), + '--generate-docbook', 'doc-gen', + '--output-directory', '@OUTDIR@', + '@INPUT@' + ], + build_by_default: true + ) +endforeach + +configure_file( + input: 'version.xml.in', + output: 'version.xml', + configuration: version_conf +) + +gnome.gtkdoc('shell', + main_sgml: 'shell-docs.sgml', + src_dir: [ + join_paths(meson.source_root(), 'src'), + join_paths(meson.build_root(), 'src') + ], + scan_args: [ + '--ignore-headers=' + ' '.join(private_headers + exclude_directories) + ], + install: true +) diff --git a/docs/reference/shell/shell-docs.sgml b/docs/reference/shell/shell-docs.sgml new file mode 100644 index 0000000..ebfd221 --- /dev/null +++ b/docs/reference/shell/shell-docs.sgml @@ -0,0 +1,69 @@ + + + +]> + + + Shell Reference Manual + + for Shell &version;. + + + + + + Actors + + + + Application tracking + + + + + + Search + + + + Tray Icons + + + + + + + Integration helpers and utilities + + + + + + + + + + + + + API Index + + + + Index of deprecated API + + + + + diff --git a/docs/reference/shell/version.xml.in b/docs/reference/shell/version.xml.in new file mode 100644 index 0000000..d78bda9 --- /dev/null +++ b/docs/reference/shell/version.xml.in @@ -0,0 +1 @@ +@VERSION@ diff --git a/docs/reference/st/meson.build b/docs/reference/st/meson.build new file mode 100644 index 0000000..3e9e9ab --- /dev/null +++ b/docs/reference/st/meson.build @@ -0,0 +1,23 @@ +private_headers = [ + 'st-private.h', + 'st-theme-node-private.h' +] + +configure_file( + input: 'version.xml.in', + output: 'version.xml', + configuration: version_conf +) + +gnome.gtkdoc('st', + main_sgml: 'st-docs.sgml', + src_dir: [ + join_paths(meson.source_root(), 'src', 'st'), + join_paths(meson.build_root(), 'src', 'st') + ], + scan_args: [ + '--ignore-headers=' + ' '.join(private_headers), + '--rebuild-sections' + ], + install: true +) diff --git a/docs/reference/st/st-docs.sgml b/docs/reference/st/st-docs.sgml new file mode 100644 index 0000000..be4cec2 --- /dev/null +++ b/docs/reference/st/st-docs.sgml @@ -0,0 +1,69 @@ + + + +]> + + + St Reference Manual + + for St &version;. + + + + + + API reference + + Abstract classes and Interfaces + + + + + + Widgets + + + + + + + + Containers + + + + + + + Styling + + + + + + + + + + + API Index + + + + Index of deprecated API + + + + + diff --git a/docs/reference/st/version.xml.in b/docs/reference/st/version.xml.in new file mode 100644 index 0000000..d78bda9 --- /dev/null +++ b/docs/reference/st/version.xml.in @@ -0,0 +1 @@ +@VERSION@ -- cgit v1.2.3