autorevisión: en línea en la nube

PROGRAMA:

NOMBRE

revisión automática: extrae los metadatos de la revisión actual de los repositorios de control de versiones

SINOPSIS

autorrevisión {-t | -s } [-o [-f]] [-U] [-V]

DESCRIPCIÓN

Extrae metadatos sobre la revisión principal de su repositorio.

Este programa está destinado a ser utilizado por sistemas de construcción de proyectos para extraer propiedades que pueden
ser utilizado en cadenas de versiones de software. Puede emitir archivos fuente que contienen variables y
definiciones de macros adecuadas para su uso con C, C ++, Java, sh, Python, Perl, Mac info.plist y
otros tipos de archivos (consulte la lista completa a continuación).

La fuente generada se escribe en la salida estándar.

Este programa normalmente se puede llamar desde cualquier lugar dentro de una copia del repositorio. Bajo bzr el
la copia debe ser de una sucursal, no de un repositorio completo de múltiples sucursales. Bajo Subversion debe ser
se llama bajo la comprobación de un repositorio, no el repositorio en sí.

Si especifica un archivo de caché, entonces cuando autorrevisión se ejecuta donde ningún repositorio puede ser
reconocido, los valores del archivo de caché se utilizarán en su lugar. Si un repositorio puede ser
reconocido, la caché se reescribe. Esta característica hace posible que su compilación se ejecute
desde un tarball descomprimido que incluye el archivo de caché.

Válido Repositorio Tipos
Git: Se recomienda una versión superior a 1.7.2.3.

mercurial: Se recomienda una versión superior a 1.6.

Subversión: Cualquier versión de producción.

Bazar: Cualquier versión de producción.

Válido Salida Tipos
cierre
Un archivo fuente de clojure que configura las variables de clojure.

h
Un archivo de encabezado adecuado para C / C ++.

caballos de fuerza
Archivo de encabezado de C ++ alternativo con espacio de nombres. El espacio de nombres se asigna desde VCS_BASENAME.

ini
Un archivo de origen ini que configura las variables ini.

Java
Un archivo fuente de Java que establece las propiedades de la clase.

javaprop
Un archivo de propiedades de Java (como ini); útil cuando META-INF se puede leer en Java.

js
Un archivo de origen javascript que configura las variables javascript.

json
Un archivo de formato JSON.

luna
Un archivo de origen lua que configura las variables lua.

m4
Un archivo fuente m4 que define macros m4.

matlab
Salida de Matlab.

octava
Salida de octava.

php
Un archivo de origen PHP que configura las variables de PHP.

pl
Un archivo fuente de Perl que configura las variables de Perl (perl es un sinónimo aceptable).

py
Un archivo fuente de Python que configura las variables de Python (pitón es un sinónimo aceptable).

rpm
Un formato de archivo de especificación de RPM que configura macros de archivo de especificación.

esquema
Un archivo de origen de esquema que configura las variables del esquema.

sh
Un archivo de texto adecuado para incluir desde un script bash. Trabajará con Ruby.

rápido
Un archivo de origen Swift que configura las constantes globales de Swift.

A menos que se establezca VCS_EXTRA y cualquier símbolo que falte debido al repositorio
el apoyo se establece en cero.

Texas
Un archivo fuente de TeX que define las macros de TeX. Tenga en cuenta que los símbolos reciben nombres diferentes.
ya que el subrayado tiene un significado especial en TeX. Por ejemplo, VCS_SHORT_HASH es
renombrado a \ vcsShortHash.

Xcode
Un encabezado como salida para usar con xcode para completar cadenas de info.plist.

Válido Símbolo nombres
VCS_TYPE
El tipo de repositorio: "git", "hg", "bzr" o "svn".

VCS_NOMBREBASE
El nombre base de la raíz del directorio. Para la mayoría de los VCS, este será simplemente el nombre de base de
el directorio raíz del repositorio. Para Subversion, autorrevisión aunque navegará hacia arriba
Troncal, ramas y directorios de etiquetas para encontrar la raíz real.

VCS_NUM
Un recuento de revisiones entre la actual y la inicial; útil para informar
construir números.

VCS_UUID
Un identificador universalmente único, generado a partir de la confirmación raíz en git y hg; para svn
utiliza el UUID proporcionado.

Para git elegimos la confirmación más antigua si hay más de una.

Actualmente no implementado para bzr.

FECHA_VCS
La fecha de la confirmación más reciente en formato ISO-8601 / RFC3339 verdadero, incluidos los segundos.

VCS_SUCURSAL
El nombre de la rama del gráfico de confirmación que se seleccionó cuando se ejecutó la autoversión.

En git, normalmente será el nombre corto de la rama actual (el asterisco
línea en la salida de "git branch") excepto que cuando la rama no tiene un
shortname será una refspec completa.

Bajo hg la función que se llama sucursales es en realidad una especie de coloración gráfica
(varios cabezales pueden tener el mismo nombre de rama) por lo que este símbolo se rellena con el
marcador actual si existe, con el nombre de la rama actual como respaldo.

En Subversion, esto normalmente será tronco o el nombre de base de alguna rama o
subdirectorio de etiquetas, dependiendo de dónde autoversión fue corrido.

Bajo bzr, este es el nick de la rama en la que se encuentra.

VCS_TAG
El nombre de la etiqueta más reciente ancestral a la confirmación actual.

Vacío bajo Subversion.

VCS_TICK
Un recuento de confirmaciones desde la etiqueta más reciente ancestral hasta la confirmación actual o un alias
of VCS_NUM si no hay etiquetas anteriores.

Vacío bajo Subversion.

VCS_EXTRA
Un símbolo reservado específicamente para ser colocado por el usuario a través del entorno o vía
scripts.

VCS_FULL_HASH
Un identificador único completo para la revisión actual.

VCS_SHORT_HASH
Una versión abreviada de VCS_FULL_HASH, pero VCS_FULL_HASH si no se puede acortar.

VCS_WC_MODIFICADO
Establézcalo en 1 si se ha modificado el directorio de trabajo actual y en 0 si no. Si el
el lenguaje de salida tiene literales booleanos nativos, verdadero significa modificado y falso
sin modificar. La salida de C / C ++ se deja como numérica para que el preprocesador pueda probarla.
Sin seguimiento archivos están No ignorado ver -U para Detalles.

OPCIONES

-t
Establece el tipo de salida. Es obligatorio a menos que -s está especificado; ambos -t y -s no puede ser
utilizado en la misma invocación.

-s
Cambia el comportamiento de los informes; en lugar de emitir un archivo de símbolo a stdout, solo el
se informará el valor de ese símbolo individual. Es obligatorio a menos que -t is
especificado; ambos -t y -s no se puede utilizar en la misma invocación.

-o
Establece el nombre del archivo de caché.

-f
Fuerza el uso de datos de caché incluso en un repositorio; útil para acelerar posteriores
se ejecuta si se necesita más de un formato de salida.

-U
Hace que los archivos sin seguimiento se verifiquen al determinar si la copia de trabajo está modificada
para Subversión only. Si bien este es el comportamiento predeterminado para todos los demás repositorios
tipos, está desactivado de forma predeterminada para Subversion debido a problemas de velocidad.

-V
Emite la versión de revisión automática y sale.

Utilice la revisión automática en línea utilizando los servicios de onworks.net