<commit_before><!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
<node name="/Call_Content_Interface_Audio_Control"
  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
  <tp:copyright>Copyright © 2009-2011 Collabora Ltd.</tp:copyright>
  <tp:license xmlns="http://www.w3.org/1999/xhtml">
    <p>This library is free software; you can redistribute it and/or
      modify it under the terms of the GNU Lesser General Public
      License as published by the Free Software Foundation; either
      version 2.1 of the License, or (at your option) any later version.</p>

    <p>This library is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      Lesser General Public License for more details.</p>

    <p>You should have received a copy of the GNU Lesser General Public
      License along with this library; if not, write to the Free Software
      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
      02110-1301, USA.</p>
  </tp:license>

  <interface name="org.freedesktop.Telepathy.Call1.Content.Interface.AudioControl"
    tp:causes-havoc="experimental">
    <tp:added version="0.25.UNRELEASED">(draft 1)</tp:added>
    <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.Interface.Media"/>
    <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal" value="true"/>

    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
      <p>This interface allows the connection manager to be kept informed of,
          and control, the input and output volumes of an audio stream.
          While generally not needed, if the connection manager needs to
          handle stream volumes directly (typically when using Raw
          <tp:type>Call_Content_Packetization_Type</tp:type>), this interface may be necessary.</p>

      <p>If this interface is present, the handler should call ReportInputVolume
          and ReportOutputVolume whenever the the input or output volume is
          changed. Regardless of whether this is in response to the local user
          changing volume controls or after updating the stream volumes in
          response to changes in InputVolume and OutputVolume signalled by the
          connection manager.</p>

      <p>The maximum volume as used in this Interface represent the unamplified
         hardware volume (0db). No software amplification should be used to
         boost the signal to a higher level when this Interface is in use</p>
    </tp:docstring>

    <property name="RequestedInputVolume" tp:type="Audio_Control_Volume" type="i" access="read"
      tp:name-for-bindings="Requested_Input_Volume">
      <tp:docstring>
        The input volume curently requested by the Connection Manager.
        Initially and on any changes the client should change its input volume
        to match the requested volume.
      </tp:docstring>
    </property>

    <method name="ReportInputVolume" tp:name-for-bindings="Report_Input_Volume">
      <arg direction="in" name="Volume" tp:type="Audio_Control_Volume" type="i">
        <tp:docstring>
          The input volume level currently in use.
        </tp:docstring>
      </arg>
      <tp:docstring>
        <p>Inform the CM that the Content input volume has been
          changed by the client.</p>

        <p>It is the clients responsibility to change the input volume used for
           the content. However, the client MUST call this whenever it changes
           input volume for the content.</p>
      </tp:docstring>
    </method>

    <property name="RequestedOutputVolume" tp:type="Audio_Control_Volume" type="i" access="read"
      tp:name-for-bindings="Requested_Output_Volume">
      <tp:docstring>
        The input volume curently requested by the Connection Manager.
        Initially and on any changes the client should change its input volume
        to match the requested volume.
      </tp:docstring>
    </property>

    <method name="ReportOutputVolume" tp:name-for-bindings="Report_Output_Volume">
      <arg direction="in" name="Volume" tp:type="Audio_Control_Volume" type="i">
        <tp:docstring>
          Report the output volume level as currently used by the client.
        </tp:docstring>
      </arg>
      <tp:docstring>
        <p>Report to the CM that the content output volume has been
          changed by the client.</p>

        <p>It is the client's responsibility to change the output volume used
           for the content. However, the client MUST call this whenever it changes
           output volume for the content.</p>
      </tp:docstring><commit_msg>AudioControl: Add more spec markup and tweak wording<commit_after><!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
