git-add: en línea en la nube

PROGRAMA:

NOMBRE

git-add: agrega el contenido del archivo al índice

SINOPSIS

git add [--verbose | -v] [--secar-ejecutar | -n] [--force | -f] [--interactivo | -i] [--parche | -pag]
[--editar | -e] [- [no-] todos | - [no-] ignorar-eliminar | [--update | -u]]
[--intento-de-agregar | -N] [--actualizar] [--ignorar errores] [--ignorar faltantes]
[-] [ ...]

DESCRIPCIÓN

Este comando actualiza el índice utilizando el contenido actual que se encuentra en el árbol de trabajo, para
preparar el contenido preparado para la próxima confirmación. Por lo general, agrega el contenido actual de
rutas existentes en su conjunto, pero con algunas opciones también se puede utilizar para agregar contenido con
sólo una parte de los cambios realizados en los archivos del árbol de trabajo aplicados, o eliminar las rutas que no
ya no existen en el árbol de trabajo.

El "índice" contiene una instantánea del contenido del árbol de trabajo, y es esta instantánea
que se toma como contenido de la siguiente confirmación. Por lo tanto, después de realizar cambios en el
árbol de trabajo, y antes de ejecutar el comando de confirmación, debe usar el comando agregar para agregar
cualquier archivo nuevo o modificado en el índice.

Este comando se puede ejecutar varias veces antes de una confirmación. Solo agrega el contenido de
los archivos especificados en el momento en que se ejecuta el comando add; si quieres cambios posteriores
incluido en la siguiente confirmación, debe ejecutar git add nuevamente para agregar el nuevo contenido al
índice.

El comando git status se puede usar para obtener un resumen de qué archivos tienen cambios que
se preparan para la próxima confirmación.

El comando git add no agregará archivos ignorados por defecto. Si alguno de los archivos ignorados
especificado explícitamente en la línea de comando, git add fallará con una lista de archivos ignorados.
Los archivos ignorados alcanzados por la recursividad de directorio o el globbing de nombre de archivo realizado por Git (cita
sus globos antes del caparazón) se ignorarán en silencio. los git add El comando se puede utilizar para
agregue archivos ignorados con la opción -f (forzar).

Por favor mira compromiso de git(1) para conocer formas alternativas de agregar contenido a una confirmación.

CAMPUS

