1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
# SPDX-License-Identifier: LGPL-2.1-or-later
#
# This file is part of libnvme.
# Copyright (c) 2022 Dell Inc.
# Copyright (c) 2022 SUSE LLC
#
# Authors: Martin Belanger <Martin.Belanger@dell.com>
# Authors: Daniel Wagner <dwagner@suse.de>
#
api_files = [
'filters.h',
'ioctl.h',
'linux.h',
'log.h',
'tree.h',
'types.h',
'fabrics.h',
'util.h'
]
sphinx_sources = [
'conf.py',
'index.rst',
'config-schema.json'
]
want_docs = get_option('docs')
want_docs_build = get_option('docs-build')
if want_docs != 'false'
kernel_doc = find_program('kernel-doc')
conf = configuration_data()
conf.set('SYSCONFDIR', sysconfdir)
if want_docs == 'all' or want_docs == 'man'
mandir = join_paths(get_option('mandir'), 'man2')
list_man_pages = find_program('list-man-pages.sh')
if want_docs_build
foreach apif : api_files
foreach file : files('../src/nvme/' + apif)
subst = configure_file(
input: file,
output: '@BASENAME@.msubst',
configuration: conf)
c = run_command(list_man_pages, subst)
man_pages = c.stdout().split()
foreach page : man_pages
custom_target(
page.underscorify() + '_man',
input: subst,
output: page + '.2',
capture: true,
command: [kernel_doc,
'-module', 'libnvme',
'-man',
'-function',
page,
subst],
install: true,
install_dir: mandir)
endforeach
endforeach
endforeach
else
if want_docs == 'all' or want_docs == 'man'
install_subdir('man', install_dir: mandir)
endif
endif
endif
if want_docs == 'all' or want_docs == 'html'
htmldir = join_paths(get_option('htmldir'), 'nvme')
sphinx_build = find_program('sphinx-build-3', 'sphinx-build')
if sphinx_build.found() and want_docs_build
cat = find_program('cat')
rsts = []
foreach apif : api_files
afile = files('../src/nvme/' + apif)
subst = configure_file(
input: afile,
output: '@BASENAME@.hsubst',
configuration: conf)
rst = custom_target(
apif.underscorify() + '_rst',
input: subst,
output: '@BASENAME@._rst',
capture: true,
command: [kernel_doc,
'-rst',
'@INPUT@'])
rsts += rst
endforeach
libnvme = custom_target(
'libnvme',
command: [ cat, '@INPUT@' ],
capture: true,
input: rsts,
output: 'libnvme.rst')
static_sources = []
foreach file : sphinx_sources
static_sources += configure_file(input: file, output: file, copy: true)
endforeach
custom_target(
'generate_doc_html',
input: [static_sources, libnvme],
output: 'html',
command: [sphinx_build,
'-b', 'html',
'@OUTDIR@',
'@OUTDIR@' + '/html'],
install: true,
install_dir: htmldir)
else
# The HTML doc is not ready yet.
# if want_docs == 'all' or want_docs == 'html'
# install_subdir('html', install_dir: htmldir)
# endif
endif
endif
endif
|
