Manual del script kdesvn-build

Descarga y actualiza adecuada y automáticamente los módulos de Subversion.

Contabiliza el tiempo de compilación de los módulos.

Intenta reconstruir automáticamente los módulos que utilizan una compilación incremental y que son más dados a producir errores después de ciertas modificaciones.

Puede continuar el trabajo donde finalizó otro programa, o compilar un módulo concreto.

Incorpora una serie de opciones de configuración por defecto adecuadas para compilar KDE desde un Subversion anónimo.

Incorpora soporte de Unsermake.

Acepta tildes en el archivo de configuración, por ejemplo:

qtdir ~/kdesvn/build/qt-copy

Es posible definir los directorios donde se compilan, instalan y guardan los logs.

Configura automáticamente un directorio para la compilación, distinto de aquel donde se guarda el código fuente para evitar mezclarlos. Una excepción la constituye qt-copy, salvo que quiera probar “truco para compilar qt en un directorio aparte”).

Puede especificar opciones globales que se aplicarán a todos los módulos que descargue y opciones específicas paa cada módulo.

Dado que autotools no está siempre sincronizado con los cambios del código fuente, puede forzar la recompilación de un determinado módulo creando un archivo con el nombre .refresh-me en el directorio de compilación de dicho módulo, o ejecutando kdesvn-build con la copcío --refresh-build.

Puede definir varias variables para usar durante la compilación: KDEDIR, QTDIR, DO_NOT_COMPILE, y CXXFLAGS.

Archivos de registro. Los archivos de registro están numerados y fechados para facilitar la identificación en cada ejecución del script. También se crea un enlace llamado "latest" que apunta siempre al más reciente.

Si está utilizando una instalación de KDE en su directorio de usuario en lugar de en el sistema (para lo cual necesitaría ser root para instalarla), puede usar este script para instalarla. El código no ha sido demasiado probado, además utiliza bastante la llamada system(), por tanto no es muy recomendable ejecutarlo como root.

Puede utilizar make-install-prefix para insertar un comando antes del propio make installl. Esto es especialmente útil para sudo.

Puede utilizar apidox para compilar e instalar automáticamente la documentación del API de algunos módulos.

Es posible descargar sólo una parte de un módulo de KDESubversion. Por ejemplo puede descargar sólo taglib del módulo kdesupport, o bien K3B de extragear/multimedia. El script usará automáticamente kde-common si fuese necesario.

Puede que le interese saber “exactamente” qué es lo que el script va a hacer. Si lo ejecuta con la opción --pretend o -p, le dará una descripción muy detallada de los comandos que va a ejecutar aunque sin realmente ejecutarlo.

Soporte para la descarga de ramas específicas de Subversion. Aún es necesario pulir esta opción, pero puede definir la rama que quiere compilar mediante la opción de configuración module-base-path.

Encontrar la réplica del servidor Subversion de KDE más rápida. El servidor por defecto debería ir bien. No se da una lista de servidores con el programa, así que si no es así, deberá buscar usted otros servidores.

Lavarse los dientes. Debería acordarse de hacerlo usted :-)

Este script probablemente tenga algunos fallos. Lo sentimos.

apidox, para compilar la documentación del API.

apply-qt-patches, para mejorar qt-copy.

binpath, para definir la variable PATH.

branch,para decargar la versión de una determinada rama en lugar de /trunk.

build-dir, para definir el directorio de compilación.

checkout-only, para descargar sólo parte de un módulo.

colorful-output para colorear la salida del script.

configure-flags para definir las opciones de configuración de un módulo.

cxxflags para definir la variable CXXFLAGS.

dest-dir para cambiar el nombre del directorio de un determinado módulo.

disable-agent-check, para evitar que kdesvn-build compruebe el estado del agente de ssh.

do-not-compile, para marcar directorios que no desee compilar.

inst-apps, para compilar el instalar sólo algunos directorios.

install-after-build, para no instalar después de compilar.

kdedir, para definir el directorio de instalación de KDE.

libpath, para definir la variable LD_LIBRARY_PATH.

make-install-prefix, para ejecutar algún programa de apoyo (como sudo) durante la instalación.

make-options, para pasarle opciones al programa make.

manual-build, para que el módulo no se compile automáticamente.

manual-update, para evitar que se realice automáticamente cualquier acción sobre el módulo.

module-base-path, para modificar el lugar de descarga del módulo (util para las ramas y etiquetas).

niceness, para modificar la prioridad de ejecución asignada al script.

no-rebuild-on-fail, para que no se vuelva a ejecutar make en caso de fallo.

qtdir, para definir la ruta a Qt.

set-env, para definir una variable de entorno.

source-dir, para modificar el directorio a donde se descargará el código fuente.

stop-on-failure, para que kdesvn-build pare en cuanto encuentre un fallo.

svn-server, para modificar el servidor desde donde se descarga el código fuente.

use-qt-builddir-hack, para compilar Qt en un directorio aparte tal como se hace con el resto de KDE.

use-unsermake, para utilizar el sistema avanzado de compilación unsermake.