tde-i18n/tde-i18n-ru/docs/tdevelop/tdevelop/tdevelop-install.docbook

<appendix id="tdevelop-install">

<appendixinfo>
  <authorgroup>
    <author><firstname>Bernd</firstname><surname>Pol</surname></author>
    <author><firstname>Anne-Marie</firstname><surname>Mahfouf</surname></author>
    <!-- ROLES_OF_TRANSLATORS -->
  </authorgroup>
</appendixinfo>

<title>Установка &tdevelop;</title>

<indexterm zone="tdevelop-install">
  <primary>установка</primary></indexterm>

<para>В этой главе описаны все этапы сборки и установки &tdevelop;: <itemizedlist>
  <listitem><para>Раздел <link linkend="tdevelop-install-howto">Как получить &tdevelop;</link> содержит информацию по загрузке последней версии &tdevelop; в виде исходного кода из репозитория SVN. </para></listitem>
  <listitem><para>Раздел <link linkend="requirements">Требования &tdevelop;</link> содержит список программ и библиотек, необходимых для сборки &tdevelop;. </para></listitem>
  <listitem><para>Раздел <link linkend="compile-and-install">Сборка и установка &tdevelop;</link> проведёт вас через все этапы сборки и установки &tdevelop;. </para></listitem>
  <listitem><para>Раздел <link linkend="make-api">Как получить документацию по &API;</link> рассказывает что такое API и как вам получить удобный инструмент для навигации по исходникам &tdevelop;. </para></listitem>
</itemizedlist>
</para>

<sect1 id="tdevelop-install-howto">
<title>Как получить &tdevelop;</title>

<indexterm zone="tdevelop-install-howto">
  <primary>получение &tdevelop;</primary></indexterm>
<indexterm zone="tdevelop-install-howto">
  <primary>&tdevelop;</primary>
  <secondary>получение</secondary></indexterm>

<para>&tdevelop; доступен в собранном виде во многих дистрибутивах &Linux;, таких, как SuSE, RedHat и других, чаще всего в виде пакета RPM, для упрощения процесса установки. Для установки из собранного пакета обратитесь к документации по вашему дистрибутиву. </para>
<para>Также вы можете загрузить исходный код, собрать и установить &tdevelop; самостоятельно. Исходный код среды разработки доступен на <ulink url="http://www.kdevelop.org">http://www.kdevelop.org</ulink> и <ulink url="http://download.kde.org">ftp-сервер &kde;</ulink>. </para>

<sect2 id="howto-svn">
<title>Получение ежедневных снимков &tdevelop; из SVN</title>

<indexterm zone="howto-svn">
  <primary>svn</primary></indexterm>

<para>Если вы хотите быть в курсе последних разработок, то доступен анонимный снимок репозитория SVN.</para>
<para>Имя модуля <emphasis>tdevelop</emphasis> в репозитории <filename class="directory">svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop</filename>. </para>

<sect3 id="howto-svn-co">
<title>Скачивание рабочей копии</title>

<indexterm zone="howto-svn-co">
  <primary>checkout</primary></indexterm>
<indexterm zone="howto-svn-co">
  <primary>&tdevelop;</primary>
  <secondary>svn</secondary>
  <tertiary>checkout</tertiary></indexterm>

<para>Для получения версии &tdevelop;, загрузите его с анонимного репозитория SVN. Эта операция называется скачивание рабочей копии (<emphasis>checkout</emphasis>). </para>

<note><para>Далее подразумевается, что исходный код &tdevelop; расположен в каталоге <filename class="directory">~/kde3src</filename>. </para></note>

<informalexample><simplelist>
  <member># Создаём конечный каталог, если необходимо: </member>
  <member><prompt>~&gt; </prompt> <userinput>mkdir kde3src</userinput> </member>
  <member><prompt>~&gt; </prompt> <userinput>cd kde3src</userinput> </member>
  <member><prompt>~/kde3src&gt; </prompt> <userinput>svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop</userinput> </member>
  <member><prompt>~/kde3src&gt; </prompt> <userinput>cd tdevelop</userinput> </member>
