# Copyright(c) 2010-2015 Intel Corporation
from docutils import nodes
-from distutils.version import LooseVersion
+from packaging.version import Version
from sphinx import __version__ as sphinx_version
-from sphinx.highlighting import PygmentsBridge
-from pygments.formatters.latex import LatexFormatter
from os import listdir
from os import environ
from os.path import basename
from os.path import dirname
from os.path import join as path_join
+from sys import argv, stderr
import configparser
import sphinx_rtd_theme
html_theme = "sphinx_rtd_theme"
- html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
except:
print('Install the sphinx ReadTheDocs theme for improved html documentation '
- 'layout: https://sphinx-rtd-theme.readthedocs.io/')
+ 'layout: https://sphinx-rtd-theme.readthedocs.io/',
+ file=stderr)
pass
+stop_on_error = ('-W' in argv)
+
project = 'Data Plane Development Kit'
html_logo = '../logo/DPDK_logo_vertical_rev_small.png'
-latex_logo = '../logo/DPDK_logo_horizontal_tag.png'
-html_add_permalinks = ""
+if Version(sphinx_version) >= Version('3.5'):
+ html_permalinks = False
+else:
+ html_add_permalinks = ""
html_show_copyright = False
highlight_language = 'none'
-release = environ['DPDK_VERSION']
+release = environ.setdefault('DPDK_VERSION', "None")
version = release
master_doc = 'index'
# Figures, tables and code-blocks automatically numbered if they have caption
numfig = True
-latex_documents = [
- ('index',
- 'doc.tex',
- '',
- '',
- 'manual')
-]
-
-# Latex directives to be included directly in the latex/pdf docs.
-custom_latex_preamble = r"""
-\usepackage{textalpha}
-\RecustomVerbatimEnvironment{Verbatim}{Verbatim}{xleftmargin=5mm}
-\usepackage{etoolbox}
-\robustify\(
-\robustify\)
-"""
-
-# Configuration for the latex/pdf docs.
-latex_elements = {
- 'papersize': 'a4paper',
- 'pointsize': '11pt',
- # remove blank pages
- 'classoptions': ',openany,oneside',
- 'babel': '\\usepackage[english]{babel}',
- # customize Latex formatting
- 'preamble': custom_latex_preamble
-}
-
-
-# Override the default Latex formatter in order to modify the
-# code/verbatim blocks.
-class CustomLatexFormatter(LatexFormatter):
- def __init__(self, **options):
- super(CustomLatexFormatter, self).__init__(**options)
- # Use the second smallest font size for code/verbatim blocks.
- self.verboptions = r'formatcom=\footnotesize'
-
-# Replace the default latex formatter.
-PygmentsBridge.latex_formatter = CustomLatexFormatter
-
# Configuration for man pages
man_pages = [("testpmd_app_ug/run_app", "testpmd",
"tests for dpdk pmds", "", 1),
name = ini_filename[:-4]
name = name.replace('_vf', 'vf')
pmd_names.append(name)
+ if not pmd_names:
+ # Add an empty column if table is empty (required by RST syntax)
+ pmd_names.append(' ')
# Pad the table header names.
max_header_len = len(max(pmd_names, key=len))
# Initialize the dict with the default.ini value.
ini_data[ini_filename] = valid_features.copy()
- # Check for a valid ini section.
+ # Check for a section.
if not config.has_section(section):
- print("{}: File '{}' has no [{}] secton".format(warning,
- ini_filename,
- section))
continue
# Check for valid features names.
if name not in valid_features:
print("{}: Unknown feature '{}' in '{}'".format(warning,
name,
- ini_filename))
+ ini_filename),
+ file=stderr)
+ if stop_on_error:
+ raise Exception('Warning is treated as a failure')
continue
if value:
'Features',
'Features availability in networking drivers',
'Feature')
+ table_file = dirname(__file__) + '/nics/rte_flow_items_table.txt'
+ generate_overview_table(table_file, 2,
+ 'rte_flow items',
+ 'rte_flow items availability in networking drivers',
+ 'Item')
+ table_file = dirname(__file__) + '/nics/rte_flow_actions_table.txt'
+ generate_overview_table(table_file, 3,
+ 'rte_flow actions',
+ 'rte_flow actions availability in networking drivers',
+ 'Action')
table_file = dirname(__file__) + '/cryptodevs/overview_feature_table.txt'
generate_overview_table(table_file, 1,
'Features',
'Asymmetric',
'Asymmetric algorithms in crypto drivers',
'Asymmetric algorithm')
+ table_file = dirname(__file__) + '/cryptodevs/overview_os_table.txt'
+ generate_overview_table(table_file, 6,
+ 'OS',
+ 'Operating systems support for crypto drivers',
+ 'Operating system')
table_file = dirname(__file__) + '/compressdevs/overview_feature_table.txt'
generate_overview_table(table_file, 1,
'Features',
'Features',
'Features availability in bbdev drivers',
'Feature')
+ table_file = dirname(__file__) + '/gpus/overview_feature_table.txt'
+ generate_overview_table(table_file, 1,
+ 'Features',
+ 'Features availability in GPU drivers',
+ 'Feature')
+ table_file = dirname(__file__) + '/eventdevs/overview_feature_table.txt'
+ generate_overview_table(table_file, 1,
+ 'Scheduling Features',
+ 'Features availability in eventdev drivers',
+ 'Feature')
+ table_file = dirname(__file__) + '/eventdevs/overview_rx_adptr_feature_table.txt'
+ generate_overview_table(table_file, 2,
+ 'Eth Rx adapter Features',
+ 'Features availability for Ethdev Rx adapters',
+ 'Feature')
+ table_file = dirname(__file__) + '/eventdevs/overview_tx_adptr_feature_table.txt'
+ generate_overview_table(table_file, 3,
+ 'Eth Tx adapter Features',
+ 'Features availability for Ethdev Tx adapters',
+ 'Feature')
+ table_file = dirname(__file__) + '/eventdevs/overview_crypto_adptr_feature_table.txt'
+ generate_overview_table(table_file, 4,
+ 'Crypto adapter Features',
+ 'Features availability for Crypto adapters',
+ 'Feature')
+ table_file = dirname(__file__) + '/eventdevs/overview_timer_adptr_feature_table.txt'
+ generate_overview_table(table_file, 5,
+ 'Timer adapter Features',
+ 'Features availability for Timer adapters',
+ 'Feature')
- if LooseVersion(sphinx_version) < LooseVersion('1.3.1'):
+ if Version(sphinx_version) < Version('1.3.1'):
print('Upgrade sphinx to version >= 1.3.1 for '
- 'improved Figure/Table number handling.')
+ 'improved Figure/Table number handling.',
+ file=stderr)
# Add a role to handle :numref: references.
app.add_role('numref', numref_role)
# Process the numref references once the doctree has been created.
git.droids-corp.org / dpdk.git / blobdiff