restore doc

doc/conf.py

@@ -1,3 +1,5 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
 #
 # pytest_httpserver documentation build configuration file, created by
 # sphinx-quickstart on Sat Aug 11 08:07:37 2018.
@@ -27,6 +29,7 @@
 
 # If your documentation needs a minimal Sphinx version, state it here.
 #
+# needs_sphinx = '1.0'
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -47,6 +50,7 @@
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
+# source_suffix = ['.rst', '.md']
 source_suffix = ".rst"
 
 # The master toctree document.
@@ -96,6 +100,7 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
+# html_theme_options = {}
 
 html_theme_options = {
     "canonical_url": "",
@@ -141,12 +146,16 @@
 latex_elements: Dict[str, str] = {
     # The paper size ('letterpaper' or 'a4paper').
     #
+    # 'papersize': 'letterpaper',
     # The font size ('10pt', '11pt' or '12pt').
     #
+    # 'pointsize': '10pt',
     # Additional stuff for the LaTeX preamble.
     #
+    # 'preamble': '',
     # Latex figure (float) alignment
     #
+    # 'figure_align': 'htbp',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples