aemv: en línea en la nube

PROGRAMA:

NOMBRE

aegis mover archivo: cambie el nombre de uno o más archivos como parte de un cambio

SINOPSIS

égida -MoVe_file [ opción...] viejo nombre nuevo nombre [ old1 new1 [ old2 new2 ] ]
égida -MoVe_file -Lista [ opción...]
égida -MoVe_file -Ayudar

DESCRIPCIÓN

El égida -MoVe_file El comando se usa para copiar un archivo en un cambio y cambiar su nombre en
al mismo tiempo.

Los archivos nombrados se copiarán desde la línea de base (archivo antiguo) en el desarrollo
directorioarchivo nuevo) y se agregaron a la lista de archivos en el cambio.

Advertencia: si ya hay archivos en el directorio de desarrollo de viejo nombre or
las nuevo nombre se sobrescribirán.

El archivo antiguo en el directorio de desarrollo contendrá 1 KB de texto aleatorio. Lo aleatorio
El texto es lo suficientemente repugnante que la mayoría de los compiladores darán mensajes de error, si el
archivo se referencia accidentalmente. Esto suele ser muy útil al mover archivos de inclusión.

Puede cambiar el nombre de los directorios. Todos los archivos en el viejo nombre se cambiará el nombre del árbol de directorios
estar debajo del nuevo nombre árbol de directorio.

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 otro archivo
los invalida lógicamente.

Cuando se enumeran los archivos de cambios (égida -Lista Cambiar_archivos -Breve) los nuevos archivos (nuevo-
nombre ) aparecerá en la lista y los archivos eliminados (viejo nombre) Hará no aparecerá en el
listado conciso. Del mismo modo, cuando los archivos del proyecto se enumeran con un cambio explícito
número (égida -Lista Proyecto_archivos -Breve -Cambio N) ninguno de los archivos del cambio, incluidos
tanto los archivos nuevos como los eliminados, aparecerán en la lista concisa. Estas dos características son
muy útil cuando se llama aegis desde dentro de un DMT para generar la lista de archivos fuente.

Notificación
El nuevo_archivo_comando y eliminar_archivo_comando en el proyecto config archivo se ejecutan, si está configurado.
El proyecto_archivo_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.

Notificación
Al completar con éxito este comando, las notificaciones generalmente realizadas por el
aire(1) aenf(1) y aent(1) los comandos se ejecutan, según corresponda. Estos incluyen el
proyecto_archivo_comando, nuevo_archivo_comando, nuevo_comando_de_prueba y eliminar_archivo_comando campos
del proyecto config expediente. Ver aepconf(5) para obtener más información.

CAMPUS

Se entienden las siguientes opciones:

-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 aemv 'aegis -mv \! * -v'
sh $ aemv () {aegis -mv "$ @" -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 alguno de los archivos ya está en el 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.

Use aemv en línea usando los servicios de onworks.net