Clarify docs for the format and builder tags

1 files changed, 7 insertions, 6 deletions

diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst
index d0ace3fa7..86b625dbc 100644
--- a/doc/markup/misc.rst
+++ b/doc/markup/misc.rst
@@ -179,10 +179,11 @@ Including content based on tags
    within :file:`conf.py`) are true.  Boolean expressions, also using
    parentheses (like ``html and (latex or draft)``) are supported.
 
-   The format and the name of the current builder (``html``, ``latex`` or
-   ``text``) is always set as a tag [#]_. To make the distinction between
+   The *format* and the *name* of the current builder (``html``, ``latex`` or
+   ``text``) are always set as a tag [#]_. To make the distinction between
    format and name explicit, they are also added with the prefix ``format_`` and
-   ``builder_``.
+   ``builder_``, e.g. the epub builder defines the tags  ``html``, ``epub``,
+   ``format_html`` and ``builder_epub``. 
 
    .. versionadded:: 0.6
    .. versionchanged:: 1.2
@@ -245,6 +246,6 @@ following directive exists:
 
 .. rubric:: Footnotes
 
-.. [#] At the moment only the epub builder distinguishes between the builder
-   format and the builder name.
-
+.. [#] For most builders name and format are the same. At the moment only
+       builders derived from the html builder distinguish between the builder
+       format and the builder name.