aerm - Online en la nube

PROGRAMA:

NOMBRE

aegis eliminar archivo: agregue los archivos que se eliminarán a un cambio

SINOPSIS

égida -Remover archivo nombre del archivo... [ opción...]
égida -Remover archivo -Lista [ opción...]
égida -Remover archivo -Ayudar

DESCRIPCIÓN

El égida -Remover archivo El comando se usa para agregar archivos que se eliminarán a un cambio. El archivo
se agregará a la lista de archivos en el cambio y se eliminará de la línea de base
en el momento de la integración.

Este comando puede usarse para eliminar pruebas, no solo archivos fuente. Las pruebas se tratan solo
como cualquier otro archivo fuente, y están sujetos al mismo proceso.

Se creará un archivo en el directorio de desarrollo que contiene 1 KB de texto aleatorio. los
El texto aleatorio es lo suficientemente repugnante que la mayoría de los compiladores darán mensajes de error,
en caso de que se haga referencia al archivo accidentalmente. Esto suele ser muy útil al eliminar
incluir archivos.

Puede especificar un nombre de directorio para eliminar todos los archivos del árbol de directorios nombrado. Está
un error si no hay archivos relevantes.

Archive Nombre Interpretación
El programa aegis intentará determinar los nombres de los archivos del proyecto a partir de los nombres de los archivos.
dado en la línea de comando. Todos los nombres de archivo se almacenan dentro de los proyectos de aegis como relativos
a la raíz del árbol de directorios de la línea base. El directorio de desarrollo y el
directorio de integración son sombras de este directorio de línea base, por lo que estos nombres relativos
aplicar aquí también. Los archivos nombrados en la línea de comando se convierten primero en rutas absolutas
si necesario. Luego se comparan con la ruta de referencia, el directorio de desarrollo
ruta y la ruta del directorio de integración, para determinar un nombre relativo a la línea de base. Está
un error si el archivo nombrado está fuera de uno de estos árboles de directorios.

El -BAse_RElativo La opción se puede utilizar para hacer que los nombres de archivo relativos se interpreten como
en relación con la ruta de la línea de base; Los nombres de archivo absolutos se seguirán comparando con los distintos
rutas para determinar un nombre relativo a la línea de base.

El relativa_de_archivo_de_preferencia en el archivo de configuración del usuario se puede utilizar para modificar
este comportamiento predeterminado. Ver aeuconf(5) para obtener más información.

Proceso Lado Efectos
Este comando cancelará cualquier registro de compilación o prueba, porque agregar un archivo de forma lógica
los invalida.

Cuando se enumeran los archivos de cambios (égida -Lista Cambiar_archivos -Breve) los archivos eliminados
no aparecen en la lista concisa. Del mismo modo, cuando los archivos del proyecto se enumeran con un
número de cambio explícito (égida -Lista Proyecto_archivos -Breve -Cambio N) ninguno de los cambios
Los archivos, incluidos los archivos eliminados, no aparecerán en la lista concisa. Estos dos
Las funciones son muy útiles al llamar a aegis desde dentro de un DMT para generar la lista de
archivos fuente.

Cambiar las Tipo de Propiedad of a Archive
Si desea cambiar el tipo de un archivo (por ejemplo, de una prueba a un archivo fuente, o vicio
versa) podría hacerlo como dos cambios, primero usando aire(1) en un cambio y luego
usando aenf(1) o aent(1) en un segundo cambio, o puede combinar ambos pasos en el mismo
cambio. Recuerde usar el aire -noblanco o obtendrás una nueva y peculiar
plantilla de archivo.

Notificación
El eliminar_archivo_comando en el proyecto config se ejecuta el archivo, si está configurado. los archivo_proyecto_‐
comando también se ejecuta, si está configurado, y si ha habido una integración recientemente. Ver
aepconf(5) para obtener más información.

BLANCO

Aegis le proporciona lo que a menudo se llama una "ruta de visualización" que indica el desarrollo
herramientas (compiladores, sistemas de compilación, etc.) busque primero en el directorio de desarrollo, luego en
la línea de base de la rama, y ​​así sucesivamente hasta la línea de base del tronco.

El problema con las rutas de visualización es que para eliminar archivos, necesita algún tipo de
"whiteout" para decir "deja de mirar, se ha eliminado".

Cuando usas el aire(1) o aemv(1) comandos, esto significa "agregar información a este cambio
que eliminará el archivo de la línea de base cuando se integre este cambio ". Es decir mientras
el cambio está en el "Ser" desarrollado estado, el archivo sólo se "elimina" en el desarrollo
directorio: todavía está presente en la línea de base y lo estará hasta que se realice el cambio
integrado con éxito.

Cuando se utiliza el aire(1) o aemv(1) comandos, Aegis creará un archivo de 1K para actuar como el
whiteout. Su contenido es bastante feo, por lo que si compila o incluye el "eliminado"
archivo accidentalmente, obtiene un error fatal. Esto le recordará que elimine los obsoletos
Referencias.

