git-rev-parse: en línea en la nube

PROGRAMA:

NOMBRE

git-rev-parse - Seleccionar y masajear parámetros

SINOPSIS

git rev-analizar [ --opción ] ...

DESCRIPCIÓN

Muchos comandos de porcelainish de Git toman una combinación de banderas (es decir, parámetros que comienzan con un
guión -) y parámetros destinados al subyacente git lista de revoluciones comando que usan internamente
y banderas y parámetros para los otros comandos que utilizan aguas abajo de git lista de revoluciones. Esto
El comando se usa para distinguir entre ellos.

CAMPUS

Operación Modos
Cada una de estas opciones debe aparecer primero en la línea de comando.

--parseopt
Uso git rev-analizar en el modo de análisis de opciones (consulte la sección PARSEOPT a continuación).

--comillas cuadradas
Uso git rev-analizar en el modo de cotización de shell (consulte la sección SQ-QUOTE a continuación). En contraste con
la opción --sq a continuación, este modo solo hace citas. No se hace nada más para mandar
entrada.

Opciones para --parseopt
--keep-dashdash
Solo tiene sentido en el modo --parseopt. Le dice al analizador de opciones que repita el primero:
conocido en lugar de saltearlo.

- detener-en-no-opción
Solo tiene sentido en el modo --parseopt. Permite que el analizador de opciones se detenga en la primera
argumento sin opción. Esto se puede usar para analizar subcomandos que toman opciones


--atascado
Solo tiene sentido en el modo --parseopt. Muestra las opciones en su forma larga si
disponibles, y con sus argumentos estancados.

Opciones para Filtración
--sólo revoluciones
No emitir indicadores y parámetros no destinados a git lista de revoluciones mando.

--no-revoluciones
No emitir indicadores y parámetros destinados a git lista de revoluciones mando.

--banderas
No genere parámetros que no sean de marca.

--no-banderas
No da salida a los parámetros de la bandera.

Opciones para Salida
--defecto
Si no hay ningún parámetro proporcionado por el usuario, utilice en lugar de.

--prefijo
Compórtate como si git rev-analizar fue invocado desde el subdirectorio del trabajo
árbol. Cualquier nombre de archivo relativo se resuelve como si tuviera el prefijo y será
impreso en esa forma.

Esto se puede usar para convertir argumentos a un comando que se ejecuta en un subdirectorio para que
todavía se puede utilizar después de pasar al nivel superior del repositorio. Por ejemplo:

prefijo = $ (git rev-parse --show-prefix)
cd "$ (git rev-parse --show-toplevel)"
eval "set - $ (git rev-parse --sq --prefix" $ prefix "" $ @ ")"

--verificar
Verifique que se proporcione exactamente un parámetro y que se pueda convertir en un
SHA-20 de 1 bytes que se puede utilizar para acceder a la base de datos de objetos. Si es así, emítalo al
salida estándar; de lo contrario, error.

Si desea asegurarse de que la salida realmente nombre un objeto en su objeto
base de datos y / o se puede utilizar como un tipo específico de objeto que necesita, puede agregar el
^ {type} operador de pelado al parámetro. Por ejemplo, git rev-parse "$ VAR ^ {commit}"
se asegurará de que $ VAR nombre un objeto existente que sea un compromiso (es decir, un compromiso, o
una etiqueta anotada que apunta a una confirmación). Para asegurarse de que $ VAR nombre un
objeto de cualquier tipo, se puede utilizar git rev-parse "$ VAR ^ {object}".

-q, - silencioso
Solo tiene sentido en el modo --verify. No muestre un mensaje de error si el primer argumento
no es un nombre de objeto válido; en su lugar, salga silenciosamente con un estado distinto de cero. SHA-1 para
los nombres de objeto válidos se imprimen en stdout en caso de éxito.

--sq
Por lo general, la salida se realiza en una línea por indicador y parámetro. Esta opción hace que la salida
Línea única, debidamente cotizada para consumo por concha. Útil cuando espera su
parámetro para contener espacios en blanco y nuevas líneas (por ejemplo, cuando se usa pico -S con git
diff- *). A diferencia de la opción --sq-quote, la entrada del comando aún se interpreta
como de costumbre.

