xref: /aosp_15_r20/external/flashrom/doc/conf.py (revision 0d6140be3aa665ecc836e8907834fcd3e3b018fc)
1*0d6140beSAndroid Build Coastguard Worker# Configuration file for the Sphinx documentation builder.
2*0d6140beSAndroid Build Coastguard Worker#
3*0d6140beSAndroid Build Coastguard Worker# For the full list of built-in configuration values, see the documentation:
4*0d6140beSAndroid Build Coastguard Worker# https://www.sphinx-doc.org/en/master/usage/configuration.html
5*0d6140beSAndroid Build Coastguard Worker
6*0d6140beSAndroid Build Coastguard Workerimport os
7*0d6140beSAndroid Build Coastguard Worker
8*0d6140beSAndroid Build Coastguard Worker# -- Project information -----------------------------------------------------
9*0d6140beSAndroid Build Coastguard Worker# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
10*0d6140beSAndroid Build Coastguard Worker
11*0d6140beSAndroid Build Coastguard Workerproject = 'flashrom'
12*0d6140beSAndroid Build Coastguard Worker# copyright = '2023, The flashrom authors'
13*0d6140beSAndroid Build Coastguard Workerauthor = 'The flashrom authors'
14*0d6140beSAndroid Build Coastguard Worker
15*0d6140beSAndroid Build Coastguard Worker# -- General configuration ---------------------------------------------------
16*0d6140beSAndroid Build Coastguard Worker# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
17*0d6140beSAndroid Build Coastguard Worker
18*0d6140beSAndroid Build Coastguard Workermaster_doc = 'index' # this is needed for old versions
19*0d6140beSAndroid Build Coastguard Worker
20*0d6140beSAndroid Build Coastguard Workerextensions = [
21*0d6140beSAndroid Build Coastguard Worker    'sphinx.ext.todo'
22*0d6140beSAndroid Build Coastguard Worker]
23*0d6140beSAndroid Build Coastguard Worker
24*0d6140beSAndroid Build Coastguard Worker#templates_path = ['_templates']
25*0d6140beSAndroid Build Coastguard Workerexclude_patterns = []
26*0d6140beSAndroid Build Coastguard Worker
27*0d6140beSAndroid Build Coastguard Worker# -- Options for Todo extension ----------------------------------------------
28*0d6140beSAndroid Build Coastguard Worker# https://www.sphinx-doc.org/en/master/usage/extensions/todo.html
29*0d6140beSAndroid Build Coastguard Worker
30*0d6140beSAndroid Build Coastguard Worker# If this is True, todo and todolist produce output, else they produce nothing. The default is False.
31*0d6140beSAndroid Build Coastguard Workertodo_include_todos = False
32*0d6140beSAndroid Build Coastguard Worker
33*0d6140beSAndroid Build Coastguard Worker
34*0d6140beSAndroid Build Coastguard Worker
35*0d6140beSAndroid Build Coastguard Worker# -- Options for HTML output -------------------------------------------------
36*0d6140beSAndroid Build Coastguard Worker# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
37*0d6140beSAndroid Build Coastguard Worker
38*0d6140beSAndroid Build Coastguard Workerhtml_theme = 'alabaster'
39*0d6140beSAndroid Build Coastguard Worker#html_static_path = ['_static']
40*0d6140beSAndroid Build Coastguard Worker
41*0d6140beSAndroid Build Coastguard Workerhtml_favicon = 'logo/flashrom_icon_color-32x32.ico'
42*0d6140beSAndroid Build Coastguard Worker
43*0d6140beSAndroid Build Coastguard Worker
44*0d6140beSAndroid Build Coastguard Worker# -- Options for manual page output --------------------------------------------
45*0d6140beSAndroid Build Coastguard Workerman_make_section_directory = True
46*0d6140beSAndroid Build Coastguard Workerman_show_urls = True
47*0d6140beSAndroid Build Coastguard Workerman_pages = [
48*0d6140beSAndroid Build Coastguard Worker    ('classic_cli_manpage', project, '', [], 8),
49*0d6140beSAndroid Build Coastguard Worker]
50