<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % Portuguese "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<title
>Ferramenta de Programação</title>

<author
><firstname
>Cornelius</firstname
> <surname
>Schumacher</surname
> <affiliation
> <address
> <email
>schumacher@kde.org</email>
</address>
</affiliation>
</author>

<author
><firstname
>Waldo</firstname
> <surname
>Bastian</surname
> <affiliation
> <address
> <email
>bastian@kde.org</email>
</address>
</affiliation>
</author>

<author
><firstname
>Zack</firstname
> <surname
>Rusin</surname
> <affiliation
> <address
> <email
>zack@kde.org</email>
</address>
</affiliation>
</author>
<date
>01-06-2006</date
> <productname
>Ambiente de Trabalho K</productname
> </refentryinfo>

<refmeta>
<refentrytitle>
<command
>kconfig_compiler</command>
</refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
>kconfig_compiler</refname>
<refpurpose
>Compilador de configurações do KDE</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>kconfig_compiler</command
> <arg
>Opções do Qt</arg
> <arg
>Opções do KDE</arg
> <arg
>opções</arg
> <arg choice="plain"
><replaceable
>ficheiro.kcfg</replaceable
></arg
> <arg choice="plain"
><replaceable
>ficheiro.kcfgc</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <command
>kconfig_compiler</command
> gera código-fonte em C++ a partir de dois ficheiros. O primeiro ficheiro (.kcfg) contém informações sobre as opções de configuração e o segundo (.kcfgc) oferece as opções de geração de código. </para>

<para
>O código-fonte gerado contém uma classe baseada na <command
>KConfigSkeleton</command
> que oferece uma API para aceder aos dados de configuração das aplicações. </para>
</refsect1>

<refsect1>
<title
>Opções</title>

<para>
<variablelist>
<title
><emphasis role="bold"
>Argumentos:</emphasis
></title>

<varlistentry>
<term>
<replaceable
>ficheiro.kcfg</replaceable>
</term>
<listitem>
<para
>Ficheiro 'kcfg' de entrada em XML</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<replaceable
>ficheiro.kcfgc</replaceable>
</term>
<listitem>
<para
>Ficheiro das opções de geração de código</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções:</emphasis
></title>

<varlistentry>
<term>
<option
>-d, --directory &lt;pasta&gt;</option>
</term>
<listitem>
<para
>A pasta para onde gerar os ficheiros [.]</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções genéricas:</emphasis
></title>

<varlistentry>
<term>
<option
>--help</option>
</term>
<listitem>
<para
>Mostra a ajuda acerca das opções.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-qt</option>
</term>
<listitem>
<para
>Mostra as opções específicas do Qt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-kde</option>
</term>
<listitem>
<para
>Mostra as opções específicas do KDE</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-all</option>
</term>
<listitem>
<para
>Mostrar todas as opções</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--author</option>
</term>
<listitem>
<para
>Mostra informações sobre o autor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>-v, --version</option>
</term>
<listitem>
<para
>Mostra a versão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--license</option>
</term>
<listitem>
<para
>Mostra informações sobre a licença</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções do KDE:</emphasis
></title>

<varlistentry>
<term>
<option
>--caption &lt;título&gt;</option>
</term>
<listitem>
<para
>utiliza o 'caption' como o título da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--icon &lt;ícone&gt;</option>
</term>
<listitem>
<para
>utiliza o 'icon' como o ícone da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--miniicon &lt;ícone&gt;</option>
</term>
<listitem>
<para
>utiliza o 'icon' como o ícone da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--config &lt;ficheiro&gt;</option>
</term>
<listitem>
<para
>Usar o ficheiro de configuração alternativo</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--dcopserver &lt;servidor&gt;</option>
</term>
<listitem>
<para
>Usar o servidor de DCOP indicado em 'servidor'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--nocrashhandler</option>
</term>
<listitem>
<para
>Desactivar o tratamento de estoiros para obter os ficheiros 'core'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--waitforwm</option>
</term>
<listitem>
<para
>Espera um gestor de janelas compatível com WM_NET</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--style &lt;estilo&gt;</option>
</term>
<listitem>
<para
>Define o estilo gráfico da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--geometry &lt;geometria&gt;</option>
</term>
<listitem>
<para
>Define a geometria do cliente da janela principal - veja o 'man X' para obter o formato dos argumentos</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções do Qt:</emphasis
></title>

<varlistentry>
<term>
<option
>--display &lt;nome-ecrã&gt;</option>
</term>
<listitem>
<para
>Utilizar o ecrã do servidor de X 'displayname'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--session &lt;id-sessão&gt;</option>
</term>
<listitem>
<para
>Restaurar a aplicação com o 'sessionId' dado</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--cmap</option>
</term>
<listitem>
<para
>Faz com que a aplicação instale um mapa de cores privado num ecrã de 8 bits</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--ncols &lt;quantidade&gt;</option>
</term>
<listitem>
<para
>Limita o número de cores reservadas no cubo de cores para um ecrã de 8 bits, se a aplicação estiver a usar a especificações de cores QApplication::ManyColor</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--nograb</option>
</term>
<listitem>
<para
>Indica ao Qt para nunca capturar o rato ou o teclado</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--sync</option>
</term>
<listitem>
<para
>Muda para o modo síncrono, para fins de depuração</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--fn, --font &lt;nome-tipo-letra&gt;</option>
</term>
<listitem>
<para
>Define o tipo de letra da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--bg, --background &lt;cor&gt;</option>
</term>
<listitem>
<para
>Define a cor de fundo por omissão, bem como uma paleta da aplicação (os tons claros e escuros são calculados)</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--fg, --foreground &lt;cor&gt;</option>
</term>
<listitem>
<para
>Altera a cor do texto por omissão</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--btn, --button &lt;cor&gt;</option>
</term>
<listitem>
<para
>Altera a cor dos botões por omissão</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--name &lt;nome&gt;</option>
</term>
<listitem>
<para
>Define o nome da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--title &lt;título&gt;</option>
</term>
<listitem>
<para
>Define o título (legenda) da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--visual TrueColor</option>
</term>
<listitem>
<para
>Obriga a aplicação a usar um visual TrueColor num ecrã de 8 bits</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--inputstyle &lt;estilo-entrada&gt;</option>
</term>
<listitem>
<para
>Define o estilo de introdução de dados do XIM (X Input Method). Os valores possíveis são 'onthespot', 'overthespot', 'offthespot' e 'root'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--im &lt;servidor de XIM&gt;</option>
</term>
<listitem>
<para
>Define o servidor de XIM</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--noxim</option>
</term>
<listitem>
<para
>Desactiva o XIM</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--reverse</option>
</term>
<listitem>
<para
>Inverte por completo a disposição dos elementos gráficos</para>
</listitem>
</varlistentry>
</variablelist>
</para>

</refsect1>

<refsect1>
<title
>Veja Também</title>
<variablelist>
<varlistentry>
<term>
<option
>http://developer.kde.org</option>
</term>
<listitem>
<para
>Página Web do Canto do Programador do KDE</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title
>Problemas</title>
<para
>Use por favor o <ulink url="http://bugs.kde.org"
>bugs.kde.org</ulink
> para comunicar os erros; não os envie directamente para os autores por e-mail.</para>
</refsect1>

</refentry>