</simplelist></informalexample>

<note><para>После полной загрузки рабочей копии &tdevelop; вы можете постоянно иметь самую последнюю версию путём обновления, что описано в следующем разделе. </para></note>

<important><para><emphasis>Пожалуйста, не загружайте каждый раз все файлы заново!</emphasis> Используйте команду svn update. </para></important>

<para>Теперь вы можете собрать &tdevelop;, как показано в разделе <link linkend="compile-and-install">Сборка и установка &tdevelop;</link>. </para>

</sect3> <!-- howto-svn-co -->

<sect3 id="howto-svn-up">
<title>Поддержка локальной рабочей копии в актуальном состоянии</title>

<indexterm zone="howto-svn-up">
  <primary>update</primary></indexterm>
<indexterm zone="howto-svn-up">
  <primary>&tdevelop;</primary>
  <secondary>svn</secondary>
  <tertiary>update</tertiary></indexterm>

<para>После загрузки (и сборки) &tdevelop; из SVN можно поддерживать вашу рабочую копию исходного кода в актуальном состоянии, чтобы получать все исправления. Для этого (опять же таки предполагается, что копия исходного кода &tdevelop; расположена в каталоге <filename class="directory">kde3src</filename>). </para>
<para>Обратите внимание на использование команды <command>up</command> (<emphasis>update</emphasis>, обновить) вместо <command>co</command> (<emphasis>checkout</emphasis>). </para>

<informalexample><simplelist>
  <member><prompt>~&gt; </prompt> <userinput>cd kde3src</userinput> </member>
  <member><prompt>~/kde3src&gt; </prompt> <userinput>cd tdevelop</userinput> </member>
  <member><prompt>~/kde3src&gt; </prompt> <userinput>svn up</userinput> </member>
</simplelist></informalexample>

<note><para>Следите за сообщениями svn в процессе обновления, так как от этого зависят конкретные шаги сборки. </para></note>

<para>После обновления &tdevelop;, приложение нужно собрать как описано в главе <link linkend="compile-and-install-make-svn">Нюансы сборки из SVN</link>. </para>
</sect3> <!-- howto-svn-up -->

</sect2> <!-- howto-svn -->

</sect1> <!-- howto -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="requirements">
<title>Требования</title>

<indexterm zone="requirements">
  <primary>требования</primary></indexterm>
<indexterm zone="requirements">
  <primary>&tdevelop;</primary>
  <secondary>требования</secondary></indexterm>
<indexterm zone="requirements">
  <primary>GNU</primary>
  <secondary>требования</secondary></indexterm>

<para>Для успешной сборки и последующего использования &tdevelop;, необходимо установить следующие программы и библиотеки. Обычно они поставляются с дистрибутивами, а значит установить их можно просто. </para>

<itemizedlist>
<title>Требуется:</title>
  <listitem>
  <para><application>gcc/g++</application> &ge; 2.95.3 (или аналог) <indexterm>
      <primary>gcc</primary>
      <secondary>требования</secondary></indexterm>
    <indexterm>
      <primary>g++</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="gcc.gnu.org">gcc.gnu.org</ulink> </para>
  </listitem>
  <listitem>
  <para><application>&GNU; make</application> (или аналог) <indexterm>
      <primary>make</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.gnu.org/software/make">www.gnu.org/software/make</ulink> </para>
  </listitem>
  <listitem>
  <para>&perl; 5.004 (или выше) <indexterm>
      <primary>Perl</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.perl.com">www.perl.com</ulink> </para>
  </listitem>
  <listitem>
  <para><application>autoconf</application> &ge; 2.52 (или выше) <indexterm>
      <primary>autoconf</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.gnu.org/software/autoconf">www.gnu.org/software/autoconf</ulink> </para>
  </listitem>
  <listitem>
  <para><application>automake</application> &ge; 1.6 (или выше) <indexterm>
      <primary>automake</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.gnu.org/software/automake">www.gnu.org/software/automake</ulink> </para>
  </listitem>
  <listitem>
  <para><application>flex</application> 2.5.4 (или выше) <indexterm>
      <primary>flex</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.gnu.org/software/flex">www.gnu.org/software/flex</ulink> </para>
  </listitem>
  <listitem>
  <para>&Qt; &ge; 3.0.3 (или выше) <indexterm>
      <primary>Qt</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.trolltech.com/products/qt">www.trolltech.com/products/qt</ulink> </para>
  </listitem>
  <listitem>
  <para><application>KDE</application> &ge; 3.0.2 (или выше) <indexterm>
      <primary>KDE</primary>
      <secondary>требования</secondary></indexterm>
  </para>
  <para>Официальный сайт: <ulink url="www.kde.org">www.kde.org</ulink> </para>
  </listitem>
