docs/scripts/man-fixincludes.1.docbook

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003 <!ENTITY % Catalan  "INCLUDE">
0004 ]>
0005
0006 <refentry lang="&language;">
0007 <refentryinfo>
0008 <author
0009 ><personname
0010 ><firstname
0011 >Ben</firstname
0012 ><surname
0013 >Burton</surname
0014 ></personname
0015 > <email
0016 >bab@debian.org</email
0017 ></author>
0018 <date
0019 >7 d'abril de 2003</date>
0020 </refentryinfo>
0021
0022 <refmeta>
0023 <refentrytitle
0024 ><command
0025 >fixincludes</command
0026 ></refentrytitle>
0027 <manvolnum
0028 >1</manvolnum>
0029 </refmeta>
0030
0031 <refnamediv>
0032 <refname
0033 ><command
0034 >fixincludes</command
0035 ></refname>
0036 <refpurpose
0037 >Redueix el nombre de #includes en els fitxers font del &kde;</refpurpose>
0038 </refnamediv>
0039
0040 <refsynopsisdiv>
0041 <cmdsynopsis
0042 ><command
0043 >fixincludes</command
0044 > <group
0045 ><option
0046 >-v, --verbose</option
0047 ></group
0048 > <group
0049 ><option
0050 >-e, --experimental</option
0051 ></group
0052 > <group
0053 ><option
0054 >-m, --modify</option
0055 ></group
0056 > <group
0057 ><option
0058 ><replaceable
0059 >fitxer</replaceable
0060 ></option
0061 ></group
0062 > <group
0063 ><option
0064 >--help</option
0065 ></group
0066 > </cmdsynopsis>
0067 </refsynopsisdiv>
0068
0069 <refsect1>
0070 <title
0071 >Descripció</title>
0072
0073 <para
0074 ><command
0075 >fixincludes</command
0076 > intenta reduir el nombre de #includes en els fitxers de codi font de C++. La majoria del processament que realitza és específic per a &kde; i per això és possible que no funcioni tan bé sobre fonts d'aplicacions no &kde;.</para>
0077
0078 <para
0079 >Els següents problemes són identificats per <command
0080 >fixincludes</command
0081 >:</para>
0082
0083 <itemizedlist>
0084 <listitem>
0085 <para
0086 >Incloure capçaleres que ja no estan suportades però que existeixen per compatibilitat amb antigues versions de Qt/KDE;</para>
0087 </listitem>
0088 <listitem>
0089 <para
0090 >Incloure el mateix fitxer múltiples vegades. </para>
0091 </listitem>
0092 </itemizedlist>
0093
0094 <para
0095 >També disposa d'un mode experimental que intenta eliminar un #include cada vegada (amb algunes excepcions) per a comprovar si el codi segueix compilant. Tingueu present que això modifica el codi font original. </para>
0096
0097 <para
0098 >Per omissió, no es modifiquen els fitxers originals, simplement s'escriuen a l'eixida estàndard. </para>
0099
0100 <para
0101 >La llista de fitxers de C++ a analitzar haurà de ser indicada mitjançant la línia d'ordres. Si no s'indica cap fitxer, s'examinaran els del directori actual junt amb els seus subdirectoris (menys els que en el seu fitxer <filename
0102 >Makefile.am</filename
0103 > contingui les opcions <option
0104 >-UQT_NO_COMPAT</option
0105 > o <option
0106 >-UKDE_NO_COMPAT</option
0107 >).</para>
0108
0109 <para
0110 >Aquesta utilitat forma part del joc de desenvolupament de programari del &kde;. </para>
0111
0112 </refsect1>
0113
0114 <refsect1>
0115 <title
0116 >Opcions</title>
0117
0118 <variablelist>
0119 <varlistentry>
0120 <term
0121 ><option
0122 >-v, --verbose</option
0123 ></term>
0124 <listitem
0125 ><para
0126 >Mode informatiu. Mostra informació de depuració addicional escrivint-la a l'eixida estàndard.</para
0127 ></listitem>
0128 </varlistentry>
0129 <varlistentry>
0130 <term
0131 ><option
0132 >-e, --experimental</option
0133 ></term>
0134 <listitem
0135 ><para
0136 >Mode experimental, ja ha estat descrit amb detall abans. Tingueu present que aquesta opció implica <option
0137 >--modify</option
0138 >.</para
0139 ></listitem>
0140 </varlistentry>
0141 <varlistentry>
0142 <term
0143 ><option
0144 >-m, --modify</option
0145 ></term>
0146 <listitem
0147 ><para
0148 >Alhora que escriu els missatges a través de l'eixida estàndard, es modifica el codi original per a solucionar qualsevol problema trobat.</para
0149 ></listitem>
0150 </varlistentry>
0151 </variablelist>
0152
0153 </refsect1>
0154
0155 <refsect1>
0156 <title
0157 >Autors</title>
0158 <para
0159 ><command
0160 >fixincludes</command
0161 > ha estat escrit per en Dirk Mueller <email
0162 >mueller@kde.org</email
0163 >. </para>
0164 </refsect1>
0165
0166 </refentry>