Mercurial > hg > CbC > CbC_llvm
comparison polly/docs/conf.py @ 252:1f2b6ac9f198 llvm-original
LLVM16-1
author | Shinji KONO <kono@ie.u-ryukyu.ac.jp> |
---|---|
date | Fri, 18 Aug 2023 09:04:13 +0900 |
parents | c4bab56944e8 |
children |
comparison
equal
deleted
inserted
replaced
237:c80f45b162ad | 252:1f2b6ac9f198 |
---|---|
15 from datetime import date | 15 from datetime import date |
16 | 16 |
17 # If extensions (or modules to document with autodoc) are in another directory, | 17 # If extensions (or modules to document with autodoc) are in another directory, |
18 # add these directories to sys.path here. If the directory is relative to the | 18 # add these directories to sys.path here. If the directory is relative to the |
19 # documentation root, use os.path.abspath to make it absolute, like shown here. | 19 # documentation root, use os.path.abspath to make it absolute, like shown here. |
20 #sys.path.insert(0, os.path.abspath('.')) | 20 # sys.path.insert(0, os.path.abspath('.')) |
21 | 21 |
22 # -- General configuration ----------------------------------------------------- | 22 # -- General configuration ----------------------------------------------------- |
23 | 23 |
24 # If your documentation needs a minimal Sphinx version, state it here. | 24 # If your documentation needs a minimal Sphinx version, state it here. |
25 #needs_sphinx = '1.0' | 25 # needs_sphinx = '1.0' |
26 | 26 |
27 # Add any Sphinx extension module names here, as strings. They can be extensions | 27 # Add any Sphinx extension module names here, as strings. They can be extensions |
28 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. | 28 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. |
29 extensions = ['sphinx.ext.todo', 'sphinx.ext.mathjax'] | 29 extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax"] |
30 | 30 |
31 # Add any paths that contain templates here, relative to this directory. | 31 # Add any paths that contain templates here, relative to this directory. |
32 templates_path = ['_templates'] | 32 templates_path = ["_templates"] |
33 | 33 |
34 # The suffix of source filenames. | 34 # The suffix of source filenames. |
35 source_suffix = '.rst' | 35 source_suffix = ".rst" |
36 | 36 |
37 # The encoding of source files. | 37 # The encoding of source files. |
38 #source_encoding = 'utf-8-sig' | 38 # source_encoding = 'utf-8-sig' |
39 | 39 |
40 # The master toctree document. | 40 # The master toctree document. |
41 master_doc = 'index' | 41 master_doc = "index" |
42 | 42 |
43 # General information about the project. | 43 # General information about the project. |
44 project = u'Polly' | 44 project = "Polly" |
45 copyright = u'2010-%d, The Polly Team' % date.today().year | 45 copyright = "2010-%d, The Polly Team" % date.today().year |
46 | 46 |
47 # The language for content autogenerated by Sphinx. Refer to documentation | 47 # The language for content autogenerated by Sphinx. Refer to documentation |
48 # for a list of supported languages. | 48 # for a list of supported languages. |
49 #language = None | 49 # language = None |
50 | 50 |
51 # There are two options for replacing |today|: either, you set today to some | 51 # There are two options for replacing |today|: either, you set today to some |
52 # non-false value, then it is used: | 52 # non-false value, then it is used: |
53 #today = '' | 53 # today = '' |
54 # Else, today_fmt is used as the format for a strftime call. | 54 # Else, today_fmt is used as the format for a strftime call. |
55 #today_fmt = '%B %d, %Y' | 55 # today_fmt = '%B %d, %Y' |
56 | 56 |
57 # List of patterns, relative to source directory, that match files and | 57 # List of patterns, relative to source directory, that match files and |
58 # directories to ignore when looking for source files. | 58 # directories to ignore when looking for source files. |
59 exclude_patterns = ['_build', 'analyzer'] | 59 exclude_patterns = ["_build", "analyzer"] |
60 | 60 |
61 # The reST default role (used for this markup: `text`) to use for all documents. | 61 # The reST default role (used for this markup: `text`) to use for all documents. |
62 #default_role = None | 62 # default_role = None |
63 | 63 |
64 # If true, '()' will be appended to :func: etc. cross-reference text. | 64 # If true, '()' will be appended to :func: etc. cross-reference text. |
65 #add_function_parentheses = True | 65 # add_function_parentheses = True |
66 | 66 |
67 # If true, the current module name will be prepended to all description | 67 # If true, the current module name will be prepended to all description |
68 # unit titles (such as .. function::). | 68 # unit titles (such as .. function::). |
69 #add_module_names = True | 69 # add_module_names = True |
70 | 70 |
71 # If true, sectionauthor and moduleauthor directives will be shown in the | 71 # If true, sectionauthor and moduleauthor directives will be shown in the |
72 # output. They are ignored by default. | 72 # output. They are ignored by default. |
73 #show_authors = False | 73 # show_authors = False |
74 | 74 |
75 # The name of the Pygments (syntax highlighting) style to use. | 75 # The name of the Pygments (syntax highlighting) style to use. |
76 pygments_style = 'friendly' | 76 pygments_style = "friendly" |
77 | 77 |
78 # A list of ignored prefixes for module index sorting. | 78 # A list of ignored prefixes for module index sorting. |
79 #modindex_common_prefix = [] | 79 # modindex_common_prefix = [] |
80 | 80 |
81 in_progress_title = "(In-Progress) " if tags.has("PreRelease") else "" | 81 in_progress_title = "(In-Progress) " if tags.has("PreRelease") else "" |
82 | 82 |
83 rst_epilog = f""" | 83 rst_epilog = f""" |
84 .. |ReleaseNotesTitle| replace:: {in_progress_title} Release Notes | 84 .. |ReleaseNotesTitle| replace:: {in_progress_title} Release Notes |
88 | 88 |
89 # The theme to use for HTML and HTML Help pages. See the documentation for | 89 # The theme to use for HTML and HTML Help pages. See the documentation for |
90 # a list of builtin themes. | 90 # a list of builtin themes. |
91 try: | 91 try: |
92 import sphinx_rtd_theme | 92 import sphinx_rtd_theme |
93 | |
93 html_theme = "sphinx_rtd_theme" | 94 html_theme = "sphinx_rtd_theme" |
94 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] | 95 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] |
95 except ImportError: | 96 except ImportError: |
96 html_theme = 'haiku' | 97 html_theme = "haiku" |
97 | 98 |
98 | 99 |
99 # Theme options are theme-specific and customize the look and feel of a theme | 100 # Theme options are theme-specific and customize the look and feel of a theme |
100 # further. For a list of options available for each theme, see the | 101 # further. For a list of options available for each theme, see the |
101 # documentation. | 102 # documentation. |
102 #html_theme_options = {} | 103 # html_theme_options = {} |
103 | 104 |
104 # Add any paths that contain custom themes here, relative to this directory. | 105 # Add any paths that contain custom themes here, relative to this directory. |
105 #html_theme_path = [] | 106 # html_theme_path = [] |
106 | 107 |
107 # The name for this set of Sphinx documents. If None, it defaults to | 108 # The name for this set of Sphinx documents. If None, it defaults to |
108 # "<project> v<release> documentation". | 109 # "<project> v<release> documentation". |
109 #html_title = None | 110 # html_title = None |
110 | 111 |
111 # A shorter title for the navigation bar. Default is the same as html_title. | 112 # A shorter title for the navigation bar. Default is the same as html_title. |
112 #html_short_title = None | 113 # html_short_title = None |
113 | 114 |
114 # The name of an image file (relative to this directory) to place at the top | 115 # The name of an image file (relative to this directory) to place at the top |
115 # of the sidebar. | 116 # of the sidebar. |
116 #html_logo = None | 117 # html_logo = None |
117 | 118 |
118 # The name of an image file (within the static path) to use as favicon of the | 119 # The name of an image file (within the static path) to use as favicon of the |
119 # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 | 120 # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 |
120 # pixels large. | 121 # pixels large. |
121 #html_favicon = None | 122 # html_favicon = None |
122 | 123 |
123 # Add any paths that contain custom static files (such as style sheets) here, | 124 # Add any paths that contain custom static files (such as style sheets) here, |
124 # relative to this directory. They are copied after the builtin static files, | 125 # relative to this directory. They are copied after the builtin static files, |
125 # so a file named "default.css" will overwrite the builtin "default.css". | 126 # so a file named "default.css" will overwrite the builtin "default.css". |
126 html_static_path = [] | 127 html_static_path = [] |
127 | 128 |
128 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, | 129 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, |
129 # using the given strftime format. | 130 # using the given strftime format. |
130 #html_last_updated_fmt = '%b %d, %Y' | 131 # html_last_updated_fmt = '%b %d, %Y' |
131 | 132 |
132 # If true, SmartyPants will be used to convert quotes and dashes to | 133 # If true, SmartyPants will be used to convert quotes and dashes to |
133 # typographically correct entities. | 134 # typographically correct entities. |
134 #html_use_smartypants = True | 135 # html_use_smartypants = True |
135 | 136 |
136 # Custom sidebar templates, maps document names to template names. | 137 # Custom sidebar templates, maps document names to template names. |
137 #html_sidebars = {} | 138 # html_sidebars = {} |
138 | 139 |
139 # Additional templates that should be rendered to pages, maps page names to | 140 # Additional templates that should be rendered to pages, maps page names to |
140 # template names. | 141 # template names. |
141 #html_additional_pages = {} | 142 # html_additional_pages = {} |
142 | 143 |
143 # If false, no module index is generated. | 144 # If false, no module index is generated. |
144 #html_domain_indices = True | 145 # html_domain_indices = True |
145 | 146 |
146 # If false, no index is generated. | 147 # If false, no index is generated. |
147 #html_use_index = True | 148 # html_use_index = True |
148 | 149 |
149 # If true, the index is split into individual pages for each letter. | 150 # If true, the index is split into individual pages for each letter. |
150 #html_split_index = False | 151 # html_split_index = False |
151 | 152 |
152 # If true, links to the reST sources are added to the pages. | 153 # If true, links to the reST sources are added to the pages. |
153 #html_show_sourcelink = True | 154 # html_show_sourcelink = True |
154 | 155 |
155 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. | 156 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. |
156 #html_show_sphinx = True | 157 # html_show_sphinx = True |
157 | 158 |
158 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. | 159 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. |
159 #html_show_copyright = True | 160 # html_show_copyright = True |
160 | 161 |
161 # If true, an OpenSearch description file will be output, and all pages will | 162 # If true, an OpenSearch description file will be output, and all pages will |
162 # contain a <link> tag referring to it. The value of this option must be the | 163 # contain a <link> tag referring to it. The value of this option must be the |
163 # base URL from which the finished HTML is served. | 164 # base URL from which the finished HTML is served. |
164 #html_use_opensearch = '' | 165 # html_use_opensearch = '' |
165 | 166 |
166 # This is the file name suffix for HTML files (e.g. ".xhtml"). | 167 # This is the file name suffix for HTML files (e.g. ".xhtml"). |
167 #html_file_suffix = None | 168 # html_file_suffix = None |
168 | 169 |
169 # Output file base name for HTML help builder. | 170 # Output file base name for HTML help builder. |
170 htmlhelp_basename = 'Pollydoc' | 171 htmlhelp_basename = "Pollydoc" |
171 | 172 |
172 | 173 |
173 # -- Options for LaTeX output -------------------------------------------------- | 174 # -- Options for LaTeX output -------------------------------------------------- |
174 | 175 |
175 latex_elements = { | 176 latex_elements = { |
176 # The paper size ('letterpaper' or 'a4paper'). | 177 # The paper size ('letterpaper' or 'a4paper'). |
177 #'papersize': 'letterpaper', | 178 #'papersize': 'letterpaper', |
178 | 179 # The font size ('10pt', '11pt' or '12pt'). |
179 # The font size ('10pt', '11pt' or '12pt'). | 180 #'pointsize': '10pt', |
180 #'pointsize': '10pt', | 181 # Additional stuff for the LaTeX preamble. |
181 | 182 #'preamble': '', |
182 # Additional stuff for the LaTeX preamble. | |
183 #'preamble': '', | |
184 } | 183 } |
185 | 184 |
186 # Grouping the document tree into LaTeX files. List of tuples | 185 # Grouping the document tree into LaTeX files. List of tuples |
187 # (source start file, target name, title, author, documentclass [howto/manual]). | 186 # (source start file, target name, title, author, documentclass [howto/manual]). |
188 latex_documents = [ | 187 latex_documents = [ |
189 ('index', 'Polly.tex', u'Polly Documentation', | 188 ("index", "Polly.tex", "Polly Documentation", "The Polly Team", "manual"), |
190 u'The Polly Team', 'manual'), | |
191 ] | 189 ] |
192 | 190 |
193 # The name of an image file (relative to this directory) to place at the top of | 191 # The name of an image file (relative to this directory) to place at the top of |
194 # the title page. | 192 # the title page. |
195 #latex_logo = None | 193 # latex_logo = None |
196 | 194 |
197 # For "manual" documents, if this is true, then toplevel headings are parts, | 195 # For "manual" documents, if this is true, then toplevel headings are parts, |
198 # not chapters. | 196 # not chapters. |
199 #latex_use_parts = False | 197 # latex_use_parts = False |
200 | 198 |
201 # If true, show page references after internal links. | 199 # If true, show page references after internal links. |
202 #latex_show_pagerefs = False | 200 # latex_show_pagerefs = False |
203 | 201 |
204 # If true, show URL addresses after external links. | 202 # If true, show URL addresses after external links. |
205 #latex_show_urls = False | 203 # latex_show_urls = False |
206 | 204 |
207 # Documents to append as an appendix to all manuals. | 205 # Documents to append as an appendix to all manuals. |
208 #latex_appendices = [] | 206 # latex_appendices = [] |
209 | 207 |
210 # If false, no module index is generated. | 208 # If false, no module index is generated. |
211 #latex_domain_indices = True | 209 # latex_domain_indices = True |
212 | 210 |
213 | 211 |
214 # If true, show URL addresses after external links. | 212 # If true, show URL addresses after external links. |
215 #man_show_urls = False | 213 # man_show_urls = False |
216 | 214 |
217 | 215 |
218 # -- Options for Texinfo output ------------------------------------------------ | 216 # -- Options for Texinfo output ------------------------------------------------ |
219 | 217 |
220 # Grouping the document tree into Texinfo files. List of tuples | 218 # Grouping the document tree into Texinfo files. List of tuples |
221 # (source start file, target name, title, author, | 219 # (source start file, target name, title, author, |
222 # dir menu entry, description, category) | 220 # dir menu entry, description, category) |
223 texinfo_documents = [ | 221 texinfo_documents = [ |
224 ('index', 'Polly', u'Polly Documentation', | 222 ( |
225 u'The Polly Team', 'Polly', 'One line description of project.', | 223 "index", |
226 'Miscellaneous'), | 224 "Polly", |
225 "Polly Documentation", | |
226 "The Polly Team", | |
227 "Polly", | |
228 "One line description of project.", | |
229 "Miscellaneous", | |
230 ), | |
227 ] | 231 ] |
228 | 232 |
229 # Documents to append as an appendix to all manuals. | 233 # Documents to append as an appendix to all manuals. |
230 #texinfo_appendices = [] | 234 # texinfo_appendices = [] |
231 | 235 |
232 # If false, no module index is generated. | 236 # If false, no module index is generated. |
233 #texinfo_domain_indices = True | 237 # texinfo_domain_indices = True |
234 | 238 |
235 # How to display URL addresses: 'footnote', 'no', or 'inline'. | 239 # How to display URL addresses: 'footnote', 'no', or 'inline'. |
236 #texinfo_show_urls = 'footnote' | 240 # texinfo_show_urls = 'footnote' |