fix documentation generation

README.rst

 .. _README:
 
-Accounting periods
+Accounting Periods
 ==================
 
 Per-period accounting concept. Periods can be individually closed.

doc/Makefile

@@ -13,7 +13,7 @@
 endif
 
 project:=$(shell basename $(shell readlink -f ..))
-branch:=$(shell hg branch)
+branch:=$(shell hg identify --branch)
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4

doc/autotodo.py

@@ -64,7 +64,8 @@
             "\t\t:language: python\n"
             "\t\t:lines: %s-%s\n"
             "\t\t:emphasize-lines: %s\n"
-            % (
+            %
+            (
                 class_name,
                 "-" * len(class_name),
                 line,
@@ -81,7 +82,7 @@
 
 def create_autotodo(folder, todolist):
     with open("autotodo", "w+") as f:
-        for tag, info in list(todolist.items()):
+        for tag, info in todolist.items():
             f.write("%s\n%s\n\n" % (tag, "=" * len(tag)))
             write_info(f, info, folder)
 
@@ -93,7 +94,7 @@
         (root, ext) = os.path.splitext(name)
         if ext in exts:
             file_info = scan_file(os.path.join(dirname, name), tags)
-            for tag, info in list(file_info.items()):
+            for tag, info in file_info.items():
                 if info:
                     res[tag].extend(info)
 

doc/conf.py

@@ -238,7 +238,7 @@
     (
         master_doc,
         "%s.tex" % module_nospace,
-        u"%s Documentation" % project,
+        "%s Documentation" % project,
         author,
         "manual",
     )
@@ -270,7 +270,7 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    (master_doc, module_lowercase, u"%s Documentation" % project, [author], 1)
+    (master_doc, module_lowercase, "%s Documentation" % project, [author], 1)
 ]
 
 # If true, show URL addresses after external links.
@@ -308,8 +308,6 @@
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 # texinfo_no_detailmenu = False
 
-todo_include_todos = True
-
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {"https://docs.python.org/3/": None}
 
@@ -332,7 +330,7 @@
 superproject_path = os.path.dirname(
     os.path.dirname(os.path.dirname(os.getenv("PWD")))
 )
-c = configparser.SafeConfigParser()
+c = configparser.ConfigParser()
 c.read(os.path.join(superproject_path, "setup.cfg"))
 sphinxodoo_addons_path = []
 
@@ -336,5 +334,9 @@
 c.read(os.path.join(superproject_path, "setup.cfg"))
 sphinxodoo_addons_path = []
 
-for line in c.get("odoo_scripts", "addon_dirs").splitlines():
+addon_dirs = set(
+    os.path.dirname(path)
+    for path in c.get("odoo_scripts", "modules").split())
+
+for line in addon_dirs:
     sphinxodoo_addons_path.append(os.path.join(superproject_path, line))

doc/index.rst

@@ -6,7 +6,6 @@
    :maxdepth: 2
 
    README
-   modules
    NEWS
    TODO