Roland Meister  committed ef3092d

Add warning for unusual chars in filenames. Closes #1199

  • Participants
  • Parent commits ff1f35b

Comments (0)

Files changed (1)

File 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