<appendix id="kdevelop-install">

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

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

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

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

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

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

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

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

<indexterm zone="howto-cvs">
  <primary
>CVS</primary
></indexterm>

<para
>Доступен анонимное &CVS;-хранилище: имя модуля &mdash; <emphasis
>kdevelop</emphasis
> на <filename class="directory"
>:pserver:anonymous@anoncvs.kde.org:/home/kde</filename
>. </para>

<sect3 id="howto-cvs-co">
<title
>Первоначальная загрузка файлов (checkout)</title>

<indexterm zone="howto-cvs-co">
  <primary
>checkout</primary
></indexterm>
<indexterm zone="howto-cvs-co">
  <primary
>&kdevelop;</primary>
  <secondary
>CVS</secondary>
  <tertiary
>checkout</tertiary
></indexterm>

<para
>Для получения версии &kdevelop;, загрузите его с анонимного &CVS;. Эта операция называется <emphasis
>checkout</emphasis
>. </para>

<note
><para
>Далее подразумевается, что исходники &kdevelop; расположены в каталоге <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
>cvs -z3 -d :pserver:anonymous@anoncvs.kde.org:/home/kde co kdevelop</userinput
> </member>
  <member
><prompt
>~/kde3src&gt; </prompt
> <userinput
>cd kdevelop</userinput
> </member>
</simplelist
></informalexample>

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

<important
><para
><emphasis
>Пожалуйста, не загружайте каждый раз все файлы заново!</emphasis
> Это приводит к большой загруженности нашего сервера. </para
></important>

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

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

<sect3 id="howto-cvs-up">
<title
>Поддержка локальной &CVS;-копии</title>

<indexterm zone="howto-cvs-up">
  <primary
>update</primary
></indexterm>
<indexterm zone="howto-cvs-up">
  <primary
>&kdevelop;</primary>
  <secondary
>CVS</secondary>
  <tertiary
>update</tertiary
></indexterm>

