Referencia de comandos
JHBuild usa una sintaxis de línea de comandos similar a la de herramientas como CVS:
jhbuild [Opciones globales] comando [argumentos de los comandos]
Las opciones globales de JHBuild son:
- -f, --fileconfig
-
Use un archivo de configuración alternativo, en lugar del predeterminado, ~/.jhbuildrc.
- -m, --modulesetmoduleset
-
Usar un conjunto de módulos diferente del que aparece listado en el archivo de configuración. Esta opción puede ser una ruta relativa si el conjunto de módulos está ubicado en la carpeta de módulos de JHBuild, o una ruta absoluta si está ubicado en otro sitio.
- --no-interact
-
No solicitar al usuario ninguna entrada. Esta opción es útil cuando se deja una construcción sin atender, para asegurarse de que no se interrumpe.
A continuación se listan las opciones específicas de los comandos.
5.1. autobuild
El comando autobuild construye automáticamente los módulos tal y como se especifica en el archivo de configuración, y sube los resultados a JhAutobuild.
jhbuild autobuild [--autogen] [--clean] [--skip=módulo...] [--start-at=módulo] [--report-url=reporturl] [--verbose]
Las opciones --autogen, --clean, --skip y --start-at se procesan de la misma manera que para el comando build.
- --report-url=reporturl, -r reporturl
-
Esta opción especifica el URL de JhAutobuild a la que se debe informar
- --verbose, -v
-
Si está especificado, la salida de JHBuild será más detallada.
5.2. bootstrap
El comando bootstrap instala un conjunto de utilidades de construcción requeridas para construir la mayoría de módulos (ej. autoconf, automake, etc).
jhbuild bootstrap
El comando, bootstrap construye módulos usando el mismo método que el comando build, pero usa el conjunto de módulos bootstrap.modules.
Consulte la documentación del comando build para ver las opciones disponibles.
5.3. build
El comando build construye uno o más paquetes, incluyendo sus dependencias.
jhbuild build [--autogen] [--clean] [--check] [--dist] [--distcheck] [--ignore-suggests] [--no-network] [--skip=módulo...] [--start-at=módulo] [--tags=etiquetas] [-D fecha] [--no-xvfb] [--try-checkout] [--no-poison] [--force] [--build-optional-modules] [--min-age=hora] [módulo...]
Si no se indican nombres de módulos en la línea de comandos, se usará la lista de módulos del archivo de configuración.
- -a, --autogen
-
Ejecute siempre autogen.sh antes de construir los módulos. De forma predeterminada sólo se ejecutará autogen.sh si no se encuentra el makefile del nivel superior. De otro modo, se delega en el makefile del paquete el detectar si «configure» debe ser reconstruido o ejecutado de nuevo.
- -c, --clean
-
Ejecute make clean antes de construir los módulos.
- --check
-
Ejecute make check después de construir los módulos.
- -d, --dist
-
Ejecute make dist después de construir los módulos.
- --distcheck
-
Ejecute make distcheck después de construir los módulos.
- --ignore-suggests
-
No construir las dependencias suaves
- -n, --no-network
-
No acceda a la red mientras esté construyendo módulos. Esto omitiría la descarga o etapas de la actualización en una construcción. Si no se puede construir un módulo sin acceso a la red, dará un error.
- -s, --skip=módulo,...
-
No construir los módulos listados. Usado para omitir la construcción de determinadas dependencias.
- --tags=etiqueta,...
-
Ignorar los módulos que no coinciden con etiqueta. Los módulos se asignan automáticamente a una etiqueta que coincide con el nombre del conjunto de módulos del módulo.
- -t, --start-at=módulo
-
Comenzar en el módulo nombrado en lugar de por el principio de la lista. Esto es útil si se interrumpió la construcción por algún motivo.
- -D fecha
-
Si la versión del sistema de control de versiones subyacente lo soporta, actualice el árbol de repositorios a su estado en la fecha dada antes de la construcción. La fecha debe estar en formato ISO, ej «2009-09-18 02:32Z».
- -x, --no-xvfb
-
Ejecutar comprobaciones gráficas en el servidor X actual en lugar de en un Xvfb simulado.
- -C, --try-checkout
-
Si falla la construcción, y el sistema de control de versiones lo soporta, fuerce una descarga y ejecute autogen.sh antes de reintentar la construcción.
- -N, --no-poison
-
Si falla una o más dependencias de un conjunto de módulos, esta opción fuerza a JHBuild a intentar construir el módulo de todas formas.
- -f, --force
-
Construir los módulos aunque la política diga que no es necesario.
- --build-optional-modules
-
Los módulos, listados como dependencias opcionales, pueden no ser necesarios para construir el módulo. Esta opción fuerza a JHBuild a construir las dependencias opcionales.
- --min-time=tiempo
-
Omitir módulos instalados más recientemente que la fecha relativa dada; el formato de la cadena time es un número seguido de una unidad. Se soportan las siguientes unidades: segundos (s), minutos (m), horas (h) y días (d). Por ejemplo, --min-time=2h omitirá los módulos construidos hace menos de dos horas.
5.4. buildone
El comando buildone es similar a build, pero no construye los módulos dependientes. Es útil para reconstruir uno o más módulos.
jhbuild buildone [--autogen] [--clean] [--check] [--distcheck] [--no-network] [-D fecha] [--no-xvfb] [--force] [--min-age=hora] módulo...
Las opciones --autogen, --check, --clean, -d, --distcheck, --no-network, -D y -x se procesan de la misma manera que para el comando build.
Se debe listar al menos un módulo en la línea de comandos.
5.5. checkbranches
El comando checkbranches comprueba que las ramas de módulos están definidas correctamente en sistema de control de versiones, y que las ramas son consistentes con el conjunto de módulos.
jhbuild checkbranches [--branch=rama...]
- --branch=rama, -brama
-
La rama para comprobar.
$ jhbuild -m gnome-2.20 checkbranches no se encuentra la definición de rama de libgnomecanvas para gnome-2-20 $
5.6. clean
El comando clean limpia las carpetas de construcción de uno o más módulos.
jhbuild clean [--skip=módulo...] [--start-at=módulo]
Si no se indican nombres de módulos en la línea de comandos, se usará la lista de módulos del archivo de configuración.
Consulte la documentación del comando build para obtener una descripción de las opciones disponibles.
5.7. dot
El comando dot genera un archivo que describe el grafo dirigido formado por las dependencias entre un conjunto de módulos. Se puede procesar este archivo usando el software GraphViz para generar un diagrama.
jhbuild dot [--soft-deps] [--clusters] [módulo...]
Si no se indican nombres de módulos en la línea de comandos, se usará la lista de módulos del archivo de configuración.
La opción --soft-deps añadirá líneas de puntos desde los módulos hasta sus dependencias débiles. La opción --clusters agrupará los módulos de los metamódulos juntos.
La salida del comando «dot» se puede redirigir a la utilidad «dot» para generar un archivo PostScript:
$ jhbuild dot modules | dot -Tps > dependencias.ps
O una imagen PNG:
$ jhbuild dot modules | dot -Tpng > dependencias.png
5.8. gui
El comando gui inicia una interfaz gráfica de JHBuild que se puede usar para seleccionar los módulos que construir y cambiar algunas opciones.
jhbuild gui
La interfaz gŕafica se renderiza usando GTK, por lo que se necesitarán algunas bibliotecas de soporte adicionales.
5.9. info
El comando info muestra información de uno o más módulos.
jhbuild info módulo...
The command displays the module name, type, dependencies, dependent packages, the source directory, and the time it was last installed with JHBuild. If available, information specific to the module type such as the CVS repository or download URL will also be displayed.
Si no se especifica ningún módulo el comando mostrará información acerca de todos los módulos definidos en el conjunto de módulos.
5.10. list
El comando list se usa para mostrar una lista expandida de los módulos que el comando build construiría.
jhbuild list [-a] [-r] [-s] [--start-at=módulo] [--tags=etiquetas] [--ignore-suggests] [--list-optional-modules] [módulo...]
Si no se indican nombres de módulos en la línea de comandos, se usará la lista de módulos del archivo de configuración.
Las opciones --skip, --start-at, --tags, --ignore-suggests y -D se procesan de la misma manera que para el comando build.
- -a, --all-modules
-
Listar todos los módulos del conjunto de módulos sin importar sus dependencias de construcción.
- -r, --show-revision
-
Si se asigna un módulo a una rama, mostrar el nombre de la rama con el nombre del módulo.
- --list-optional-modules
-
Esta opción fuerza a JHBuild a listar dependencias opcionales
5.11. rdepends
El comando rdepends muestra las dependencias inversas de un módulo.
jhbuild rdepends [módulo]
- --dependencies
-
Mostrar las dependencias junto a los módulos.
- --direct
-
Limitar la muestra a los módulos directamente dependientes del módulo dado.
5.12. run
El comando run ejecuta un comando especificado usando el mismo entorno que usa JHBuild cuando construye los módulos.
jhbuild run [--in-builddir] [--in-checkoutdir] programa [argumento...]
Si usa JHBuild para construir GNOME este comando puede ser útil en los scripts de inicio de las X.
- --in-builddir=módulo
-
Ejecute el comando en la carpeta de construcción del módulo especificado.
- --in-checkoutdir=módulo
-
Ejecute el comando en la carpeta de fuentes del módulo especificado.
5.13. sanitycheck
El comando sanitycheck lleva a cabo una serie de comprobaciones para ver si el entorno de construcción es correcto.
jhbuild sanitycheck
Algunas de las comprobaciones incluyen:
-
Los prefijos de descarga e instalación son escribibles.
-
Las herramientas de construcción requeridas están instaladas.
-
Algunas macros usadas habitualmente están disponibles en la rutas de búsqueda de los comandos de aclocal, asociados con varias versiones de automake.
-
El catálogo XML contiene la DTD de DocBook y hojas de estilos.
5.14. shell
El comando shell inicia una consola de usuario con el mismo entorno que usa JHBuild cuando construye los módulos.
jhbuild shell
Este comando es equivalente al siguiente:
$ jhbuild run $SHELL
The UNDER_JHBUILD environment variable will be set to "true" when this shell is active. You can use the presence of that variable to customize your shell's prompt to indicate that you indeed are under a jhbuild-controlled shell. For example, you may want to put this in your .bashrc:
if [ -n "$UNDER_JHBUILD" ]; then PS1="[jhbuild] $PS1" fi
This will make your bash shell display [jhbuild] before your normal prompt, making it easier to see which shells are under a jhbuild environment.
5.15. tinderbox
El comando tinderbox es parecido a build, pero guarda toda la salida del terminal en archivos HTML aptos para publicarlos en un sitio web. Se puede usar para configurar sistemas parecidos a Tinderbox de Mozilla o o Buildd de Debian.
jhbuild tinderbox [--autogen] [--clean] [--no-network] [--output=carpeta] [--skip=módulo...] [--start-at=módulo] [-D fecha] [-C] [-N] [-f] [módulo...]
Las opciones --autogen, --clean, --no-network, --skip, --start-at, -D, -C, -N y -f se procesan de la misma manera que para el comando build.
- -o, --output=carpeta
-
La carpeta donde guardar los archivos HTML.
5.17. update
El comando update es similar a build, pero sólo realiza la fase de descarga o actualización de los módulos sin construirlos.
jhbuild update [--skip=módulo...] [--start-at=módulo] [--tags=etiquetas] [--ignore-suggests] [-D fecha] [módulo...]
Las opciones --skip, --start-at, --tags, --ignore-suggests y -D se procesan de la misma manera que para el comando build.
5.18. updateone
El comando updateone es similar a update, pero no actualiza los módulos dependientes. Es útil para actualizar uno o varios módulos.
jhbuild updateone [-D fecha] módulo...
La opción -D se procesa de la misma manera que para el comando build.
Se debe listar al menos un módulo en la línea de comandos.