Cuando el cambio en integrado, el archivo eliminado es no copiado / vinculado desde la línea de base a
el directorio de integración, y es no copiado del directorio de desarrollo. En esto
tiempo que se ha ido físicamente (sin desvanecimiento). Se supone que debido al error
induciendo el borrado, todas las referencias antiguas se encontraron y se corrigieron mientras el cambio estaba en el
"Ser" desarrollado estado.

Archive Los manifiestos
Al generar una lista de archivos para compilar o vincular, es importante que el archivo
El manifiesto se generará a partir de información conocida por Aegis, en lugar de hacerlo desde el sistema de archivos.
Esto es por varias razones:

(a) Aegis sabe exactamente qué archivos (fuente) están dónde, mientras que todo lo demás está
inferir el conocimiento de Aegis; y

(b) buscar en el sistema de archivos es difícil cuando la ruta de la vista es más larga que 2 directorios
(y el método de ramificación de Aegis puede hacerlo arbitrariamente largo); y

(c) Los archivos de blanqueamiento y cualquier otra cosa que se deje "por ahí" confundirán cualquier método
que interroga al sistema de archivos.

La forma más sencilla de utilizar el conocimiento de archivos de Aegis es con algo como un awk(1) guión
procesando las listas de archivos Aegis. Por ejemplo, puede hacer esto con para lograr(1) como sigue:
# generar el archivo de manifiesto
manifiesto.make.inc: manifiesto.make.awk
(égida -l cf -ter; égida -l pf -ter) | \
awk -f manifest.make.awk> manifest.make.inc
# ahora incluye el archivo de manifiesto
incluir manifest.make.inc
Nota: esto sería ineficaz si lo hiciera una vez por directorio, pero no hay nada
lo que le impide escribir numerosas asignaciones en el manifiesto.make.inc archivo, todo en uno
pasar.

Es posible hacer lo mismo con el generador de informes de Aegis (ver aer(1) para más
información), pero esto es más complicado que el awk(1) guión. Sin embargo, con el
información "directamente de la boca del caballo", por así decirlo, también puede ser mucho más inteligente.

Este manifiesto de archivo quedaría desactualizado sin un interbloqueo al archivo de Aegis
comandos de operaciones. Usando el comando_archivo_proyecto y cambiar_archivo_comando campos de
el proyecto config archivo (ver aepconf(5) para obtener más información), puede eliminar este archivo
en momentos estratégicos.
/ * ejecutar cuando se modifica el manifiesto del archivo de cambios * /
change_file_command = "rm -f manifest.make.inc";
/ * ejecutar cuando se modifica el manifiesto del archivo del proyecto * /
project_file_command = "rm -f manifest.make.inc";
Por lo tanto, el nuevo manifiesto de archivo se reconstruirá durante la próxima aeb(1) comando.

Opciones y Preferencias
Hay un -No-WhiteOut opción, que puede usarse para suprimir archivos de borrado cuando usa
las aire(1) y aemv(1) comandos. Hay un correspondiente -BlancoFuera opción, que es
generalmente el predeterminado.

Hay un preferencia_blanca campo en el archivo de preferencias del usuario (ver aeuconf(5) para
más información) si desea configurar esta opción de forma más permanente.

Whiteout Archive Plantillas
El plantilla_blanca campo del proyecto config El archivo se puede utilizar para producir lenguaje
archivos de error específicos. Si ninguna entrada de la plantilla de blanqueamiento coincide, un archivo de 1 KB muy feo
producirse: debería inducir errores de compilación para casi cualquier lenguaje.

Si desea un mensaje de error más legible por humanos, entradas como
plantilla_blanca =
[
{
patrón = ["*. [ch]"];
body = "#error Este archivo ha sido eliminado.";
}
];
puede ser muy eficaz (este ejemplo asume gcc(1) se está utilizando).

Si es imprescindible que no se producirá un archivo de borrado, por ejemplo, para archivos de origen C, podría
use una plantilla de blanqueamiento como
plantilla_blanca =
[
{patrón = ["* .c"]; }
];
porque un ausente cuerpo el subcampo significa que no genera ningún archivo de borrado.

Es posible que tenga más de una entrada de plantilla de blanqueamiento, pero tenga en cuenta que el orden de
las entradas son importantes. Se utilizará la primera entrada que coincida.

Archive la columna Acción del Riesgo
Cuando se ejecuta este comando, primero verifica los archivos de cambios con los archivos de proyectos. Si
hay inconsistencias, las acciones del archivo se ajustarán de la siguiente manera:

crear Si se está creando un archivo, pero se integra otro conjunto de cambios que también
crea el archivo, la acción del archivo en el conjunto de cambios que aún se está desarrollando será
ajustado a "modificar".

modificar Si se está modificando un archivo, pero hay otro conjunto de cambios integrado que elimina
archivo, la acción de archivo en el conjunto de cambios que aún se está desarrollando será
ajustado a "crear".

eliminar Si se está eliminando un archivo, pero hay otro conjunto de cambios integrado que elimina
el archivo, el archivo se eliminará del conjunto de cambios que aún se está desarrollando.

