tde-i18n/tde-i18n-pt/docs/tdesdk/scripts/man-fixincludes.1.docbook

<?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>
<author><personname><firstname>Ben</firstname><surname>Burton</surname></personname> <email>bab@debian.org</email></author>
<date>7 de Abril de 2003</date>
</refentryinfo>

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

<refnamediv>
<refname><command>fixincludes</command></refname>
<refpurpose>Reduz o número de #includes em ficheiro de código do &kde;</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis><command>fixincludes</command> <group><option>-v, --verbose</option></group> <group><option>-e, --experimental</option></group> <group><option>-m, --modify</option></group> <group><option><replaceable>ficheiro</replaceable></option></group> <group><option>--help</option></group> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title>Descrição</title>

<para>O <command>fixincludes</command> tenta reduzir o número de inclusões (#include) nos ficheiros de código em C++. Muito do processamento deste é específico do código do &kde; e, como tal, poderá não funcionar tão bem com o código das aplicações não-&kde;.</para>

<para>Os seguintes problemas são identificados pelo <command>fixincludes</command>:</para>

<itemizedlist>
<listitem>
<para>A inclusão de ficheiros que já não sejam suportados, mas que ainda existam por compatibilidade com versões mais antigas do Qt/KDE;</para>
</listitem>
<listitem>
<para>Incluir o mesmo ficheiro várias vezes. </para>
</listitem>
</itemizedlist>

<para>Existe também um modo experimental que tenta remover cada um dos #include's de cada vez (com algumas excepções) para ver se o código compila à mesma. Lembre-se que este modo experimental irá modificar o código original. </para>

<para>Por omissão, o código não será modificado; os problemas identificados simplesmente serão apresentados no 'standard output'. </para>

<para>A lista de ficheiros de C++ a examinar deverá ser indicada na linha de comandos. Se não forem indicados ficheiros, todo o código em C++ dentro e/ou abaixo da pasta actual será examinado (com a excepção das pastas cujo <filename>Makefile.am</filename> contenha <option>-UQT_NO_COMPAT</option> ou <option>-UKDE_NO_COMPAT</option>)</para>

<para>Este utilitário faz parte do Kit de Desenvolvimento de Software do KDE. </para>

</refsect1>

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

<variablelist>
<varlistentry>
<term><option>-v, --verbose</option></term>
<listitem><para>Modo descritivo. Será mostrada alguma informação adicional de depuração no 'standard output'.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-e, --experimental</option></term>
<listitem><para>O modo experimental, tal como foi descrito, em detalhe. Lembre-se que esta opção implica a <option>--modify</option>.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>-m, --modify</option></term>
<listitem><para>Assim como escreve as mensagens no 'standard output', efectua de facto as modificações ao código original, de modo a corrigir os problemas encontrados.</para></listitem>
</varlistentry>
</variablelist>

</refsect1>

<refsect1>
<title>Autores</title>
<para>O <command>fixincludes</command> foi criado por Dirk Mueller <email>mueller@kde.org</email>. </para>
</refsect1>

</refentry>