aeclone - Online en la nube

PROGRAMA:

NOMBRE

clon aegis: haga una copia exacta de un cambio

SINOPSIS

égida -Clon [ opción...] cambie el número [ cambie el número ]
égida -Clon -Ayudar
égida -Clon -Versión

DESCRIPCIÓN

La pestaña égida -Clon El comando se utiliza para crear réplicas exactas de los cambios. Esto es de la mayoria
utilícelo cuando sea necesario aplicar un cambio a varias ramas paralelas.

Un número de cambio deben ser suministrado. Este es el cambio a replicar. Si alguna rama
se dan opciones (ver más abajo) el número de cambio obligatorio se aplica a la sucursal
especificado. Si no se especifica una rama, el cambio se aplica al proyecto (implícito o
explícito).

Si se proporciona el segundo número de cambio opcional, este es el número de cambio que se creará
para sostener la réplica; si no se proporciona, el siguiente número de cambio disponible será
usado.

Si se ha completado el cambio que se va a replicar, se realizarán las revisiones de archivo correspondientes.
extraído de la historia; de lo contrario, los archivos se copiarán del directorio de desarrollo
del cambio que se va a copiar. Tenga cuidado: si un archivo en el cambio que fue clonado
posteriormente cambia, esos cambios will no sea ser rastreado automágicamente. Es mejor si
Los cambios se clonan en un momento estable, como uno de los estados posteriores al final del desarrollo, o incluso
después de integrar pase.

desarrollo Directory Ubicación
Por favor, Nota: Aegis también consulta el sistema de archivos subyacente para determinar su noción de
Tamaño máximo de archivo. Donde el tamaño de archivo máximo del sistema de archivos es menor que
longitud_de_nombre_de_archivo_máxima, el sistema de archivos gana. Esto puede suceder, por ejemplo, cuando está
utilizando el sistema de archivos Linux UMSDOS, o cuando tiene un NFS montado, un antiguo V7
sistema de archivos. Configuración longitud_de_nombre_de_archivo_máxima a 255 en estos casos no altera el
hecho de que los límites de los sistemas de archivos subyacentes son mucho más pequeños (12 y 14, respectivamente).

Si sus directorios de desarrollo (o todo su proyecto) están en sistemas de archivos con nombre de archivo
limitaciones, o una parte de las compilaciones heterogéneas tienen lugar en un entorno de este tipo,
ayuda a decirle a Aegis lo que son (usando el proyecto config campos del archivo) para que
no se tope con la situación en la que el proyecto se basa en los más permisivos
entornos, pero falla con misteriosos errores en los entornos más limitados.

Si sus directorios de desarrollo se encuentran habitualmente en un sistema de archivos Linux UMSDOS,
probablemente sea mejor configurar dos_nombre_archivo_requerido = su verdadero, y también cambiando el
plantilla_de_directorio_de_desarrollo campo. Desarrollo heterogéneo con varias ventanas
los entornos también pueden requerir esto.

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 sea copiado / vinculado desde la línea de base a
el directorio de integración, y es no sea 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 “piensen de nuevo sobre los incrementos de precio”(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.

y Preferencias
Hay un -No-WhiteOut opción, que puede usarse para suprimir archivos de borrado cuando usa
la 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
La pestaña 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
Los comandos de notificación que ejecutaría el aecp(1) aedb(1) aenf(1) aent(1) y
aire(1) los comandos se ejecutan, según corresponda. los proyecto_archivo_comando también se ejecuta, si está configurado.
See aepconf(5) para obtener más información.

Clonación y La fusión de

Cuando se utiliza eclon(1) para clonar un conjunto de cambios y luego integrar uno de los dos cambios
conjuntos, observará que Aegis dice que los archivos del cambio no integrado están ahora
fuera de plazo.

Si tu corres aem(1) para volver a actualizar los archivos desactualizados, fusionar(1) y algunos (pero
no) todas las demás herramientas de fusión, señala casi todo como un conflicto, aunque
ambas alternativas son idénticas.

El problema es que dos cambios hacen ediciones idénticas en el mismo lugar en el mismo archivo
son un conflicto lógico, incluso si no es un conflicto real, y se necesita un ser humano para entender
fuera la diferencia. Piense en una lista de compras: el baño necesita más jabón, y también
EL BAÑO PRINCIPAL. El segundo "jabón" de la fusión de las dos listas de la compra no es un
duplicado, realmente necesitas dos cajas de jabón. A veces, las ediciones de los archivos de origen son
mismo: a veces el conflicto lógico se resuelve aplicando ambas ediciones idénticas, no
solo uno.

Este es solo el fusionar(1) el comando es más conservador que el de RCS unir(1) comando.

La forma más fácil de lidiar con esta situación común es ejecutar un
aecpu sin cambios
comando antes tu ejecutas el aem(1) fusiona el comando y tendrás menos dolor. Es también
Vale la pena recordar que Aegis guarda el archivo original con un sufijo B (B para copia de seguridad) por lo que
puedes simplemente
mv fubar,B fubar
si sabe que todos los conflictos son conflictos lógicos.

OPCIONES

Se entienden las siguientes opciones:

-Rama número
Esta opción se puede utilizar para especificar una rama diferente para el archivo de origen, en lugar de
que la línea de base. (Ver también -Maletero opción. Tenga en cuenta: el -Rama opción
no toma un nombre de proyecto, solo el sufijo del número de sucursal.

-Abuelo
Esta opción se puede utilizar para especificar la rama del abuelo (una por encima de la
rama actual) para el archivo de origen, en lugar de la línea de base. (El abuelo
La opción es la misma que la opción "-branch ..").

-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.

-Directorio camino
Esta opción se puede utilizar para especificar qué directorio se utilizará. Es un error
si el usuario actual no tiene los permisos adecuados para crear el directorio
camino dado. Este debe ser un camino absoluto.

Precaución: Si está utilizando un montador automático, no use `pwd` para hacer un valor absoluto.
ruta, por lo general da una respuesta incorrecta.

-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.

-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.

-Producción nombre de archivo
Esta opción se puede utilizar para especificar un nombre de archivo que se escribirá con la
número de cambio determinado automáticamente. Útil para escribir guiones.

-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.

-Maletero
Esta opción se puede utilizar para especificar el tronco del proyecto para el archivo de origen, en lugar de
que la línea de base. (Ver también -Rama opción, la opción -trunk es la misma que
la opción "-branch -".)

-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.

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=valor"la convención también es
entendido.

ERRORES

Es un error si el usuario actual no es administrador del proyecto. (En algunos
casos es posible que los desarrolladores de un proyecto creen cambios, consulte aepattr(5) para
más información.)

SALIR ESTADO

La pestaña é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 aeclone en línea utilizando los servicios de onworks.net