Commits

Anonymous committed ef3092d

Add warning for unusual chars in filenames. Closes #1199

Comments (0)

Files changed (1)

doc/markup/toctree.rst

   documents or document-containing directories with such names.  (Using ``_`` as
   a prefix for a custom template directory is fine.)
 
+.. warning::
+
+  Be careful with unusual characters in filenames.  Some formats may interpret
+  these characters in unexpected ways:
+
+  * Do not user the colon ``:`` for HTML based formats.  Links to other parts
+    may not work.
+
+  * Do not use the plus ``+`` for the ePub format.  Some resources may not be
+    found.
 
 .. rubric:: Footnotes