<node name="/Call_Content_Interface_Audio_Control"
  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
  <tp:copyright>Copyright © 2009-2011 Collabora Ltd.</tp:copyright>
  <tp:license xmlns="http://www.w3.org/1999/xhtml">
    <p>This library is free software; you can redistribute it and/or
      modify it under the terms of the GNU Lesser General Public
      License as published by the Free Software Foundation; either
      version 2.1 of the License, or (at your option) any later version.</p>

    <p>This library is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      Lesser General Public License for more details.</p>

    <p>You should have received a copy of the GNU Lesser General Public
      License along with this library; if not, write to the Free Software
      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
      02110-1301, USA.</p>
  </tp:license>

  <interface name="org.freedesktop.Telepathy.Call1.Content.Interface.AudioControl"
    tp:causes-havoc="experimental">
    <tp:added version="0.25.UNRELEASED">(draft 1)</tp:added>
    <tp:requires interface="org.freedesktop.Telepathy.Call1.Content.Interface.Media"/>
    <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal" value="true"/>

    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
      <p>This interface allows the connection manager to be kept informed of,
          and control, the input and output volumes of an audio stream.
          While generally not needed, if the connection manager needs to
          handle stream volumes directly (typically when using Raw
          <tp:type>Call_Content_Packetization_Type</tp:type>), this interface may be necessary.</p>

      <p>If this interface is present, the handler should call
          <tp:member-ref>ReportInputVolume</tp:member-ref>
          and <tp:member-ref>ReportOutputVolume</tp:member-ref> whenever the
          the input or output volume is changed. Regardless of whether this is
          in response to the local user changing volume controls or after
          updating the stream volumes in response to changes in
          <tp:member-ref>RequestedInputVolume</tp:member-ref> and
          <tp:member-ref>RequestedOutputVolume</tp:member-ref> signalled by the
          connection manager.</p>

      <p>The maximum volume as used in this Interface represent the unamplified
         hardware volume (0db). No software amplification should be used to
         boost the signal to a higher level when this Interface is in use</p>
    </tp:docstring>

    <property name="RequestedInputVolume" tp:type="Audio_Control_Volume" type="i" access="read"
      tp:name-for-bindings="Requested_Input_Volume">
      <tp:docstring>
        The input volume as requested by the Connection Manager.
        Initially and on any changes the client should change its input volume
        to match the requested volume.
      </tp:docstring>
    </property>

    <method name="ReportInputVolume" tp:name-for-bindings="Report_Input_Volume">
      <arg direction="in" name="Volume" tp:type="Audio_Control_Volume" type="i">
        <tp:docstring>
          Report the input volume level as set by the client.
        </tp:docstring>
      </arg>
      <tp:docstring>
        <p>Report to the CM that the Content input volume has been
          changed by the client.</p>

        <p>It is the clients responsibility to change the input volume used for
           the content. However, the client MUST call this whenever it changes
           input volume for the content.</p>
      </tp:docstring>
    </method>

    <property name="RequestedOutputVolume" tp:type="Audio_Control_Volume" type="i" access="read"
      tp:name-for-bindings="Requested_Output_Volume">
      <tp:docstring>
        The input volume as requested by the Connection Manager.
        Initially and on any changes the client should change its input volume
        to match the requested volume.
      </tp:docstring>
    </property>

    <method name="ReportOutputVolume" tp:name-for-bindings="Report_Output_Volume">
      <arg direction="in" name="Volume" tp:type="Audio_Control_Volume" type="i">
        <tp:docstring>
          Report the output volume level as set by the client.
        </tp:docstring>
      </arg>
      <tp:docstring>
        <p>Report to the CM that the content output volume has been
          changed by the client.</p>

        <p>It is the client's responsibility to change the output volume used
           for the content. However, the client MUST call this whenever it changes
           output volume for the content.</p>
      </tp:docstring>
{'fraction_non_alphanumeric': 0.08733401430030643, 'fraction_numerical': 0.008784473953013279, 'mean_word_length': 3.1575371549893845, 'pattern_counts': {'":': 0, '<': 127, '<?xml version=': 0, '>': 127, 'https://': 0, 'lorem ipsum': 0, 'www.': 6, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7141346', 'n_tokens_mistral': 2694, 'n_tokens_neox': 2583, 'n_words': 977}