<para
>После успешной загрузки (и сборки) &kdevelop; из CVS, можно поддерживать вашу локальную копию исходников в соответствии с &CVS;, чтобы, например, сразу иметь доступ ко всем новым функциям и исправлениям ошибок. Для этого (опять же таки предполагается, что исходники &kdevelop; расположены в каталоге <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
>cvs -z3 -d :pserver:anonymous@anoncvs.kde.org:/home/kde up kdevelop</userinput
> </member>
  <member
><prompt
>~/kde3src&gt; </prompt
> <userinput
>cd kdevelop</userinput
> </member>
</simplelist
></informalexample>

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

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

</sect2
> <!-- howto-cvs -->

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

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

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

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

<para
>Для успешной сборки и последующего использования &kdevelop;, необходимо установить следующие программы и библиотеки. Обычно они поставляются с дистрибутивами, а значит установить их можно просто. </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
>CVS</application
></emphasis
> с <ulink url="http://www.cvshome.org"
>http://www.cvshome.org</ulink
> для использования системы конкурирующих версий &CVS;. <indexterm>
      <primary
>CVS</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
> в установочном каталоге &kdevelop; и введите <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
>(каталог-kdevelop)&gt; </prompt
> <userinput
>ln -s $KDEDIR/share/apps/kdelibs/admin admin</userinput
></member>
    </simplelist
></informalexample>
    <para
>в консоли. При этом &kdevelop; будет использовать стандартные настройки в &kde;-каталоге <filename class="directory"
>admin</filename
> . </para>
  </listitem>
  <listitem>
    <para
>Убедитесь, что вы <emphasis
>не смешиваете разные версии &Qt;</emphasis
>. Всегда направляйте &kdevelop; на версию &Qt;, с которой была собрана библиотека &kde;. Иначе вы можете получить очень странное поведение программы. </para>
  </listitem>
</orderedlist>
</note>

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

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

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

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

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

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

<indexterm zone="compile-and-install-preliminaries">
  <primary
>подготовление</primary>
  <secondary
>Установка &kdevelop;</secondary
></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary
>KDEDIR</primary
></indexterm>
<indexterm zone="compile-and-install-preliminaries">
  <primary
>QTDIR</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 KDEDIR=</userinput
>(путь к KDE)</member>
  <member
><userinput
>export QTDIR=</userinput
>(путь к библиотеке Qt)</member>
  <member
><userinput
>export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput
></member>
  <member
><userinput
>export LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput
></member>
  <member
><userinput
>export PATH=$QTDIR/bin:$KDEDIR/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 KDEDIR </userinput
>(путь к KDE)</member>
  <member
><userinput
>setenv QTDIR </userinput
>(путь к библиотеке Qt)</member>
  <member
><userinput
>setenv LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH</userinput
></member>
  <member
><userinput
>setenv LIBRARY_PATH $QTDIR/lib:$KDEDIR/lib:$LIBRARY_PATH</userinput
></member>
  <member
><userinput
>setenv PATH $QTDIR/bin:$KDEDIR/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
>Сборка &kdevelop;</title>

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

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

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

<para
>Если вы собираете &kdevelop; со снимка &CVS;, начальные шаги сборки зависят от того, загрузили ли вы все файлы вновь (checkout), или обновили загруженные ранее (update). </para>

<variablelist>
<varlistentry>
<term id="compile-and-install-make-cvs-co"
>После CVS-checkout</term>
<listitem>
<para
>Запустите сборочную систему: </para>

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

<varlistentry>
<term id="compile-and-install-make-cvs-up"
>После обновления CVS</term>
<listitem>
<para
>Следующий шаг зависит от вывода команды обновления &CVS;. Если в нём было что-то типа (слева может быть U или P - и то и то означает изменение файла): </para>

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

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

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

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

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

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

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

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

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

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

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

<note>
  <para
>На самом деле будут установлены три приложения: </para>
  <itemizedlist>
    <listitem
><para
>&kdevelop; IDE &mdash; программная среда, в которой вы обычно работаете.</para
></listitem>
    <listitem
><para
>&kdevelop; Assistant &mdash; автономный просмотрщик документации, предоставляющий всю функциональность соответствующего модуля &kdevelop; IDE.</para
></listitem>
    <listitem
><para
>&kdevelop; Designer &mdash; расширение &Qt; Designer, добавляющее специфические для &kde; элементы и интегрирующее его в &kdevelop; 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
>&kdevelop;</primary>
  <secondary
>установка</secondary>
  <tertiary
>нестандартный каталог</tertiary
></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary
>нестандартный каталог</primary
></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary
>KDEDIRS</primary
></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary
>kbuildsycoca</primary
></indexterm>

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

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

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

<note
><simplelist>
  <member
>Переменная окружения <envar
>KDEDIRS</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
> - версию &kde; из вашего дистрибутива.</member>
</simplelist
></note>

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

<note
><para
>Команду <command
>kbuildsycoca</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-документацию &kdevelop;</title>

<indexterm zone="make-api">
  <primary
>API</primary>
  <secondary
>&kdevelop;</secondary
></indexterm>
<indexterm zone="make-api">
  <primary
>&kdevelop;</primary>
  <secondary
>API</secondary
></indexterm>
<indexterm zone="make-api">
  <primary
>сборка, компиляция</primary>
  <secondary
>&kdevelop;</secondary>
  <tertiary
>API</tertiary
></indexterm>
<indexterm zone="make-api">
  <primary
>configure</primary>
  <secondary
>&kdevelop; API</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-документацию из исходников &kdevelop;, нужно указать где искать API KDELIBS ключом <option
>--with-kdelibsdoxy-dir</option
> сценария <command
>configure</command
>: </para>

<informalexample
><simplelist>
  <member
><prompt
>~/kde3src/kdevelop&gt; </prompt
> <userinput
>./configure --</userinput
>(options-as-usual)<userinput
> \</userinput
> </member>
  <member>
    <userinput
>--with-kdelibsdoxy-dir=$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</userinput>
  </member>
</simplelist
></informalexample>

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

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

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

<para
>Затем: </para>

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

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

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

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

</appendix
> <!-- kdevelop-install -->
