linux-imx

# -*- coding: utf-8 -*-

#

# The Linux Kernel documentation build configuration file, created by

# sphinx-quickstart on Fri Feb 12 13:51:46 2016.

#

# This file is execfile()d with the current directory set to its

# containing dir.

#

# Note that not all possible configuration values are present in this

# autogenerated file.

#

# All configuration values have a default; values that are commented out

# serve to show the default.

​

import sys

import os

import sphinx

​

# Get Sphinx version

major, minor, patch = sphinx.version_info[:3]

​

​

# If extensions (or modules to document with autodoc) are in another directory,

# add these directories to sys.path here. If the directory is relative to the

# documentation root, use os.path.abspath to make it absolute, like shown here.

sys.path.insert(0, os.path.abspath('sphinx'))

from load_config import loadConfig

​

# -- General configuration ------------------------------------------------

​

# If your documentation needs a minimal Sphinx version, state it here.

needs_sphinx = '1.3'

​

# Add any Sphinx extension module names here, as strings. They can be

# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom

# ones.

extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include', 'cdomain', 'kfigure', 'sphinx.ext.ifconfig']

​

# The name of the math extension changed on Sphinx 1.4

if major == 1 and minor > 3:

    extensions.append("sphinx.ext.imgmath")

else:

    extensions.append("sphinx.ext.pngmath")

​

# Add any paths that contain templates here, relative to this directory.

templates_path = ['_templates']

​

# The suffix(es) of source filenames.

# You can specify multiple suffix as a list of string:

# source_suffix = ['.rst', '.md']

source_suffix = '.rst'

​

# The encoding of source files.

#source_encoding = 'utf-8-sig'

​

# The master toctree document.

master_doc = 'index'

​

# General information about the project.

project = 'The Linux Kernel'

copyright = 'The kernel development community'

author = 'The kernel development community'

​

# The version info for the project you're documenting, acts as replacement for

# |version| and |release|, also used in various other places throughout the

# built documents.

#

# In a normal build, version and release are are set to KERNELVERSION and

# KERNELRELEASE, respectively, from the Makefile via Sphinx command line

# arguments.

#

# The following code tries to extract the information by reading the Makefile,

# when Sphinx is run directly (e.g. by Read the Docs).

try:

    makefile_version = None

    makefile_patchlevel = None

    for line in open('../Makefile'):

        key, val = [x.strip() for x in line.split('=', 2)]

        if key == 'VERSION':

            makefile_version = val

        elif key == 'PATCHLEVEL':

            makefile_patchlevel = val

        if makefile_version and makefile_patchlevel:

            break

except:

    pass

finally:

    if makefile_version and makefile_patchlevel:

        version = release = makefile_version + '.' + makefile_patchlevel

    else:

        version = release = "unknown version"

​