CAMPUS

Se entienden las siguientes opciones:

-BAse_RElativo
Esta opción se puede utilizar para hacer que los nombres de archivo relativos se consideren relativos a
la base del árbol de origen. Ver aeuconf(5) para el usuario correspondiente
preferencia.

-CURrent_RElativo
Esta opción se puede utilizar para hacer que los nombres de archivo relativos se consideren relativos a
el directorio actual. Suele ser el predeterminado. Ver aeuconf(5) para el
preferencia del usuario correspondiente.

-Cambio número
Esta opción puede usarse para especificar un cambio particular dentro de un proyecto. Ver
égida(1) para obtener una descripción completa de esta opción.

-Ayudar
Esta opción se puede utilizar para obtener más información sobre cómo utilizar el égida
.

-Lista
Esta opción se puede utilizar para obtener una lista de temas adecuados para este comando.
La lista puede ser más general de lo esperado.

-No_Logging
Esta opción se puede utilizar para deshabilitar el registro automático de resultados y errores para
un archivo. Esto suele ser útil cuando se combinan varios comandos aegis en un shell.
guión.

-Proyecto nombre
Esta opción se puede utilizar para seleccionar el proyecto de interés. Cuando no -Proyecto
se especifica la opción, la AEGIS_PROJECT se consulta la variable de entorno. Si
que no existe, el usuario $ INICIO / .aegisrc el archivo se examina por defecto
campo del proyecto (ver aeuconf(5) para obtener más información). Si eso no existe,
cuando el usuario solo está trabajando en cambios dentro de un solo proyecto, el proyecto
nombre predeterminado para ese proyecto. De lo contrario, es un error.

-Breve
Esta opción puede usarse para hacer que los listados produzcan el mínimo de
información. Suele ser útil para scripts de shell.

-Verboso
Esta opción puede usarse para hacer que aegis produzca más resultados. Por defecto aegis
solo produce salida sobre errores. Cuando se usa con el -Lista opción esta opción
hace que se agreguen encabezados de columna.

-Esperar Esta opción puede usarse para requerir que los comandos Aegis esperen los bloqueos de acceso, si
no se pueden obtener de inmediato. Predeterminado para el usuario preferencia_lock_wait
si no se especifica, consulte aeuconf(5) para obtener más información.

-No, espera
Esta opción puede usarse para requerir que los comandos Aegis emitan un error fatal si el acceso
las cerraduras no se pueden obtener inmediatamente. Predeterminado para el usuario
preferencia_lock_wait si no se especifica, consulte aeuconf(5) para obtener más información.

-BlancoFuera
Esta opción se puede utilizar para solicitar que los archivos eliminados sean reemplazados por un "borrado".
archivo en el directorio de desarrollo. La idea es que compilar un archivo de este tipo
resultar en un error fatal, para que se puedan encontrar todas las referencias. Este es
generalmente el predeterminado.

-No_BlancoFuera
Esta opción se puede utilizar para solicitar que no se coloque ningún archivo de "borrado" en el
directorio de desarrollo.

Vea también égida(1) para opciones comunes a todos los comandos de aegis.

Todas las opciones pueden abreviarse; la abreviatura está documentada como letras mayúsculas,
todas las letras minúsculas y los guiones bajos (_) son opcionales. Debes usar consecutivo
secuencias de letras opcionales.

Todas las opciones no distinguen entre mayúsculas y minúsculas, puede escribirlas en mayúsculas, minúsculas o
combinación de ambos, el caso no es importante.

Por ejemplo: los argumentos "-proyecto," -PROJ "y" -p "se interpretan en el sentido de
-Proyecto opción. El argumento "-prj" no se entenderá, porque consecutivo
no se proporcionaron caracteres opcionales.

Las opciones y otros argumentos de la línea de comando se pueden mezclar arbitrariamente en la línea de comando,
después de los selectores de funciones.

Se entienden los nombres largos de las opciones de GNU. Dado que todos los nombres de opciones para égida son largos,
esto significa ignorar el interlineado adicional '-'. Los "--opción=propuesta de"la convención también es
entendido.

RECOMENDADO ALIAS

El alias recomendado para este comando es
csh% alias aerm 'aegis -rm \! * -v'
sh $ aerm () {aegis -rm "$ @" -v}

ERRORES

Es un error si el cambio no está en el "Ser" desarrollado estado.
Es un error si el cambio no se asigna al usuario actual.
Es un error si el archivo no existe en la línea de base.
Es un error si el archivo ya forma parte del cambio.

SALIR ESTADO

El égida El comando saldrá con un estado de 1 en cualquier error. los égida el comando solo
salir con un estado de 0 si no hay errores.

MEDIO AMBIENTE VARIABLES

See égida(1) para obtener una lista de variables de entorno que pueden afectar este comando. Ver
aepconf(5) para el archivo de configuración del proyecto Proyecto específico campo para saber cómo configurar
variables de entorno para todos los comandos ejecutados por Aegis.

Utilice aerm en línea utilizando los servicios de onworks.net