From a281f1b0baf65da2f798e98cbfd2b5da2e5970ea Mon Sep 17 00:00:00 2001
From: Takashi Sakamoto <o-takashi@sakamocchi.jp>
Date: Thu, 21 Nov 2019 14:06:34 +0900
Subject: [PATCH] rawmidi: doc: generate documentation of ALSARawmidi library

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
---
 doc/reference/meson.build                  |  1 +
 doc/reference/rawmidi/alsarawmidi-docs.xml | 40 ++++++++++++++++++++++
 doc/reference/rawmidi/alsarawmidi.types    |  6 ++++
 doc/reference/rawmidi/meson.build          | 10 ++++++
 4 files changed, 57 insertions(+)
 create mode 100644 doc/reference/rawmidi/alsarawmidi-docs.xml
 create mode 100644 doc/reference/rawmidi/alsarawmidi.types
 create mode 100644 doc/reference/rawmidi/meson.build

diff --git a/doc/reference/meson.build b/doc/reference/meson.build
index a03ee90..c068396 100644
--- a/doc/reference/meson.build
+++ b/doc/reference/meson.build
@@ -11,3 +11,4 @@ subdir('ctl')
 subdir('timer')
 subdir('seq')
 subdir('hwdep')
+subdir('rawmidi')
diff --git a/doc/reference/rawmidi/alsarawmidi-docs.xml b/doc/reference/rawmidi/alsarawmidi-docs.xml
new file mode 100644
index 0000000..284556c
--- /dev/null
+++ b/doc/reference/rawmidi/alsarawmidi-docs.xml
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+<!ENTITY version SYSTEM "../version.xml">
+]>
+
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
+    <bookinfo>
+        <title>ALSARawmidi Reference Manual</title>
+    <releaseinfo>This document is for the ALSARawmidi library, version &version;.
+    </releaseinfo>
+    </bookinfo>
+
+    <chapter id="alsarawmidi-enumerations">
+        <title>ALSARawmidi enumerations</title>
+        <xi:include href="xml/alsarawmidi-enum-types.xml"/>
+    </chapter>
+
+    <chapter id="alsarawmidi-global-methods">
+        <title>ALSARawmidi global methods</title>
+        <xi:include href="xml/query.xml"/>
+    </chapter>
+
+    <chapter id="alsarawmidi-objects">
+        <title>ALSARawmidi objects</title>
+        <xi:include href="xml/stream-pair.xml"/>
+        <xi:include href="xml/substream-info.xml"/>
+        <xi:include href="xml/substream-params.xml"/>
+        <xi:include href="xml/substream-status.xml"/>
+    </chapter>
+
+    <index id="index-all">
+        <title>Index of all symbols</title>
+        <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+    </index>
+
+    <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+
+</book>
diff --git a/doc/reference/rawmidi/alsarawmidi.types b/doc/reference/rawmidi/alsarawmidi.types
new file mode 100644
index 0000000..21fe64f
--- /dev/null
+++ b/doc/reference/rawmidi/alsarawmidi.types
@@ -0,0 +1,6 @@
+alsarawmidi_stream_direction_get_type
+alsarawmidi_stream_pair_info_flag_get_type
+alsarawmidi_substream_info_get_type
+alsarawmidi_stream_pair_get_type
+alsarawmidi_substream_params_get_type
+alsarawmidi_substream_status_get_type
diff --git a/doc/reference/rawmidi/meson.build b/doc/reference/rawmidi/meson.build
new file mode 100644
index 0000000..a0bbdb3
--- /dev/null
+++ b/doc/reference/rawmidi/meson.build
@@ -0,0 +1,10 @@
+gnome.gtkdoc('alsarawmidi',
+  src_dir : alsarawmidi_dir,
+  main_xml : 'alsarawmidi-docs.xml',
+  scan_args: [
+    '--ignore-headers=privates.h',
+  ],
+  gobject_typesfile: 'alsarawmidi.types',
+  dependencies: alsarawmidi_dependency,
+  install : true,
+)
-- 
2.47.3