Tabla de contenidos
SubWCRev es un programa de consola para Windows que puede utilizarse para leer el estado de una copia de trabajo local y opcionalmente realizar sustituciones de palabras clave en un fichero plantilla. A menudo se utiliza como parte del proceso de compilación como una forma de incorporar información de la copia de trabajo en el objeto que está construyendo. Típicamente, se puede utilizar para incluir el número de revisión en un diálogo “Acerca de”.
SubWCRev lee el estado de Subversion de todos los ficheros en una copia de trabajo, excluyendo los externos por defecto. Apunta el número de revisión de confirmación más alto que encuentra, y la fecha de esa confirmación. También apunta si hay modificaciones locales en la copia de trabajo, o revisiones de actualización mezcladas. El número de revisión, el rango de revisiones de actualización y el estado de las modificaciones se muestra por la salida estandar stdout.
SubWCRev.exe se llama desde la línea de comandos o desde un script, y se controla utilizando parámetros de la línea de comandos.
SubWCRev WorkingCopyPath [SrcVersionFile DstVersionFile] [-nmdfe]
WorkingCopyPath es la ruta a la copia de trabajo que se va a comprobar. Sólo puede utilizar SubWCRev en copias de trabajo, no directamente en el repositorio. La ruta puede ser absoluta o relativa al directorio actual.
Si quiere que SubWCRev realice sustituciones de palabras clave, para que se graben los campos como la revisión del repositorio y la URL a un fichero de texto, debe proporcionar un fichero plantilla SrcVersionFile y un fichero de salida DstVersionFile que contendrá la versión sustituida de la plantilla.
Hay un número de modificadores opcionales que afectan la forma en la que SubWCRev trabaja. Si utiliza más de una, debe especificarlos como un único grupo, por ejemplo, -nm y no -n -m.
Tabla 5.1. Lista de opciones de línea de comandos disponible
| Cambiar | Descripción |
|---|---|
| -n | Si se especifica esta opción, SubWCRev terminará con ERRORLEVEL 7 si la copia de trabajo tiene modificaciones locales. Esto puede utilizarse para evitar compilaciones cuando hay presentes cambios sin confirmar. |
| -m | Si se especifica esta opción, SubWCRev terminará con ERRORLEVEL 8 si la copia de trabajo contiene revisiones mezcladas. Esto puede utilizarse para evitar compilaciones de una copia de trabajo parcialmente actualizada. |
| -d | Si se especifica esta opción, SubWCRev terminará con ERRORLEVEL 9 si el fichero de destino ya existe. |
| -f | Si se especifica esta opción, SubWCRev incluirá la revisión del último cambio de las carpetas. El comportamiento por defecto es utilizar únicamente los ficheros cuando se obtienen los números de revisión. |
| -e | Si se especifica esta opción, SubWCRev examinará los directorios que se han incluído con svn:externals, pero sólo si son del mismo repositorio. El comportamiento por defecto es ignorar los externos. |
| -x | Si se especifica esta opción, SubWCRev mostrará los números de revisión en HEX. |
| -X | Si se especifica esta opción, SubWCRev mostrará los números de revisión en HEX, anteponiendo '0X'. |