Mandato delta

Finalidad

Crea un delta en un archivo SCCS.

Sintaxis

delta [ -r SID ] [ -s ] [ -n ] [ -g Lista ] [ -p ] [ -m ModificationRequestList ] [ -y [ Comentario ] ] Archivo ...

Descripción

El comando delta introduce en el archivo del Sistema de Control de Código Fuente (SCCS) nombrado cualquier cambio que se haya realizado en la versión del archivo recuperada mediante un comando get -e.

El mandato delta lee los archivos g que corresponden al archivo especificados (consulte el mandato get para obtener una descripción de los archivos creados y utilizados por SCCS) y crea un nuevo delta. Ninguna línea de un archivo g puede contener más de 512 caracteres.

Si especifica un directorio para el valor Archivo , el mandato delta realiza las acciones solicitadas en todos los archivos SCCS de ese directorio que se han extraído previamente para su edición (es decir, en todos los archivos con un s. prefijo). Si especifica un - (signo menos) en lugar del valor Archivo , el mandato delta lee la entrada estándar e interpreta cada línea como el nombre de un archivo SCCS. Cuando el mandato delta lee la entrada estándar, debe proporcionar el distintivo -y . También debe proporcionar el distintivo -m si se ha establecido el distintivo de cabecera v . El mandato delta lee la entrada estándar hasta que alcanza un carácter de fin de archivo.

Nota: Las líneas que empiezan por un carácter ASCII de SOH (binario 001) no se pueden colocar en el archivo SCCS a menos que el SOH esté entrecomillado utilizando una \ (barra inclinada invertida). SOH tiene un significado especial para SCCS y provoca un error.

El uso de un mandato get en archivos SCCS, seguido del mandato delta en esos mismos archivos, debe evitarse cuando el mandato get genera una gran cantidad de datos. En su lugar, debe alternar el uso de los mandatos get y delta .

El mandato delta guarda los cambios realizados en una versión determinada de un archivo SCCS. Para utilizar el mandato delta :

Utilice el comando get -e para obtener una versión editable del archivo.
Edite ese archivo.
Utilice el mandato delta para crear una nueva versión del archivo SCCS.

El mandato delta le solicita comentarios si no se especifica la opción -y . Los comentarios se aplican a ese delta concreto y aparecen en la cabecera del archivo SCCS. Los comentarios no se recuperan cuando se utiliza el mandato get para obtener el delta y no aparecen en el texto de un archivo recuperado. Utilice los comentarios para realizar un seguimiento de por qué se ha creado un delta.

Para ver los comentarios, utilice un editor para ver el archivo SCCS, escriba el archivo SCCS en la pantalla de visualización con el mandato cat , o imprima las partes seleccionadas del archivo en la salida estándar utilizando el mandato prs . Recuerde que no debe cambiar el contenido del archivo SCCS directamente. Para cambiar los comentarios delta, utilice el mandato cdc .

Nota: No utilice el mandato delta en un archivo si contiene palabras clave de identificación expandidas. Las versiones de archivo de sólo lectura sustituyen las palabras clave por valores de texto. La utilización del mandato delta en un archivo de sólo lectura hace que se pierdan las palabras clave. Para recuperarse de esta situación, elimine el delta o vuelva a editar el archivo y sustituya las palabras clave de identificación.

SCCS no permite el uso del mandato delta a menos que exista una copia editable del archivo.

Para evitar la pérdida de palabras clave, utilice el mandato admin con el distintivo -f para especificar el distintivo de cabecera i . Después, la ausencia de palabras clave en una versión de archivo provocará un error.

Distintivos

Elemento	Descripción
-g Lista	Especifica una lista de SID (deltas) que se deben ignorar cuando el mandato get crea el archivo g. Después de utilizar este distintivo, el mandato get ignora el delta especificado cuando crea el archivo g.
-m ModificationRequestList	Si el archivo SCCS tiene establecido el distintivo de cabecera v , se debe proporcionar un número de solicitud de modificación (MR) como razón para crear el nuevo delta. Si no especifica el distintivo -m y se establece el distintivo de cabecera v , el mandato delta lee los MRs de la entrada estándar. Si la entrada estándar es una estación de trabajo, el mandato delta le solicita los MRs. El mandato delta continúa tomando la entrada hasta que lee un carácter de fin de archivo. Siempre lee los MRs antes de los comentarios (consulte el distintivo -y ). Puede utilizar espacios en blanco, caracteres de tabulación o ambos para separar los MRs en una lista. Si el distintivo de cabecera v tiene un valor, se interpreta como el nombre de un programa que valida los números MR. Si el mandato delta devuelve un valor de salida distinto de cero del programa de validación de MR, el mandato delta presupone que algunos de los números de MR no eran válidos y deja de ejecutarse.
-n	Retiene el archivo g, que normalmente se elimina al finalizar el proceso del mandato delta .
-p	Escribe en la salida estándar (en el formato del mandato diff ) las diferencias del archivo SCCS antes y después de aplicar el delta. Consulte el mandato diff para obtener una explicación del formato.
-r SID	Especifica qué delta se va a crear en el archivo SCCS. Debe utilizar este indicador sólo si la misma persona ha realizado dos o más comandos get -e pendientes en el mismo archivo SCCS. El valor de SID puede ser el SID especificado en la línea de mandatos get o el SID que se va a crear (tal como indica el mandato get .) Se produce un error si el SID especificado no se puede identificar de forma exclusiva, o si se debe especificar un SID pero no lo es.
-s	Suprime la información que normalmente se graba en la salida estándar al completarse normalmente el mandato delta .
-y[Comentario]	Especifica el texto que describe la razón por la que se crea un delta. Una serie nula se considera un valor Comentario válido. Si la línea de comentario incluye caracteres especiales o espacios en blanco, la línea debe estar entre comillas simples o dobles. Si no especifica el distintivo -y , el mandato delta lee los comentarios de la entrada estándar hasta que encuentra una línea en blanco o un carácter de fin de archivo. Para la entrada de teclado, el mandato delta solicita los comentarios. Si el último carácter de una línea es \ (barra inclinada invertida), se ignora. Los comentarios no deben tener más de 512 caracteres.

Estado de salida

Este mandato devuelve los siguientes valores de salida:

Elemento	Descripción
0	Finalización satisfactoria.
>0	Se ha producido un error.

Ejemplos

Para registrar los cambios que ha realizado en un archivo SCCS, entre:
```
delta s.prog.c
```
Esto añade un delta al archivo SCCSs.prog.c, registrando los cambios realizados editandoprog.c. Eldeltaa continuación, le solicita un comentario que resume los cambios que ha realizado. Entre el comentario y, a continuación, especifique un carácter de fin de archivo o pulse la tecla de retorno dos veces para indicar que ha finalizado el comentario.
Para registrar los cambios que ha realizado en un archivo SCCS con un breve comentario descriptivo, entre:
```
delta -y "This delta contains the payroll function" s.prog.c
```

Archivos

Elemento	Descripción
/usr/bin/delta	Contiene el mandato delta .