nevermind, it's a regexp in our build that's been wrong for a long time and only revealed this issue after people help annotate tons of docs for us.
On Mar 20, 1:28 pm, Michael Bayer <[email protected]> wrote: > the workaround is to put :ref: on a newline: > > All about how to define :class:`~sqlalchemy.schema.Table` objects, as > well as how to create them from an existing database automatically, is > described in > :ref:`metadata_toplevel`. > > so the issue is not as screamingly urgent. and yes we're looking > through our mako templates to see if there's anything on that end that > could cause this. > > On Mar 20, 1:10 pm, Michael Bayer <[email protected]> wrote: > > > With 0.6.5 (and 0.6.2, others) I'm seeing lines like this: > > > All about how to define :class:`~sqlalchemy.schema.Table` objects, as > > well as how to create them from an existing database automatically, is > > described in :ref:`metadata_toplevel`. > > > become collapsed in the output, producing this: > > > All about how to define <a title="sqlalchemy.schema.Table" > > class="reference external" href="reference/sqlalchemy/ > > schema.html"><em>Database Meta Data</em></a>. > > > i.e., all the text from :class: on through the :ref: is getting > > lost. If I reverse the line and put the :ref: before the :class:, it > > works. If I change the :class: to be a name that isn't actually > > found, it works. Only if the :ref: is after :class:. It behaves > > like a regexp bug. > > > Has this issue been seen before ? Lots of paragraphs on the current > > sqlalchemy documentation are corrupted like this. I'm going to have > > to do something ugly to make this work for now (like put the ref in a > > new paragraph). > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
