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:
  • Si s�lo se da el argumento NOMBRE, el nombre simb�lico (etiqueta) llamado NOMBRE se borra.
  • Si NOMBRE: se da pero no REV, NOMBRE se asigna a la �ltima revisi�n en la rama por omisi�n (usualmente el tronco).
  • Si NOMBRE:REV se da, el NOMBRE se asigna a esa revisi�n. REV puede ser un nombre simb�lico en s� mismo, en este caso se traduce a un n�mero de revisi�n primero (puede ser un n�mero de rama).
  • Si REV es un n�mero de rama y le sigue un punto (.), NOMBRE se adjunta a la revisi�n m�s alta de esa rama. Si REV es simplemente $, NOMBRE se adjunta a los n�meros de revisi�n encontrados en las cadenas de claves en los ficheros de trabajo.

    En todos los casos donde NOMBRE se asigna, CVS sale con un error si hab�a una etiqueta llamada NOMBRE en el fichero (pero vea -N). No hay espacios entre -n y sus argumentos.

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