update panning articles (sandbox for improved semantic markup).

_manual/17_mixing/02_panning/01_mono_panner.html

@@ -13,15 +13,13 @@ default setting is "center" (L=50%, R=50%).
 
 <img src="/images/mono-panner-annotated.png" alt="image of the mono panner"/>
 
-<div class="well">
-<p>
+<p class="note">
   The mono panner looks a quite similar to the
   <a href="/mixing/panning/stereo_panner">stereo panner</a>
   interface. The difference is that the L/R labels in the lower half
   of the mono panner do not move because there is no "width" to
   control.
 </p>
-</div>
 
 <h2>Using the mouse</h2>
 
@@ -58,7 +56,7 @@ keybindings are available to operate on that panner:
   <dt><kbd>&larr;</kbd> / <kbd class="mod1">&larr;</kbd></dt>
   <dd>move position 1&deg; / 5&deg; to the left</dd>
   <dt><kbd>&rarr;</kbd> / <kbd class="mod1">&rarr;</kbd></dt>
-  <dd>move position 1&deg / 5&deg; to the right</dd>
+  <dd>move position 1&deg; / 5&deg; to the right</dd>
   <dt><kbd>0</kbd></dt>
   <dd>reset position to center</dd>
 </dl>

_manual/17_mixing/02_panning/02_balance_control.html

@@ -4,8 +4,8 @@ title: Balance Control
 ---                        
 
 <p>
-  For stereo tracks, you can now switch between the stereo panner and a
-  traditional <strong>balance control</strong> by right-clicking on the
+  For stereo tracks, you can now switch between the default stereo panner 
+  and a traditional <dfn>balance control</dfn> by right-clicking on the
   panner widget.
 </p>
 <img class="left" src="/images/stereo-balance.png" alt="Stereo Balance
@@ -15,8 +15,8 @@ control"/>
   Moving it to one side will linearly attenuate the signal of the opposite
   side.
 </p>
-<div class="well">
+<p class="note">
   While the balance control is considerably less flexible than the stereo 
   panner, it works with arbitrary content without danger of introducing
   comb filter artefacts.
-</div>
+</p>

_manual/17_mixing/02_panning/03_stereo_panner.html

@@ -4,29 +4,28 @@ title: Stereo Panner
 ---                        
 
 <p>
-  The default stereo panner distributes two inputs to two outputs. Its
-  behaviour is controlled by two parameters, <strong>width</strong> and
-  <strong>position</strong>. The
-  default settings for the stereo panner are <em>width=100%</em> and  
-  <em>position=center</em>. 
+  The default <dfn>stereo panner</dfn> distributes two inputs to two outputs. Its
+  behaviour is controlled by two parameters, <dfn>width</dfn> and
+  <dfn>position</dfn>. The
+  default settings for the stereo panner are <samp>width=100%</samp> and  
+  <samp>position=center</samp>. 
   This stereo panner assumes that the signals
   you wish to distribute are either uncorrelated (i.e. totally 
   independent), or that they contain a stereo image which is 
   <em>mono-compatible</em>, such as a co-incident microphone recording, or a 
   sound stage that has been created with pan pots.<sup><a href="#caveat">*</a></sup>
 </p>
-<div class="well">
+<p class="note">
   With the default values it is not possible to alter the position,
   since the width is already spread entirely across both outputs. To
   alter the position, you must first reduce the width.
-</div>
+</p>
 
 <h2>Stereo Panner User Interface</h2>
 
 <img src="/images/stereo-panner-annotated.png" alt=""/>
-
 <p>
-  The panner user interface consists of three elements, divided between
+  The <dfn>panner user interface</dfn> consists of three elements, divided between
   the top and bottom half. Click and/or drag in the top half to
   control position; click and/or drag in the bottom half to control
   width (see below for details).
@@ -56,8 +55,8 @@ title: Stereo Panner
 
 <p>
   Although the implementation of the panner uses the "position"
-  parameter, when the user interface displays it numerically, it shows a pair of numbers that
-  will be familiar to most audio engineers. 
+  parameter, when the user interface displays it numerically, it shows 
+  a pair of numbers that will be familiar to most audio engineers. 
 </p>
 
 <table>
@@ -194,13 +193,13 @@ title: Stereo Panner
 
 <h2><a name="caveat"></a>Stereo panning caveats</h2>
 
-<div class="well">
+<p class="warning">
 The stereo panner will introduce unwanted side effects on
 material that includes a time difference between the channels, such
 as A/B, ORTF or NOS microphone recordings, or delay-panned mixes.<br />   
 When you reduce the with, you are effectively summing two highly
-correlated signals with a delay, which will cause comb filtering.
-</div>
+correlated signals with a delay, which will cause <dfn>comb filtering</dfn>.
+</p>
 <p>  
 Let's take a closer look at what happens when you record a source at 45° to the
 right side with an ORTF stereo microphone array and then manipulate the width.
@@ -243,10 +242,10 @@ inside your signal chain, this spatial separation is lost and the brain will
 no longer be able to sort out the timbral mess. As usual, you
 get to keep the pieces.
 </p>
-<div class="well">
+<p class="note">
 Depending on your material and on how much you need to manipulate the width,
 some degree of comb filtering may be acceptable. Then again, it may not. Listen
 carefully for artefacts if you manipulate unknown stereo signals &mdash; many
 orchestra sample libraries for example do contain time-delay components.
-</div>
+</p>
 

_manual/17_mixing/02_panning/04_vbap_panner.html

@@ -3,13 +3,13 @@ layout: default
 title: VBAP Panner
 ---                        
 
-<div class="well notabene">
+<p class="warning">
   Ardour's VBAP panner is currently in development, and its semantics may
   change in the near future, possibly affecting your mixes. Please do not
   rely on it for important production work while the dust settles.
-</div>
+</p>
 <p>
-  <strong>VBAP</strong> is short for <em>Vector-base Amplitude Panning</em>, 
+  <dfn>VBAP</dfn> is short for <em>Vector-base Amplitude Panning</em>, 
   a versatile and
   straightforward method to pan a source around on an arbitrary number
   of speakers on a horizontal polygon or a 3D surface, even if the speaker
@@ -39,21 +39,21 @@ title: VBAP Panner
   above.
 </p>
 <p>
-  A horizontal VBAP panner has one parameter, the <strong>azimuth
-  angle</strong>. A 3D panner offers an additional <strong>elevation
-  angle</strong> control.
+  A horizontal VBAP panner has one parameter, the <dfn>azimuth
+  angle</dfn>. A 3D panner offers an additional <dfn>elevation
+  angle</dfn> control.
 </p>
-<div class="well">
+<p class="note">
   More elaborate implementations of VBAP also include a
-  <strong>spread</strong> parameter, which  will distribute the signal over a 
+  <dfn>spread</dfn> parameter, which  will distribute the signal over a 
   greater number of speakers in order to maintain constant (but no longer 
   maximal) sharpness, regardless of position. Ardour's VBAP panner does not 
   currently include this feature.
-</div>
+</p>
 
 <h2>Speaker layout</h2>
 <p>
-  Each VBAP panner is specific to its <strong>speaker layout</strong>
+  Each VBAP panner is specific to its <dfn>speaker layout</dfn>
   &mdash; the panner has
   to "know" about the precise location of all the speakers. A complete VBAP
   implementation must therefore include the possibility to define this