Use imperative language in all docstrings

[etc/vim.git] / docs / conf.py

diff --git a/docs/conf.py b/docs/conf.py
index 6edddba729f753803168911347ee22b68c5cedb4..9599afd599b1a1d4488c63ef53dcac1bbfcadd95 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -59,6 +59,7 @@ def generate_sections_from_readme():
     target_dir.mkdir(parents=True)
 
     output = None
+    target_dir = target_dir.relative_to(CURRENT_DIR)
     with open(str(readme), 'r', encoding='utf8') as f:
         for line in f:
             if line.startswith('## '):
@@ -112,6 +113,7 @@ generate_sections_from_readme()
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.napoleon',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -270,6 +272,8 @@ epub_exclude_files = ['search.html']
 
 # -- Extension configuration -------------------------------------------------
 
+autodoc_member_order = 'bysource'
+
 # -- Options for intersphinx extension ---------------------------------------
 
 # Example configuration for intersphinx: refer to the Python standard library.