</itemizedlist>

<itemizedlist>
<title>Необязательно:</title>
  <listitem><para>Средство навигации по исходному коду <emphasis><application>ctags</application></emphasis>, с <ulink url="http://ctags.sourceforge.net">http://ctags.sourceforge.net</ulink>, позволяющее быстрое перейти к объявлению или определению несколькими щелчками мыши на имени переменной в редакторе. <indexterm><primary>ctags</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>dot</application></emphasis>, генератор изображений, с <ulink url="http://www.graphviz.org">http:/www.graphviz.org</ulink>. Он нужен для &doxygen;, чтобы наглядно показать иерархию классов. <indexterm><primary>dot</primary></indexterm>
  </para></listitem>
  <listitem><para>Средство документирования <emphasis>&doxygen;</emphasis>, с <ulink url="http://www.doxygen.org">http://www.doxygen.org</ulink>, с помощью которого вы сможете сгенерировать лаконичную и гибкую документацию API вашего проекта. <indexterm><primary>doxygen</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>valgrind</application></emphasis> с <ulink url="http://developer.kde.org/~sewardj/">http://developer.kde.org/~sewardj/</ulink> поможет найти утечки памяти в вашем приложении. <indexterm><primary>valgrind</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>svn</application></emphasis> с <ulink url="http://subversion.tigris.org/">http://subversion.tigris.org/</ulink> если вы хотите использовать систему управления версиями SVN. <indexterm>
      <primary>svn</primary>
      <secondary>требования</secondary></indexterm>
  </para></listitem>
  <listitem><para>Любой другой компилятор и/или инструмент, если вы разрабатываете программное обеспечение на языке или платформе, отличных от C++/&kde;. </para></listitem>
</itemizedlist>

<note>
<orderedlist>
  <listitem>
    <para>Вы можете обойти требования &autoconf; &ge; 2.52 и &automake; &ge; 1.6. Просто удалите подкаталог <filename class="directory">admin</filename> в установочном каталоге &tdevelop; и введите <indexterm>
      <primary>autoconf</primary>
      <secondary>обхождение требования версий</secondary></indexterm>
    <indexterm>
      <primary>automake</primary>
      <secondary>обхождение требования версий</secondary></indexterm>
    <indexterm>
      <primary>требование версии</primary>
      <secondary>обхождение требования autoconf/automake</secondary></indexterm>
    </para>
    <informalexample><simplelist>
      <member><prompt>(каталог-tdevelop)&gt; </prompt> <userinput>ln -s $TDEDIR/share/apps/tdelibs/admin admin</userinput></member>
    </simplelist></informalexample>
    <para>в консоли. При этом &tdevelop; будет использовать стандартные параметры в каталоге &kde; <filename class="directory">admin</filename> . </para>
  </listitem>
  <listitem>
    <para>Убедитесь, что вы <emphasis>не смешиваете разные версии &Qt;</emphasis>. Всегда собирайте &tdevelop; с той версией &Qt;, с которой были собраны библиотеки &kde;. Иначе вы можете получить очень странное поведение программы. </para>
  </listitem>
</orderedlist>
</note>

</sect1> <!-- requirements -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="compile-and-install">
<title>Сборка и установка &tdevelop;</title>

<indexterm zone="compile-and-install">
  <primary>&tdevelop;</primary>
  <secondary>сборка</secondary></indexterm>
<indexterm zone="compile-and-install">
  <primary>&tdevelop;</primary>
  <secondary>установка</secondary></indexterm>

