<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="b">
  <refmeta>
    <refentrytitle>b Statement</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>b Statement</refname>
    <refpurpose>
      This statement resets the clock.
      <indexterm id="IndexBStatement"><primary>b statement</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      This statement resets the clock.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>b</command> p1</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>p1</emphasis> -- Specifies how the clock is to be set.
    </para>

    <refsect2>
      <title>Special Considerations</title>
      <para>
        p1 is the number of beats by which p2 values of subsequent <emphasis>i statements</emphasis> are modified. If p1 is positive, the clock is reset forward, and subsequent notes appear later, the number of beats specified by p1 being added to the note's p2. If p1 is negative, the clock is reset backward, and subsequent notes appear earlier, the number of beats specified by p1 being subtracted from the note's p2. There is no cumulative affect. The clock is reset with each <emphasis>b statement</emphasis>. If p1 = 0, the clock is returned to its original position, and subsequent notes appear at their specified p2.
      </para>
    </refsect2>
  </refsect1>
 
  <refsect1>
    <title>Examples</title>
    <para>
      <informalexample>
        <programlisting>
i1     0      2
i1     10     888		

b 5                           ; set the clock &quot;forward&quot;
i2     1      1     440       ; start time = 6
i2     2      1     480       ; start time = 7

b -1                          ; set the clock back
i3     3      2     3.1415    ; start time = 2
i3     5.5    1     1.1111    ; start time = 4.5

b 0                           ; reset clock to normal
i4     10     200   7         ; start time = 10
        </programlisting>
      </informalexample>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      Explanation suggested and example provided by Paul Winkler. (Csound Version 4.07)
    </para>
  </refsect1>
</refentry>
