aenf - Online en la nube

PROGRAMA:

NOMBRE

aegis nuevo archivo: agregue nuevos archivos para ser creados por un cambio

SINOPSIS

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

DESCRIPCIÓN

El égida -Archivo nuevo El comando se usa para agregar nuevos archivos a un cambio. Los archivos nombrados
ser agregado a la lista de archivos en el cambio.

Para cada archivo nombrado, se crea un nuevo archivo en el directorio de desarrollo, si no
ya existen. Si el archivo ya existe, no se modificará.

Si desea que un nuevo archivo fuente sea ejecutable (scripts de shell, por ejemplo),
simplemente usa el normal chmod(1) comando. Si alguno de los bits ejecutables del archivo se establece en
aede(1) vez que el archivo se recuerda como ejecutable y todos los bits de ejecución (menos el
umask del proyecto) se establecerá mediante aecp(1) comandos.

Si nombra un directorio en la línea de comando, se buscará en todo el árbol de directorios
para archivos nuevos. (Nota: se agregará absolutamente todo, incluidos los archivos de puntos y
archivos binarios, por lo que primero deberá limpiar los archivos basura).
directorio que ya está en el cambio, o en el proyecto, será ignorado. los
nombre_archivo_aceptar y nombre_archivo_rechazar patrones en el proyecto aegis.conf archivo también
ser aplicado, ver aepconf(5) para obtener más información.

Directorio Ejemplo
Hay momentos en que un comando como
$ aenf fubar / *
aegis: proyecto "ejemplo": cambio 42: "fubar / glorp" ya está en cambio
aegis: proyecto "ejemplo": cambio 42: se encontró 1 error fatal, no se agregaron archivos nuevos
$
fallará como se muestra. Hay varias formas de lidiar con esto, la más fácil es
simplemente nombre el directorio:
$ aenf fubar
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / smiley" agregado
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / frownie" agregado
$
También podrías usar el encontrar(1) comando para la selección de archivos arbitrariamente compleja, pero
primero debe excluir los archivos que el comando anterior excluye automáticamente:
$ aelcf > excluir
$ aelpf >> excluir
$ encontrar fubar Tipo f | \
grep -v -f excluir | \
xargs égida --archivo nuevo -v
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / smiley" agregado
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / frownie" agregado
$
Si no está utilizando la lista de exclusión, el encontrar(1) el comando necesitará un ajuste fino para su
estilo de directorio de desarrollo. Si está utilizando el estilo de enlace simbólico, deberá agregar
las encontrar -nenlace 1 opción además de la encontrar Tipo f .
$ encontrar fubar Tipo f -nenlaces 1 | \
xargs égida --archivo nuevo -v
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / smiley" agregado
aegis: proyecto "ejemplo": cambio 42: archivo "fubar / frownie" agregado
$
Si está usando el estilo de directorio de desarrollo de copia completa, tendrá que usar el
método de lista de exclusión, arriba.

Archive Plantillas
Cuando se crea un nuevo archivo en el directorio de desarrollo, el proyecto config archivo es
buscó una plantilla para el nuevo archivo. Si se encuentra una plantilla, el nuevo archivo se
inicializado a la plantilla, de lo contrario se creará vacío. Ver aepconf(5) para más
información.

La forma más sencilla es utilizar archivos de plantilla, como
archivo_plantilla =
[
{
patrón = ["* .c"];
body = "$ {read_file $ {plantilla fuente / c abs}}";
},
{
patrón = ["prueba / * /. sh"];
body = "$ {read_file $ {plantilla fuente / abs de prueba}}";
},
];
Como puede ver, los archivos de plantilla son parte del origen del proyecto, por lo que puede agregar el
avisos de derechos de autor y envoltorios apropiados, etc.. $ fuente la sustitución los ubica,
si no forman parte del cambio actual (y normalmente no lo son).

Los propios archivos de plantilla contienen sustituciones. los $ nombre de archivo la sustitución es
disponible y contiene el nombre del archivo que se está creando. Esto se puede manipular en
varias formas al construir el contenido de archivo apropiado. Ver aesub(5) para más
información sobre sustituciones.

También es posible ejecutar un comando para crear el nuevo archivo. Puedes hacer esto en lugar de
especificando una cadena de cuerpo, verbigracia:
archivo_plantilla =
[
{
patrón = ["*"];
body_command = "perl $ {plantilla fuente.pl abs} $ nombre de archivo";
},
];
El comando se ejecuta con un directorio actual establecido en la parte superior del directorio de desarrollo.
Es un error si el comando no crea el archivo. Puedes mezclar y combinar los dos
técnicas, cuerpo cuerda y cuerpo_comando, si tu quieres.