<para>После удовлетворения всех требований, вы можете приступить к сборки и установке &tdevelop;. В приложении описаны необходимые для этого действия. </para>
<itemizedlist>
  <listitem><para>Раздел <link linkend="compile-and-install-preliminaries">Подготовительные шаги</link> содержит инструкции по установке окружения. </para></listitem>
  <listitem><para>Раздел <link linkend="compile-and-install-make">Сборка &tdevelop;</link> расскажет как получить исходный код &tdevelop; из svn, подготовить его, скомпилировать и установить. </para></listitem>
  <listitem><para>Раздел <link linkend="compile-and-install-options">Примечания по ключам <command>configure</command></link> покажет как собрать &tdevelop; не в каталог &kde; по умолчанию. </para></listitem>
</itemizedlist>

<sect2 id="compile-and-install-preliminaries">
<title>Подготовительные шаги</title>

<indexterm zone="compile-and-install-preliminaries">
  <primary>подготовка</primary>
  <secondary>Установка &tdevelop;</secondary></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary>TDEDIR</primary></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary>TQTDIR</primary></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary>LD_LIBRARY_PATH</primary></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary>LIBRARY_PATH</primary></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary>PATH</primary></indexterm>

<para>Перед началом сборки убедитесь, что все библиотеки и инструменты доступны сборочной системе make. Для этого нужно правильно выставить переменные окружения. Шаги, которые следует выполнить при этом, зависят от используемой оболочки («shell»). </para>

<note><para>Чтобы не вводить все необходимые операторы по определению переменных окружения каждый раз, вы можете записать их в файл <filename>.bashrc</filename> или <filename>.cshrc</filename>. Таким образом, переменные будут иметь нужное значение каждый раз при входе в систему. </para></note>

<sect3 id="compile-and-install-preliminaries-bash">
<title>Настройка окружения в оболочке bash</title>

<para>Если вы используете bash, добавьте в его файл конфигурации такие строки: </para>

<informalexample><simplelist>
  <member><userinput>export TDEDIR=</userinput>(путь к KDE)</member>
  <member><userinput>export TQTDIR=</userinput>(путь к библиотеке Qt)</member>
  <member><userinput>export LD_LIBRARY_PATH=$TQTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH</userinput></member>
  <member><userinput>export LIBRARY_PATH=$TQTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH</userinput></member>
  <member><userinput>export PATH=$TQTDIR/bin:$TDEDIR/bin:$PATH</userinput></member>
</simplelist></informalexample>
<para></para>

</sect3> <!-- compile-and-install-preliminaries-bash -->

<sect3 id="compile-and-install-preliminaries-tcsh">
<title>Настройка окружения для оболочки tcsh</title>

<para>Если вы используете tcsh, добавьте в его файл конфигурации такие строки: </para>
<para>
<informalexample><simplelist>
  <member><userinput>setenv TDEDIR </userinput>(путь к KDE)</member>
  <member><userinput>setenv TQTDIR </userinput>(путь к библиотеке Qt)</member>
  <member><userinput>setenv LD_LIBRARY_PATH=$TQTDIR/lib:$TDEDIR/lib:$LD_LIBRARY_PATH</userinput></member>
  <member><userinput>setenv LIBRARY_PATH $TQTDIR/lib:$TDEDIR/lib:$LIBRARY_PATH</userinput></member>
  <member><userinput>setenv PATH $TQTDIR/bin:$TDEDIR/bin:$PATH</userinput></member>
</simplelist></informalexample>
</para>

</sect3> <!-- compile-and-install-preliminaries-tcs -->

</sect2> <!-- compile-and-install-preliminaries -->

<sect2 id="compile-and-install-make">
<title>Сборка &tdevelop;</title>

<indexterm zone="compile-and-install-make">
  <primary>make</primary>
  <secondary>Установка &tdevelop;</secondary></indexterm>
<indexterm zone="compile-and-install-make">
  <primary>сборка, компиляция</primary>
  <secondary>&tdevelop;</secondary></indexterm>

