Ésta es quizá la mejor forma de hacerlo. Si sale bien, le ahorrará tiempo de descarga y espacio en disco. Kdesvn-build descargará únicamente las partes del módulo que se indiquen. Ello es posible gracias al uso de la opción checkout-only para un módulo, que contendrá una lista de carpetas a descargar.

module kdeadmin
  checkout-only kuser kdat
end module

Una nota final sobre esta opción: Si cambia el valor de esta opción, debería utilizar kdesvn-build --refresh-build módulo para asegurarse de que el módulo se vuelve a configurar de la forma adecuada. Adicionalmente, Kdesvn-build nunca eliminará los archivos existentes si ha quitado algunas carpetas de la opción checkout-only, o ha añadido la opción al módulo que ha descargado.

En lugar de restringir lo que se descarga, es posible descargarlo todo y decirle al sistema de compilación que se salte unos pocas carpetas cuando haga la compilación. Ésto puede ser útil si una carpeta falla continuamente y no es necesario para el resto del módulo.

Esta posibilidad se maneja con la opción do-not-compile. Es similar a la opción checkout-only que se acaba de describir, en cuanto a que se reduce a una simple lista de carpetas que no deberían compilarse.

module kdebindings
  do-not-compile dcoppython
end module

Puede usar la opción inst-apps para indicar que se compilen solamente unos pocas carpetas de un módulo completo (aunque se descargará el módulo entero).

Usar esta opción equivale a combinar las opciones checkout-only y do-not-compile: el script descargará el módulo completo como do-not-compile pero sólo compilará aquellos carpetas que especifique, como checkout-only. Debido a ésto, normalmente es mejor usar simplemente checkout-only en su lugar.

Se aplican las mismas advertencias que se hicieron para las dos opciones anteriores: debe volver a configurar el módulo si cambia el valor de inst-apps.

Subversion ofrece la posibilidad de gestionar el histórico del código fuente de KDE. KDE aprovecha este soporte para crear ramas en el desarrollo y etiquetar el repositorio con cada lanzamiento de una nueva versión.

Por ejemplo, los desarrolladores de KMail podrían estar trabajando en una nueva característica en una rama diferente, con el fin de no interferir en la versión usada por la mayoría de desarrolladores. Esta rama tendría un desarrollo activo dentro de ella, incluso mientras la rama principal (llamada /trunk) continuara con su desarrollo.

Una etiqueta, por otra parte, es una instantánea del repositorio de código fuente en un instante determinado del tiempo. Las etiquetas son utilizadas por el equipo administrativo de KDE para marcar una versión de código como apropiada para su lanzamiento, mientras que permiten a los desarrolladores seguir trabajando en el código.

En Subversion no hay diferencia entre las ramas, etiquetas o la rama principal (trunk) dentro del código. Es tan sólo una convención usada por los desarrolladores. Ésto dificulta dar un soporte adecuado a las ramas y etiquetas dentro de Kdesvn-build. No obstante, hay algunas cosas que sí pueden hacerse.

El soporte para las ramas y etiquetas es manejado por un conjunto de opciones, que van desde una petición genérica para una versión, hasta especificar el URL de descarga para los usuarios avanzados.

El modo más sencillo es usar las opciones branch y tag. Usted simplemente indica la opción junto con el nombre de la rama o etiqueta deseada para un cierto módulo, y Kdesvn-build tratará de determinar la ubicación apropiada dentro del repositorio de KDE desde la que realizar la descarga. Para la mayoría de módulos de KDE esta opción funciona bastante bien.

module kdelibs
  branch 3.5
  # otras opciones...
end module

module kdemultimedia
  tag 3.4.3
  # otras opciones...
end module

Kdesvn-build admite dos opciones para situaciones en las que branch y tag suponen una ruta incorrecta: module-base-path y override-url.

Debido a varias cuestiones del sistema de compilación KDE, Kdesvn-build realizará automáticamenteuna serie de pasos para intentar que un módulo compile cuando este falle.

Si realiza un cambio en alguna opción de un módulo, o si el código fuente del módulo cambia de manera que Kdesvn-build no pueda reconocerlo, quizás necesite recompilar manualmente el módulo.

Puede hacer ésto ejecutando simplemente kdesvn-build --refresh-build módulo.

Si desea que Kdesvn-build recompile el módulo automáticamente durante la siguiente actualización de compilación normal, puede crear un archivo especial. Cada módulo tiene una carpeta de compilación. Si crea un archivo llamado .refresh-me en la carpeta de compilación para un módulo, Kdesvn-build recompilará el módulo la siguiente vez que se realice el proceso de compilación, incluso si se realiza la más rápida compilación incremental.

% touch ~/kdesvn/build/arts.refresh-me
% kdesvn-build

Puede que no quiera que Kdesvn-build intente siempre recompilar un módulo. Puede deshabilitar permanentemente este comportamiento modificando la opción no-rebuild-on-fail para que tenga el valor true (verdadero).

Para deshabilitar este comportamiento temporalmente (para una orden), use la opción --no-rebuild-on-fail en la línea de órdenes.

% kdesvn-build --no-rebuild-on-fail

Puede decirle a Kdesvn-build que comience compilando un módulo diferente al que normalmente iría en primer lugar. Ésto puede ser útil cuando una serie de módulos falla o si canceló una compilación a mitad. Para ello, use la opción --resume-from.

% kdesvn-build --resume-from=kdebase

De igual manera que puede reanudar la compilación comenzando por un módulo específico, también puede, por el contrario, actualizar y compilar todo normalmente, pero ignorando un conjunto de módulos.

Puede hacer ésto usando la opción --ignore-modules. Esta opción le dice a Kdesvn-build que ignore el resto de módulos en la línea de órdenes cuando lleva a cabo la actualización y posterior compilación.

% kdesvn-build --ignore-modules extragear/multimedia kdereview

Puede modificar las preferencias de las opciones del archivo de configuración directamente desde la línea de órdenes. Este cambio sobrescribirá las preferencias del archivo de configuración, pero sólo temporalmente, es decir, sólo tendrá efecto mientras permanezca en la línea de órdenes.

Kdesvn-build le permite cambiar las opciones con nombre del tipo nombre-opción pasando un argumento en la línea de órdenes de la forma --nombre-opción=valor. Kdesvn-build sabrá cuándo no conoce una opción y la buscará en su lista de nombres de opciones. Si no reconoce el nombre, le avisará. En otro caso le recordará el valor que puso y sobrescribirá cualquier preferencia del archivo de configuración.

% kdesvn-build --pretend --source-dir=/dev/null

Es posible también cambiar las opciones para un módulo específico. La sintaxis es similar: --módulo,nombre-de-opción=valor.

Este cambio sobreescribe cualquier preferencia similar para el módulo en el archivo de configuración y se aplica únicamente cuando la opción se pasa desde la línea de órdenes.

% kdesvn-build --kdeedu,build-dir=temp-build