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 % Russian "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 апреля 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 >Уменьшить количество объявлений #include в файлах исходного кода &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 >файл</replaceable
0060 ></option
0061 ></group
0062 > <group
0063 ><option
0064 >--help</option
0065 ></group
0066 > </cmdsynopsis>
0067 </refsynopsisdiv>
0068
0069 <refsect1>
0070 <title
0071 >Описание</title>
0072
0073 <para
0074 >Команда <command
0075 >fixincludes</command
0076 > пытается уменьшить количество объявлений #include в файлах исходного кода на языке C++. Большинство функций этой команды предназначены для исходного кода &kde;; следовательно, она может не работать должным образом для программ, не относящихся к &kde;.</para>
0077
0078 <para
0079 >С помощью команды <command
0080 >fixincludes</command
0081 > можно выявить следующие проблемы:</para>
0082
0083 <itemizedlist>
0084 <listitem>
0085 <para
0086 >Включение файлов заголовков, которые больше не поддерживаются, но существуют для обеспечения совместимости с более старыми версиями Qt/KDE;</para>
0087 </listitem>
0088 <listitem>
0089 <para
0090 >Неоднократное включение одного и того же файла. </para>
0091 </listitem>
0092 </itemizedlist>
0093
0094 <para
0095 >Также имеется экспериментальный режим: объявления #include удаляются по одному за раз (за некоторыми исключениями) для проверки того, продолжает ли компилироваться исходный код. Обратите внимание, что использование этого экспериментального режима приведёт к изменению первоначального исходного кода. </para>
0096
0097 <para
0098 >По умолчанию исходный код не будет изменён; обнаруженные проблемы просто будут переданы на стандартный вывод. </para>
0099
0100 <para
0101 >В командной строке следует указать список файлов исходного кода на языке C++, которые должны быть проверены. Если файлы не указаны, будут проверены все файлы исходного кода на языке C++, находящиеся в текущем каталоге или его подкаталогах (за исключением тех каталогов, где файл <filename
0102 >Makefile.am</filename
0103 > содержит опцию <option
0104 >-UQT_NO_COMPAT</option
0105 > или <option
0106 >-UKDE_NO_COMPAT</option
0107 >)</para>
0108
0109 <para
0110 >Эта утилита является частью пакета KDE Software Development Kit. </para>
0111
0112 </refsect1>
0113
0114 <refsect1>
0115 <title
0116 >Опции</title>
0117
0118 <variablelist>
0119 <varlistentry>
0120 <term
0121 ><option
0122 >-v, --verbose</option
0123 ></term>
0124 <listitem
0125 ><para
0126 >Режим подробной информации. Дополнительный отладочный вывод передаётся на стандартный вывод.</para
0127 ></listitem>
0128 </varlistentry>
0129 <varlistentry>
0130 <term
0131 ><option
0132 >-e, --experimental</option
0133 ></term>
0134 <listitem
0135 ><para
0136 >Экспериментальный режим, описание которого приводилось выше. Обратите внимание, что при использовании этой опции будет автоматически добавлена опция <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 >Как передать сообщения на стандартный вывод, так и действительно изменить первоначальный исходный код для устранения обнаруженных проблем.</para
0149 ></listitem>
0150 </varlistentry>
0151 </variablelist>
0152
0153 </refsect1>
0154
0155 <refsect1>
0156 <title
0157 >Авторы</title>
0158 <para
0159 >Автор команды <command
0160 >fixincludes</command
0161 > — Dirk Mueller <email
0162 >mueller@kde.org</email
0163 >. </para>
0164 </refsect1>
0165
0166 </refentry>