mirror of
https://github.com/ceph/ceph
synced 2024-12-16 00:15:35 +00:00
301fe6cbf2
* move rst files from doc/man/8 into man/8 * extract man_pages setting for sphinx from doc/conf.py to man/conf.py * generate all man pages in `make install` * add python-sphinx to Build-Depends * check for sphinx-build in `configure` * run changed rst files through sphinx-build in `make check` Signed-off-by: Kefu Chai <kchai@redhat.com>
43 lines
1.3 KiB
Python
43 lines
1.3 KiB
Python
import os
|
|
|
|
project = u'Ceph'
|
|
copyright = u'2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA'
|
|
version = 'dev'
|
|
release = 'dev'
|
|
|
|
exclude_patterns = ['**/.#*', '**/*~']
|
|
|
|
def _get_manpages():
|
|
import os
|
|
man_dir = os.path.dirname(__file__)
|
|
sections = os.listdir(man_dir)
|
|
for section in sections:
|
|
section_dir = os.path.join(man_dir, section)
|
|
if not os.path.isdir(section_dir):
|
|
continue
|
|
for filename in os.listdir(section_dir):
|
|
base, ext = os.path.splitext(filename)
|
|
if ext != '.rst':
|
|
continue
|
|
if base == 'index':
|
|
continue
|
|
with file(os.path.join(section_dir, filename)) as f:
|
|
one = f.readline()
|
|
two = f.readline()
|
|
three = f.readline()
|
|
assert one == three
|
|
assert all(c=='=' for c in one.rstrip('\n'))
|
|
two = two.strip()
|
|
name, rest = two.split('--', 1)
|
|
assert name.strip() == base
|
|
description = rest.strip()
|
|
yield (
|
|
os.path.join(section, base),
|
|
base,
|
|
description,
|
|
'',
|
|
section,
|
|
)
|
|
|
|
man_pages = list(_get_manpages())
|