[Docutils-develop] Interleaved elements

[Aahz <aa...@py...>]

I'm finally starting to buckle down to the work of emitting OpenOffice
output from my reST files (so far, I've been just writing -- haven't even
checked syntax for correctness).  I'm going to do some tests myself, but
I might as well ask for advice in parallel.  What I'm trying to figure
out is how to handle the case where two different blocks both get
attached to a preceding paragraph::

    The three execution scopes are *function local* (hereafter referred
    to as local), *module global* (hereafter referred to as global), and
    builtin scope.  Local scope exists any time Python's instruction
    pointer is inside a function/method.  Global scope refers to the
    currently executing module; functions defined in another module still
    consider that module their global scope even if imported into the
    current module's namespace::

        import M
        M.f()               # f()'s global scope is the module M
        from M import f
        f()                 # f()'s global scope is still M

    .. index::
        local
        function local
        global
        module global
        builtin

Should the order of the code block and index directive be swapped?  Does
it make any difference?  Do I need to do something special to handle
this?  (The index terms should be attached to the paragraph, not the
code block.)
-- 
Aahz (aa...@py...)           <*>         http://www.pythoncraft.com/

Project Vote Smart: http://www.vote-smart.org/