Commits

Georg Brandl committed 4e1e4c4

Remove misguided recommendation to use emphasis for variables.

Comments (0)

Files changed (1)

doc/markup/inline.rst

 =============
 
 Sphinx uses interpreted text roles to insert semantic markup into documents.
-
-Variable names are an exception, they should be marked simply with ``*var*``.
-
-For all other roles, you have to write ``:rolename:`content```.
+They are written as ``:rolename:`content```.
 
 .. note::
 
    The default role (```content```) has no special meaning by default.  You are
-   free to use it for anything you like; use the :confval:`default_role` config
-   value to set it to a known role.
+   free to use it for anything you like, e.g. variable names; use the
+   :confval:`default_role` config value to set it to a known role.
 
 
 .. _xref-syntax: