<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>Instalación de &tdevelop;</title>

<indexterm zone="tdevelop-install">
  <primary>instalación</primary></indexterm>

<para>En este capítulo se discutirán los pasos necesarios para compilar e instalar el IDE &tdevelop;: <itemizedlist>
  <listitem><para><link linkend="tdevelop-install-howto">Cómo obtener &tdevelop;</link> se concentra principalmente en la descarga del código fuente más reciente de &tdevelop; desde su repositorio svn. </para></listitem>
  <listitem><para><link linkend="requirements">Requisitos de &tdevelop;</link> lista los programas y bibliotecas que necesitará tener instalados para compilar el IDE con éxito. </para></listitem>
  <listitem><para><link linkend="compile-and-install">Compilación e instalación de &tdevelop;</link> le guía a través del proceso de compilación e instalación de la aplicación. </para></listitem>
  <listitem><para><link linkend="make-api">Cómo obtener la documentación de la API de &tdevelop;</link> le enseña qué es una API y cómo obtener esta útil herramienta para navegar a través del código fuente de &tdevelop;. </para></listitem>
</itemizedlist>
</para>

<sect1 id="tdevelop-install-howto">
<title>Cómo obtener &tdevelop;</title>

<indexterm zone="tdevelop-install-howto">
  <primary>obtener &tdevelop;</primary></indexterm>
<indexterm zone="tdevelop-install-howto">
  <primary>&tdevelop;</primary>
  <secondary>obtener</secondary></indexterm>

<para>El binario de &tdevelop; está disponible en muchas distribuciones de &Linux;, como SuSE, RedHat y otras. Estos binarios están empaquetados en algún formato adecuado (principalmente RPM) para que su instalación sea fácil. Para instalarlo, siga las instrucciones genéricas que le proporcione su distribución. </para>
<para>Tabién puede obtener el código fuente de &tdevelop;, compilarlo e instalarlo usted mismo. Este código fuente se puede encontrar en la página del proyecto, <ulink url="http://www.kdevelop.org"> http://www.kdevelop.org</ulink>, o en el <ulink url="http://download.kde.org">servidor ftp de &kde;</ulink>. </para>

<sect2 id="howto-svn">
<title>Obtener versiones diarias de &tdevelop; a partir del svn</title>

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

<para>Si desea estar al día del desarrollo actual, dispone de versiones descargadas anónimamente del repositorio svn.</para>
<para>El nombre del módulo es <emphasis>tdevelop</emphasis> en <filename class="directory">svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/tdevelop</filename>. </para>

<sect3 id="howto-svn-co">
<title>Descarga inicial del svn</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>Para obtener una versión inicial de &tdevelop;, debe descargarla de un svn anónimo. Para realizar esta operación (llamada<emphasis>checkout</emphasis>) siga los siguientes pasos. </para>

<note><para>Asumiremos que quiere tener su copia de &tdevelop; en la subcarpeta <filename class="directory">kde3src</filename> de su carpeta personal (<filename class="directory">~</filename>). </para></note>

<informalexample><simplelist>
  <member># Crear la carpeta de destino, si es necesario: </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>Tras descargar con éxito su copia de &tdevelop; puede mantenerla al día de los cambios realizados en ella usando el procedimiento de actualización que se muestra en la siguiente sección. </para></note>

<important><para>No sobrecargue el servidor. <emphasis>Por favor, no haga un «checkout» cada vez que quiera actualizar su &tdevelop;.</emphasis> Use el comando «svn update» para este propósito. </para></important>

<para>Ahora debe compilar su versión de &tdevelop; como se muestra en la sección <link linkend="compile-and-install">Compilación e instalación de &tdevelop;</link>. </para>

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

<sect3 id="howto-svn-up">
<title>Actualización de su copia del svn</title>

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

<para>Tras descargar por primera vez (y compilar con éxito) &tdevelop; del repositorio tal y como se ha mostrado, tal vez quiera mantener su copia al día para obtener todos los parches que vayan siendo añadidos. Para ello siga los pasos siguientes (de nuevo asumiremos que tiene su copia de &tdevelop; en la carpeta <filename class="directory">kde3src</filename>). </para>
<para>Note el uso del comando <command>up</command> (o <emphasis>update</emphasis>) en lugar de <command>co</command> (que significa <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>Eche un vistazo a los mensajes que genera svn durante el proceso de actualización. Los pasos exactos durante la secuencia de compilación dependerán de ello. </para></note>

<para>Ahora puede compilar una nueva versión de &tdevelop; como se muestra en el capítulo <link linkend="compile-and-install-make-svn">Consideraciones sobre la compilación especial de svn</link>. </para>
</sect3> <!-- howto-svn-up -->

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

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

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

<sect1 id="requirements">
<title>Requisitos de &tdevelop;</title>

<indexterm zone="requirements">
  <primary>requisitos</primary></indexterm>
<indexterm zone="requirements">
  <primary>&tdevelop;</primary>
  <secondary>requisitos</secondary></indexterm>
<indexterm zone="requirements">
  <primary>GNU</primary>
  <secondary>requisitos</secondary></indexterm>

<para>Para poder compilar y usar con éxito &tdevelop; necesita los siguientes programas y bibliotecas. Están disponibles como paquetes de su distribución en la mayoría de las plataformas, por lo que se pueden instalar fácilmente. </para>

<itemizedlist>
<title>Necesario:</title>
  <listitem>
  <para><application>gcc/g++</application> &ge; 2.95.3 (o compatible) <indexterm>
      <primary>gcc</primary>
      <secondary>requisitos</secondary></indexterm>
    <indexterm>
      <primary>g++</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="gcc.gnu.org">gcc.gnu.org</ulink> </para>
  </listitem>
  <listitem>
  <para><application>&GNU; make</application> (o compatible) <indexterm>
      <primary>make</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.gnu.org/software/make">www.gnu.org/software/make</ulink> </para>
  </listitem>
  <listitem>
  <para>&perl; 5.004 (o superior) <indexterm>
      <primary>Perl</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.perl.com">www.perl.com</ulink> </para>
  </listitem>
  <listitem>
  <para><application>autoconf</application> &ge; 2.52 (o superior) <indexterm>
      <primary>autoconf</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.gnu.org/software/autoconf">www.gnu.org/software/autoconf</ulink> </para>
  </listitem>
  <listitem>
  <para><application>automake</application> &ge; 1.6 (o superior) <indexterm>
      <primary>automake</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.gnu.org/software/automake">www.gnu.org/software/automake</ulink> </para>
  </listitem>
  <listitem>
  <para><application>flex</application> 2.5.4 (o superior) <indexterm>
      <primary>flex</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.gnu.org/software/flex">www.gnu.org/software/flex</ulink> </para>
  </listitem>
  <listitem>
  <para>&Qt; &ge; 3.3.0 (o superior) <indexterm>
      <primary>Qt</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.trolltech.com/products/qt">www.trolltech.com/products/qt</ulink> </para>
  </listitem>
  <listitem>
  <para><application>KDE</application> &ge; 3.4.0 (o superior) <indexterm>
      <primary>KDE</primary>
      <secondary>requisitos</secondary></indexterm>
  </para>
  <para>Disponible en <ulink url="www.kde.org">www.kde.org</ulink> </para>
  </listitem>
</itemizedlist>

<itemizedlist>
<title>Opcional:</title>
  <listitem><para>La herramienta de navegación a través del código fuente <emphasis><application>ctags</application></emphasis>, disponible en <ulink url="http://ctags.sourceforge.net">http://ctags.sourceforge.net</ulink>, que le permite acceder de forma rápida a las declaraciones y definiciones mediante varios clics de ratón sobre sus nombres en la ventana del editor. <indexterm><primary>ctags</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>dot</application></emphasis>, un compilador de lenguaje de gráficos, disponible en <ulink url="http://www.graphviz.org">http:/www.graphviz.org</ulink>. Necesita esta herramienta junto a &doxygen; si quiere mostrar gráficamente la relación existente entre sus clases (lo que es muy recomendable). <indexterm><primary>dot</primary></indexterm>
  </para></listitem>
  <listitem><para>La herramienta de documentación <emphasis>&doxygen;</emphasis>, disponible en <ulink url="http://www.doxygen.org">http://www.doxygen.org</ulink>, si quiere generar documentación consisa y potente del API de su proyecto. <indexterm><primary>doxygen</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>valgrind</application></emphasis> disponible en <ulink url="http://developer.kde.org/~sewardj/">http://developer.kde.org/~sewardj/</ulink> le ayuda a encontrar problemas de gestión de memoria en sus aplicaciones. <indexterm><primary>valgrind</primary></indexterm>
  </para></listitem>
  <listitem><para><emphasis><application>svn</application></emphasis>, disponible en <ulink url="http://subversion.tigris.org">http://subversion.tigris.org</ulink>, si quiere usar el sistema de versiones svn. <indexterm>
      <primary>svn</primary>
      <secondary>requisitos</secondary></indexterm>
  </para></listitem>
  <listitem><para>Cualquier otro compilador o herramienta necesaria para programar en otro lenguaje o plataforma distinto de C++ y &kde;, o para algún fin especial. </para></listitem>
</itemizedlist>

<note>
<orderedlist>
  <listitem>
    <para>Hasta cierto punto, puede eludir la necesidad de tener &autoconf; &ge; 2.52 y &automake; &ge; 1.6. Para ello, elimine la carpeta <filename class="directory">admin</filename> en la carpeta de instalación de &tdevelop; y escriba <indexterm>
      <primary>autoconf</primary>
      <secondary>circumvent version need</secondary></indexterm>
    <indexterm>
      <primary>automake</primary>
      <secondary>circumvent version need</secondary></indexterm>
    <indexterm>
      <primary>version need</primary>
      <secondary>circumvent for autoconf/automake</secondary></indexterm>
    </para>
    <informalexample><simplelist>
      <member><prompt>(su carpeta de tdevelop)&gt; </prompt> <userinput>ln -s $TDEDIR/share/apps/tdelibs/admin admin</userinput></member>
    </simplelist></informalexample>
    <para>en la consola. Esto hace que &tdevelop; use las preferencias generales de la carpeta <filename class="directory">admin</filename> de &kde;. </para>
  </listitem>
  <listitem>
    <para>Tenga cuidado de <emphasis>no mezclar distintas versiones de &Qt;</emphasis>. Enlace siempre &tdevelop; con la misma versión de &Qt; con que haya sido compilada su biblioteca &kde;. En caso contrario es muy probable que experimente comportamientos <emphasis>muy extraños</emphasis>. </para>
  </listitem>
</orderedlist>
</note>

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

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

<sect1 id="compile-and-install">
<title>Compilación e instalación de &tdevelop;</title>

<indexterm zone="compile-and-install">
  <primary>&tdevelop;</primary>
  <secondary>compilación</secondary></indexterm>
<indexterm zone="compile-and-install">
  <primary>&tdevelop;</primary>
  <secondary>instalación</secondary></indexterm>

<para>Una vez que haya complido todos los requisitos, estará listo para compilar e instalar &tdevelop;. Este apéndice trata de los pasos necesarios para conseguirlo. </para>
<itemizedlist>
  <listitem><para><link linkend="compile-and-install-preliminaries">Pasos preliminares</link> le enseña a configurar un entorno correcto. </para></listitem>
  <listitem><para><link linkend="compile-and-install-make">Compilación de &tdevelop;</link> trata sobre cómo obtener el código fuente de &tdevelop; del svn, cómo prepararlo para el proceso de instalación, y finalmente muestra los pasos necesarios para compilar e instalar &tdevelop;. </para></listitem>
  <listitem><para><link linkend="compile-and-install-options">Algunas notas sobre las opciones deconfigure</link> le enseña a ejecutar &tdevelop; si ha sido instalado en una carpeta distinta a la de &kde;. </para></listitem>
</itemizedlist>

<sect2 id="compile-and-install-preliminaries">
<title>Pasos preliminares</title>

<indexterm zone="compile-and-install-preliminaries">
  <primary>preliminares</primary>
  <secondary>Instalación de &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>Antes de iniciar la secuencia de compilación debe asegurarse de que el sistema «make» puede acceder a todas las bibliotecas y herramientas necesarias. Para ello debe ajustar correctamente algunas variables de entorno. Los pasos reales a realizar dependerán del intérprete de comandos que esté usando. </para>

<note><para>Para evitar el tener que teclear cada vez todas las sentencias que hacen falta para ajustar las variables de entorno necesarias cuando quiera compilar, debería colocarlas en su archivo <filename>.bashrc</filename> o <filename>.cshrc</filename>. De este modo, las variables de entorno se ajustarán correctamente cada vez que inicie el intérprete de comandos. </para></note>

<sect3 id="compile-and-install-preliminaries-bash">
<title>Configuración del entorno para el intérprete bash</title>

<para>Si usa el intérprete bash, añada las siguientes líneas: </para>

<informalexample><simplelist>
  <member><userinput>export TDEDIR=</userinput>(ruta a su instalación de KDE)</member>
  <member><userinput>export TQTDIR=</userinput>(ruta a su biblioteca 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>Configuración del entorno para el intérprete tcsh</title>

<para>Si está usando el intérprete tcsh, añada las siguientes líneas: </para>
<para>
<informalexample><simplelist>
  <member><userinput>setenv TDEDIR </userinput>(ruta a su instalación de KDE)</member>
  <member><userinput>setenv TQTDIR </userinput>(ruta a su biblioteca 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>Compilar &tdevelop;</title>

<indexterm zone="compile-and-install-make">
  <primary>make</primary>
  <secondary>Instalación de &tdevelop;</secondary></indexterm>
<indexterm zone="compile-and-install-make">
  <primary>compilación</primary>
  <secondary>&tdevelop;</secondary></indexterm>

<note><para>En la siguiente sección supondremos que ha colocado el código fuente de &tdevelop; en la carpeta <filename class="directory">~/kde3src/tdevelop</filename>. </para></note>

<sect3 id="compile-and-install-make-svn">
<title>Consideraciones especiales sobre la compilación de svn</title>

<para>En el caso de que utilice una versión de &tdevelop; descargada directamente del repositorio svn, los pasos iniciales para su compilación dependen de si realizó un «checkout» completo y de si solo actualizó el código fuente. </para>

<variablelist>
<varlistentry>
<term id="compile-and-install-make-svn-co">Tras hacer un «checkout» del svn</term>
<listitem>
<para>Debe <emphasis>inicializar el sistema «make»</emphasis> tras realizar un «checkout». Esto también será de aplicación cada vez que necesite empezar desde cero. Escriba: </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make -f admin/Makefile.common svn-clean</userinput> </member></simplelist></informalexample>
<para>y luego <emphasis>siga el resto de pasos siguientes</emphasis>. </para>
<note><para>Necesita tener acceso al repositorio svn para la limpieza si hace falta reconstruir algunos archivos dañados o que no existan en su copia local. </para></note>
<important><para>El comando <command>svn-clean</command> <emphasis>eliminará cada archivo</emphasis> de la carpeta que no esté en el svn. Asegúrese de hacer una copia de seguridad de cualquier información valiosa antes de ejecutar este comando de limpieza. </para></important>
</listitem>
</varlistentry>

<varlistentry>
<term id="compile-and-install-make-svn-up">Tras una actualización svn</term>
<listitem>
<para>El siguiente paso depende de la salida de la secuencia de actualización svn. Si ha obtenido como resultado (puede existir una «U» o una «P» como marca en la columna de la izquierda, ambas indicando que el archivo ha sido modificado) algo como esto: </para>

<screen>U /ruta_a_alguna_carpeta/Makefile.am
</screen>
<para>o si realizó un «checkout» completo, debe introducir: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make -f Makefile.svn</userinput> </member></simplelist></informalexample>
<para>antes de proceder con <emphasis>todos los pasos siguientes</emphasis>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3> <!-- compile-and-install-make-svn -->

<sect3 id="compile-and-install-make-basic">
<title>Secuencia de comandos <command>make</command> básica</title>

<para>Una vez que el sistema «make» básico haya sido ajustado, debe decidir qué tipo de sistema &tdevelop; quiere usar. Esto se hace en el siguiente paso de configuración, que construye los <filename>Makefile</filename>s reales que usará el comando <command>make</command>. </para>

<note><para>Puede omitir la opción <option>--prefix</option> en las siguientes líneas de comando para <command>configure</command> si quiere que &tdevelop; se instale en la carpeta predeterminada de &kde;. Consulte el capítulo <link linkend="compile-and-install-options">Algunas notas sobre las opciones de «configure»</link>. </para></note>

<variablelist>
<varlistentry>
<term>Una versión compilada para ser depurada</term>
<listitem>
<para>Si quiere seguir el rastro de lo que hace su aplicación &tdevelop; cuando esté en ejecución, debe construir una versión compilada para ser depurada. Ejecute el siguiente comando <command>configure</command> para ello: </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --enable-debug=full --prefix=</userinput>(donde está su kde3) </member></simplelist></informalexample>
</listitem>
</varlistentry>

<varlistentry>
<term>Una versión compilada para ser liberada</term>
<listitem>
<para>Si solo quiere usar &tdevelop; por sí mismo, bastará con una versión compilada para ser liberada (que es más pequeña y se ejecuta más rápidamente). El comando <command>configure</command> hace esto de forma predeterminada.</para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --prefix=</userinput>(donde está su kde3) </member></simplelist></informalexample>

<note>
<para>Si quiere construir su propia <link linkend="make-api">documentación del API</link> de &tdevelop;, debería incluir una opción adicional en el comando <command>configure</command>: </para>
<informalexample><simplelist>
  <member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --</userinput>(opciones como las anteriores) <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 e instalación de &tdevelop;</term>
<listitem>
<para><command>configure</command> comprobará el sistema y creará algunos archivos <filename>Makefile</filename> según lo que encuentre. El comando <command>make</command> usará el <filename>Makefile</filename> principal de forma predeterminada. De este modo </para>

<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make</userinput> </member></simplelist></informalexample>
<para>es suficiente. Si es necesario, obtenga ahora privilegios de usuario root con el comando </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>su</userinput> </member></simplelist></informalexample>
<para>e introduzca la contraseña del usuario root. Luego, instale la aplicación: </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make install</userinput> </member></simplelist></informalexample>
<para>Eso es todo. Si ha instalado &tdevelop; en la carpeta predeterminada de &kde; podrá ejecutar ahora el IDE. En caso contrario, necesitará algunos pasos adicionales como se muestra más adelante en la sección <link  linkend="compile-and-install-options-dir">Carpeta de instalación no predeterminada</link>. </para>

<note>
  <para>De hecho, normalmente habrá tres aplicaciones instaladas basadas en &tdevelop;: </para>
  <itemizedlist>
    <listitem><para>El IDE de &tdevelop; &mdash; el lugar donde normalmente trabajará.</para></listitem>
    <listitem><para>El navegador de documentación independiente del Asistente de &tdevelop; &mdash; aisla todas las potentes utilidades de documentación del IDE &tdevelop; en una herramienta separada. Esto resulta útil cuando necesita buscar determinada documentación sobre programación pero no quiere iniciar todo el IDE.</para></listitem>
    <listitem><para>El Diseñador de &tdevelop; &mdash; Amplía el «Diseñador de interfaces de usuario de &Qt;» con elementos específicos de &kde; y se integra perfectamente en el IDE de &tdevelop;.</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>Algunas notas sobre las opciones de <command>configure</command></title>

<sect3 id="compile-and-install-options-dir">
<title>Carpeta de instalación no predeterminada</title>

<indexterm zone="compile-and-install-options-dir">
  <primary>&tdevelop;</primary>
  <secondary>instalación</secondary>
  <tertiary>carpeta no predeterminada</tertiary></indexterm>
<indexterm zone="compile-and-install-options-dir">
  <primary>carpeta no predeterminada</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>Por defecto, <command>configure</command> prepara el IDE para que se instale en la carpeta predeterminada de &kde;. Esto es necesario porque &tdevelop; asume que puede acceder directamente a ciertas herramientas y partes que residen ahí. Si quiere usar su propia carpeta de instalación, debe indicárselo a <command>configure</command> con la opción <option>--prefix</option>. </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --prefix=</userinput>(donde está su kde3) </member></simplelist></informalexample>
<para>Existe un inconveniente si hace esto: debe proporcionar a &tdevelop; un medio para acceder a las herramientas y partes necesarias existentes en la carpeta de &kde; cuando esté funcionando (puede usar el IDE sin hacer esto, pero no dispondrá de todas sus capacidades). </para>
<para>Inicie un intérprete de comandos y ejecute lo siguiente antes de iniciar &tdevelop; en la línea de introducción de comandos: </para>

<note><para><emphasis>Tenga cuidado en usar la forma plural:</emphasis> es <quote><envar>TDEDIRS</envar></quote>, no <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>(Ahora puede iniciar &tdevelop;) </member>
  <member><prompt>~&gt; </prompt> <userinput>tdevelop</userinput> </member>
</simplelist></informalexample>

<note><simplelist>
  <member>La variable de entorno <envar>TDEDIRS</envar> debe estar asignada a la <emphasis>lista de carpetas del &kde; activo</emphasis> de su sistema. Usamos</member>
  <member><filename class="directory">/usr/local/kde</filename>:<filename class="directory">/opt/kde3</filename></member>
  <member>solo como ejemplo.</member>
  <member>La carpeta <filename class="directory">/usr/local/kde</filename> puede contener, por ejemplo, una versión incompleta de &kde; que haya compilado para propósitos de depuración, y la carpeta <filename class="directory">/opt/kde3</filename> puede contener, adicionalmente, la versión estándar de&kde; que proporciona su distribución y que usa en el trabajo diario.</member>
</simplelist></note>

<para>En un intérprete tcsh debe establecer las variables de entorno usando: </para>
<informalexample><simplelist><member><prompt>~&gt; </prompt> <userinput>setenv TDEDIRS /usr/local/kde:/opt/kde3</userinput> </member></simplelist></informalexample>
<para>El comando <command>tdebuildsycoca</command> (<quote>construir la caché de control del sistema</quote>) busca bibliotecas y cachés, sus ubicaciones y versiones, de modo que &tdevelop; pueda encontrarlas. El inconveniente es que tarda cierto tiempo en ejecutarse (y que necesita ejecutarse cada vez que llama al intérprete de comandos para iniciar &tdevelop; desde una carpeta no predeterminada). Es posible que quiera añadir los comandos anteriores a un guión del intérprete de comandos para eliminar la necesidad de tener que escribirlos una y otra vez. </para>
<para>También puede poner esas líneas en su archivo <filename>.bashrc</filename> o <filename>.cshrc</filename>, pero esto no es recomendable, ya que <command>tdebuildsycoca</command> se ejecutará cada vez que inicie el intérprete de comandos. </para>

<note><para>El comando <command>tdebuildsycoca</command> no se ejecuta como usuario «root». Debe llamarlo como usuario normal (pero tampoco <emphasis>es una idea muy buena</emphasis> realizar el desarrollo de software como «root»). </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>Cómo obtener la documentación del API de &tdevelop;</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>compilación</primary>
  <secondary>&tdevelop;</secondary>
  <tertiary>API</tertiary></indexterm>
<indexterm zone="make-api">
  <primary>configurar</primary>
  <secondary>API de &tdevelop;</secondary></indexterm>

<para>API significa <quote>interfaz del programa de aplicación</quote>. Relmente el API contiene una serie de descripciones (como convenciones de llamada) mediante las que un programa de aplicación puede acceder al sistema operativo y a otros servicios. En nuestro contexto se ha adoptado una definición más amplia: el API de una aplicación &Qt; o de &kde; es un extracto de las interfaces de las clases y de los métodos, una sinopsis para usar como un diccionario para navegar a través del código fuente. </para>
<para>Existe una versión del API más reciente disponible en la <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html">web de KDevelop</ulink>. Se actualiza automáticamente cada 24 horas, de modo que siempre esté al día. </para>
<para>Esta versión se usa mejor en modo de solo lectura a través de Internet. Si no dispone de acceso permanente a Internet también puede construir su propia documentación del API a partir del código fuente de &tdevelop;. Para ello debe de indicar al sistema «automake» dónde encontrar el API de KDELIBS en su sistema. Esto se consigue con la opción especial <option>--with-tdelibsdoxy-dir</option> en el comando <command>configure</command> cuando prepare la compilación del código fuente de &tdevelop;: </para>

<informalexample><simplelist>
  <member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>./configure --</userinput>(opciones usuales)<userinput> \</userinput> </member>
  <member>
    <userinput>--with-tdelibsdoxy-dir=$TDEDIR/share/doc/HTML/en/tdelibs-apidocs</userinput>
  </member>
</simplelist></informalexample>

<para>(<command>make</command> sustituirá la variable global <varname>$TDEDIR</varname> por la dirección de la carpeta real de &kde; guardada en ella). Ejecute luego el comando <command>make</command> <link linkend="compile-and-install-make-basic">como siempre</link>. Una vez construido el IDE &tdevelop; también tendrá la oportunidad de construir su API. Para ello debe ejecutar </para>
<informalexample><simplelist><member><prompt>~/kde3src/tdevelop&gt; </prompt> <userinput>make apidocs</userinput> </member></simplelist></informalexample>

<para>Esto creará un archivo <filename>Doxyfile</filename> en la carpeta principal de &tdevelop; que luego será procesado por la aplicación <application>Doxygen</application> para generar un buen número de archivos <filename>.html</filename> con la documentación del API. Cuando este a menudo largo proceso (puede durar más de una hora en un sistema lento) llegue a su fin, tendrá que instalar la documentación del API del mismo modo que tiene que instalar el IDE &tdevelop;. Si es necesario, obtenga permisos de superusuario con </para>

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

<para>e introduzca la contraseña del usuario root. Luego, instale los archivos del API: </para>

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

<para>Cuando haya terminado <command>make</command> le informará de la carpeta donde encontrará el contenido de la documentación del API. Apunte esa dirección, ya que podrá usarla desde &konqueror; al igual que desde &tdevelop;, en el caso de que haya configurado el código fuente de &tdevelop; como un proyecto sobre el que trabajar. </para>

<note><para>Es muy probable que vea un buen número de mensajes de aviso y/o de error mientras <application>Doxygen</application> genera la documentación del API. Puede ignorarlos, ya que solo tienen interés para los desarrolladores de &tdevelop;. Si la generación de la documentación del API termina con éxito, podrá utilizar los archivos <filename>.html</filename> que la contienen. </para></note>

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

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