From afdcfb9e1e7ab223da8bb5e4ad412e8852ff3d44 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Wed, 9 Nov 2016 01:16:32 -0500 Subject: tweak some sphinx configs --- api-docs/source/conf.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'api-docs/source/conf.py') diff --git a/api-docs/source/conf.py b/api-docs/source/conf.py index 42bcfb87..ac6042b4 100644 --- a/api-docs/source/conf.py +++ b/api-docs/source/conf.py @@ -121,7 +121,7 @@ exclude_patterns = [] # If true, the current module name will be prepended to all description # unit titles (such as .. function::). # -# add_module_names = True +add_module_names = False # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. @@ -211,7 +211,7 @@ html_static_path = ['_static'] # If false, no module index is generated. # -# html_domain_indices = True +html_domain_indices = False # If false, no index is generated. # @@ -219,11 +219,11 @@ html_static_path = ['_static'] # If true, the index is split into individual pages for each letter. # -# html_split_index = False +html_split_index = False # If true, links to the reST sources are added to the pages. # -# html_show_sourcelink = True +html_show_sourcelink = False # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. # -- cgit v1.3.1 From 4cbb658c6065d56dcc08a38d7f69f28c420c5e80 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Tue, 17 Jan 2017 15:37:06 -0500 Subject: fix missing documentation --- api-docs/source/conf.py | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'api-docs/source/conf.py') diff --git a/api-docs/source/conf.py b/api-docs/source/conf.py index 379d6d7e..c7fa4a89 100644 --- a/api-docs/source/conf.py +++ b/api-docs/source/conf.py @@ -31,7 +31,7 @@ import binaryninja def modulelist(modulename): modules = inspect.getmembers(modulename, inspect.ismodule) - return filter(lambda x: x[0] not in ("abc", "ctypes", "core", "struct", "sys", "_binaryninjacore", "traceback", "code", "enum", "json", "threading"), modules) + return filter(lambda x: x[0] not in ("abc", "ctypes", "core", "struct", "sys", "_binaryninjacore", "traceback", "code", "enum", "json", "threading", "startup", "associateddatastore"), modules) def classlist(module): @@ -53,7 +53,7 @@ def generaterst(): ''') for modulename, module in modulelist(binaryninja): - filename = 'binaryninja.{module}.rst'.format(module=modulename) + filename = 'binaryninja.{module}-module.rst'.format(module=modulename) pythonrst.write(' {module} <{filename}>\n'.format(module=modulename, filename=filename)) modulefile = open(filename, "w") modulefile.write('''{module} module @@ -69,6 +69,11 @@ def generaterst(): modulefile.write('''\n.. toctree:: :maxdepth: 2\n''') + + modulefile.write('''\n\n.. automodule:: binaryninja.{module} + :members: + :undoc-members: + :show-inheritance:'''.format(module=modulename)) modulefile.close() pythonrst.write('''.. automodule:: binaryninja -- cgit v1.3.1 From 148924f082ba45f041431d004f630de56b59c144 Mon Sep 17 00:00:00 2001 From: Jordan Wiens Date: Fri, 20 Jan 2017 18:53:32 -0500 Subject: make python docs default for API help --- api-docs/source/conf.py | 4 ++-- api-docs/source/old-index.rst | 25 +++++++++++++++++++++++++ 2 files changed, 27 insertions(+), 2 deletions(-) create mode 100644 api-docs/source/old-index.rst (limited to 'api-docs/source/conf.py') diff --git a/api-docs/source/conf.py b/api-docs/source/conf.py index c7fa4a89..c87cb114 100644 --- a/api-docs/source/conf.py +++ b/api-docs/source/conf.py @@ -43,7 +43,7 @@ def classlist(module): def generaterst(): - pythonrst = open("python.rst", "w") + pythonrst = open("index.rst", "w") pythonrst.write('''Binary Ninja Python API Documentation ===================================== @@ -130,7 +130,7 @@ source_suffix = '.rst' # source_encoding = 'utf-8-sig' # The master toctree document. -master_doc = 'python' +master_doc = 'index' # General information about the project. project = u'Binary Ninja API' diff --git a/api-docs/source/old-index.rst b/api-docs/source/old-index.rst new file mode 100644 index 00000000..355d6901 --- /dev/null +++ b/api-docs/source/old-index.rst @@ -0,0 +1,25 @@ +.. Binary Ninja API documentation master file, created by + sphinx-quickstart on Tue Jun 28 23:02:45 2016. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +.. include global.rst + +Binary Ninja API Documentation +============================== + +Contents: + +.. toctree:: + :maxdepth: 2 + + Python API +.. C++ API +.. C API + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` -- cgit v1.3.1