Second part of prior commit

1 files changed, 1007 insertions, 0 deletions

diff --git a/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/tools.docbook b/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/tools.docbook
new file mode 100644
index 00000000000..edfb1c6f3d4
--- /dev/null
+++ b/tde-i18n-pt_BR/docs/tdemultimedia/artsbuilder/tools.docbook
@@ -0,0 +1,1007 @@
+<!-- 
+<?xml version="1.0" ?>
+<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">
+
+To validate or process this file as a standalone document, uncomment
+this prolog. Be sure to comment it out again when you are done -->
+
+<chapter id="arts-tools">
+<title
+>Ferramentas do &arts;</title>
+
+<para
+>Incluído com o &arts;, vem um conjunto de utilitários para controlar e configurar o seu comportamento. Você precisa de ter alguma familiaridade com a maioria dessas ferramentas para usar efetivamente o &arts;. Esta seção descreve cada um dos utilitários e as suas opções de comando. </para>
+
+<sect1 id="kde-control-center">
+<title
+>&kcontrol;</title>
+
+<para
+>Ao rodar o &arts; no &kde;, o &kcontrolcenter; oferece um grupo de opções do painel de controle na categoria <guilabel
+>Som</guilabel
+>. Algumas dessas opções são usadas pelo &arts;. Você também poderá associar sons com vários eventos do gerenciador de janelas e do &kde; com o painel <menuchoice
+><guilabel
+>Aparência &amp; Comportamento</guilabel
+><guilabel
+>Notificações do Sistema</guilabel
+></menuchoice
+>. Veja o manual do &kcontrol; para saber como usar as opções do painel. </para>
+
+</sect1>
+
+<sect1 id="artsd">
+<title
+>&artsd;</title>
+
+<para
+>O acesso aos recursos de hardware de som é controlado pelo &artsd;, o servidor do &arts;. Isto permite aos diferentes aplicativos enviarem pedidos simultâneos ao servidor, onde poderão ser misturados e tocados. Sem um servidor de som centralizado, um único aplicativo que usasse um dispositivo de som iria impedir que os outros aplicativos o usassem também. </para>
+
+<para
+>Para usar o &arts;, deverá existir uma e apenas uma cópia do &artsd; sendo executada. É tipicamente executada quando o &kde; se inicia, se estiver ativo no painel <guilabel
+>Servidor de Som</guilabel
+> do &kcontrol;. </para>
+
+<para
+>O programa aceita os seguintes argumentos:</para>
+
+<!-- LW: FIX THIS -->
+
+<cmdsynopsis
+><command
+>artsd</command
+> <group choice="opt"
+> <option
+>-n</option
+> <option
+>-p</option
+> <option
+>-N</option
+> <option
+>-W <replaceable
+>n</replaceable
+></option
+> </group
+> <group choice="opt"
+> <option
+>-a <replaceable
+>método de audio</replaceable
+></option
+> <option
+>-r <replaceable
+>taxa amostragem</replaceable
+></option
+> <option
+>-b <replaceable
+>bits</replaceable
+></option
+> <option
+>-d</option
+> <option
+>-D <replaceable
+>nome dispositivo</replaceable
+></option
+> <option
+>-F <replaceable
+>fragmentos</replaceable
+></option
+> <option
+>-S <replaceable
+>tamanho</replaceable
+></option
+> <option
+>-s <replaceable
+>segundos</replaceable
+></option
+> <option
+>-m <replaceable
+>nome da aplicação</replaceable
+></option
+> </group
+> <group choice="opt"
+> <option
+>-h</option
+> <option
+>-A</option
+> <option
+>-v</option
+> <option
+>-l <replaceable
+>nível</replaceable
+></option
+> </group
+> </cmdsynopsis>
+
+<variablelist
+><varlistentry>
+<term
+><option
+>-r <replaceable
+>taxa de amostragem</replaceable
+></option
+></term>
+<listitem>
+<para
+>Indica a taxa de amostragem a usar.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-h</option
+></term>
+<listitem>
+<para
+>Mostra o modo de usar os comandos.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-n</option
+></term>
+<listitem>
+<para
+>Ativa a transparência na rede.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-p <replaceable
+>porta</replaceable
+></option>
+</term>
+<listitem>
+<para
+>Define a porta <acronym
+>TCP</acronym
+> a usar (implica o <option
+>-n</option
+>).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-u</option
+></term>
+<listitem>
+<para
+>Público e sem autenticação (perigoso).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-d</option
+></term>
+<listitem>
+<para
+>Ativa a operação em full duplex.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><option
+>-D <replaceable
+>nome do dispositivo</replaceable
+></option
+></term>
+<listitem>
+<para
+>Indica o dispositivo de áudio a usar (normalmente é o <filename
+>/dev/dsp</filename
+>).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-F <replaceable
+>fragmentos</replaceable
+></option
+></term>
+<listitem>
+<para
+>Define o número de fragmentos.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-S <replaceable
+>tamanho</replaceable
+></option
+></term>
+<listitem>
+<para
+>Define o tamanho de cada fragmento em bytes.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-s <replaceable
+>segundos</replaceable
+></option
+></term>
+<listitem>
+<para
+>Define o tempo de suspensão automática do servidor, em segundos. Um valor igual a zero desativa a suspensão automática.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-m <replaceable
+>nome do aplicativo</replaceable
+></option
+></term>
+<listitem>
+<para
+>Indica o nome de um aplicativo para usar para mostrar as mensagem de erro, de aviso e informativas. Se você estiver rodando o KDE, poderá usar o utilitário <application
+>artsmessage</application
+> para isto.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-N</option
+></term>
+<listitem>
+<para
+>Aumenta o tamanho dos buffers de rede para um valor adequado para rodar em uma LAN de 10 Mbps. Isto é equivalente a usar a opção '-w 5' (ver abaixo). </para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><option
+>-w <replaceable
+>n</replaceable
+></option
+></term>
+<listitem>
+<para
+>Ao rodar o <application
+>artsd</application
+> sobre uma conexão de rede com outra máquina, você poderá querer usar um tamanho maior dos buffers para evitar cortes. O aRts fornece aos aplicativos um tamanho mínimo sugerido. Sem esta opção, o tamanho padrão baseia-se no valor 'tamanho do fragmento' * 'número de fragmentos'. Se usar esta opção você poderá aumentar o tamanho pré-definido por um fator de <replaceable
+>n</replaceable
+>. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-l <replaceable
+>nível</replaceable
+></option
+></term>
+<listitem>
+<para
+>Indica o nível de informações - 3 (silencioso), 2 (avisos), 1 (informação), 0 (depuração).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-v</option
+></term>
+<listitem>
+<para
+>Mostra o número da versão.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para
+>Na maioria dos casos, bastará executar o &artsd;. </para>
+</sect1>
+
+<sect1 id="artswrapper">
+<title
+>&artswrapper;</title>
+
+<para
+>Para oferecer uma boa resposta em tempo-real, o &artsd; é normalmente executado como um processo em tempo-real (nas plataformas que suportem prioridades de tempo-real). Isto necessita de permissões do <systemitem class="username"
+>root</systemitem
+>, por isso, para minimizar as implicações de segurança, o &artsd; poderá ser iniciado com o pequeno programa de interface &artswrapper;, o qual simplesmente configura a prioridade de tempo-real (executando como <systemitem class="username"
+>root</systemitem
+>) e executa depois o &artsd; como um usuário que não o <systemitem class="username"
+>root</systemitem
+>. </para>
+
+<para
+>Se você tornar o artswrapper SUID <systemitem class="username"
+>root</systemitem
+>, ele irá provavelmente melhorar a qualidade da sua reprodução de áudio, reduzindo os cortes na música. Contudo, aumenta também o risco de que um erro no código ou algum usuário malicioso faça estourar ou prejudicar o seu sistema. Além disso, nas máquinas multi-usuário, priorizar o áudio de alta-fidelidade poderá provocar uma perda de desempenho para os usuário que estão tentando fazer um uso <quote
+>produtivo</quote
+> da máquina.</para>
+
+</sect1>
+
+<sect1 id="artsshell">
+<title
+>&artsshell;</title>
+
+<para
+>O comando &artsshell; pretende ser um utilitário para efetuar diversas funções relacionadas com o servidor de som. Pretende-se que o utilitário seja extendido com comandos novos no futuro (veja os comentários no código-fonte para ter algumas idéias). </para>
+
+<para
+>O comando aceita o seguinte formato: </para>
+
+<!-- LW: FIX THIS -->
+
+<cmdsynopsis
+><command
+>artsshell</command
+> <group
+> <arg
+>suspend</arg
+><arg
+>status</arg
+> <arg
+>terminate</arg
+> <arg
+>autosuspend <replaceable
+>segundos</replaceable
+></arg
+> <arg
+>networkbuffers <replaceable
+>n</replaceable
+></arg
+> <arg
+>volume [<replaceable
+>volume</replaceable
+>]</arg
+> <arg
+>stereoeffect <replaceable
+>opções</replaceable
+></arg
+> </group
+> <group
+> <option
+>-h</option
+> <option
+>-q</option
+> </group
+> </cmdsynopsis>
+
+<para
+>artsshell [options] <replaceable
+>comando</replaceable
+> [<replaceable
+>opções do comando</replaceable
+>] </para>
+
+<para
+>São suportadas as seguintes opções: </para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><option
+>-q</option
+></term>
+<listitem>
+<para
+>Suprime todos os resultados.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-h</option
+></term>
+<listitem>
+<para
+>Mostra o modo de usar os comandos.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para
+>São suportados os seguintes comandos:</para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><option
+>suspend</option
+></term>
+<listitem>
+<para
+>Suspende o servidor de som. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>status</option
+></term>
+<listitem>
+<para
+>Mostra a informação de estado do servidor de som.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>terminate</option
+></term>
+<listitem>
+<para
+>Termina o servidor de som. Isto poderá confundir e/ou estourar os aplicativos que estejam usando-o no momento. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>autosuspend</option
+> <parameter
+>segundos</parameter
+></term>
+<listitem>
+<para
+>Configura o tempo de suspensão automática para o número de segundos indicado. O servidor de som suspender-se-á se estiver inativo durante esse período de tempo. Um valor igual a zero desativa a suspensão automática. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>networkbuffers</option
+> <parameter
+>n</parameter
+></term>
+<listitem>
+<para
+>Define o tamanho dos buffers de rede para ser um fator de <parameter
+>n</parameter
+> vezes o tamanho pré-definido. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>volume</option
+> [<replaceable
+>volume</replaceable
+>]</term>
+<listitem>
+<para
+>Altera o fator de escala para as saídas de áudio do servidor de som. O argumento <replaceable
+>volume</replaceable
+> é um valor de ponto flutuante. Sem argumentos, é mostrado o volume atual. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>stereoeffect lista</option
+></term>
+<listitem>
+<para
+>Mostra todos os módulos de efeitos estéreo disponíveis.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>stereoeffect insert [top|bottom]</option
+> <replaceable
+>nome</replaceable
+></term>
+<listitem>
+<para
+>Introduz um efeito estéreo na pilha de efeitos. Devolve um identificador que poderá ser usado para removê-lo posteriormente. Poderá ser instalado no topo ou no fundo (o padrão).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>stereoeffect remove</option
+> <replaceable
+>identificador</replaceable
+></term>
+<listitem>
+<para
+>Remove o efeito estéreo com o identificador <replaceable
+>identificador</replaceable
+> da pilha de efeitos.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="artsplay">
+<title
+><application
+>artsplay</application
+></title>
+
+<para
+>O comando <application
+>artsplay</application
+> é um utilitário simples para tocar um arquivo de som. Ele aceita um único argumento que corresponde ao nome de um arquivo de som que é enviado para o servidor de som de modo a ser tocado. O arquivo de som poderá ser qualquer tipo de arquivo de som comum como o <literal role="extension"
+>wav</literal
+> ou o <literal role="extension"
+>au</literal
+>. Este utilitário é bom para testar se o servidor de som está funcionando. Se executar dois comandos em paralelo ou em sucessão rápida, você poderá demonstrar como os servidores de som misturam mais de uma fonte.</para>
+
+</sect1>
+
+<sect1 id="artsdsp">
+<title
+><application
+>artsdsp</application
+></title>
+
+<para
+>O servidor de som só suporta os aplicativos que tirem partido do &arts;. Muitas dos aplicativos legadas querem acessar o dispositivo de som diretamente. O comando &artsdsp; oferece uma solução intermediária que permite à maioria desses aplicativos rodarem sem alterações. </para>
+
+<para
+>Quando um aplicativo é executado com o &artsdsp;, todos os acessos ao dispositivo de áudio <filename class="devicefile"
+>/dev/dsp</filename
+> são interceptados e mapeados em chamadas à <acronym
+>API</acronym
+> do &arts;. Embora a emulação do dispositivo não seja perfeita, a maioria dos aplicativos funciona desta forma, ainda que com alguma latência e degradação de performance. </para>
+
+<para
+>O comando &artsdsp; segue o formato: </para>
+
+<!-- LW: FIX THIS -->
+<para
+>artsdsp [<replaceable
+>opções</replaceable
+>] <replaceable
+>argumentos da aplicação</replaceable
+> </para>
+
+<para
+>São reconhecidas as seguintes opções: </para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><option
+>-h</option
+>, <option
+>--help</option
+></term>
+<listitem>
+<para
+>Mostra uma breve ajuda.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><option
+>-n</option
+> <option
+>--name</option
+> = <replaceable
+>nome</replaceable
+></term>
+<listitem>
+<para
+>Usa o <replaceable
+>nome</replaceable
+> para identificar o tocador no <command
+>artsd</command
+>.</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-m</option
+> <option
+>--mmap</option
+></term>
+<listitem>
+<para
+>Emula o mapeamento de memória (&eg; para o <application
+>Quake</application
+>).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-v</option
+> <option
+>--verbose</option
+></term>
+<listitem>
+<para
+>Mostra os parâmetros.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<para
+>Uma invocação típica é a seguinte: </para>
+
+<para>
+<userinput
+><command
+>artsdsp</command
+> <option
+>-v</option
+> <option
+>-m</option
+> <parameter
+>realplay <replaceable
+>musica.mp3</replaceable
+></parameter
+></userinput>
+</para>
+
+<para
+>Alguns aplicativos funcionam melhor com a opção <option
+>--mmap</option
+>. Nem todas as funcionalidades do dispositivo de som estão emuladas por completo, mas a maioria dos aplicativos deverão funcionar. Se encontrar algum que não funcione, envie um relatório de erro detalhado para que os programadores possam corrigir. Mais uma vez, lembre-se que isto é uma solução intermediária e uma espécie de 'truque sujo'; a melhor solução será adicionar o suporte nativo do &arts; aos aplicativos. Se o seu aplicativo de som favorito não tem o suporte ao &arts;, peça ao programador para fornecê-lo. </para>
+
+</sect1>
+
+<sect1 id="artscat">
+<title
+><application
+>artscat</application
+></title>
+
+<para
+>Este é um utilitário simples para enviar os dados brutos para o servidor de som. Você precisa indicar o formato dos dados (a taxa de amostragem, o tamanho da amostra e o número de canais). Este não é provavelmente um utilitário que você use muito, mas poderá ser útil para fins de teste. A sintaxe do comando é a seguinte: </para>
+
+<!-- LW: FIX THIS -->
+ 
+<para
+>artscat [ <replaceable
+>opções</replaceable
+> ] [ <replaceable
+>nome do arquivo</replaceable
+> ] </para>
+
+<para
+>Se não for indicado nenhum arquivo, irá ler do 'standard input'. São suportadas as seguintes opções: </para>
+
+<variablelist>
+<varlistentry>
+<term
+><option
+>-r</option
+> <parameter
+>taxa de amostragem</parameter
+></term>
+<listitem>
+<para
+>Configura a taxa de amostragem a ser usada. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-b</option
+> <parameter
+>bits</parameter
+></term>
+<listitem>
+<para
+>Define o tamanho da amostra a usar (8 ou 16). </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-c</option
+> <parameter
+>canais</parameter
+></term>
+<listitem>
+<para
+>Define o número de canais (1 ou 2). </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-h</option
+></term>
+<listitem>
+<para
+>Mostra a utilização do comando e sai. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect1>
+
+<sect1 id="artscontrol">
+<title
+>&artscontrol;</title>
+
+<para
+>Este é um utilitário gráfico para efetuar um determinado número de tarefas relacionadas com o servidor de som. A janela padrão mostra dois indicadores de nível do volume e uma barra para controlar o volume global. No menu <guimenu
+>Ver</guimenu
+>, você poderá selecionar outras funções: </para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><guimenuitem
+>Osciloscópio FFT</guimenuitem
+></term>
+<listitem>
+<para
+>Abre uma janela que mostra uma visualização do tipo de analisador de espectro em tempo-real. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guimenuitem
+>Gerenciador de Áudio</guimenuitem
+></term>
+<listitem>
+<para
+>Mostra as fontes de áudio ativas e permite-lhe conectá-las a qualquer um dos barramentos disponíveis. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guimenuitem
+>Estado do aRts</guimenuitem
+></term>
+<listitem>
+<para
+>Mostra se o servidor de som está rodando e se o escalonamento é feito em tempo-real. Indica quando o servidor se suspende automaticamente e permite-lhe suspendê-lo imediatamente. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guimenuitem
+>Gerenciador de MIDI</guimenuitem
+></term>
+<listitem>
+<para
+>Mostra as entradas e saídas ativas de &MIDI; e permite-lhe criar conexões [TODO: Isto ainda funciona? São precisos mais detalhes]. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guimenuitem
+>FreeVerb</guimenuitem
+></term>
+<listitem>
+<para
+>Conecta um efeito de reverberação FreeVerb à pilha dos efeitos de saída do &arts; e permite-lhe controlar graficamente os parâmetros do efeito. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guimenuitem
+>Mostrador de volume com Leds</guimenuitem
+></term>
+<listitem>
+<para
+>Muda os indicadores de volume da janela principal para usar um mostrador colorido com <acronym
+>LED</acronym
+>s em vez de usar barras de progresso. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="artsc-config">
+<title
+><application
+>artsc-config</application
+></title>
+
+<para
+>Este é um utilitário para ajudar os programadores a usar a <acronym
+>API</acronym
+> de C do &arts;. Ele mostra as opções apropriadas do compilador e do editor de ligações que são necessárias ao compilar e ao gerar um executável com o &arts;. Pretende-se que seja usado nos 'Makefile's para ajudar na portabilidade. O comando aceita três opções: </para>
+
+<variablelist>
+<varlistentry>
+<term
+><option
+>--cflags</option
+></term>
+<listitem>
+<para
+>Mostra as opções do compilador que são necessárias ao compilar com a <acronym
+>API</acronym
+> de C do &arts;. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>--libs</option
+></term>
+<listitem>
+<para
+>Mostra as opções do editor de ligações que são necessárias ao gerar o executável que usa as bibliotecas da <acronym
+>API</acronym
+> de C do &arts;. </para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><acronym
+>--version</acronym
+></term>
+<listitem>
+<para
+>Mostra a versão do comando <command
+>artsc-config</command
+>. </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para
+>O resultado típico do comando é mostrado em baixo:</para>
+
+<screen width="40"
+><prompt
+>%</prompt
+> <userinput
+><command
+>artsc-config</command
+> <option
+>--cflags</option
+></userinput>
+<computeroutput
+>-I/usr/local/kde3/include/artsc</computeroutput>
+<prompt
+>%</prompt
+> <userinput
+><command
+>artsc-config</command
+> <option
+>--libs</option
+></userinput>
+<computeroutput
+>-L/usr/local/kde3/lib -ldl -lartsc -DPIC -fPIC -lpthread</computeroutput>
+<prompt
+>%</prompt
+> <userinput
+><command
+>artsc-config</command
+> <option
+>--version</option
+></userinput>
+<computeroutput
+>0.9.5</computeroutput
+>
+</screen>
+
+<para
+>Você poderá usar este utilitário em um Makefile para uma regra do tipo: </para>
+
+<programlisting
+>artsc: artsc.c
+        gcc `artsc-config --cflags` -o artsc artsc.c `artsc-config --libs`
+</programlisting>
+
+</sect1>
+
+<sect1 id="mcopidl">
+<title
+>&mcopidl;</title>
+
+<para
+>O comando &mcopidl; é o compilador de arquivos &IDL; para o &MCOP;, o 'Multimedia Communication Protocol' usado pelo &arts;. As interfaces no &arts; são definidas em &IDL;, uma 'Interface Definition Language' independente da linguagem. O utilitário &mcopidl; aceita um arquivo &IDL; como entrada e gera arquivos de inclusão e de código em C++ que implementam essa interface. O comando aceita a seguinte sintaxe: </para>
+
+<!-- LW: FIX THIS -->
+
+<para
+>mcopidl [ <replaceable
+>opções</replaceable
+> ] <replaceable
+>nome do arquivo</replaceable
+> </para>
+
+<para
+>As opções válidas são:</para>
+<variablelist>
+<varlistentry>
+<term
+><option
+>-I</option
+> <parameter
+>diretório</parameter
+></term>
+<listitem>
+<para
+>Procura no <parameter
+>diretório</parameter
+> pelos arquivos de inclusão. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-e</option
+> <parameter
+>nome</parameter
+></term>
+<listitem>
+<para
+>Exclui a estrutura, interface ou tipo enumerado <parameter
+>nome</parameter
+> da geração de código. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><option
+>-t</option
+></term>
+<listitem>
+<para
+>Cria também os arquivos <literal role="extension"
+>.mcoptype</literal
+>/<literal role="extension"
+>.mcopclass</literal
+> que contêm a informação de tipo para o arquivo &IDL;. </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para
+>Para mais informações sobre o &MCOP; e o &IDL;, você poderá ver a seção <link linkend="interfaces"
+>Interfaces e &IDL;</link
+>. </para>
+
+</sect1>
+
+</chapter>