Audio/VBoxManage: Resolved a @todo: Marked the modifyvm "--audio" switch as being deprecated and introduced the switches "--audio-driver" and "--audio-enabled". This allows more flexible control of the audio stack.

git-svn-id: https://www.virtualbox.org/svn/vbox/trunk@98032 cfe28804-0f27-0410-a406-dd0f0b0b656f

1 files changed, 48 insertions, 26 deletions

diff --git a/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml
index 5ef313d1c63..6bf52da560a 100644
--- a/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml
+++ b/doc/manual/ru_RU/man_VBoxManage-modifyvm.xml
@@ -422,17 +422,6 @@ time on documenting it. -->
           <arg choice="plain">off</arg>
           <arg choice="plain"><replaceable>IO-база</replaceable> <replaceable>IRQ</replaceable></arg>
         </group></arg>
-      <arg>--audio=<group choice="plain">
-          <arg choice="plain">none</arg>
-          <arg choice="plain">default</arg>
-          <arg choice="plain">null</arg>
-          <arg choice="plain">dsound</arg>
-          <arg choice="plain">was</arg>
-          <arg choice="plain">oss</arg>
-          <arg choice="plain">alsa</arg>
-          <arg choice="plain">pulse</arg>
-          <arg choice="plain">coreaudio</arg>
-        </group></arg>
       <arg>--audio-controller=<group choice="plain">
           <arg choice="plain">ac97</arg>
           <arg choice="plain">hda</arg>
@@ -444,6 +433,21 @@ time on documenting it. -->
           <arg choice="plain">stac9221</arg>
           <arg choice="plain">sb16</arg>
         </group></arg>
+      <arg>--audio-driver=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">default</arg>
+          <arg choice="plain">null</arg>
+          <arg choice="plain">dsound</arg>
+          <arg choice="plain">was</arg>
+          <arg choice="plain">oss</arg>
+          <arg choice="plain">alsa</arg>
+          <arg choice="plain">pulse</arg>
+          <arg choice="plain">coreaudio</arg>
+        </group></arg>
+      <arg>--audio-enabled=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
       <arg>--audio-in=<group choice="plain">
           <arg choice="plain">on</arg>
           <arg choice="plain">off</arg>
@@ -1881,7 +1885,25 @@ it unless this changes. -->
             </para></listitem>
         </varlistentry>
         <varlistentry>
-          <term><option>--audio=<replaceable>тип</replaceable></option></term>
+          <term><option>--audio-controller=<replaceable>тип-контроллера</replaceable></option></term>
+          <listitem><para>
+              Задает аудио контроллер, используемый в ВМ.
+              Допустимые значения:
+              <literal>ac97</literal>, <literal>hda</literal> и
+              <literal>sb16</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audio-codec=<replaceable>тип-кодека</replaceable></option></term>
+          <listitem><para>
+              Указывает аудио кодек, используемый в ВМ. Допустимые
+              значения: <literal>stac9700</literal>,
+              <literal>ad1980</literal>, <literal>stac9221</literal>
+              и <literal>sb16</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audio-driver=<replaceable>тип</replaceable></option></term>
           <listitem><para>
               Указывает, что ВМ имеет поддержку аудио определенного типа.
               Допустимые значения:
@@ -1895,24 +1917,24 @@ it unless this changes. -->
               хоста. Вывод справки по команде <command>VBoxManage
               modifyvm</command> поможет определить поддерживаемые
               типы аудио для вашей операционной системы.
+            </para>
+            <para>
+              Для обеспечения максимальной совместимости между хостами можно
+              использовать стандартный можно использовать аудиодрайвер по
+              умолчанию. Затем виртуальная машина автоматически выберет
+              наиболее подходящий аудиодрайвер для текущего доступного хоста.
             </para></listitem>
         </varlistentry>
         <varlistentry>
-          <term><option>--audio-controller=<replaceable>тип-контроллера</replaceable></option></term>
-          <listitem><para>
-              Задает аудио контроллер, используемый в ВМ.
-              Допустимые значения:
-              <literal>ac97</literal>, <literal>hda</literal> и
-              <literal>sb16</literal>.
-            </para></listitem>
-        </varlistentry>
-        <varlistentry>
-          <term><option>--audio-codec=<replaceable>тип-кодека</replaceable></option></term>
+          <term><option>--audio-enabled=on|off</option></term>
           <listitem><para>
-              Указывает аудио кодек, используемый в ВМ. Допустимые
-              значения: <literal>stac9700</literal>,
-              <literal>ad1980</literal>, <literal>stac9221</literal>
-              и <literal>sb16</literal>.
+              Указывает, следует ли включить или отключить звук для виртуальной
+              машины.
+            </para>
+            <para>
+              Эта опция имеет приоритет над опциями --audio-on и --audio-off
+              т.е. отключение звука с помощью этой опции приведет к отключению
+              как входной, так и выходной звук.
             </para></listitem>
         </varlistentry>
         <varlistentry>