mirror of https://github.com/ARMmbed/mbed-os.git
Remove previous docs building method and replaced by `doxygen doxyfile_options`
parent
38d511674d
commit
7dfc75de6d
1512
tools/misc/Doxyfile
1512
tools/misc/Doxyfile
File diff suppressed because it is too large
Load Diff
|
@ -1,47 +0,0 @@
|
|||
"""An api for generating documentation from the codebase
|
||||
"""
|
||||
|
||||
from os.path import dirname, join
|
||||
from os import sep
|
||||
from re import compile
|
||||
|
||||
import subprocess
|
||||
|
||||
def generate_documentation(dirs, output_dir):
|
||||
"""Use doxygen to generate the documentation
|
||||
|
||||
Positional arguments:
|
||||
dirs - the directories that doxygen should scan for documentation
|
||||
output_dir - location of the documentation after the return of this function
|
||||
"""
|
||||
print dirs
|
||||
with open(join(dirname(__file__), "Doxyfile")) as doxyfile:
|
||||
proc = subprocess.Popen(["doxygen", "-"], stdin=subprocess.PIPE)
|
||||
proc.stdin.write(doxyfile.read())
|
||||
proc.stdin.write("OUTPUT_DIRECTORY={}\n".format(output_dir))
|
||||
proc.stdin.write("INPUT={}".format(" ".join(dirs)))
|
||||
proc.stdin.close()
|
||||
proc.wait()
|
||||
|
||||
EXCLUDES = ["targets", "features/FEATURE", "features/mbedtls",
|
||||
"features/nanostack", "features/storage"]
|
||||
|
||||
def is_not_excluded(src):
|
||||
return all(exclude not in src for exclude in EXCLUDES)
|
||||
|
||||
if __name__ == "__main__":
|
||||
import sys
|
||||
from os.path import abspath, dirname, join
|
||||
# Be sure that the tools directory is in the search path
|
||||
ROOT = abspath(join(dirname(__file__), "..", ".."))
|
||||
sys.path.insert(0, ROOT)
|
||||
|
||||
from tools.toolchains.gcc import GCC_ARM
|
||||
from tools.targets import TARGET_MAP
|
||||
toolchain = GCC_ARM(TARGET_MAP["Super_Target"])
|
||||
resources = toolchain.scan_resources(".")
|
||||
generate_documentation(filter(is_not_excluded,
|
||||
sum(map(lambda x:x.headers,
|
||||
resources.features.values()),
|
||||
resources.headers)),
|
||||
join(dirname(dirname(__file__)), "mbed-docs"))
|
Loading…
Reference in New Issue