--no
Cuando muestre los nombres de los objetos, antepóngalos con ^ y desnudarse ^ prefijo de los nombres de los objetos
que ya tengo uno.

--abbrev-ref [= (estricto | suelto)]
Un nombre corto no ambiguo del nombre del objeto. La opción core.warnAmbiguousRefs es
se utiliza para seleccionar el modo de abreviatura estricta.

--corto, --corto = número
En lugar de generar los valores SHA-1 completos de los nombres de objeto, intente abreviarlos a
un nombre único más corto. Cuando no se especifica una longitud, se utiliza 7. La longitud mínima es 4.

--simbólico
Por lo general, los nombres de los objetos se envían en formato SHA-1 (con posibles ^ prefijo); esta
La opción hace que se muestren en una forma lo más cercana posible a la entrada original.

--simbólico-nombre-completo
Esto es similar a --symbolic, pero omite entradas que no son referencias (es decir, rama o
nombres de etiquetas; o más explícitamente eliminar la ambigüedad de la forma "cabezas / maestro", cuando desee
nombrar la rama "maestra" cuando hay una etiqueta denominada desafortunadamente "maestra") y mostrar
ellos como nombres de referencia completos (por ejemplo, "refs / heads / master").

Opciones para Objetos
--todas
Mostrar todas las referencias encontradas en las referencias /.

--ramas [= patrón], --tags [= patrón], --remotes [= patrón]
Mostrar todas las ramas, etiquetas o ramas de seguimiento remoto, respectivamente (es decir, referencias encontradas
en refs / heads, refs / tags o refs / remotes, respectivamente).