<note><para>Далее подразумевается, что исходный код &tdevelop; расположен в каталоге <filename class="directory">~/kde3src/tdevelop</filename>. </para></note>

<sect3 id="compile-and-install-make-svn">
<title>Особенности сборки из SVN</title>

<para>Если вы собираете &tdevelop; из SVN, начальные шаги сборки зависят от того, загрузили ли вы рабочую копию (checkout) или обновили ранее загруженную копию (update). </para>

<variablelist>
<varlistentry>
<term id="compile-and-install-make-svn-co">После svn checkout</term>
<listitem>
<para>Вы должны <emphasis>инициализировать сборочную систему</emphasis> после скачивания рабочей копии. Тоже самое необходимо сделать если вы хотите начать сборку с нуля. Наберите: </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make -f admin/Makefile.common svn-clean</userinput> </member></simplelist></informalexample>
<para>и выполните <emphasis>все следующие шаги</emphasis>. </para>
<note><para>Для восстановления повреждённых и отсутствующих файлов, возможно, потребуется запустить svn cleanup. </para></note>
<important><para>Выполните команду <command>svn-clean</command> чтобы <emphasis>удалить все файлы</emphasis>, не имеющие соответствия в репозитории SVN. Убедитесь что вы сделали резервные копии всей ценной информации перед выполнением этой команды. </para></important>
</listitem>
</varlistentry>

<varlistentry>
<term id="compile-and-install-make-svn-up">После обновления SVN</term>
<listitem>
<para>Следующий шаг зависит от вывода команды обновления svn update. Если в нём было U или P в начале строки &mdash; это означает изменение файла: </para>

<screen>U /some_directory_path/Makefile.am
</screen>
<para>или, после загрузки рабочей копии (checkout), введите: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make -f Makefile.svn</userinput> </member></simplelist></informalexample>
<para>перед выполнением <emphasis>всех следующих шагов</emphasis>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3> <!-- compile-and-install-make-svn -->

<sect3 id="compile-and-install-make-basic">
<title>Команды сборки <command>make</command></title>

<para>Теперь вы должны решить, какую систему &tdevelop; вы хотите использовать. На следующем шаге генерируются файлы <filename>Makefile</filename>, который нужны для сборки командой <command>make</command>. </para>

<note><para>Вы можете не указывать параметр <option>--prefix</option> при запуске <command>configure</command>, в этом случае &tdevelop; будет установлен в каталог &kde; по умолчанию. Подробно это изложено в разделе <link linkend="compile-and-install-options">Примечания по ключам <command>configure</command></link>. </para></note>

<variablelist>
<varlistentry>
<term>Версия с отладочной информацией</term>
<listitem>
<para>Если вы хотите следить за тем, что &tdevelop; делает во время выполнения, выберите сборку версии с отладочной информацией. Просто запустите <command>configure</command> следующим образом: </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --enable-debug=full --prefix=</userinput>(путь-к-kde3) </member></simplelist></informalexample>
</listitem>
</varlistentry>

<varlistentry>
<term>Финальная версия</term>
<listitem>
<para>Если вы хотите просто использовать &tdevelop; как есть (с меньшим размером и более быстрой работой), запускайте <command>configure</command>  с параметрами по умолчанию:</para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --prefix=</userinput>(путь-к-kde3) </member></simplelist></informalexample>

<note>
<para>Если вы хотите собрать также <link linkend="make-api">документацию по API</link> для &tdevelop;, вам нужно указать соответствующий параметр в команде запуска <command>configure</command>: </para>
<informalexample><simplelist>
  <member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --</userinput>(такие-же-ключи) <userinput>\</userinput></member> <member><userinput>--with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs</userinput></member>
</simplelist></informalexample>
</note>
</listitem>
</varlistentry>