...
Archivos para agregar contenido. Se pueden proporcionar fileglobs (por ejemplo, * .c) para agregar todas las coincidencias
archivos. También se puede utilizar un nombre de directorio principal (por ejemplo, dir para agregar dir / archivo1 y dir / archivo2).
dado para actualizar el índice para que coincida con el estado actual del directorio como un todo (p. ej.
especificar dir registrará no solo un archivo dir / file1 modificado en el árbol de trabajo, un
archivo dir / archivo2 agregado al árbol de trabajo, pero también un archivo dir / archivo3 eliminado del
árbol de trabajo. Tenga en cuenta que las versiones anteriores de Git solían ignorar los archivos eliminados; usar
--no-all opción si desea agregar archivos nuevos o modificados, pero ignora los eliminados.

-n, --secar
En realidad, no agregue los archivos, solo muestre si existen y / o se ignorarán.

-v, --detallado
Sea prolijo.

-f, --fuerza
Permitir agregar archivos que de otro modo se ignorarían.

-i, --interactivo
Agregue contenidos modificados en el árbol de trabajo de forma interactiva al índice. Ruta opcional
Se pueden proporcionar argumentos para limitar la operación a un subconjunto del árbol de trabajo. Ver
"Modo interactivo" para obtener más detalles.

-p, --parche
Elija de forma interactiva trozos de parche entre el índice y el árbol de trabajo y agréguelos
al índice. Esto le da al usuario la oportunidad de revisar la diferencia antes de agregar
contenido modificado al índice.

Esto efectivamente ejecuta add --interactive, pero omite el menú de comandos inicial y
salta directamente al subcomando patch. Consulte "Modo interactivo" para obtener más detalles.

-e, --edit
Abra la diferencia frente al índice en un editor y deje que el usuario lo edite. Después del editor
se cerró, ajuste los encabezados del trozo y aplique el parche al índice.

La intención de esta opción es seleccionar y elegir las líneas del parche para aplicar, o incluso
para modificar el contenido de las líneas a escenificar. Esto puede ser más rápido y flexible.
que usar el selector interactivo de trozos. Sin embargo, es fácil confundirse a uno mismo y
cree un parche que no se aplique al índice. Consulte EDICIÓN DE PARCHES a continuación.

-u, --actualizar
Actualice el índice justo donde ya tiene una entrada que coincida . Esto quita
así como modifica las entradas del índice para que coincidan con el árbol de trabajo, pero no agrega archivos nuevos.

Si no se da cuando se usa la opción -u, todos los archivos rastreados en todo el
Se actualizan el árbol de trabajo (las versiones anteriores de Git se utilizan para limitar la actualización a la actual
directorio y sus subdirectorios).

-A, --todos, --no-ignorar-eliminación
Actualice el índice no solo donde el árbol de trabajo tiene un archivo coincidente pero
también donde el índice ya tiene una entrada. Esto agrega, modifica y elimina el índice
entradas para que coincidan con el árbol de trabajo.

Si no se da cuando se usa la opción -A, todos los archivos en todo el árbol de trabajo
se actualizan (las versiones anteriores de Git se utilizan para limitar la actualización al directorio actual y
sus subdirectorios).

--no-todo, --ignore-eliminación
Actualice el índice agregando nuevos archivos que son desconocidos para el índice y archivos modificados
en el árbol de trabajo, pero ignore los archivos que se han eliminado del árbol de trabajo.
Esta opción no es operativa cuando no se utiliza.

Esta opción es principalmente para ayudar a los usuarios que están acostumbrados a versiones anteriores de Git, cuyas
"git add ... "era un sinónimo de" git add --no-all ...", es decir
archivos eliminados ignorados.

-N, --intento-de-agregar
Registre solo el hecho de que la ruta se agregará más tarde. Una entrada para el camino es
colocado en el índice sin contenido. Esto es útil, entre otras cosas, para mostrar
el contenido no preparado de dichos archivos con git diff y su confirmación con git commit
-a.

--actualizar
No agregue los archivos, solo actualice su información stat () en el índice.

--ignorar-errores
Si algunos archivos no se pudieron agregar debido a errores al indexarlos, no cancele la
operación, pero continúe agregando los demás. El comando seguirá saliendo con un valor distinto de cero
estado. La variable de configuración add.ignoreErrors se puede establecer en true para hacer esto
el comportamiento predeterminado.

--ignorar-faltante
Esta opción solo se puede usar junto con --dry-run. Al usar esta opción, el usuario
puede comprobar si alguno de los archivos dados sería ignorado, sin importar si ya están
presente en el árbol de trabajo o no.

--
Esta opción se puede utilizar para separar las opciones de la línea de comandos de la lista de archivos,
(útil cuando los nombres de archivo pueden confundirse con las opciones de la línea de comandos).

CONFIGURACIÓN

La variable de configuración opcional core.excludesFile indica una ruta a un archivo
que contiene patrones de nombres de archivos para excluir de git-add, similar a
$ GIT_DIR / info / exclude. Los patrones del archivo de exclusión se utilizan además de los de
info / excluir. Ver ignorar(5).

EJEMPLOS

· Agrega contenido de todos los archivos * .txt en el directorio de documentación y su
subdirectorios:

$ git agregar documentación / \ *. txt

Tenga en cuenta que el asterisco * se cita del shell en este ejemplo; esto permite que el
El comando incluye los archivos de los subdirectorios del directorio Documentation /.

· Considera agregar contenido de todos los scripts de git - *. Sh:

$ git agregar git - *. sh

Debido a que este ejemplo permite que el shell expanda el asterisco (es decir, está enumerando el
archivos explícitamente), no considera subdir / git-foo.sh.

INTERACTIVO MODO

Cuando el comando ingresa al modo interactivo, muestra la salida del estado
subcomando, y luego entra en su ciclo de comando interactivo.

El bucle de comando muestra la lista de subcomandos disponibles y da un mensaje "¿Qué ahora>?".
En general, cuando el mensaje termina con un solo >, puede elegir solo una de las opciones
dado y escriba return, así:

*** Comandos ***
1: estado 2: actualización 3: revertir 4: agregar sin seguimiento
5: parche 6: diff 7: quit 8: ayuda
¿Y ahora qué> 1

También puede decir s o sta o status arriba siempre que la elección sea única.

El ciclo de comando principal tiene 6 subcomandos (más ayuda y salir).

estado
Esto muestra el cambio entre HEAD e index (es decir, lo que se comprometerá si dice
git commit), y entre el índice y los archivos de árbol de trabajo (es decir, lo que podría
más adelante antes de git commit usando git add) para cada ruta. Una salida de muestra se parece a
modo:

camino sin etapas escenificado
1: nada binario foo.png
2: + 403 / -35 + 1 / -1 git-add - interactive.perl

Muestra que foo.png tiene diferencias con HEAD (pero eso es binario, por lo que el recuento de líneas
no se puede mostrar) y no hay diferencia entre la copia indexada y el árbol de trabajo
versión (si la versión del árbol de trabajo también fuera diferente, binario habría sido mostrado
en lugar de nada). El otro archivo, git-add - interactive.perl, tiene 403 líneas agregadas
y 35 líneas eliminadas si confirma lo que está en el índice, pero el archivo de árbol de trabajo tiene
modificaciones adicionales (una adición y una supresión).

actualización
Esto muestra la información de estado y emite un mensaje "Actualizar >>". Cuando el aviso
termina con doble >>, puede hacer más de una selección, concatenada con
espacio en blanco o coma. También puedes decir rangos. Por ejemplo, "2-5 7,9" para elegir 2,3,4,5,7,9
de la lista. Si se omite el segundo número de un rango, todos los parches restantes se
tomado. Por ejemplo, "7-" para elegir 7,8,9 de la lista. Puedes decir * para elegir todo.

Lo que eligió se resaltará con *, Así:

camino sin etapas escenificado
1: nada binario foo.png
* 2: + 403 / -35 + 1 / -1 git-add - interactive.perl

Para eliminar la selección, anteponga la entrada con - así:

Actualizar >> -2

Después de hacer la selección, responda con una línea vacía para organizar el contenido del trabajo.
archivos de árbol para las rutas seleccionadas en el índice.

revertir
Tiene una interfaz de usuario muy similar a actualización, y la información por etapas para las rutas seleccionadas
se revierten a los de la versión HEAD. Revertir nuevos caminos los deja sin seguimiento.

agregar sin seguimiento
Tiene una interfaz de usuario muy similar a actualización y revertiry le permite agregar rutas sin seguimiento a
El índice.

parche
Esto le permite elegir un camino de un estado como selección. Después de elegir el camino,
presenta la diferencia entre el índice y el archivo de árbol de trabajo y le pregunta si
quiero escenificar el cambio de cada trozo. Puede seleccionar una de las siguientes opciones y
tipo retorno:

y - escenifica este trozo
n - no pongas en escena a este trozo
q - salir; no pongas en escena a este trozo ni a ninguno de los restantes
a - escenifica este trozo y todos los trozos posteriores en el archivo
d - no prepares a este trozo ni a ninguno de los últimos en el archivo
g - selecciona un trozo al que ir
/ - busca un trozo que coincida con la expresión regular dada
j - deja a este trozo indeciso, mira el siguiente trozo indeciso
J - deja a este trozo indeciso, mira el siguiente trozo
k - dejar a este trozo indeciso, ver trozo indeciso anterior
K - deja a este trozo indeciso, mira el trozo anterior
s - divide el trozo actual en trozos más pequeños
e - editar manualmente el trozo actual
? - ayuda de impresión

Después de decidir el destino de todos los macizos, si hay alguno elegido, el índice
se actualiza con los trozos seleccionados.

Puede omitir tener que escribir return aquí, estableciendo la variable de configuración
interactive.singleKey a verdadero.

diff
Esto le permite revisar lo que se comprometerá (es decir, entre HEAD e index).

EDICIÓN PARCHES

Invocar git add -e o seleccionar e en el selector interactivo de hunk abrirá un parche en
su editor; una vez que sale el editor, el resultado se aplica al índice. Eres libre de
realizar cambios arbitrarios en el parche, pero tenga en cuenta que algunos cambios pueden resultar confusos
resultados, o incluso dar como resultado un parche que no se puede aplicar. Si quieres abortar el
operación por completo (es decir, no presentar nada nuevo en el índice), simplemente elimine todas las líneas del
parche. La lista a continuación describe algunas cosas comunes que puede ver en un parche y qué
las operaciones de edición tienen sentido en ellos.

el contenido agregado
El contenido agregado está representado por líneas que comienzan con "+". Puede evitar la puesta en escena
líneas de adición eliminándolas.

contenido eliminado
El contenido eliminado está representado por líneas que comienzan con "-". Puedes prevenir la puesta en escena
su eliminación convirtiendo el "-" en un "" (espacio).

contenido modificado
El contenido modificado está representado por líneas "-" (eliminando el contenido antiguo) seguidas de
líneas "+" (agregando el contenido de reemplazo). Puede evitar la puesta en escena de la modificación
convirtiendo las líneas "-" en "" y eliminando las líneas "+". Tenga en cuenta que modificando solo
Es probable que la mitad del par introduzca cambios confusos en el índice.

También hay operaciones más complejas que se pueden realizar. Pero ten cuidado porque el
el parche se aplica solo al índice y no al árbol de trabajo, aparecerá el árbol de trabajo
para "deshacer" el cambio en el índice. Por ejemplo, al introducir una nueva línea en el índice que
no está en HEAD ni en el árbol de trabajo preparará la nueva línea para el compromiso, pero el
La línea aparecerá revertida en el árbol de trabajo.

Evite el uso de estas construcciones o hágalo con extrema precaución.

eliminar contenido intacto
El contenido que no difiere entre el índice y el árbol de trabajo se puede mostrar en
líneas de contexto, comenzando con un "" (espacio). Puede organizar líneas de contexto para su eliminación
convirtiendo el espacio en un "-". El archivo de árbol de trabajo resultante parecerá
Vuelva a agregar el contenido.

modificar contenido existente
También se pueden modificar las líneas de contexto preparándolas para su eliminación (convirtiendo "" a
"-") y agregando una línea "+" con el nuevo contenido. Del mismo modo, se pueden modificar las líneas "+"
para adiciones o modificaciones existentes. En todos los casos, la nueva modificación
aparecen revertidos en el árbol de trabajo.

nuevo contenido
También puede agregar contenido nuevo que no existe en el parche; simplemente agregue nuevas líneas,
cada uno comenzando con "+". La adición aparecerá revertida en el árbol de trabajo.

También hay varias operaciones que deben evitarse por completo, ya que harán que el
parche imposible de aplicar:

· Agregar líneas de contexto ("") o eliminar ("-")

· Eliminar líneas de contexto o eliminación

· Modificar el contenido de las líneas de contexto o eliminación

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