Re: [Docutils-users] Problem (?) with inline literals

[David A. <da...@bo...>]

David Goodger <go...@py...> writes:

> David Abrahams wrote:
>> The following line doesn't seem to format as expected:
>> 
>>     Those bracketed expressions are Python ``list``s.  A ``list`` is
>> 
>> I just wanted the word "list" to appear twice as an inline literal,
>> with the 's' following in a normal font.  Is there a way to do this?
>
> reStructuredText's inline markup is designed to work at the phrase-level,
> not at the character level.  So no, you can't do it, at least not directly.
> However, there is a work-around; certain punctuation characters *are*
> allowed adjacent to inline markup end-strings, such as apostrophes.  So you
> could write it like this:
>
>     Those bracketed expressions are Python ``list``'s.  A ``list`` is
>                                                   (^ note the apostrophe)
>
> This rule allows for text like "Use double backquotes ("``") for inline
> literals."  For all the gory details, see
>
>     http://docutils.sf.net/spec/rst/reStructuredText.html#inline-markup

David,

Thanks for your reply.  When I try your workaround I still get a
grammatically incorrect apostrophe in the word "lists".  Would it
break anything if you added the backslash to the list of "certain
punctuation characters"?  That way, I could write ``list``\s and get
exactly the effect I want.

-- 
                       David Abrahams
   da...@bo... * http://www.boost-consulting.com
Boost support, enhancements, training, and commercial distribution