2.4 Opciones de la línea de órdenes para convert-ly

En general, el programa se invoca de la manera siguiente:

convert-ly [opción]… archivo…

De manera predeterminada, convert-ly escribe los datos a la salida estándar.

Se pueden dar las siguientes opciones:

--version

Mostrar el número de versión y salir.

-h, --help

Mostrar la ayuda de uso y salir.

-d, --diff-version-update

Incrementar la cadena \version solamente si el archivo efectivamente ha cambiado. En tal caso, la cabecera de versión corresponderá a la versión siguiente al último cambio efectivo. Los números de las versiones de desarrollo se redondean hacia arriba al número de la siguiente versión estable, a no ser que fuera superior al número de la versión objetivo. Sin esa opción, la versión refleja la última conversión que se intentó hacer.

-e, --edit

Aplicar las conversiones directamente sobre el archivo de entrada, modificándolo in situ. Si el archivo original se llama miarchivo.ly, se retinene una copia de seguridad con el nombre miarchivo.ly~, es decir, se añade al final un carácter de tilde curva. Este archivo de copia de seguridad puede ser un archivo oculto en algunos sistemas operativos.

Si quiere que la salida convertida se almacene bajo un nombre distinto, redireccione la salida estándar hacia un archivo.

convert-ly miarchivo.ly > miarchivonuevo.ly

Véase también la opción --backup-numbered.

-b, --backup-numbered

Cuando se usa con la opción ‘-e’, numerar los archivos de copia de seguridad de forma que no se sobreescriba ninguna versión anterior. Suponiendo que el archivo de entrada se llama miarchivo.ly, intentar almacenar la copia de seguridad en miarchivo.ly.~1~. Si existe, intentar en cambio myfile.ly.~2~, etc. Los archivos de copia de seguridad podrían ser archivos ocultos en algunos sistemas operativos.

-f, --from=versión_de_origen

Establece la versión desde la que convertir. Si no aparece esta opción, convert-ly tratará de adivinarla, basándose en el (primer) enunciado \version del archivo. Ejemplo: --from=2.10.25

-h, --help

Imprimir la ayuda de utilización.

-l loglevel, --loglevel=loglevel

Fijar el grado en que la salida es prolija a loglevel. Los valores posibles son PROGRESS (avance; predeterminado), NONE (ninguno), WARN (advertencias), ERROR (errores) y DEBUG (depuración).

-n, --no-version

Normalmente convert-ly añade un indicador \version a la salida. La especificación de esta opción lo suprime.

-c, --current-version

De manera predeterminada, convert-ly actualiza la cadena \version a la versión más baja necesaria. Si se aporta esta opción, se usa en su lugar la versión actual de LilyPond (2.25.30).

-s, --show-rules

Mostrar las reglas de conversión y salir. La cantidad de información se puede ajustar con las opciones --from y --to.

-t, --to=versión_final

Fijar explícitamente a qué \version convertir, en caso contrario el valor predeterminado es la versión más actual. Debe ser más alta que la versión de partida.

convert-ly --to=2.14.1 miarchivo.ly

-v, --verbose

Mostrar las descripciones de las reglas durante la conversión.

-w, --warranty

Mostrar la garantía y el copyright, y salir.

Para actualizar fragmentos de LilyPond dentro de archivos de Texinfo, use

convert-ly --from=… --to=… --no-version *.itely

Para ver los cambios en la sintaxis de LilyPond entre dos versiones dadas, use

convert-ly --from=… --to=… -s