shithub: opus

Download patch

ref: 0431f9335557b6af0167e0be21210dacf8e606d2
parent: e7aa6cb9a09cbd3538b0d41fc86eb28c2fc3c0bd
author: Ralph Giles <[email protected]>
date: Wed Jan 16 09:14:32 EST 2013

Improve Content Type figure placement.

With xml2rfc 2.3.9, I was getting the 'audio/ogg; codecs=opus'
figure hoisted out of the the containing paragraph, which was
very confusing.

I've tried to improve this by moving the surrounding paragraph
into the figure using the <preamble> and <postamble> tags, as
in the example in draft-mrose-writting-rfcs.

Unfortunately this still isn't perfect. Since the surrounding
paragraph is part of the figure we can't set align="center" on
the figure itself, and the processor seems to ignore it on the
artwork element. I've compensated by adding some leading
whitespace.

--- a/doc/draft-ietf-codec-oggopus.xml

+++ b/doc/draft-ietf-codec-oggopus.xml

@@ -1219,16 +1219,18 @@

 The RECOMMENDED mime-type for Ogg Opus files is "audio/ogg".

 </t>

-<t>

+<figure>

+<preamble>

 If more specificity is desired, one MAY indicate the presence of Opus streams

  using the codecs parameter defined in <xref target="RFC6381"/>, e.g.,

-<figure align="center">

-<artwork align="left"><![CDATA[

-audio/ogg; codecs=opus

+</preamble>

+<artwork align="center"><![CDATA[

+    audio/ogg; codecs=opus

 ]]></artwork>

-</figure>

+<postamble>

  for an Ogg Opus file.

-</t>

+</postamble>

+</figure>

 <t>

 The RECOMMENDED filename extension for Ogg Opus files is '.opus'.