Si se proporciona un patrón, solo se muestran las referencias que coinciden con el glob de shell dado. Si el
el patrón no contiene un carácter globular (?, * o [), se convierte en un prefijo
coincidir agregando / *.

--glob = patrón
Muestra todas las referencias que coinciden con el patrón de patrón de globo de caparazón. Si el patrón no comienza
con refs /, esto se antepone automáticamente. Si el patrón no contiene un
carácter globbing (?, * o [), se convierte en una coincidencia de prefijo agregando / *.

--excluir =
No incluir referencias coincidentes que las siguientes --todas, - ramas, - etiquetas,
--remotes, o --glob consideraría de otra manera. Se acumulan repeticiones de esta opción
patrones de exclusión hasta el siguiente --todos, - ramas, - etiquetas, - controles remotos o - global
opción (otras opciones o argumentos no borran los patrones acumulados).

Los patrones dados no deben comenzar con referencias / cabezas, referencias / etiquetas o referencias / controles remotos cuando
aplicados a --branches, --tags, o --remotes, respectivamente, y deben comenzar con
refs / cuando se aplica a --glob o --all. Si un final /* se pretende, se debe dar
explícitamente

--disambiguate =
Muestre todos los objetos cuyo nombre comience con el prefijo dado. El debe estar en
por lo menos 4 dígitos hexadecimales para evitar enumerar todos y cada uno de los objetos en el
repositorio por error.

Opciones para archivos
--local-env-vars
Enumere las variables de entorno GIT_ * que son locales para el repositorio (por ejemplo, GIT_DIR o
GIT_WORK_TREE, pero no GIT_EDITOR). Solo se enumeran los nombres de las variables, no
su valor, incluso si están establecidos.

--git-dir
Muestra $ GIT_DIR si está definido. De lo contrario, muestre la ruta al directorio .git. El camino
mostrado, cuando es relativo, es relativo al directorio de trabajo actual.

Si $ GIT_DIR no está definido y no se detecta que el directorio actual se encuentre en un Git
repositorio o árbol de trabajo imprime un mensaje en stderr y sale con un estado distinto de cero.

--git-común-dir
Muestre $ GIT_COMMON_DIR si está definido, de lo contrario $ GIT_DIR.

--está-dentro-git-dir
Cuando el directorio de trabajo actual está debajo del directorio del repositorio, imprima "verdadero",
de lo contrario "falso".

--es-inside-work-tree
Cuando el directorio de trabajo actual está dentro del árbol de trabajo del repositorio imprimir
"verdadero", de lo contrario "falso".

--es-bare-repository
Cuando el repositorio está vacío, escriba "verdadero", de lo contrario "falso".

--resolve-git-dir
Comprobar si es un repositorio válido o un archivo git que apunta a un repositorio válido,
e imprima la ubicación del repositorio. Si es un archivo git, entonces el resuelto
Se imprime la ruta al repositorio real.

--git-path
Resolver "$ GIT_DIR / "y toma otras variables de reubicación de ruta, como
$ GIT_OBJECT_DIRECTORY, $ GIT_INDEX_FILE ... en la cuenta. Por ejemplo, si
$ GIT_OBJECT_DIRECTORY se establece en / foo / bar y luego "git rev-parse --git-path objects / abc"
devuelve / foo / bar / abc.

--mostrar-cdup
Cuando se invoca el comando desde un subdirectorio, muestra la ruta del nivel superior
directorio relativo al directorio actual (normalmente una secuencia de "../", o un
cuerda vacía).

--show-prefijo
Cuando se invoca el comando desde un subdirectorio, muestre la ruta del actual
directorio relativo al directorio de nivel superior.

- show-toplevel
Muestra la ruta absoluta del directorio de nivel superior.

--ruta-índice-compartido
Muestra la ruta al archivo de índice compartido en modo de índice dividido, o vacía si no está en
modo de índice dividido.

Otro Opciones
--since = cadena de fechas, --after = cadena de fechas
Analizar la cadena de fecha y generar el parámetro correspondiente --max-age = para git
lista de revoluciones.

--until = cadena de fechas, --before = cadena de fechas
Analizar la cadena de fecha y generar el parámetro correspondiente --min-age = para git
lista de revoluciones.

...
Banderas y parámetros a analizar.

ESPECIFICANDO REVISIONES

Un parámetro de revisión normalmente, pero no necesariamente, nombra un objeto de confirmación. Usa
lo que se llama un extendido SHA-1 sintaxis. A continuación, se muestran varias formas de deletrear los nombres de los objetos. El
los que aparecen cerca del final de esta lista nombran árboles y blobs contenidos en una confirmación.

, p.ej dae86e1950b1277e545cee180551750029cfe735, dae86e
El nombre completo del objeto SHA-1 (cadena hexadecimal de 40 bytes) o una subcadena inicial que
es único dentro del repositorio. Por ejemplo, dae86e1950b1277e545cee180551750029cfe735 y
dae86e nombran el mismo objeto de confirmación si no hay otro objeto en su repositorio
cuyo nombre de objeto comienza con dae86e.

, p.ej v1.7.4.2-679-g3bee7fb
Salida de git describe; es decir, una etiqueta más cercana, opcionalmente seguida de un guión y un
número de confirmaciones, seguido de un guión, un gy un nombre de objeto abreviado.

, p.ej dominar, jefes / maestro, refs / jefes / maestro
Un nombre de referencia simbólico. P.ej dominar normalmente significa el objeto de confirmación al que hace referencia
refs / jefes / maestro. Si tienes ambos jefes / maestro y etiquetas / maestro, puede
decir explícitamente jefes / maestro para decirle a Git a cuál te refieres. Cuando es ambiguo, un
se desambigua tomando el primer partido en las siguientes reglas:

1. Si $ GIT_DIR / existe, eso es lo que quieres decir (esto suele ser útil sólo
para CABEZA, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD y CHERRY_PICK_HEAD);

2. de lo contrario, refs / si existiera;

3. de lo contrario, refs / tags / si existiera;

4. de lo contrario, refs / jefes / si existiera;

5. de lo contrario, refs / remotos / si existiera;

6. de lo contrario, refs / remotos / /CABEZA si existiera.

CABEZA nombra la confirmación en la que basó los cambios en el árbol de trabajo.
FETCH_HEAD registra la rama que obtuvo de un repositorio remoto con su
última invocación de recuperación de git. ORIG_HEAD es creado por comandos que mueven tu CABEZA
de manera drástica, para registrar la posición del CABEZA antes de su operación, entonces
que puede cambiar fácilmente la punta de la rama al estado antes de ejecutar
de ellas. MERGE_HEAD registra las confirmaciones que está fusionando en su rama
cuando ejecuta git merge. CHERRY_PICK_HEAD registra el compromiso que eres
cherry-picking cuando ejecuta git cherry-picking.

Tenga en cuenta que cualquiera de los refs / * Los casos anteriores pueden provenir de la $ GIT_DIR / refs
directorio o desde el $ GIT_DIR / referencias-empaquetadas Archivo. Mientras que la codificación del nombre de referencia es
sin especificar, se prefiere UTF-8 ya que algunos procesos de salida pueden asumir nombres de referencia en
UTF-8.

@
@ solo es un atajo para CABEZA.

@ { }, p.ej maestro @ {ayer}, CABEZA @ {5 minutos atrás}
Una referencia seguida del sufijo @ con una especificación de fecha incluida en un par de llaves
(p.ej {ayer}, {1 mes 2 semanas. 3 días 1 horas. 1 segundo atrás} or {1979-02-26
18:30:00}) especifica el valor de la referencia en un momento anterior. Este sufijo puede
solo debe usarse inmediatamente después de un nombre de referencia y la referencia debe tener un registro existente
($ GIT_DIR / logs /). Tenga en cuenta que esto busca el estado de su local ref en un dado
hora; p. ej., lo que estaba en tu local dominar rama la semana pasada. Si quieres mirar
confirmaciones realizadas durante ciertos momentos, consulte --ya que y --Hasta que.

@ { }, p.ej maestro @ {1}
Una referencia seguida del sufijo @ con una especificación ordinal incluida en un par de llaves
(p.ej 1 {}, 15 {}) especifica el n-ésimo valor anterior de esa ref. Por ejemplo maestro @ {1}
es el valor previo inmediato de dominar mientras maestro @ {5} es el quinto valor anterior de
dominar. Este sufijo solo se puede utilizar inmediatamente después de un nombre de referencia y la referencia debe
tener un registro existente$ GIT_DIR / logs /).

@ { }, p.ej @ {1}
Puede utilizar el @ construir con una parte de referencia vacía para obtener una entrada de reflog del
rama actual. Por ejemplo, si está en una sucursal blabla luego @ {1} significa lo mismo que
blabla @ {1}.

@ {- }, p.ej @ {- 1}
El constructo @ {- } significa el th branch / commit verificado antes de la actual
uno.

@{río arriba}, p.ej master @ {upstream}, @ {u}
El sufijo @{río arriba} a un nombre de rama (forma corta @ {u}) se refiere a
rama que la rama especificada por branchname está configurada para construir encima de (configurada
con rama. .remote y rama. .unir). Un nombre de rama faltante tiene como valor predeterminado
el actual.

@{empujar}, p.ej master @ {push}, @{empujar}
El sufijo @{empujar} informa que la rama "hacia donde empujaríamos" si se ejecutara git push
mientras se verificó el nombre de la rama (o el actual CABEZA si no se especifica un nombre de rama).
Dado que nuestro destino de inserción está en un repositorio remoto, por supuesto, informamos el local
seguimiento de la rama que corresponde a esa rama (es decir, algo en refs / remotos /).

Aquí tienes un ejemplo para que quede más claro:

$ git config push.default actual
$ git config remoto.pushdefault myfork
$ git checkout -b mybranch origin / master

$ git rev-parse --symbolic-full-name @ {upstream}
refs / remotos / origen / maestro

$ git rev-parse --symbolic-full-name @ {push}
refs / remotes / myfork / mybranch

Tenga en cuenta en el ejemplo que configuramos un flujo de trabajo triangular, donde extraemos de uno
ubicación y empujar a otra. En un flujo de trabajo no triangular, @{empujar} es el mismo que
@{río arriba}, y no es necesario.

^, p.ej CABEZA ^, v1.5.1 ^ 0
Un sufijo ^ a un parámetro de revisión significa el primer padre de ese objeto de confirmación. ^
significa el el padre (es decir ^ es equivalente a ^ 1). Como regla especial,
^ 0 significa el compromiso en sí mismo y se usa cuando es el nombre de objeto de una etiqueta
objeto que se refiere a un objeto de confirmación.

~, p.ej maestro ~ 3
Un sufijo ~ a un parámetro de revisión significa el objeto de confirmación que es el th
ancestro de generación del objeto de confirmación nombrado, siguiendo solo a los primeros padres. Es decir
~ 3 es equivalente a ^^^ que es equivalente a ^ 1 ^ 1 ^ 1. Vea a continuación una
Ilustración del uso de este formulario.

^ { }, p.ej v0.99.8 ^ {confirmar}
Un sufijo ^ seguido de un nombre de tipo de objeto entre llaves significa desreferencia
el objeto en recursivamente hasta que un objeto de tipo se encuentra o el objeto
ya no se puede desreferenciar (en cuyo caso, barf). Por ejemplo, si es un
comprometerse, ^ {confirmar} describe el objeto de confirmación correspondiente. Del mismo modo, si
es un árbol, ^ {árbol} describe el objeto de árbol correspondiente. ^ 0 is
una abreviatura para ^ {confirmar}.

rev ^ {objeto} se puede utilizar para asegurarse acelerar nombra un objeto que existe, sin
Requiriendo acelerar para ser una etiqueta, y sin desreferenciar acelerar; porque una etiqueta ya es una
objeto, no es necesario eliminar la referencia ni una sola vez para llegar a un objeto.

rev ^ {etiqueta} se puede utilizar para asegurar que acelerar identifica un objeto de etiqueta existente.

^ {}, p.ej v0.99.8 ^ {}
Un sufijo ^ seguido de un par de llaves vacío significa que el objeto podría ser una etiqueta, y
desreferenciar la etiqueta de forma recursiva hasta que se encuentre un objeto que no sea de etiqueta.

^ {/ }, p.ej HEAD ^ {/ arreglar feo bicho}
Un sufijo ^ a un parámetro de revisión, seguido de un par de llaves que contiene un texto led
por una barra, es lo mismo que el :/arreglar feo error sintaxis a continuación, excepto que devuelve el
La confirmación coincidente más joven que se puede alcanzar desde el antes ^.

: /, p.ej :/arreglar feo error
Dos puntos, seguidos de una barra inclinada, seguidos de un texto, nombran una confirmación cuyo mensaje de confirmación
coincide con la expresión regular especificada. Este nombre devuelve la coincidencia más joven
commit que es accesible desde cualquier ref. Si el mensaje de confirmación comienza con un ! Usted
tengo que repetir eso; la secuencia especial : /!, seguido de algo más que !, es
reservado por ahora. La expresión regular puede coincidir con cualquier parte del mensaje de confirmación. A
hacer coincidir los mensajes que comienzan con una cadena, se puede usar, por ejemplo, : / ^ foo.

:, p.ej HEAD: README, : README, master: ./ README
Un sufijo : seguido de una ruta nombra el blob o árbol en la ruta dada en el árbol-ish
objeto nombrado por la parte antes de los dos puntos. :camino (con una parte vacía antes del
dos puntos) es un caso especial de la sintaxis que se describe a continuación: contenido registrado en el índice
en el camino dado. Un camino que comienza con ./ or .. / es relativo al trabajo actual
directorio. La ruta dada se convertirá para que sea relativa a la raíz del árbol de trabajo
directorio. Esto es más útil para abordar un blob o árbol de una confirmación o árbol que
tiene la misma estructura de árbol que el árbol de trabajo.

: :, p.ej : 0: README, : README
Dos puntos, opcionalmente seguidos de un número de etapa (0 a 3) y dos puntos, seguidos de un
ruta, nombra un objeto blob en el índice en la ruta dada. Falta un número de etapa (y
los dos puntos que le siguen) nombran una entrada de etapa 0. Durante una fusión, la etapa 1 es la
antepasado común, la etapa 2 es la versión de la rama de destino (normalmente la actual
branch), y la etapa 3 es la versión de la rama que se está fusionando.

Aquí hay una ilustración, de Jon Loeliger. Ambos nodos de confirmación B y C son padres de confirmación
nodo A. Las confirmaciones principales se ordenan de izquierda a derecha.

GHIJ
\ / \ /
DEF
\ | /\
\ | / |
\ | / |
antes de Cristo
\ /
\ /
A

A = = A ^ 0
B = A ^ = A ^ 1 = A ~ 1
C = A ^ 2 = A ^ 2
D = A ^^ = A ^ 1 ^ 1 = A ~ 2
E = B ^ 2 = A ^^ 2
F = B ^ 3 = A ^^ 3
G = A ^^^ = A ^ 1 ^ 1 ^ 1 = A ~ 3
H = D ^ 2 = B ^^ 2 = A ^^^ 2 = A ~ 2 ^ 2
Yo = F ^ = B ^ 3 ^ = A ^^ 3 ^
J = F ^ 2 = B ^ 3 ^ 2 = A ^^ 3 ^ 2

ESPECIFICANDO RANGOS

Los comandos que recorren el historial, como git log, operan en un conjunto de confirmaciones, no solo en una
cometer. Para estos comandos, especificando una única revisión con la notación descrita en el
sección anterior significa el conjunto de confirmaciones alcanzables desde esa confirmación, después de la confirmación
cadena de ascendencia.

Para excluir confirmaciones alcanzables de una confirmación, un prefijo ^ se utiliza notación. P.ej ^ r1 r2 significa
confirma accesible desde r2 pero excluye los accesibles desde r1.

Esta operación de conjunto aparece tan a menudo que hay una abreviatura para ella. Cuando tienes dos
confirma r1 y r2 (nombrado de acuerdo con la sintaxis explicada en ESPECIFICACIÓN DE REVISIONES arriba),
puede solicitar confirmaciones a las que se puede acceder desde r2 excluyendo aquellas a las que se puede acceder desde
r1 por ^ r1 r2 y se puede escribir como r1..r2.

Una notación similar r1 ... r2 se llama diferencia simétrica de r1 y r2 y se define como
r1 r2 --no $ (git base de fusión --todas r1 r2). Es el conjunto de confirmaciones que son alcanzables
de cualquiera de r1 or r2 pero no de ambos.

En estos dos métodos abreviados, puede omitir un extremo y dejar que sea el predeterminado HEAD. Por ejemplo,
origen.. es una abreviatura de origen .. CABEZA y pregunta "¿Qué hice desde que me bifurqué del
rama de origen? "Del mismo modo, ..origen es una abreviatura de HEAD..origen y pregunta "¿Qué hizo el
origen desde que me bifurqué de ellos? "Tenga en cuenta que .. Significaría CABEZA A CABEZA que es un vacio
rango que es tanto accesible como inalcanzable desde HEAD.

Otros dos métodos abreviados para nombrar un conjunto formado por una confirmación y su confirmación principal
existe. los r1 ^ @ notación significa todos los padres de r1. r1 ^! incluye compromiso r1 pero excluye a todos
de sus padres.

En resumen:


Incluir confirmaciones que son accesibles desde (es decir, antepasados ​​de) .

^
Excluir confirmaciones a las que se puede acceder desde (es decir, antepasados ​​de) .

..
Incluir confirmaciones accesibles desde pero excluye aquellos que son accesibles
desde . Cuando cualquiera o se omite, por defecto es CABEZA.

...
Incluya confirmaciones a las que se pueda acceder desde o pero excluye a los que
son accesibles desde ambos. Cuando cualquiera o se omite, por defecto es CABEZA.

^ @, p.ej CABEZA ^ @
Un sufijo ^ seguido de un signo arroba es lo mismo que enumerar a todos los padres de
(es decir, incluya cualquier cosa accesible desde sus padres, pero no el compromiso en sí).

^!, p.ej HEAD ^!
Un sufijo ^ seguido de un signo de exclamación es lo mismo que dar confirmación y luego
todos sus padres prefijados con ^ para excluirlos (y sus antepasados).

A continuación, se muestran algunos ejemplos:

DGHD
DFGHIJDF
^ GDHD
^ DBEIJFB
B..CC
B ... CGHDEBC
^ DBCEIJFBC
CIJFC
C ^ @ IJF
C ^! C
¡F ^! DGHDF

PARSEOPTO

En modo --parseopt, git rev-analizar ayuda a las opciones de masaje para llevar a los scripts de shell el
las mismas instalaciones que tienen los empotrados C. Funciona como un normalizador de opciones (por ejemplo, divide una sola
cambia valores agregados), un poco como conseguiroptar(1) lo hace.

Toma en la entrada estándar la especificación de las opciones para analizar y comprender,
y hace eco en la salida estándar una cadena adecuada para sh(1) eval para reemplazar el
argumentos con los normalizados. En caso de error, genera el uso en el error estándar
stream y sale con el código 129.

Nota: asegúrese de citar el resultado al pasarlo a eval. Vea a continuación un ejemplo.

Entrada Formato
git rev-analizar --parseopt El formato de entrada está completamente basado en texto. Tiene dos partes, separadas por
una línea que contiene solo -. Las líneas antes del separador (deben ser una o más) son
utilizado para el uso. Las líneas después del separador describen las opciones.

Cada línea de opciones tiene este formato:

* ? SP + ayuda LF


su formato es el carácter de opción corto, luego el nombre de opción largo separado por un
coma. No se requieren ambas partes, aunque es necesaria al menos una. No puede contener
cualquiera de los caracteres. h, help, dry-run yf son ejemplos de
.


son de *, =,? o !.

· Use = si la opción tiene un argumento.

· Usar ? para significar que la opción toma un argumento opcional. Probablemente quieras
use el modo --stuck-long para poder analizar sin ambigüedades el argumento opcional.

· Utilice * para indicar que esta opción no debe figurar en el uso generado para el
-h argumento. Se muestra para --help-all como se documenta en gitcli(7).

· Usar ! para no hacer disponible la correspondiente opción larga negada.


, si se especifica, se utiliza como nombre del argumento en la salida de ayuda, para
opciones que toman argumentos. termina con el primer espacio en blanco. Está
acostumbrado a usar un guión para separar palabras en una sugerencia de argumento de varias palabras.

El resto de la línea, después de eliminar los espacios, se utiliza como ayuda asociada a
la opción.

Las líneas en blanco se ignoran y las líneas que no coinciden con esta especificación se utilizan como opción
encabezados de grupo (comience la línea con un espacio para crear tales líneas a propósito).

Ejemplo
OPTS_SPEC = "\
algún-comando [opciones] ...

¡Algún comando hace foo y bar!
--
h, ayuda a mostrar la ayuda

foo alguna opción ingeniosa --foo
bar = alguna opción interesante --bar con un argumento
baz = arg otra opción genial --baz con un argumento con nombre
qux? path qux puede tomar un argumento de ruta pero tiene significado por sí mismo

Un encabezado de grupo de opciones
¿C? opción C con un argumento opcional "

eval "$ (echo" $ OPTS_SPEC "| git rev-parse --parseopt -" $ @ "|| echo salir $?)"

Uso texto
Cuando "$ @" es -ho --help en el ejemplo anterior, se mostrará el siguiente texto de uso:

uso: algún-comando [opciones] ...

¡Algún comando hace foo y bar!

-h, --help muestra la ayuda
- foo alguna opción ingeniosa --foo
--bar ... alguna opción genial --bar con un argumento
--baz otra opción genial --baz con un argumento con nombre
--qux [= ] qux puede tomar un argumento de ruta pero tiene significado por sí mismo

Un encabezado de grupo de opciones
-C [...] opción C con un argumento opcional

COTIZACIÓN SQ

En el modo --sq-quote, git rev-analizar hace eco en la salida estándar una sola línea adecuada para
sh(1) eval. Esta línea se hace normalizando los argumentos que siguen a --sq-quote. Nada
aparte de citar los argumentos se hace.

Si desea que la entrada de comando aún se interprete como de costumbre por git rev-analizar antes de
la salida está entre comillas, consulte la opción --sq.

Ejemplo
$ gato> su-git-script.sh << \ EOF
#!/ Bin / sh
args = $ (git rev-parse --sq-quote "$ @") # citar argumentos proporcionados por el usuario
command = "git frotz -n24 $ args" # y úselo dentro de un
# línea de comando
eval "$ comando"
EOF

$ sh your-git-script.sh "a b'c"

EJEMPLOS

· Imprime el nombre del objeto de la confirmación actual:

$ git rev-parse --verificar CABEZA

· Imprime el nombre del objeto de confirmación de la revisión en la variable de shell $ REV:

$ git rev-parse --verify $ REV ^ {commit}

Esto generará un error si $ REV está vacío o no es una revisión válida.

· Similar al anterior:

$ git rev-parse - maestro predeterminado - verificar $ REV

pero si $ REV está vacío, se imprimirá el nombre del objeto de confirmación del maestro.

GIT

Parte de los git(1) suite

Use git-rev-parse en línea usando los servicios de onworks.net