On 9/7/2010 17:35, Daniel Neuhäuser wrote:
But, what if I *really* wanted to remove that space? Is there some
rule against doing that?
Yeah there is, inline markup can't be used in words like *foo*bar. Try
escaping the opening bracket like :ref:`foo<bar>`\<baz>.

YMMV, but often the cleanest looking version is:

:ref:`foo<bar>`\ <baz>

The escaped space will not be output, but makes a clear separation between the markup.

However this shouldn't raise an exception like this but that is a
problem with docutils.

No, I believe it should, to remain consistent with the aforementioned case (*foo*bar) and several other examples besides that one (which docutils, for instance, lumps under the name "character-level inline markup").

The relevant documentation:

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-markup

Particularly, the small immediately following subsection:

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#character-level-inline-markup

Also:

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#escaping-mechanism

--
--Max Battcher--
http://worldmaker.net

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to