The behavior of :confval:html_file_suffix changed slightly: the empty string now means "no suffix" instead of "default suffix", use `None` for "default suffix".

CHANGES

@@ -81,6 +81,9 @@ Features added
   - Added :confval:`html_show_copyright` config value.
   - Added :confval:`latex_show_pagerefs` and :confval:`latex_show_urls`
     config values.
+  - The behavior of :confval:`html_file_suffix` changed slightly: the
+    empty string now means "no suffix" instead of "default suffix", use
+    ``None`` for "default suffix".
 
 * New builders:
 

doc/config.rst

@@ -626,8 +626,8 @@ that use Sphinx' HTMLWriter class.
 
 .. confval:: html_file_suffix
 
-   If nonempty, this is the file name suffix for generated HTML files.  The
-   default is ``".html"``.
+   This is the file name suffix for generated HTML files.  The default is
+   ``".html"``.
 
    .. versionadded:: 0.4
 

sphinx/builders/html.py

@@ -99,7 +99,7 @@ class StandaloneHTMLBuilder(Builder):
         self.init_templates()
         self.init_highlighter()
         self.init_translator_class()
-        if self.config.html_file_suffix:
+        if self.config.html_file_suffix is not None:
             self.out_suffix = self.config.html_file_suffix
 
         if self.config.html_link_suffix is not None:

sphinx/quickstart.py

@@ -186,8 +186,8 @@ html_static_path = ['%(dot)sstatic']
 # base URL from which the finished HTML is served.
 #html_use_opensearch = ''
 
-# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = ''
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%(project_fn)sdoc'