<varlistentry>
<term>Сборка посредством make и установка</term>
<listitem>
<para>Скрипт <command>configure</command> проверит систему и создаст файл <filename>Makefile</filename>, который будет использовать команда <command>make</command>. Команда <command>make</command> будет использовать основной файл <filename>Makefile</filename> по умолчанию. </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make</userinput> </member></simplelist></informalexample>
<para>Для установки получите права суперпользователя командой: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>su</userinput> </member></simplelist></informalexample>
<para>и введите пароль пользователя root. После этого установите &tdevelop;: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make install</userinput> </member></simplelist></informalexample>
<para>Если &tdevelop; установлен в каталог &kde; по умолчанию, вы можете сразу запустить <acronym>IDE</acronym>. Иначе потребуются некоторые дополнительные шаги. Подробно об этом рассказано в разделе <link linkend="compile-and-install-options-dir">Нестандартный каталог установки</link>. </para>

<note>
  <para>На самом деле будут установлены три программы: </para>
  <itemizedlist>
    <listitem><para>&tdevelop; IDE &mdash; среда разработки, в которой вы обычно работаете.</para></listitem>
    <listitem><para>&tdevelop; Assistant &mdash; программа автономного просмотра документации, предоставляющая всю функциональность соответствующего модуля &tdevelop; IDE.</para></listitem>
    <listitem><para>&tdevelop; Designer &mdash; расширение &Qt; Designer, добавляющее специфические для виджеты &kde; и интегрирующее его в &tdevelop; IDE.</para></listitem>
  </itemizedlist>
</note>
</listitem>
</varlistentry>
</variablelist>


</sect3> <!-- compile-and-install-make-basic -->
</sect2> <!-- compile-and-install-make -->


<sect2 id="compile-and-install-options">
<title>Примечания по ключам <command>configure</command></title>

<sect3 id="compile-and-install-options-dir">
<title>Нестандартный каталог установки</title>

<indexterm zone="compile-and-install-options-dir">
  <primary>&tdevelop;</primary>
  <secondary>установка</secondary>
  <tertiary>нестандартный каталог</tertiary></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary>нестандартный каталог</primary></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary>TDEDIRS</primary></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary>tdebuildsycoca</primary></indexterm>

<para>По умолчанию <acronym>IDE</acronym> устанавливается в каталог &kde;. Это необходимо &tdevelop; для прямого доступа к некоторым утилитам и модулям, расположенным в этом каталоге. Чтобы использовать другой каталог для установки, запустите <command>configure</command> с параметром <option>--prefix</option>: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --prefix=</userinput>(путь-к-kde3) </member></simplelist></informalexample>
<para>И всё же устанавливать программу в другой каталог не рекомендуется. Конечно, вы можете сделать это, но тогда вы получите очень ограниченную функциональность. </para>
<para>Перед запуском &tdevelop; выполните следующие команды из командной строки: </para>

<note><para><emphasis>Обратите внимание на множественную форму:</emphasis> <quote><envar>TDEDIRS</envar></quote>, а не <quote><envar>TDEDIR</envar></quote> </para></note>

<informalexample><simplelist>
  <member><prompt>~&gt; </prompt> <userinput>export TDEDIRS=/usr/local/kde:/opt/kde3</userinput> </member>
  <member><prompt>~&gt; </prompt> <userinput>tdebuildsycoca</userinput> </member>
  <member>Теперь запустим &tdevelop;: </member>
  <member><prompt>~&gt; </prompt> <userinput>tdevelop</userinput> </member>
</simplelist></informalexample>

<note><simplelist>
  <member>Переменная окружения <envar>TDEDIRS</envar> должна содержать <emphasis>список активных каталогов &kde;</emphasis> вашей системы. Обычно это</member>
  <member><filename class="directory">/usr/local/kde</filename>:<filename class="directory">/opt/kde3</filename></member>
  <member>однако в вашей системе это могут быть другие каталоги.</member>
  <member>Каталог <filename class="directory">/usr/local/kde</filename>, например, может содержать неполную версию &kde;, которую вы собрали для отладки, а <filename class="directory">/opt/kde3</filename> &mdash; версию &kde; из вашего дистрибутива.</member>
</simplelist></note>