Archive Nombre Limitaciones
Hay varios controles disponibles para limitar la forma de los nombres de los archivos del proyecto. Todo
Estos controles se pueden encontrar en el archivo de configuración del proyecto, consulte aepconf(5) para más
información. Los más significativos se describen brevemente aquí:

longitud_de_archivo_máxima = entero;
Este campo se utiliza para limitar la longitud de los nombres de archivo. Es posible que no todos los archivos nuevos
componentes de ruta más largos que esto. El valor predeterminado es 255 si no se establece. Para el máximo
portabilidad, debe configurarlo en 14.

posix_filename_charset = booleano;
Este campo se puede utilizar para limitar los caracteres permitidos en los nombres de archivo a solo aquellos
permitido explícitamente por POSIX. Predeterminado a false si no está configurado, es decir, cualquiera que sea su
el sistema operativo lo tolerará, excepto los espacios en blanco y los caracteres de alto bit.
Para una máxima portabilidad, debe configurar esto en verdadero.

dos_filename_required = booleano;
Este campo se puede utilizar para limitar los nombres de archivo para que se ajusten al DOS 8 + 3
límites de nombre de archivo y al conjunto de caracteres de nombre de archivo de DOS. Predeterminado a false si no
conjunto.

windows_filename_required = booleano;
Este campo se puede utilizar para limitar los nombres de archivo para que se ajusten a la versión de Windows98.
y límites de nombre de archivo y juego de caracteres de WindowsNT. Predeterminado a false si no está configurado.

shell_safe_filenames = booleano;
Este campo se puede utilizar para limitar los nombres de archivo para que no contengan shell
caracteres especiales. Predeterminado a verdadero si no está configurado. Si este campo se establece en false,
necesitarás usar el $ {cita} sustitución de nombres de archivos en los comandos, para
asegúrese de que los nombres de archivo que contienen caracteres especiales de shell no tengan
efectos secundarios. Los caracteres extraños en los nombres de archivo también pueden confundir su dependencia
herramienta de mantenimiento.

allow_white_space_in_filenames = booleano;
Este campo se puede utilizar para permitir espacios en blanco en los nombres de los archivos. Esta voluntad
permitir que los siguientes caracteres aparezcan en los nombres de los archivos: retroceso (BS, \ b, 0x08),
tabulación horizontal (HT, \ t, 0x09), nueva línea (NL, \ n, 0x0A), tabulación vertical (VT, \ v,
0x0B), avance de formulario (FF, \ f, 0x0C) y retorno de carro (CR, \ r, 0x0D). Predeterminado a
falso si no se establece.

Tenga en cuenta que este campo no anula otros filtros de nombre de archivo. Será
necesario establecer explícitamente shell_safe_filenames = false así como. Será
necesario para establecer dos_nombre_archivo_requerido = false (el predeterminado) también. Será
necesario para establecer posix_nombre_archivo_charset = false (el predeterminado) también.

El usuario debe tener mucho cuidado al usar la sustitución $ {quote} alrededor de todos los archivos.
nombres en comandos en la configuración del proyecto. E incluso entonces, sustituciones
que esperan una lista de nombres de archivos separados por espacios tendrán resultados indefinidos.

allow_non_ascii_filenames = booleano;
Este campo se puede utilizar para permitir nombres de archivo con caracteres no imprimibles en ASCII en
ellos. Por lo general, esto significaría un juego de caracteres UTF8 o internacional de algún tipo.
El valor predeterminado es falso si no se establece.

Tenga en cuenta que este campo no anula otros filtros de nombre de archivo. Será
necesario establecer explícitamente shell_safe_filenames = false así como. Será
necesario para establecer dos_nombre_archivo_requerido = false (el predeterminado) también. Será
necesario para establecer posix_nombre_archivo_charset = false (el predeterminado) también.

filename_pattern_accept = [cadena];
Este campo se utiliza para especificar una lista de patrones de nombres de archivo aceptables.
El valor predeterminado es "*" si no se establece.

filename_pattern_reject = [cadena];
Este campo se utiliza para especificar una lista de patrones de nombres de archivo inaceptables.

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

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.

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.

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.

Notificación
El nuevo_archivo_comando en el archivo de configuración del proyecto, si está configurado. los proyecto_-
comando_archivo también se ejecuta, si está configurado, y si ha habido una integración recientemente. Ver
aepconf(5) para obtener más información.

PROBAR CORRELACIONES

