Added @code/@endcode and removed .html

ppapi/api/ppb_audio.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the <code>PPB_Audio</code> interface, which provides
  * realtime stereo audio streaming capabilities.
  */
 
@@ skipping 15 matching lines @@
  * The <code>PPB_Audio</code> interface contains pointers to several functions
  * for handling audio resources. Please refer to the
  * <a href="/chrome/nativeclient/docs/audio.html">Pepper
  * Audio API</a> for information on using this interface.
  * Please see descriptions for each <code>PPB_Audio</code> and
  * <code>PPB_AudioConfig</code> function for more details. A C example using
  * <code>PPB_Audio</code> and <code>PPB_AudioConfig</code> follows.
  *
  * <strong>Example: </strong>
  * 
- * <code>
+ * @code
  * void audio_callback(void* sample_buffer,
  *                     uint32_t buffer_size_in_bytes,
  *                     void* user_data) {
  *   ... quickly fill in the buffer with samples and return to caller ...
  *  }
  *
  * ...Assume the application has cached the audio configuration interface in
  * <code>audio_config_interface</code> and the audio interface in
  * <code>audio_interface</code>...

[cstefansen, 2012/02/21 18:43:37]

For my edification: will <code> tags be rendered correctly, when embedded inside
@code as they are here?

[jond, 2012/02/24 20:44:27]

Those shouldn't be there. Removing them.

On 2012/02/21 18:43:37, cstefansen wrote:

  *
  * uint32_t count = audio_config_interface->RecommendSampleFrameCount(
  *     PP_AUDIOSAMPLERATE_44100, 4096);
  * PP_Resource pp_audio_config = audio_config_interface->CreateStereo16Bit(
  *     pp_instance, PP_AUDIOSAMPLERATE_44100, count);
  * PP_Resource pp_audio = audio_interface->Create(pp_instance, pp_audio_config,
  *     audio_callback, NULL);
  * audio_interface->StartPlayback(pp_audio);
  *
  * ...audio_callback() will now be periodically invoked on a separate thread...
- * </code>
+ * @endcode
  */
 interface PPB_Audio {
  /**
   * Create() creates an audio resource. No sound will be heard until
   * StartPlayback() is called. The callback is called with the buffer address
   * and given user data whenever the buffer needs to be filled. From within the
   * callback, you should not call <code>PPB_Audio</code> functions. The
   * callback will be called on a different thread than the one which created
   * the interface. For performance-critical applications (i.e. low-latency
   * audio), the callback should avoid blocking or calling functions that can
@@ skipping 69 matching lines @@
    * @return A <code>PP_Bool</code> containing <code>PP_TRUE</code> if
    * successful, otherwise <code>PP_FALSE</code>. Also returns
    * <code>PP_TRUE</code> (and is a no-op) if called while playback is already
    * stopped. If a callback is in progress, StopPlayback() will block until the
    * callback completes.
    */
   PP_Bool StopPlayback(
       [in] PP_Resource audio);
 };