<para>в оболочке tcsh определение переменных окружения происходит таким образом: </para>
<informalexample><simplelist><member><prompt>~&gt; </prompt> <userinput>setenv TDEDIRS /usr/local/kde:/opt/kde3</userinput> </member></simplelist></informalexample>
<para>Команда <command>tdebuildsycoca</command> (<quote>build system control cache</quote> &mdash; кэш системных параметров) выполняет поиск библиотек и записывает их размещение и версию в кэш, чтобы &tdevelop; смог их найти. Это займёт некоторое время, и это нужно выполнять каждый раз перед запуском &tdevelop; из оболочки, если вы установили программу в нестандартный каталог. Конечно, из этих команд можно составить сценарий и запускать только его. </para>
<para>Кроме того можно дополнить файлы <filename>.bashrc</filename> или <filename>.cshrc</filename>, но это не желательно, так как команда будут выполняться при каждом входе в консоль. </para>

<note><para>Команду <command>tdebuildsycoca</command> не нужно выполнять с правами суперпользователя. И вообще, заниматься разработкой под root <emphasis>не очень хорошая идея</emphasis>! </para></note>
</sect3> <!-- compile-and-install-options-dir -->

<!-- ### put a sect3 with other configuration options here -->

</sect2> <!-- compile-and-install-options -->

</sect1> <!-- compile-and-install -->

<sect1 id="make-api">
<title>Как получить документацию по &API;</title>

<indexterm zone="make-api">
  <primary>API</primary>
  <secondary>&tdevelop;</secondary></indexterm>
<indexterm zone="make-api">
  <primary>&tdevelop;</primary>
  <secondary>API</secondary></indexterm>
<indexterm zone="make-api">
  <primary>сборка, компиляция</primary>
  <secondary>&tdevelop;</secondary>
  <tertiary>API</tertiary></indexterm>
<indexterm zone="make-api">
  <primary>configure</primary>
  <secondary>API &tdevelop;</secondary></indexterm>

<para>API &mdash; сокращение от <quote>Application Program Interface</quote> (программный интерфейс приложения). Это набор описаний, по которым приложение обращается к операционной системе и другим службам. API приложения &kde; или &Qt; &mdash; описание интерфейсов классов и методов, которые используются для навигации по исходному коду приложения. </para>
<para>Последняя версия документации по API находится на <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html">сайте KDevelop</ulink>. Она обновляется каждые 24 часа. </para>
<para>Чтобы собрать документацию по API из исходного кода &tdevelop; самостоятельно, нужно указать где искать API KDELIBS, добавив параметр <option>--with-tdelibsdoxy-dir</option> при запуске <command>configure</command>: </para>

<informalexample><simplelist>
  <member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --</userinput>(прочие параметры)<userinput> \</userinput> </member>
  <member>
    <userinput>--with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs</userinput>
  </member>
</simplelist></informalexample>

<para>(<command>make</command> заменит глобальную переменную <varname>$TDEDIR</varname> на каталог, где установлен &kde;). Затем запустите <command>make</command> <link linkend="compile-and-install-make-basic">как обычно</link>. После сборки &tdevelop; можно также собрать документацию по API. Для этого выполните </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make apidocs</userinput> </member></simplelist></informalexample>

<para>Это создаст файл <filename>Doxyfile</filename> в основном каталоге исходного кода &tdevelop;, который передаётся на обработку программе <application>Doxygen</application>, в результате чего будет создано большое количество файлов <filename>.html</filename> в течение некоторого времени (до часа на медленных машинах). После окончания процесса сборки нужно установить документацию. Получите права суперпользователя </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>su</userinput> </member></simplelist></informalexample>

<para>и введите пароль пользователя root, затем установите файлы документации по API: </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make install-apidox</userinput> </member></simplelist></informalexample>

<para>После этого <command>make</command> выведет имя каталога, где установлена документация по API. </para>

<note><para>Возможно, вы увидите большое количество предупреждений или сообщений об ошибках в процессе сборки документации по API программой <application>Doxygen</application>. Они представляют интерес только для разработчиков &tdevelop;. Если всё пройдёт нормально, файлы <filename>.html</filename> будут доступными для чтения. </para></note>

</sect1> <!-- make-api -->

</appendix> <!-- tdevelop-install -->