El comando "aegis -Test -SUGgest" se puede utilizar para que aegis sugiera una regresión adecuada
pruebas para su cambio, según los archivos de origen de su cambio. Esto automáticamente
concentra el esfuerzo de prueba en pruebas relevantes, reduciendo el número de pruebas de regresión
necesario estar seguro de que no ha introducido un error.

Las correlaciones de prueba son generadas por el comando "aegis -Integrate_Pass", que
asocia cada prueba del cambio con cada archivo fuente del cambio. Por lo tanto, cada
El archivo de origen acumula una lista de pruebas que se han asociado con él en el pasado.
Esto no es tan exacto como el análisis de cobertura de código, pero es una aproximación razonable en
práctica.

El aecp(1) y aenf(1) los comandos se utilizan para asociar archivos con un cambio. Mientras ellos
no realizan activamente la asociación, estos son los archivos utilizados por aeipass(1) y
aet(1) para determinar qué archivos fuente están asociados con qué pruebas.

Probar La correlación Exactitud
Suponiendo que las correlaciones de las pruebas son precisas y que las pruebas son uniformes
distribuidos en todo el espacio funcional, habrá menos de 1 / número posibilidad de que un
la prueba relevante no ha sido ejecutada por el "aegis -Test -SUGgest número"Comando. Un pequeño
Se agrega una cantidad de ruido a la ponderación de prueba, por lo que a veces se producen cosas inesperadas.
probado, y las mismas pruebas no se ejecutan siempre.

La precisión de la correlación de la prueba se puede mejorar asegurándose de que:

· Cada cambio debe estar fuertemente enfocado, sin inclusiones de archivos gratuitas. Esta
evita correlaciones falsas.

· Cada elemento de nueva funcionalidad debe agregarse en un cambio individual, en lugar de
varios juntos. Esto correlaciona fuertemente las pruebas con la funcionalidad.

· Cada error debe corregirse en un cambio individual, en lugar de varios juntos. Esta
correlaciona fuertemente las pruebas con la funcionalidad.

· Las correlaciones de prueba se perderán si se mueven los archivos. Esto se debe a que las correlaciones son por
nombre.

La mejor manera de que las pruebas se correlacionen con precisión con los archivos de origen es cuando se produce un cambio
contiene una prueba y exactamente los archivos relacionados con la funcionalidad bajo prueba. También
muchos archivos falsos debilitarán la utilidad de las correlaciones de prueba.

CAMPUS

Se entienden las siguientes opciones

-Construir
Esta opción puede usarse para especificar que el archivo se construye durante una compilación
(a menudo solo una compilación integrada), por lo que se puede mantener el historial. Este es
útil para generar archivos de parche, donde se muestra un historial de archivos generados
importante. Es posible que los archivos creados de esta manera no se copien en un cambio, aunque
pueden eliminarse. Evite el uso de archivos de este tipo, si es posible.

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

-CONFIGURADO
Esta opción puede usarse para especificar que el archivo es un proyecto Aegis
archivo de configuración. El archivo de configuración del proyecto predeterminado se llama aegis.conf,
sin embargo, se puede utilizar cualquier nombre de archivo. También puede utilizar más de un archivo,
dividir el contenido en varios archivos, todos los cuales deben ser de este tipo.

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

-Mantener
Esta opción se puede utilizar para conservar archivos y / o directorios que normalmente se eliminan o
reemplazado por el comando. Predeterminado para el usuario eliminar_archivo_preferencia si no
especificado, ver aeuconf(5) para obtener más información.

-No_Mantener
Esta opción se puede utilizar para garantizar que los archivos y / o directorios se eliminen.
o reemplazado por el comando. Predeterminado para el usuario eliminar_archivo_preferencia si no
especificado, ver aeuconf(5) para obtener más información.

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

-Plantilla
Esta opción puede usarse para especificar que se debe usar una nueva plantilla de archivo, incluso
si el archivo ya existe.

-No_TEMplate
Esta opción puede usarse para especificar que no se debe usar una nueva plantilla de archivo,
incluso si el archivo no existe (se creará cualquier archivo vacío).

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

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 aenf 'aegis -nf \! * -v'
sh $ aenf () {aegis -nf "$ @" -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 ya forma parte del cambio.
Es un error si el archivo ya forma parte de la línea de base.
Es un error si los archivos nombrados en la línea de comando no son archivos normales y no
directorios. (Si necesita enlaces simbólicos o archivos especiales, créelos en el momento de la compilación).

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 aenf en línea utilizando los servicios de onworks.net