Node:admin,
Next:annotate,
Previous:add,
Up:Ordenes y Opciones
admin
Synopsis: admin [OPCIONES] [FICHEROS]
- Nombres alternativos - adm, rcs
- Requiere - Copia de trabajo, repositorio
- Cambios - Repositorio
Este mandato es una interfaz a las distintas tareas de administraci�n
- especialmente, tareas aplicables a ficheros RCS individuales en
el repositorio, como cambiar la clave de sustituci�n o cambiar
un mensaje de registro despu�s de que haya sido entregado.
Aunque admin se comporta recursivamente, si no hay ficheros dados como
argumentos, normalmente usted querr� nombrarlos expl�citamente.
Es muy raro que un mandato admin suelto tenga sentido cuando se aplica
a todos los ficheros en un proyecto, o incluso un directorio. De este
modo, cuando las siguientes explicaciones se refieran al "fichero",
quere decir el fichero o (raramente) los ficheros pasados como
argumentos al mandato admin.
Si hay un grupo de sistema llamado cvsadmin
en la m�quina del
repositorio, s�lo los miembros de este grupo pueden ejecutar admin
(con la excepci�n de la orden cvs admin -k
, que siempre
se permite). As�, usted puede impedir admin para todos los usuarios
configurando el grupo para no tener usuarios.
Opciones:
- -AFICHERO_VIEJO - (En desuso) Adjunta la lista de accesos RCS del
FICHERO_VIEJO a la lista de accesos del fichero que es el argumento
de admin. CVS no tiene en cuenta las listas de acceso RCS, as�
que esta opci�n es in�til.
- -a USUARIO1 [,USUARIO2...] - (En desuso) Adjunta los usuarios en la
lista separada por comas a la lista de acceso del fichero. Como -A,
esta opci�n es in�til en CVS.
- -bREV - Especifica la revisi�n de la rama por omisi�n del fichero
(usualmente el tronco) a REV. No necesita normalmente esta opci�n,
pero podr�a usarla para volver a una versi�n de un vendedor
si est� usando ramas de vendedores. No debe haber espacio entre
la opci�n -b y su argumento.
- -cPREFIJO_DE_COMENTARIO - (En desuso) Especifica la cabecera de comentario
del fichero a PREFIJO_DE_COMENTARIO. El encabezamiento del comentario no se
usa por CVS ni incluso por recientes versiones de RCS; as�, esta
opci�n es in�til y se incluye s�lo por compatibilidad
retrospectiva.
- -eUSUARIO1[,USUARIO2...] - (En desuso) Quita los nombres de usuario que
aparecen en la lista separada por comas de la lista de acceso del fichero
RCS. Como -a y -A, esta opci�n es ya in�til en CVS.
- -i o -I - Estas dos han ca�do tan en desuso que ni siquiera voy
a contarle qu� hac�an. (Ver el manual Cederqvist si siente
curiosidad).
- -kMODO - Especifica la clave de sustituci�n por omisi�n del fichero a
MODO. Esta opci�n se comporta como la opci�n -k para a�adir, s�lo
le proporciona una manera de cambiar el modo de un fichero despu�s de
que haya sido a�adido. (Ver la secci�n Claves de Sustitucion (Claves RCS) m�s adelante en el cap�tulo para ver modos v�lidos).
No debe haber espacio entre -k y su argumento.
- -L - Configura el candado a
strict
. (Ver -l abajo.)
- -l[REV] - Cierra la revisi�n del fichero a REV. Si REV es omitido,
cierra la �ltima revisi�n en la rama por omisi�n (usualmente el
tronco). Si REV es una rama, cierra la �ltima revisi�n de la rama.
La intenci�n de esta opci�n es proporcionarle un modo de hacer
obtenciones reservadas, donde s�lo un usuario a la vez puede
estar editando un fichero. No estoy seguro de lo �til que es esto
realmente, pero si quiere probarlo, debe probablemente hacerlo en
conjunci�n con el script rcslock.pl
en el directorio de la
distribuci�n contrib/
. Ver comentarios en este fichero para
obtener m�s informaci�n. Entre otras cosas, estos comentarios indican
que el bloqueo debe ser configurado a strict
. (Ver -L.) No
hay espacio entre -l y su argumento.
- -mREV:MENSAJE - Cambia el registro de mensajes para la revisi�n REV
a MENSAJE. Muy �til - junto con -k, esta es probablemente la opci�n
de administraci�n m�s usada. No hay espacio entre la opci�n y los
argumentos o alrededor de las comas entre dos argumentos. De hecho,
MENSAJE puede contener espacios dentro (en tal caso, recuerde rodearlo
por comillas para que el shell sepa que todo ello es una sola cosa).
- -NNOMBRE[:[REV]] - Igual que -n, excepto que fuerza el remplazo de cualquier
asignamiento existente del nombre simb�lico NOMBRE, en vez de salir
con un error.
- -nNOMBRE[:[REV]] - �ste es un interfaz gen�rico a asignar, renombrar y
borrar etiquetas. No hay raz�n, que yo sepa, de preferirlo al
mandato tag y las variadas opciones disponibles ah� (-d, -r,
-b, -f, y esas). Recomiendo usar, en cambio, el mandato tag. El NOMBRE y
la REVisi�n opcional pueden ser combinadas de las siguientes formas:
- -oRANGO - Borra las revisiones especificadas por RANGO (tambi�n
conocido como "anticuar", de ah� la -o). El rango puede ser
especificado de uno de las siguientes modos:
- REV1::REV2 - Colapsa todas las revisiones intermedias entre REV1 y
REV2, de modo que el historial de revisiones vaya directamente de
REV1 a REV2. Despu�s de esto, cualquier revisi�n entre las dos
ya no existir�, y habr� un salto discontinuo en la secuencia de
n�meros de revisiones.
- ::REV - Colapsa todas las revisiones entre el principio de la
rama de REVisi�n (que puede ser el principio del tronco) y la
REVisi�n, no inclusive, por supuesto. REV es la primera revisi�n
de esta l�nea.
- REV:: - Colapsa todas las revisiones entre REV y el final de su
rama (que puede ser el tronco). REV es entonces la �ltima revisi�n
de esta l�nea.
- REV - Borra la revisi�n REV (-o1.8 ser�a equivalente a
-o1.7::1.9).
- REV1:REV2 - Borra las revisiones de REV1 a REV2, inclu�das.
Deben estar en la misma rama. Despu�s de esto, no puede recuperar
REV1, REV2, o cualquier otra de las revisiones entre ellas.
- :REV - Borra las revisiones entre el comienzo de la rama (o tronco)
a REV, inclu�da. (Ver el aviso precedente.)
Note que las revisiones que se borran pueden tener ramas o bloqueos.
Si cualquiera de las revisiones tiene nombres simb�licos adjuntos,
deber� borrarlos primero con tag -d o admin -n. (De hecho, ahora mismo
CVS s�lo protege contra el borrado de revisiones con nombres
simb�licos si est� usando una de las sintaxis ::, pero las
sintaxis con coma tal vez cambien pronto a este comportamiento tambi�n).
En vez de usar esta opci�n para deshacer una entrega mala, puede
entregar una nueva revisi�n de deshaga el cambio err�neo. No hay
espacios entre -o y sus argumentos.
- -q - Dice a CVS que se ejecute silenciosamente - no se imprimen
mensajes de diagn�stico (simplemente como la opci�n global -q).
- -sESTADO[:REV] - Configura el atributo de estado de la revisi�n
REV a ESTADO. Si REV se omite, la �ltima revisi�n en la rama
por omisi�n (usualmente el tronco) se usa. Si REV es una etiqueta
de rama o n�mero, se usa la �ltima revisi�n de esta rama.
Cualquier cadena de letras o n�meros es aceptable para ESTADO;
unos estados com�nmente usados son Exp para Experimental, Stab para
Estable y Rel para Lanzamiento. (De hecho, CVS ajusta el estado a Exp
cuando un fichero se crea).
Note que CVS usa el estado "dead" para sus propios prop�sitos, as�
que no lo especifique.
Los estados se muestran en la salida de registro de CVS y en las
claves RCS $Log y $State en los ficheros. No hay espacio entre -s
y sus argumentos.
- -t[FICHERO_DESC] - Remplaza la descripci�n (mensaje de creaci�n)
para el fichero con contenidos FICHERO_DESC, o lo lee de la entrada
est�ndar si no se especifica FICHERO_DESC.
Esta �til opci�n, desafortunadamente, no funciona actualmente
en CVS cliente/servidor. Adem�s, si lo itenta en cliente/servidor
y omite FICHERO_DESC, cualquier descripci�n existente para el
fichero es cortada y remplazada por una cadena vac�a. Si
necesita reescribir la descripci�n de un fichero, h�galo
bien usando s�lo CVS local en la misma m�quina que el
repositorio o -t-CADENA (ver adelante). No hay espacio entre -t
y su argumento. FICHERO_DESC puede no comanzar con gui�n (-
).
- -t-CADENA - Como -t, excepto que CADENA es tomada directamente como
la nueva descripci�n. CADENA puede contener espacios, en cuyo
caso debe rodearla por comillas. A diferencia de la otra sintaxis para
-t, esta funciona tanto en cliente/servidor como localmente.
- -U - Configura el bloqueo a no-estricto. (Ver opciones -l y -L,
discutidas anteriormente.)
- -u[REV] - Libera la revisi�n REV. (Ver -l). Si se omite REV, CVS
libera el �ltimo bloqueo mantenido por el solicitante. Si alg�n
otro que el due�o de un bloqueo lo rompe, un mensaje
por correo electr�nico se env�a al due�o original del
bloqueo. El contenido de este mensaje se solicita en la entrada
est�ndar de la persona que rompe el bloqueo. No hay espacio entre
-u y su argumento.
- -VN�MERO_DE_VERSI�N_CVS - (En desuso) Esto sol�a ser un modo
de pedir a CVS producir ficheros RCS aceptables para versiones
anteriores de RCS. Ahora el formato RCS usado por CVS est� qued�ndose
lejos del formato RCS usado por RCS, as� que la opci�n es in�til.
Especificarla acaba en un error.
- -xSUFIJO - (En desuso) Te�ricamente, esto le da un modo de especificar
el sufijo de los nombres de fichero RCS. Sin embargo, CVS y las herramientas
relacionadas dependen todos del sufijo por omisi�n (,v), as� que esta
opci�n no hace nada.