7678 lines
290 KiB
Plaintext
7678 lines
290 KiB
Plaintext
== CMD_DESCRIPTION_ACL ==
|
||
Establece permisos para un usuario, en un objeto dado.
|
||
|
||
== CMD_USAGE_ACL ==
|
||
Sintaxis:
|
||
|
||
cm acl --user=usr_name | --group=group_name <action=<+|-permission>+>+ spec_objeto
|
||
|
||
--user Nombre de usuario.
|
||
--group Nombre de grupo.
|
||
action Acción a aplicar: permitir, denegar o sobrescribir.
|
||
-allowed para habilitar permisos
|
||
-denied para denegar
|
||
-overrideallowed
|
||
-overridedenied
|
||
permission Permiso a aplicar.
|
||
Usa comas para separar permisos.
|
||
(Usa 'cm showpermissions' para mostrar todos los
|
||
permisos disponibles.)
|
||
spec_objeto Especificación del objeto sobre el que se van a fijar
|
||
los permisos.
|
||
Objetos válidos para este comando son:
|
||
repserver, repositorio, rama, changeset, etiqueta, item
|
||
y atributo.
|
||
(Usa 'cm help objectspec' para obtener más información
|
||
sobre especificaciones.)
|
||
La especificación puede ser también una ruta segura.
|
||
Consulta las Notas para obtener más información sobre
|
||
las rutas seguras.
|
||
|
||
Uso especial para rutas seguras:
|
||
cm acl [regular options] [--delete] [--branches=comma separated list] spec
|
||
(Opcionalmente, cada rama especificada en --branches se puede preceder con
|
||
los signos + o - para especificar si una rama se añadirá o se eliminará de
|
||
la lista cuando se edite.)
|
||
|
||
== CMD_HELP_ACL ==
|
||
La configuración de permisos requiere comprender cómo se gestiona la seguridad
|
||
en Plastic SCM. Lee la Guía de Seguridad para aprender cómo funcionan estos
|
||
permisos de seguridad:
|
||
https://www.plasticscm.com/documentation/security/plastic-scm-version-control-security-guide.shtml
|
||
|
||
Notas:
|
||
|
||
Este comando fija permisos de usuario o grupo a los objetos, repositorios,
|
||
ramas, etiquetas y/o rutas de servidor especificados.
|
||
|
||
Object specs:
|
||
Usa 'cm help objectspec' para aprender cómo especificar objetos.
|
||
El comando acl usa un tipo especial de especificación: rutas seguras.
|
||
|
||
- Especificación de rutas seguras (secured paths):
|
||
path:server_path[#tag]
|
||
Ejemplos: path:/src/foo.c
|
||
path:/doc/pdf
|
||
path:/doc/pdf#documents
|
||
|
||
Acciones de permisos:
|
||
Usa -allowed y -denied para especificar qué permisos aplicar.
|
||
Usa los argumentos -overrideallowed y -overridedenied para especificar
|
||
qué permisos se sobrescriben.
|
||
|
||
Cada acción requiere una lista de permisos separados por comas.
|
||
|
||
Nombres de permisos:
|
||
Cada nombre de permiso debe ir precedido del símbolo + o -.
|
||
El símbolo + aplica el permiso y el símbolo - lo elimina.
|
||
Para ver los permisos de un objeto, usa el comando 'cm showacl'.
|
||
|
||
Permisos sobrescritos:
|
||
Sobrescribir un permiso usando --overrideallowed y --overridedenied te
|
||
permite evitar la herencia de permisos.
|
||
Esto es útil para evitar los permisos aplicados a nivel de repositorio o
|
||
de servidor.
|
||
Por ejemplo:
|
||
cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test
|
||
(Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del
|
||
repositorio 'test' incluso si ella tiene los permisos denegados a
|
||
nivel de repositorio.)
|
||
|
||
Permisos de rutas de servidor (rutas seguras):
|
||
- Es posible especificar permisos para una ruta de servidor dada.
|
||
- Estos permisos se comprueban durante la operación de check-in.
|
||
- Estos permisos también pueden ser comprobados durante la operación de
|
||
update y usados para prevenir ciertos directorios y ficheros sean
|
||
descargados al espacio de trabajo.
|
||
- Por cada ítem que se proteja (checkin), el servidor intenta concordar
|
||
la ruta del ítem con una ruta segura. Si se encuentra, entonces la
|
||
operación de checkin comprueba si el ítem tiene permisos para ser
|
||
protegido (checked in).
|
||
|
||
Los permisos que se pueden definir para una ruta segura son:
|
||
ci, change, add, move, rm, read
|
||
|
||
Si la comprobación de permisos no es satisfactoria para ninguno de los
|
||
ítems involucrados, entonces la operación de checkin se cancelará.
|
||
|
||
Para aplicar permisos de rutas seguras a un grupo de ramas, usa la
|
||
opción --branches.
|
||
Por ejemplo:
|
||
cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0
|
||
|
||
Para editar el ACL asociado a una ruta segura, usa el símbolo "#".
|
||
Por ejemplo:
|
||
cm acl --user=jo -denied=+rm path:/src#rule0
|
||
(Sin "#", la lista de ramas tendría que ser especificada de nuevo).
|
||
|
||
Es posible también editar la lista de ramas de una ruta segura.
|
||
Por ejemplo:
|
||
cm acl path:/src#rule0 --branches=-main,+main/rel1
|
||
(Elimina main de la lista y añade main/rel1.)
|
||
|
||
Para eliminar una ruta segura, usa el argumento --delete.
|
||
Por ejemplo:
|
||
cm acl --user=jo --delete path:/src#rule0
|
||
|
||
Herencia:
|
||
Herencia es una opción que proviene de los inicios de Plastic SCM 3.0.
|
||
Es una opción avanzada, pero también está obsoleta.
|
||
Permite a un objeto heredar los permisos de otro objeto, sobrescribiendo
|
||
las relaciones de herencia por defecto.
|
||
|
||
Usa la opción -cut para cortar la cadena de herencia.
|
||
Usa la opción -cutncpy para cortar y copiar los permisos heredados.
|
||
(Estas características vienen inspiradas por los permisos de sistema de
|
||
Windows donde puedes cortar herencia pero mantener los permisos
|
||
actuales.)
|
||
|
||
La opción -inherit permiter heredar de una especificación de objeto.
|
||
Por ejemplo: '-inherit=object_spec'
|
||
|
||
Ejemplos:
|
||
|
||
cm acl --user=danipen -denied=+ci rep:core
|
||
(Deniega el permiso de checkin al usuario danipen en el repositorio 'core'.)
|
||
|
||
cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main
|
||
(Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso
|
||
'chgperm' al grupo 'developers' en la rama 'main'.)
|
||
|
||
Ejemplos con rutas de servidor:
|
||
|
||
cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0
|
||
(Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que
|
||
concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta #rel
|
||
se crea para poder referirse a ella más adelante.)
|
||
|
||
cm acl path:/server#rel --branches=-/main,+/main/Rel2.1
|
||
(Actualiza la ruta segura '/server', cuya etiqueta es 'rel', borrando la
|
||
rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la
|
||
ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista
|
||
de ramas contendrá main/Rel2.1 y main/2.0)
|
||
|
||
cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc
|
||
(Eliminar el permiso de lectura a vsanchezm, sobrescribiéndolo, en la ruta
|
||
/doc.)
|
||
|
||
== CMD_DESCRIPTION_ACTIVATEUSER ==
|
||
Activa un usuario de licencia desactivado previamente.
|
||
|
||
== CMD_USAGE_ACTIVATEUSER ==
|
||
Sintaxis:
|
||
|
||
cm activateuser nombre1 nombre2 ... [opciones]
|
||
|
||
nombre: Nombre del usuario que se desea activar.
|
||
|
||
Opciones:
|
||
|
||
--server: activa el usuario en el servidor especificado.
|
||
Usa 'cm help objectspec' para saber más sobre especificaciones.
|
||
|
||
== CMD_HELP_ACTIVATEUSER ==
|
||
Notas:
|
||
|
||
Este comando activa un usuario para que pueda utilizar Plastic SCM.
|
||
Para activar un usuario, éste ha de estar desactivado previamente.
|
||
Para activar un usuario por primera vez, basta con utilizar Plastic SCM
|
||
con las credenciales del usuario a activar, siempre que no se sobrepase
|
||
el número máximo de usuarios autorizados.
|
||
|
||
Ejemplos:
|
||
|
||
cm activate user juan
|
||
|
||
== CMD_DESCRIPTION_ADD ==
|
||
Añade un ítem al repositorio.
|
||
|
||
== CMD_USAGE_ADD ==
|
||
Sintaxis:
|
||
|
||
cm add [options]* <ruta>+
|
||
|
||
ruta Rutas de los ítems a añadir, separados por espacios.
|
||
Usa comillas (") para especificar rutas que contengan
|
||
espacios.
|
||
Usa * para añadir todo el contenido del directorio
|
||
actual.
|
||
|
||
Opciones:
|
||
|
||
-R|-r|--recursive Añade los ítems recursivamente.
|
||
--silent No muestra ninguna salida.
|
||
--ignorefailed Si un ítem no se puede añadir, la operación de add
|
||
continuará sin él. Importante: si un directorio no se
|
||
puede añadir, su contenido tampoco se añadirá.
|
||
--skipcontentcheck Cuando la extensión no es suficiente para determinar si
|
||
el fichero es de texto o binario, se asumirá que es
|
||
binario en lugar de usar el contenido para detectar el
|
||
tipo. Este funcionamiento se asume para aumentar el
|
||
rendimiento en grandes operaciones de checkin.
|
||
|
||
|
||
== CMD_HELP_ADD ==
|
||
Notas:
|
||
|
||
Requisitos para añadir items:
|
||
- El directorio padre del ítem a añadir debe existir en el repositorio.
|
||
|
||
Ejemplos:
|
||
|
||
cm add file1.txt file2.txt
|
||
(Añade los ítems file1.txt y file2.txt.)
|
||
|
||
cm add c:\workspace\file.txt
|
||
(Añade el ítem file.txt en la ruta c:\workspace.)
|
||
|
||
cm add -R c:\workspace\src
|
||
(Añade recursivamente el contenido de la ruta src.)
|
||
|
||
cm add -R *
|
||
(Añade recursivamente todo el contenido del directorio actual.)
|
||
|
||
== CMD_USAGE_ADDIGNOREPATTERN ==
|
||
Uso:
|
||
|
||
cm addignorepattern pattern1 pattern2 ... patternN [--workspace=wkpath | --allworkspaces][--remove]
|
||
|
||
== CMD_DESCRIPTION_ADMIN ==
|
||
Ejecuta comandos de administración en el servidor.
|
||
|
||
== CMD_USAGE_ADMIN ==
|
||
Sintaxis:
|
||
|
||
cm admin comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
readonly
|
||
|
||
Para obtener más información de cada uno de los comandos ejecute:
|
||
cm changeset command --usage
|
||
cm changeset command --help
|
||
|
||
== CMD_HELP_ADMIN ==
|
||
Notas:
|
||
Sólo el administrador del servidor puede ejecutar el comando admin.
|
||
|
||
Ejemplos:
|
||
|
||
cm admin readonly enter
|
||
cm admin readonly status
|
||
|
||
== CMD_DESCRIPTION_ADMIN_READONLY ==
|
||
Permite habilitar/deshabilitar el modo solo-lectura en el servidor.
|
||
|
||
== CMD_USAGE_ADMIN_READONLY ==
|
||
Sintaxis:
|
||
|
||
cm admin readonly acción [servidor]
|
||
|
||
Acciones:
|
||
|
||
enter: habilita el modo de solo-lectura en el servidor.
|
||
leave: deshabilita el modo de solo-lectura en el servidor.
|
||
status: muestra el estado del modo de solo-lectura del servidor.
|
||
|
||
Opciones:
|
||
servidor: El comando se ejecuta en el servidor especificado
|
||
(servidor:puerto; usa 'cm help objectspec' para más información.)
|
||
Si no se especifica un servidor, el comando se ejecuta
|
||
en servidor del espacio de trabajo actual.
|
||
Si la ruta actual no está en un espacio de trabajo,
|
||
se ejecuta en el servidor por defecto configurado en
|
||
client.conf.
|
||
|
||
== CMD_HELP_ADMIN_READONLY ==
|
||
Notas:
|
||
Sólo el administrador del servidor puede ejecutar el comando readonly.
|
||
|
||
Ejemplos:
|
||
|
||
cm admin readonly enter diana:8086
|
||
cm admin readonly leave
|
||
|
||
== CMD_DESCRIPTION_ANNOTATE ==
|
||
Lista el contenido de un fichero o directorio, indicando para cada línea el propietario y la revisión en la cual fue introducida.
|
||
|
||
== CMD_USAGE_ANNOTATE ==
|
||
Sintaxis:
|
||
|
||
cm annotate spec [opciones]
|
||
|
||
spec Especificación del fichero que se va a anotar.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--format=cadena: Cadena con el formato de salida.
|
||
--dateformat=cadena: Cadena con el formato en que se escribirán las fechas.
|
||
--ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
|
||
--repository=repspec: Especificación del repositorio para calcular las
|
||
anotaciones. Por defecto, este comando utiliza el
|
||
repositorio del workspace cuya revisión está cargada.
|
||
Usa 'cm help objectspec' para más información sobre las
|
||
especificaciones de repositorio.
|
||
|
||
método_de_comparación:
|
||
none (por defecto)
|
||
eol (ignora diferencias en retornos de carro)
|
||
whitespaces (ignora diferencias en espacios en blanco)
|
||
eol&whitespaces (las dos anteriores)
|
||
|
||
== CMD_HELP_ANNOTATE ==
|
||
Notas:
|
||
|
||
Los items de tipo binario no están soportados por este commando.
|
||
|
||
Este comando admite una cadena de formato para mostrar la salida.
|
||
|
||
Los parametros de salida de este comando son los siguientes:
|
||
{owner}: El propietario de la línea.
|
||
{rev}: La especificación de la revision donde apareció la línea.
|
||
{content}: El contenido de la línea.
|
||
{date}: La fecha de la revisión donde fue introducida la línea.
|
||
{comment}: El comentario de la revisión donde apareció la línea.
|
||
{changeset}: El changeset de la revisión donde apareció la línea.
|
||
{line}: El número de línea dentro del fichero.
|
||
{branch}: La rama de la revisión donde apareció la línea.
|
||
{ismergerev}: La revisión donde apareció la línea fue creada en una
|
||
operación de merge.
|
||
|
||
Puede usar la opción --dateformat para especificar el formato en el que se
|
||
escribirán las fechas en pantalla.
|
||
|
||
El commando annotate puede recuperar los datos de un repositorio remoto
|
||
usando la opción --repository. Esto es útil cuando se trabaja con
|
||
repositorios replicados.
|
||
|
||
Ejemplos:
|
||
|
||
cm ann c:\workspace\src
|
||
cm ann c:\workspace\file.txt
|
||
cm ann c:\workspace\file.txt --format"{owner} {date} {content}"
|
||
cm ann c:\workspace\file.txt --format"{owner, -7} {content} [{date}]" \
|
||
--dateformat=yyyyMMdd
|
||
cm ann c:\workspace\file.txt --repository=centralRep@myserver:8084
|
||
|
||
cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666
|
||
(Anota el fichero empezando en el changeset 73666 y usando un server path.)
|
||
|
||
== CMD_DESCRIPTION_APPLY_LOCAL ==
|
||
Aplica los cambios locales (movidos, borrados y modificados localmente).
|
||
|
||
== CMD_USAGE_APPLY_LOCAL ==
|
||
Sintaxis:
|
||
|
||
cm applylocal [opciones] [rutas]
|
||
|
||
rutas: rutas de los cambios locales a aplicar. Por defecto son los de todo
|
||
el workspace.
|
||
|
||
Opciones:
|
||
|
||
--dependencies: Incluir las dependencias de los cambios locales entre los
|
||
ítems a proteger.
|
||
|
||
== CMD_HELP_APPLY_LOCAL ==
|
||
Notas:
|
||
|
||
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
|
||
todos los cambios locales en el espacio de trabajo.
|
||
|
||
- La operación se aplica siempre recursivamente desde la ruta indicada.
|
||
|
||
Ejemplos:
|
||
|
||
cm applylocal fichero1.txt fichero2.txt
|
||
cm applylocal . (Aplica los cambios locales para el directorio actual y
|
||
todo su contenido)
|
||
cm applylocal (Aplica los cambios locales para todo el workspace)
|
||
|
||
== CMD_DESCRIPTION_ARCHIVE ==
|
||
Almacena o restaura datos en almacenamiento externo de un conjunto dado de revisiones especificadas.
|
||
|
||
== CMD_USAGE_ARCHIVE ==
|
||
Sintaxis:
|
||
|
||
cm archive [revspec]+ [-c=comentario] [-f=path y nombre de fichero base]
|
||
cm archive [revspec]+ --restore
|
||
|
||
[revspec]+ una o más especificaciones de revisión. Se pueden leer desde la
|
||
entrada estándar (STDIN) con el modificador de comando "-". Usa
|
||
'cm help objectspec' para más información sobre especificaciones.
|
||
[-c | --comment] especifica el comentario que se agregará a los datos
|
||
archivados que se generen.
|
||
[-f | --file] especifica el nombre y (opcionalmente) el path de los ficheros
|
||
que se crearán para almacenar los datos por archivar.
|
||
|
||
[--restore] restaura los datos previamente archivados utilizando los
|
||
ficheros de almacenamiento generados.
|
||
|
||
== CMD_HELP_ARCHIVE ==
|
||
Notas:
|
||
|
||
El comando permite extraer datos desde la base de datos de un repositorio
|
||
y volcarlos en almacenamiento externo, ahorrando espacio en la base de
|
||
datos.
|
||
|
||
Usa 'cm help objectspec' para saber más sobre cómo especificar una revisión.
|
||
|
||
El comando también puede usarse para restaurar las revisiones 'archivadas',
|
||
volviéndolas a introducir en la base de datos (opción --restore).
|
||
|
||
El usuario que ejecute este comando debe ser administrador del servidor
|
||
de Plastic SCM (propietario del servidor de repositorios) para que se le
|
||
permita completar la operación.
|
||
|
||
Cada segmento de datos de las revisiones especificadas se almacenará en
|
||
un fichero diferente, prefijado por el contenido del argumento --file.
|
||
Este argumento puede contener tanto un 'path' completo con un prefijo de
|
||
nombre de archivo como únicamente dicho prefijo.
|
||
|
||
Una vez archivados los datos de las revisiones, se podrá acceder a ellos
|
||
de dos maneras:
|
||
|
||
1) Desde el cliente: el cliente de Plastic SCM detectará que los datos
|
||
fueron archivados y pedirá al usuario que indique la ubicación en la que
|
||
se encuentran. El usuario puede configurar las ubicaciones de los datos
|
||
externos creando un fichero 'externaldata.conf' (en las ubicaciones
|
||
estándar para ficheros de configuración, siguiendo las mismas reglas que se
|
||
aplican para el fichero client.conf) que contendrá los paths en los que
|
||
se encuentren los datos archivados.
|
||
|
||
2) Desde el servidor: de esta forma los usuarios estarán totalmente
|
||
aislados del hecho de que los datos han sido archivados, ya que las
|
||
peticiones se resolverán de forma transparente por el servidor. Para
|
||
ello, el administrador creará un fichero 'externaldata.conf' en el
|
||
directorio del servidor con los paths de los datos externos.
|
||
|
||
Para restaurar (unarchive) los datos de una revisión (o conjunto de
|
||
revisiones) los datos archivados deberán estar accesibles desde el cliente.
|
||
Por tanto, no es posible restaurar datos que estén siendo resueltos por el
|
||
servidor -método 2)- porque el cliente no será capaz de identificarlos como
|
||
archivados, al resolverse de forma transparente por el servidor. Si se están
|
||
resolviendo los datos externos en servidor, para poder restaurar será
|
||
necesario que el administrador elimine los volúmenes por restaurar de las
|
||
ubicaciones accesibles por el servidor o que configure 'externaldata.conf'
|
||
apropiadamente.
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto, y no se especifica un comentario al
|
||
archivar, el editor se abrirá automáticamente para que especifique
|
||
un comentario.
|
||
|
||
Especificaciones de revisión:
|
||
|
||
rev:path[#(brSpec|csetSpec|lbSpec)], ej: rev:fichero.cs#cs:5
|
||
rev:fichero.cs#br:/main/task1
|
||
|
||
Ejemplos:
|
||
|
||
Archivar bigfile.zip:
|
||
$ cm archive bigfile.zip#br:/main#13
|
||
|
||
Archivar todos los ficheros mayores de 25Mb
|
||
$ cm find "revs where size > 26214400" --format="{item}#{branch}" --nototal | cm archive --comment="volume00" -f="volume00" -
|
||
|
||
Restaurar todos los ficheros archivados mayores de 25 Mb
|
||
$ cm find "revs where size > 26214400 and archived='true'" --format="{item}#{branch}" --nototal | cm archive --restore
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE ==
|
||
Use este comando para administrar atributos.
|
||
|
||
== CMD_USAGE_ATTRIBUTE ==
|
||
Sintaxis:
|
||
|
||
cm attribute | att command [options]
|
||
|
||
Comandos:
|
||
|
||
create | mk
|
||
delete | rm
|
||
set
|
||
unset
|
||
rename
|
||
edit
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm attribute comando --usage
|
||
cm attribute comando --help
|
||
|
||
== CMD_HELP_ATTRIBUTE ==
|
||
Ejemplos:
|
||
|
||
cm attribute create estado
|
||
cm attribute set att:estado br:/main/SCM105 abierto
|
||
cm attribute unset att:estado br:/main/SCM105
|
||
cm attribute delete att:estado
|
||
cm attribute rename att:estado estadoBuild
|
||
cm attribute edit att:estado "Estado de la tarea en CI"
|
||
|
||
== CMD_DESCRIPTION_CHANGELIST ==
|
||
Permite organizar los cambios pendientes del espacio de trabajo en diferentes changelists.
|
||
|
||
== CMD_USAGE_CHANGELIST ==
|
||
Sintaxis:
|
||
|
||
a) Manejo de los objetos 'changelist':
|
||
|
||
cm changelist [list]
|
||
Muestra los changelists en el espacio de trabajo actual.
|
||
|
||
cm changelist add changelistName [descpription_text] [--persistent | --notpersistent]
|
||
Crea un nuevo changelist con nombre = "changelistName":
|
||
"descpription_text": descripción para el nuevo changelist.
|
||
"--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
|
||
contenido del changelist se queda vacío (los cambios que contiene se protegen o se
|
||
deshacen).
|
||
(valor por defecto: "--notpersistent").
|
||
|
||
cm changelist rm changelistName
|
||
Borra un changelist con nombre = "changelistName".
|
||
|
||
cm changelist edit changelistName [editParameterAction newValue] [--persistent | --notpersistent]
|
||
Modifica un changelist con nombre = "changelistName:
|
||
"editParameterAction": Posibles valores: "rename" | "description"
|
||
"--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
|
||
contenido del changelist se queda vacío (los cambios que contiene se deshacen o se les
|
||
ejecuta una operación de check-in.
|
||
(valor por defecto: "--notpersistent").
|
||
|
||
b) Manejo del contenido de un 'changelist' concreto:
|
||
|
||
cm changelist changelistName (add | rm) ruta(s)
|
||
Añade / elimina del changelist con nombre = "changelistName" el cambio que
|
||
coincide con la(s) ruta(s) especificada(s).
|
||
|
||
Opciones:
|
||
|
||
clist_name El nombre un changelist.
|
||
clist_desc La descripción un changelist.
|
||
action_name Utiliza '^rename' o '^description' para modificar un
|
||
changelist.
|
||
action_value Realiza la operación de renombrado o cambio de la descripción
|
||
cuando editas un changelist.
|
||
--persistent El changelist permacenerá en el workspace incluso si se ha ejecutado
|
||
una operación de check-in o de revert.
|
||
--notpersistent (Default) El changelist no permanecerá en el workspace.
|
||
--symlink Realizar la operacion de checkin sobre el fichero de link y no
|
||
al que apunta..
|
||
|
||
== CMD_HELP_CHANGELIST ==
|
||
Notas:
|
||
|
||
El comando 'changelist' permite administrar los changelists existentes en un
|
||
espacio de trabajo, así como los cambios que contiene cada uno de ellos.
|
||
|
||
Ejemplos del manejo de los changelists existentes en el espacio de trabajo:
|
||
|
||
$ cm changelist
|
||
(lista los changelists en el espacio de trabajo actual).
|
||
|
||
$ cm changelist add config_changes "dotConf files" --persistent
|
||
(crea un changelist con nombre "config_changes", descripción "dotConf files",
|
||
que además quedará persistente en el espacio de trabajo una vez que se
|
||
haga check-in o revert de dicho changelist).
|
||
|
||
$ cm changelist edit config_changes rename "config_files" --notpersistent
|
||
(edita el changelist con nombre "config_changes" y lo renombra a
|
||
"config_files". Además convierte el changelist en no persistente).
|
||
|
||
$ cm changelist edit config_changes --notpersistent
|
||
(edita el changelist con nombre "config_changes" y lo convierte en no persistente).
|
||
|
||
$ cm changelist rm "config_files"
|
||
(elimina el changelist "congig_files" del espacio de trabajo actual).
|
||
|
||
Ejemplos del manejo del contenido de un changelist:
|
||
(Nota, los ficheros que se manejan en los siguientes comandos han de
|
||
encontrarse en estado "Added" or "Checked-out".
|
||
|
||
$ cm changelist "config_files" add "foo.conf"
|
||
(añade el fichero "foo.conf" al changelist "config_files")
|
||
|
||
$ cm changelist "config_files" rm "foo.conf"
|
||
(elimina el fichero "foo.conf" del changelist "config_files" y
|
||
lo mueve al changelist por defecto del sistema).
|
||
|
||
== CMD_DESCRIPTION_CHANGESET ==
|
||
Ejecuta operaciones avanzadas sobre changesets.
|
||
|
||
== CMD_USAGE_CHANGESET ==
|
||
Sintaxis:
|
||
|
||
cm changeset comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
move | mv
|
||
delete | rm
|
||
editcomment | edit
|
||
|
||
Para obtener más información de cada uno de los comandos ejecute:
|
||
cm changeset command --usage
|
||
cm changeset command --help
|
||
|
||
== CMD_HELP_CHANGESET ==
|
||
Ejemplos:
|
||
|
||
cm changeset move cs:15@myrepo br:/main/scm005@myrepo
|
||
cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT ==
|
||
Modifica el comentario de un changeset.
|
||
|
||
== CMD_USAGE_CHANGESET_EDIT_COMMENT ==
|
||
Sintaxis:
|
||
|
||
cm changeset editcomment | edit <cset_spec> <nuevo_comentario>
|
||
|
||
Opciones:
|
||
|
||
spec_cset El changeset objetivo para editar su comentario.
|
||
Usa 'cm help objectspec' para más información.
|
||
nuevo_comentario El nuevo comentario que será asignado al changeset
|
||
seleccionado.
|
||
|
||
== CMD_HELP_CHANGESET_EDIT_COMMENT ==
|
||
Notas:
|
||
|
||
- La especificación del changeset objetivo debe ser válida.
|
||
|
||
Ejemplos:
|
||
|
||
cm changeset editcomment cs:15@myrepo "Olvidé añadir detalles importantes."
|
||
cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
|
||
"Este texto de comentario sustituirá al anterior."
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_MOVE ==
|
||
Mueve un changeset y todos sus descendientes en la misma rama a otra rama distinta.
|
||
|
||
== CMD_USAGE_CHANGESET_MOVE ==
|
||
Sintaxis:
|
||
|
||
cm changeset move | mv <spec_cset> <spec_branch>
|
||
|
||
Opciones:
|
||
|
||
spec_cset El primer changeset que debe moverse a una rama
|
||
diferente. Todos los changeset descendientes en la
|
||
misma rama se moverán también.
|
||
spec_branch La rama destino a la que mover los changesets
|
||
seleccionados. Debe estar vacía o no existir. En caso
|
||
de no existir, el comando la creará.
|
||
|
||
Usa 'cm help objectspec' para obtener más información sobre cómo indicar
|
||
especificaciones de changeset y rama.
|
||
|
||
== CMD_HELP_CHANGESET_MOVE ==
|
||
Notas:
|
||
|
||
- La especificación del changeset objetivo debe ser válida.
|
||
- La rama de destino debe estar vacía o no existir.
|
||
- Si la rama de destino no existe, el comando la creará.
|
||
- Los enlaces de merge no se verán afectados dado que las ramas no están
|
||
involucradas en ellos.
|
||
|
||
Ejemplos:
|
||
|
||
cm changeset move cs:15@myrepo br:/main/scm005@myrepo
|
||
cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
|
||
br:/hotfix/TL-352
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_DELETE ==
|
||
Elimina un changeset del repositorio.
|
||
|
||
== CMD_USAGE_CHANGESET_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm changeset delete | rm <spec_cset>
|
||
|
||
Opciones:
|
||
|
||
spec_cset El changeset seleccionado para eliminar. Debe cumplir
|
||
una serie de condiciones; ver ayuda completa para
|
||
más información. Usa 'cm help objectspec' para aprender
|
||
cómo construir las especificaciones.
|
||
|
||
== CMD_HELP_CHANGESET_DELETE ==
|
||
Notas:
|
||
|
||
- El changeset objetivo debe ser el último en su rama.
|
||
- No debe haber ningún otro changeset que tenga al objetivo como padre.
|
||
- El changeset objetivo no debe ser origen de merge ni estar envuelto en
|
||
el intervalo origen de un merge de intervalo.
|
||
- No debe haber etiquetas aplicadas al changeset objetivo.
|
||
- El changeset objetivo no puede ser el changeset raíz (cs:0)
|
||
|
||
Ejemplos:
|
||
|
||
cm changeset rm cs:4525@myrepo@myserver
|
||
cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
|
||
|
||
== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
|
||
Cambia la contraseña del usuario actual cuando la configuración de seguridad es usuario/contraseña.
|
||
|
||
== CMD_USAGE_CHANGEUSERPASSWORD ==
|
||
Sintaxis:
|
||
|
||
cm changeuserpassword
|
||
|
||
== CMD_HELP_CHANGEUSERPASSWORD ==
|
||
Notas:
|
||
|
||
Este comando solamente está disponible cuando el sistema de seguridad y
|
||
usuarios está configurado en modo de funcionamiento de usuario/contraseña.
|
||
|
||
Ejemplo:
|
||
|
||
cm changeuserpassword
|
||
|
||
== CMD_DESCRIPTION_CHECKCONNECTION ==
|
||
Comprueba la conexión del cliente de Plastic SCM contra el servidor.
|
||
|
||
== CMD_USAGE_CHECKCONNECTION ==
|
||
Sintaxis:
|
||
|
||
cm checkconnection
|
||
|
||
== CMD_HELP_CHECKCONNECTION ==
|
||
Notas:
|
||
|
||
Este comando retorna un mensaje indicando si hay una conexión valida contra
|
||
el servidor de Plastic SCM o no.
|
||
El comando comprueba si el usuario configurado es válido.
|
||
También comprueba si la versión del cliente es compatible con la del
|
||
servidor.
|
||
|
||
== CMD_DESCRIPTION_CHECKDB ==
|
||
Comprueba la integridad de las bases de datos.
|
||
|
||
== CMD_USAGE_CHECKDB ==
|
||
Sintaxis:
|
||
|
||
cm checkdatabase [spec]
|
||
|
||
spec: Especificación del servidor o de un repositorio.
|
||
Usa 'cm help objectspec' para aprender cómo indicar especificaciones
|
||
de servidor y repositorio.
|
||
|
||
== CMD_HELP_CHECKDB ==
|
||
Notas:
|
||
|
||
- Si no se especifica [spec], el comando utilizará el valor del servidor
|
||
del fichero client.conf.
|
||
|
||
Ejemplos:
|
||
|
||
cm checkdatabase repserver:localhost:8084
|
||
cm checkdatabase rep:default@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_CHECKIN ==
|
||
Crea una nueva revisión de un ítem.
|
||
|
||
== CMD_USAGE_CHECKIN ==
|
||
Se pueden proteger tanto ficheros como directorios.
|
||
Sintaxis:
|
||
|
||
cm checkin [opciones] [rutas]
|
||
|
||
rutas: rutas de los items a proteger.
|
||
|
||
Opciones:
|
||
|
||
--nchk: (No check) No chequea el contenido del fichero al proteger.
|
||
Ver notas para mas información.
|
||
--symlink: Realizar la operacion de checkin sobre el fichero de link y no
|
||
al que apunta.
|
||
-c: Añade un comentario al changeset creado en la operación de protección.
|
||
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
|
||
--all (-a): Los ítems cambiados, movidos y borrados localmente, en las
|
||
rutas dadas, también serán protegidos.
|
||
--dependencies: Incluir las dependencias de los cambios locales entre los
|
||
ítems a proteger.
|
||
--private: Los ítems privados también serán protegidos.
|
||
|
||
== CMD_HELP_CHECKIN ==
|
||
Notas:
|
||
|
||
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
|
||
todos los cambios pendientes en el espacio de trabajo.
|
||
|
||
- La operación de protección se aplica siempre recursivamente desde la
|
||
ruta indicada.
|
||
|
||
- Requisitos para proteger un ítem:
|
||
|
||
* El ítem debe estar controlado por Plastic SCM.
|
||
* El ítem ha de estar desprotegido.
|
||
* La revisión ha de tener cambios. Es decir, no se pueden proteger los
|
||
mismos datos. Para eliminar la desprotección descartando los cambios,
|
||
se utiliza el comando uncheckout.
|
||
* Con la opción --nchk, se fuerza la protección del ítem, sin comprobar
|
||
los datos.
|
||
|
||
Ejemplos:
|
||
|
||
cm checkin fichero1.txt fichero2.txt
|
||
cm checkin . (Protege el directorio actual)
|
||
(Proteger recursivamente el contenido de 'src')
|
||
cm checkin link --symlink
|
||
(Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
|
||
|
||
Comentarios:
|
||
|
||
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
|
||
|
||
cm ci file1.txt -c="my comment"
|
||
cm ci file1.txt -m "my comment"
|
||
|
||
Proteger 'changelist'. Ejemplo:
|
||
|
||
cm status --short --compact --changelist=pending_to_review | cm checkin -
|
||
(El comando listará los paths en el changelist llamado 'pending_to_review'
|
||
y dicha lista será redirigida a la entrada del comando 'checkin').
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto, y no se especifica un comentario al
|
||
hacer checkin, el editor se abrirá automáticamente para que especifique
|
||
un comentario.
|
||
|
||
== CMD_DESCRIPTION_CHECKOUT ==
|
||
Desprotege un ítem dado.
|
||
|
||
== CMD_USAGE_CHECKOUT ==
|
||
Sintaxis:
|
||
|
||
cm co [Opciones] paths
|
||
|
||
paths: Rutas de los elementos que se desean desproteger.
|
||
|
||
Opciones:
|
||
|
||
-R: Descender recursivamente dentro del ítem.
|
||
--symlink: Efectúar la desprotección sobre el fichero de link y no al que
|
||
apunta.
|
||
--ignorefailed: Si un ítem no se puede bloquear (no se le puede hacer un
|
||
checkout exclusivo), la operación de checkout continuará sin él.
|
||
|
||
== CMD_HELP_CHECKOUT ==
|
||
Notas:
|
||
|
||
Cuando un ítem del workspace se desea modificar, se debe desproteger.
|
||
La forma de desproteger un ítem es utilizando el comando co.
|
||
Se pueden desproteger tanto ficheros como directorios.
|
||
|
||
Requisitos: Para poder desproteger elementos:
|
||
|
||
El ítem debe estar controlado por Plastic.
|
||
El ítem debe estar protegido previamente.
|
||
|
||
Ejemplos:
|
||
|
||
cm co . (Desproteger el directorio actual)
|
||
cm co c:\workspace\fichero.txt
|
||
cm co fichero1.cs fichero2.cs
|
||
cm co –R c:\workspace\src (desprotege recursivamente todo el contenido de ‘src’)
|
||
cm co –R * (desprotege recursivamente todos los elementos del directorio actual)
|
||
cm co link --symlink
|
||
(desprotege el fichero de link y no el fichero al que apunta, disponible en UNIX)
|
||
|
||
== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
|
||
Comprueba la sintaxis de un selector.
|
||
|
||
== CMD_USAGE_CHECKSELECTORSYNTAX ==
|
||
Uso:
|
||
|
||
cm checkselectorsyntax [--file=file]
|
||
|
||
Opciones:
|
||
|
||
--file=file: El fichero del cual leer el selector; si no se especifica se
|
||
supone la entrada estándar.
|
||
|
||
== CMD_HELP_CHECKSELECTORSYNTAX ==
|
||
Notas:
|
||
|
||
Este comando lee el selector desde un fichero o desde la entrada estándar
|
||
y comprueba si su sintaxis es válida. Si falla la comprobación se muestra
|
||
en la salida estándar.
|
||
|
||
== CMD_DESCRIPTION_CHGREVTYPE ==
|
||
Cambia el tipo de todas las revisiones de un ítem.
|
||
|
||
== CMD_USAGE_CHGREVTYPE ==
|
||
Sintaxis:
|
||
|
||
cm changerevisiontype | chgrevtype | crt rutas --type=tipo
|
||
rutas: Rutas de los items para alterar el tipo de sus revisiones.
|
||
tipo: Tipo al que se fijarán las revisiones.
|
||
|
||
== CMD_HELP_CHGREVTYPE ==
|
||
Notas:
|
||
|
||
Este comando sólo puede aplicarse a ficheros, no a directorios.
|
||
El tipo especificado, ha de ser alguno soportado por el sistema:
|
||
bin
|
||
txt
|
||
...
|
||
|
||
Ejemplos:
|
||
|
||
cm changerevisiontype c:\workspace\file.txt --type=txt
|
||
(Cambia el tipo de revisión de 'file.txt' a 'txt'.)
|
||
|
||
cm chgrevtype comp.zip "image file.jpg" --type=bin
|
||
(Cambia el tipo de revisión de 'comp.zip' e "image file.jpg" a 'bin'.)
|
||
|
||
cm crt *.* --type=txt
|
||
(Cambia el tipo de revisión de todos los archivos a 'txt'.)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_EDIT ==
|
||
Cambia la información asociada a un trigger existente.
|
||
|
||
== CMD_USAGE_TRIGGER_EDIT ==
|
||
Sintaxis:
|
||
|
||
cm trigger edit subtipo-tipo posición [opciones]
|
||
|
||
subtipo-tipo: Tipo y subtipo de trigger.
|
||
Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
|
||
trigger disponibles. Algunos ejemplos son:
|
||
|
||
before-mkbranch
|
||
after-mkwokspace
|
||
after-setselector
|
||
|
||
posición: posición que ocupa el trigger que deseamos modificar.
|
||
|
||
Opciones:
|
||
|
||
--position=posición: nueva posición para el trigger especificado.
|
||
--name=nombre: nuevo nombre para el trigger especificado.
|
||
--script=ruta: nueva ruta de ejecución para el script del trigger
|
||
especificado. Si esta ruta comienza por "webtrigger ", se
|
||
considerará como web trigger. Consulte la ayuda del comando para obtener
|
||
detalles adicionales.
|
||
--filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
|
||
filtro de busqueda indicado.
|
||
--server=servidor: modifica el trigger en el servidor especificado.
|
||
Si no se especifica ninguno lo busca en el que se configuró en el cliente.
|
||
Usa 'cm help objectspec' para más información.
|
||
|
||
== CMD_HELP_TRIGGER_EDIT ==
|
||
Notas:
|
||
|
||
Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
|
||
como comando de trigger. En este caso, el trigger ejecutará una consulta
|
||
POST contra el URI especificado, en la que el cuerpo de la petición
|
||
contiene un diccionario JSON con las variables de entorno del trigger.
|
||
También estará presente una clave INPUT apuntando a un vector de cadenas de
|
||
texto para aquellos triggers que escriban en la entrada estándar de sus
|
||
comandos asociados.
|
||
|
||
Ejemplos:
|
||
cm trigger edit after-setselector 6 --name="Gestiona backup2" --script="/nuevo/path/al/script"
|
||
cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
|
||
|
||
cm tr edit after-add 2 --script="webtrigger http://myserver.org/api"
|
||
|
||
== CMD_DESCRIPTION_CODEREVIEW ==
|
||
Crea, edita o elimina revisiones de código.
|
||
|
||
== CMD_USAGE_CODEREVIEW ==
|
||
Sintaxis:
|
||
|
||
cm codereview <spec> <título> [--status=nombre_estado]
|
||
[--assignee=nombre_usuario] [--format=cad_formato]
|
||
[--repository=rep_spec]
|
||
|
||
spec Puede tratarse tanto de una especificación de
|
||
changeset como de una especificación de rama.
|
||
Determina el objetivo de la nueva revisión de código.
|
||
título Una cadena de texto para utilizarla como título de la
|
||
nueva revisión de código.
|
||
|
||
cm codereview -e <id> [--status=nombre_estado]
|
||
[--assignee=nombre_usuario] [--repository=rep_spec]
|
||
|
||
cm codereview -d <id> [id...] [--repository=rep_spec]
|
||
|
||
id Número identificador de la revisión de código. Puede
|
||
utilizarse también su GUID.
|
||
|
||
Opciones:
|
||
|
||
-e Edita los parámetros de una revisión de código
|
||
existente.
|
||
-d Elimina una revisión de código existente.
|
||
--status Modifica el estado de una revisión de código. Consulte
|
||
las notas para más información.
|
||
--assignee Modifica el usuario asignado a la revisión de código.
|
||
--repository Indica el repositorio que se utilizará por defecto.
|
||
--format Devuelve el mensaje de respuesta con el formato
|
||
especificado. Consulte la ayuda para más información.
|
||
|
||
== CMD_HELP_CODEREVIEW ==
|
||
Notas:
|
||
|
||
Este comando permite manipular revisiones de código: crear, editar
|
||
y eliminar revisiones de código de changesets o ramas.
|
||
|
||
Para crear una nueva revisión de código se requiere una especificación de
|
||
changeset o rama, junto con un título. Además, puede indicarse tanto
|
||
el usuario asignado (revisor de los cambios) como el estado inicial.
|
||
Como resultado se devolverá un ID (o GUID, si así se solicitó).
|
||
|
||
Para editar o eliminar una revisión de código existente se requiere el ID
|
||
(o GUID) de la misma. No se mostrarán mensajes si no se detectan errores.
|
||
|
||
El parámetro 'status' sólo puede tener como valor uno de los siguientes:
|
||
'Under review' (valor por defecto), 'Reviewed' o 'Rework required'.
|
||
|
||
El parámetro 'repository' se encuentra disponible para actuar sobre las
|
||
revisiones de código de un repositorio diferente al asociado al espacio
|
||
de trabajo actual (o para situaciones en las que no exista espacio de
|
||
trabajo).
|
||
|
||
Personalización del formato de salida:
|
||
|
||
Este comando acepta una cadena de formato para mostrar su salida.
|
||
Los parámetros de salida del comando son los siguientes:
|
||
{0} id
|
||
{1} guid
|
||
|
||
Por favor, tenga en cuenta que el parámetro --format sólo tiene efecto
|
||
al crear una nueva revisión de código.
|
||
|
||
Ejemplos:
|
||
|
||
cm codereview cs:1856@myrepo@myserver:8084 "Mi nueva revisión" --assignee=dummy
|
||
cm codereview br:/main/task001@myrepo@myserver:8084 "Mi nueva revisión" --status="Rework required" --assignee=newbie --format="{id} -> {guid}"
|
||
|
||
cm codereview 1367 -e --assignee=new_assignee
|
||
cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed
|
||
|
||
cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084
|
||
cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d
|
||
|
||
== CMD_DESCRIPTION_CRYPT ==
|
||
Encripta una contraseña.
|
||
|
||
== CMD_USAGE_CRYPT ==
|
||
Sintaxis:
|
||
|
||
cm crypt mypassword
|
||
|
||
mypassword Contraseña que se va a encriptar.
|
||
|
||
== CMD_HELP_CRYPT ==
|
||
Notas:
|
||
|
||
Este comando encripta una contraseña cualquiera pasada como argumento.
|
||
Está diseñado para encriptar las contraseñas de los ficheros de
|
||
configuración y aumentar así su seguridad.
|
||
|
||
Ejemplos:
|
||
|
||
cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
|
||
(Encripta la contraseña en el fichero de la base de datos de configuración:
|
||
db.conf)
|
||
|
||
== CMD_DESCRIPTION_DEACTIVATEUSER ==
|
||
Desactiva un usuario activado previamente.
|
||
|
||
== CMD_USAGE_DEACTIVATEUSER ==
|
||
Sintaxis:
|
||
|
||
cm deactivateuser nombre1 nombre2 ... [opciones]
|
||
|
||
nombre: Nombre del usuario que se desea desactivar.
|
||
|
||
Opciones:
|
||
|
||
--nosolveuser: Intenta desactivar el usuario especificado sin resolver
|
||
el nombre dado en el sistema de autenticación subyacente.
|
||
|
||
--server: desactiva el usuario en el servidor especificado.
|
||
|
||
== CMD_HELP_DEACTIVATEUSER ==
|
||
Notas:
|
||
|
||
Este comando deshabilita a un usuario para el uso de Plastic SCM.
|
||
|
||
Por favor, consulte la guía de usuario, o el comando "activateuser" para
|
||
obtener más información acerca de la habilitación de usuarios de Plastic SCM.
|
||
|
||
Para activar un usuario por primera vez, basta con utilizar Plastic SCM con
|
||
las credenciales del usuario a activar, siempre que no se sobrepase el
|
||
número máximo de usuarios autorizados.
|
||
|
||
El comando comprueba que el usuario a deshabilitar existe en el sistema de
|
||
autenticación subyacente (p.ej: ActiveDirectory, LDAP, Usuario/Contraseña ...).
|
||
|
||
Si se desea desactivar un usuario que ya no existe en el sistema de autenticación,
|
||
utilice la opción --nosolveuser
|
||
|
||
Ejemplos:
|
||
|
||
cm deactivateuser juan
|
||
cm deactivateuser juan --server=miservidor:8084
|
||
cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser
|
||
|
||
== CMD_DESCRIPTION_DIFF ==
|
||
Muestra las diferencias existentes entre dos revisiones o dos changesets
|
||
|
||
== CMD_USAGE_DIFF ==
|
||
Sintaxis:
|
||
|
||
cm differences [opciones] version1 [version2] [ruta]
|
||
|
||
version1: especificación de rama, primera revisión, changeset, etiqueta o
|
||
shelve a comparar.
|
||
version2: segunda especificación de revisión, changeset, etiqueta o shelve
|
||
a comparar.
|
||
ruta: muestra las diferencias en el fichero especificado
|
||
Usa 'cm help objectspec' para obtener más información sobre especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--added: imprime sólo las diferencias consistentes en items añadidos
|
||
--changed: imprime sólo las diferencias consistentes en items cambiados
|
||
--moved: imprime sólo las diferencias consistentes en items movidos
|
||
o renombrados
|
||
--deleted: imprime sólo las diferencias consistentes en items borrados
|
||
--all: imprime todas las diferencias
|
||
|
||
La primera letra de cada línea que se imprime denota el tipo de cambio:
|
||
|
||
A significa que el ítem fue añadido
|
||
C signnifica que el ítem fue cambiado
|
||
D significa que el ítem fue borrado
|
||
M significa que el ítem fue movido o renombrado. El ítem a la izquierda
|
||
es el nombre original, el ítem a la derecha es el nombre en destino
|
||
|
||
--clean: limpia las diferencias de la rama (omite las diferencias que vienen
|
||
de los merges
|
||
--download: almacena el contenido de las diferencias en la ruta especificada.
|
||
--fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace absolutas
|
||
siempre que sea posible.
|
||
--repositorypaths: imprime rutas de repositorio en lugar de rutas
|
||
de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
|
||
|
||
== CMD_HELP_DIFF ==
|
||
Notas:
|
||
|
||
Este comando muestra las diferencias en una rama si el segundo comando no se
|
||
especifica o entre dos revisiones, changesets o etiquetas si se especifica
|
||
el segundo parámetro.
|
||
|
||
|
||
Comparar ramas:
|
||
|
||
cm diff br:/main/task001
|
||
cm diff br:/main/task001 \doc\readme.txt
|
||
|
||
Comparar changesets:
|
||
|
||
cm diff 19
|
||
cm diff 19 25
|
||
cm diff cs:19 cs:25
|
||
cm diff cs:19 cs:23 --changed
|
||
cm diff cs:19 cs:23 --repositorypaths
|
||
cm diff cs:19 cs:23 \doc\readme.txt
|
||
|
||
Comparar etiquetas:
|
||
|
||
cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease
|
||
cm diff lb:tag_193.2 cs:34214
|
||
cm diff cs:31492 lb:tag_193.2
|
||
|
||
Comaprar shelves:
|
||
|
||
cm diff sh:2
|
||
cm diff sh:2 sh:4
|
||
|
||
Comparar revisiones:
|
||
cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
|
||
cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
|
||
serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_DIFFMETRICS ==
|
||
Muestra métricas sobre las diferencias de dos revisiones (líneas añadidas, cambiadas y borradas).
|
||
|
||
== CMD_USAGE_DIFFMETRICS ==
|
||
(líneas cambiadas, añadidas y borradas)
|
||
|
||
Sintaxis:
|
||
|
||
cm diffmetrics [opciones] spec_revision1 spec_revision2
|
||
|
||
spec_revision1: Especificación de revisión.
|
||
spec_revision2: La otra especificación de revisión.
|
||
|
||
Usa 'cm help objectspec' para más información sobre especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--format=str: Cadena de formato de salida. Ver notas para más información.
|
||
--encoding=tipo_codificación: Cambia la codificación.
|
||
--ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
|
||
|
||
tipo_codificación : ascii
|
||
unicode
|
||
bigendian
|
||
utf7
|
||
utf8
|
||
|
||
método_de_comparación:
|
||
none (por defecto)
|
||
eol (ignora diferencias en retornos de carra)
|
||
whitespaces (ignora diferencias en espacios en blanco)
|
||
eol&whitespaces (las dos anteriores)
|
||
|
||
== CMD_HELP_DIFFMETRICS ==
|
||
Notas:
|
||
|
||
Este comando acepta una cadena de formato para mostrar la salida.
|
||
Cada parámetro de salida se identifica con un número, y el usuario se
|
||
puede referir a él escribiéndolo entre los símbolos '{' y '}'.
|
||
|
||
Los parámetros de salida de este comando son los siguientes:
|
||
0: Número de líneas cambiadas
|
||
1: Número de líneas añadidas
|
||
2: Número de líneas borradas
|
||
|
||
Éstas son cadenas de formato válidas:
|
||
--format={0}{1}{2}
|
||
--format="Hay {0} líneas cambiadas, {1} líneas añadidas y {2} líneas borradas"
|
||
|
||
Ejemplos:
|
||
|
||
cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main/scm0211#4
|
||
cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main#3 --encoding=utf8 --ignore=whitespaces
|
||
|
||
== CMD_DESCRIPTION_FASTEXPORT ==
|
||
Exporta los datos de un repositorio de Plastic SCM a un formato fast-export.
|
||
|
||
== CMD_USAGE_FASTEXPORT ==
|
||
Sintaxis:
|
||
|
||
cm ^fast-export | ^fe <repspec> <fast-export-file>
|
||
[--^import-marks=<marks_file>]
|
||
[--^export-marks=<marks_file>]
|
||
[--^branchseparator=<chr_separator>]
|
||
[--^nodata] [--^from=<changesetid>] [--^to=<changesetid>]
|
||
Opciones:
|
||
|
||
repspec Repositorio cuyos datos serán exportados.
|
||
(Usa 'cm help objectspec' para aprender cómo especificar
|
||
un repositorio.)
|
||
fast-export-file Fichero con los datos del repositorio en formato
|
||
fast-export de Git.
|
||
--import-marks Fichero de marcas usado para la importación incremental.
|
||
Este fichero habrá sido previamente exportado con el
|
||
comando --export-marks. Los changesets descritos en este
|
||
fichero no serán importados porque ya lo fueron en una
|
||
importación previa.
|
||
--export-marks Fichero donde se guardan los changesets importados.
|
||
Este fichero podrá ser usado en una operación fast-import
|
||
para indicar los changesets que han sido importados.
|
||
--branchseparator Plastic SCM usa "/" como separador por defecto en la
|
||
jerarquía de ramas. Esta opción permite usar un carácter
|
||
como separador de jerarquía. Por ejemplo, la rama
|
||
main-task-sub será mapeada en Plastic como /main/task/sub.
|
||
--nodata Realiza la exportaciónExporta pero sin incluir datos.
|
||
Esta opción es útil si se desea comprobar que la
|
||
exportación se ejecutará sin problemas.
|
||
--from Exporta desde el changeset especificado.
|
||
--to Exporta hasta el changeset especificado.
|
||
|
||
== CMD_HELP_FASTEXPORT ==
|
||
Notas:
|
||
|
||
- Para importar un repositorio de Plastic a Git, usa el siguiente comando:
|
||
cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
|
||
|
||
- La exportación incremental es soportado usando un fichero de marcas que
|
||
contenga los changesets previamente importados (ficheros --import-marks y
|
||
--export-marks).
|
||
Esto significa que solamente los nuevos changesets que no fueron
|
||
exportados en una operación previa de fast-export serán exportados.
|
||
|
||
Ejemplos:
|
||
|
||
cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
|
||
(Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
|
||
en formato fast-export de Git y crea el fichero de marcas para poder
|
||
realizar una futura exportación incremental.)
|
||
|
||
cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
|
||
(Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
|
||
en formato Git fast-export desde el changeset '20'.)
|
||
|
||
== CMD_DESCRIPTION_FASTIMPORT ==
|
||
Importa datos de fast-export de Git en el repositorio.
|
||
|
||
== CMD_USAGE_FASTIMPORT ==
|
||
Sintaxis:
|
||
|
||
cm ^fast-import | ^fi <repspec> <fast-export-file>
|
||
[--^import-marks=<marks_file>]
|
||
[--^export-marks=<marks_file>]
|
||
[--^stats] [--^branchseparator=<chr_separator>]
|
||
[--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
|
||
|
||
Opciones:
|
||
|
||
repspec Repositorio en el cual se importarán los datos.
|
||
Si no existe en el momento de la operación, se
|
||
crea automáticamente. (Usa 'cm help objectspec'
|
||
para aprender cómo especificar un repositorio.)
|
||
fast-export-file Fichero con los datos en formato Git
|
||
fast-export.
|
||
--import-marks El fichero de etiquetas (marks) utilizado para
|
||
importaciones incrementales. Dicho fichero se
|
||
ha exportado previamente con --export-marks.
|
||
Los changesets descritos en este fichero no se
|
||
importarán porque ya existían de una importación
|
||
previa.
|
||
--export-marks El fichero en el cual se guardarán los changesets
|
||
importados. Dicho fichero se utiliza en una
|
||
operación posterior de fast-import para señalar
|
||
los changesets que ya han sido importados.
|
||
--stats Muestra estadísticas del proceso de importación.
|
||
--branchseparator Plastic SCM usa "/" como separador por defecto
|
||
en la jerarquía de ramas. Esta opción permite
|
||
usar un carácter como separador en esa
|
||
jerarquía. Por ejemplo, la rama main-task-sub
|
||
será mapeada en Plastic SCM como /main/task/sub.
|
||
--nodata Realiza la importación pero sin incluir datos.
|
||
Esta opción es útil si se desea comprobar que la
|
||
importación se ejecutará sin problemas.
|
||
--ignoremissingchangesets Los changesets que no pueden ser importados se
|
||
descartan y la operación de fast-import continúa
|
||
sin ellos.
|
||
--mastertomain Realiza la importación usando "main" en lugar
|
||
de "master".
|
||
|
||
== CMD_HELP_FASTIMPORT ==
|
||
Notas:
|
||
|
||
* Para exportar un repositorio de Git, utilice un comando como el
|
||
siguiente:
|
||
git fast-export --all -M --signed-tags=strip
|
||
--tag-of-filtered-object=drop> ..\git-fast-export.dat
|
||
La opción -M es importante para detectar ítems movidos.
|
||
|
||
* El repositorio especificado se crea en caso de que no exista.
|
||
|
||
* Se soporta una importación incremental utilizando ficheros de marcas que
|
||
contienen los changesets ya importados (--import-marks and --export-marks).
|
||
Esto significa que solamente se importarán los changesets que no fueron
|
||
importados previamente.
|
||
|
||
Ejemplos:
|
||
|
||
cm fast-import mynewrepo@atenea:8084 repo.fast-export
|
||
Importa el contenido exportado en el fichero repo.fast-export en el
|
||
repositorio "mynewrepo" del servidor atenea:8084.
|
||
|
||
cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks
|
||
Importa el contenido del fichero de exportaciones repo.fast-export en el
|
||
repositorio "mynewrepo" del servidor atenea:8084 y crea un archivo de
|
||
marcas para importaciones incrementales posteriores.
|
||
|
||
cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks
|
||
--export-marks=repo.marks
|
||
Importa el contenido del fichero repo.fast-export. Solamente se importarán
|
||
los changesets que no están en el fichero de marcas. Se utiliza el mismo
|
||
fichero de marcas para guardar los changesets que se importarán esta vez,
|
||
de nuevo con el fin de otra importación incremental posterior.
|
||
|
||
== CMD_DESCRIPTION_FILEINFO ==
|
||
Obtiene información detallada sobre elementos en el espacio de trabajo.
|
||
|
||
== CMD_USAGE_FILEINFO ==
|
||
Sintaxis:
|
||
|
||
cm fileinfo <item_path> [--fields=field_list] [--xml[=output_file]]
|
||
[--format=str_format] [--encoding=name]
|
||
|
||
item_path Elementos para mostrar, separados por espacios. Pueden
|
||
utilizarse comillas (") para aquellas rutas que
|
||
contengan espacios.
|
||
|
||
Opciones:
|
||
|
||
--fields Una cadena de valores separados por coma. Indica
|
||
qué campos se mostrarán por cada elemento.
|
||
Puede encontrar información adicional mediante el
|
||
comando 'cm help fileinfo'.
|
||
--xml Vuelca la salida en formato XML a la salida estándar.
|
||
Es posible especificar un fichero de salida. Esta opción
|
||
no puede combinarse con --format.
|
||
--format Obtiene el mensaje de salida en un formato específico.
|
||
Consulte las notas para más información. No puede
|
||
combinarse con --xml.
|
||
--symlink Aplica la operación fileinfo al enlace simbólico y no
|
||
a su destino.
|
||
--encoding Especifica la codificación de salida. P. ej.: UTF-8.
|
||
Consulte la documentación MSDN para obtener la lista de
|
||
codificaciones soportadas y su formato, al final de la
|
||
página. La columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_FILEINFO ==
|
||
Notas:
|
||
|
||
Este comando muestra una lista detallada de atributos para cada elemento
|
||
seleccionado. Cada atributo se muestra en una nueva línea por defecto.
|
||
|
||
Se puede modificar la lista de atributos para mostrar únicamente los
|
||
atributos que el usuario necesite. A tal efecto se puede utilizar el
|
||
argumento --fields=lista, que acepta una cadena de nombres de atributo
|
||
separados por comas. De este modo, solo se mostrarán aquellos argumentos
|
||
cuyo nombre esté presente en la lista.
|
||
|
||
Revision Head Changeset:
|
||
|
||
Esta opción está desactivada por defecto. Tenga en cuenta que la
|
||
recuperación de este atributo es notablemete más lenta que el resto, por
|
||
lo que recomendamos al usuario agrupar tantos ficheros por ejecución como
|
||
sea posible. Esto mejora los tiempos de ejecución, al evitar numerosas
|
||
ejecuciones 'cm fileinfo' separadas.
|
||
Adicionalmente, esta característica no se encuentra disponible actualmente
|
||
para directorios controlados por PlasticSCM.
|
||
|
||
A continuación se encuentra la lista completa de nombres de atributo. Los
|
||
nombres marcados con asterisco ('*') no se muestran por defecto:
|
||
ClientPath Ruta local del elemento en disco.
|
||
RelativePath Ruta del elemento relativa al workspace.
|
||
ServerPath Ruta del elemento en el repositorio.
|
||
(Nota: las rutas afectadas por workspace
|
||
transformables no están soportadas actualmente)
|
||
Size Tamaño del elemento.
|
||
Hash Suma 'hash' del elemento
|
||
Owner Nombre del usuario propietario del elemento.
|
||
RevisionHeadChangeset* Changeset de la revisión cargada en el último
|
||
changeset de la rama (ver párrafo anterior).
|
||
RevisionChangeset Changeset de la revisión cargada en el workspace
|
||
RepSpec Especificación del repositorio al que pertenece
|
||
el elemento (repositorio@servidor).
|
||
Status Estado actual del elemento en el espacio de
|
||
trabajo (añadido, eliminado, checkout, etc.).
|
||
Type Tipo de la revisión (texto, binario, directorio,
|
||
enlace simbólico o desconocido).
|
||
Changelist Lista de cambios a la que pertenece el elemento
|
||
(si la hubiere).
|
||
IsLocked* Muestra si el elemento está bloqueado o no.
|
||
LockedBy* Usuario que bloqueó el elemento mediante
|
||
checkout exclusivo.
|
||
LockedWhere* Localización del elemento bloqueado mediante
|
||
checkout exclusivo.
|
||
IsUnderXlink Muestra si el elemento se encuentra bajo un
|
||
Xlink o no.
|
||
UnderXlinkTarget Repositorio destino del Xlink en que se
|
||
encuentra el elemento, si lo hubiere.
|
||
UnderXlinkPath Ruta en el repositorio apuntado por el Xlink
|
||
en que se encuentra el elemento, si lo hubiere.
|
||
UnderXlinkWritable Muestra si el Xlink bajo el que se encuentra el
|
||
elemento es de escritura o no.
|
||
UnderXlinkRelative Muestra si el Xlink bajo el que se encuentra el
|
||
elemento es relativo o no.
|
||
IsXlink Muestra si el elemento es un Xlink o no.
|
||
XlinkTarget Repositorio objetivo del Xlink, si el elemento
|
||
lo es.
|
||
XlinkName Nombre del Xlink, si el elemento lo es.
|
||
XlinkWritable Muestra si el elemento es un Xlink de escritura
|
||
o no.
|
||
XlinkRelative Muestra si el elemento es un Xlink relativo o no
|
||
|
||
Personalización del formato de salida:
|
||
|
||
Este comando acepta una cadena de formato para mostrar su salida.
|
||
Los parámetros de salida de este comando son los siguientes:
|
||
ClientPath
|
||
RelativePath
|
||
ServerPath
|
||
Size
|
||
Hash
|
||
Owner
|
||
RevisionHeadChangeset
|
||
RevisionChangeset
|
||
Status
|
||
Type
|
||
Changelist
|
||
IsLocked
|
||
LockedBy
|
||
LockedWhere
|
||
IsUnderXlink
|
||
UnderXlinkTarget
|
||
UnderXlinkPath
|
||
UnderXlinkWritable
|
||
UnderXlinkRelative
|
||
IsXlink
|
||
XlinkTarget
|
||
XlinkName
|
||
XlinkWritable
|
||
XlinkRelative
|
||
RepSpec
|
||
|
||
Tenga en cuenta que las opciones --format y --xml son mutuamente
|
||
exclusivas, por lo que no se pueden utilizar simultáneamente.
|
||
|
||
Ejemplos:
|
||
|
||
cm fileinfo file1.txt file2.txt dir/
|
||
cm fileinfo "New Project.csproj" --xml
|
||
cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy
|
||
cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml
|
||
cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}"
|
||
|
||
== CMD_DESCRIPTION_FIND_QUERY ==
|
||
Obtiene una serie de objetos en base a unos criterios de búsqueda.
|
||
|
||
== CMD_USAGE_FIND_QUERY ==
|
||
Sintaxis:
|
||
|
||
cm find objeto [where str_condiciones]
|
||
[on repository 'repspec' | on repositories <'repspec'>+]
|
||
[--format=str_format] [--dateformat=date_format]
|
||
[--nototal] [--file=dump_file] [--xml] [--encoding=name]
|
||
|
||
|
||
cm find objeto [where condiciones] [on repositorios] [opciones]
|
||
|
||
objeto Objeto a buscar.
|
||
Lee la guía sobre'cm find' para ver los objetos que
|
||
puedes buscar:
|
||
https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
|
||
|
||
Opciones:
|
||
|
||
condiciones Condiciones de búsqueda sobre los atributos del objeto.
|
||
repspec Nombre o especificación del repositorio donde buscar.
|
||
En el caso de "repositories", debes separar las
|
||
especificaciones (repspec) por comas.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre las especificaciones de repositorios.
|
||
--format Devuelve el mensaje de salida en un formato determinado.
|
||
Lee la guía sobre 'cm find' para ver todos los atributos
|
||
de los objetos que puedes usar para formatear la salida:
|
||
https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
|
||
--dateformat Formato de las fechas. Por defecto "dd/MM/yyy HH:mm:ss".
|
||
--nototal No muestra el número total de registros.
|
||
--file Fichero en el que se vuelcan los resultados.
|
||
--xml Formatea salida como XML.
|
||
--encoding Especifica la codificación con la que se quiere mostrar
|
||
la salida del comando o escribir el fichero de
|
||
resultado, por ejemplo, utf-8.
|
||
Consulte la documentación de MSDN para obtener
|
||
la tabla completa de codificaciones soportadas y su
|
||
formato (al final de la página, en la columna "Name"):
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_FIND_QUERY ==
|
||
Notas:
|
||
|
||
Si no se especifica ningún repositorio, la búsqueda se realiza sobre el
|
||
repositorio actual.
|
||
|
||
Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de
|
||
comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a
|
||
estos operadores como redirecciones de E/S. Por lo que es necesario escribir
|
||
la búsqueda entre dobles comillas.
|
||
|
||
El comando cm find acepta una cadena de formato para mostrar la salida.
|
||
Cada parámetro de salida se identifica con un nombre, y el usuario se
|
||
puede referir a él escribiéndolo entre los símbolos '{' y '}'.
|
||
Los parámetros de salida se corresponden en la mayoría de los casos con
|
||
los atributos del objeto.
|
||
|
||
Estas son cadenas de formato válidas:
|
||
--format={id}{date}{name}
|
||
--format="{item}#{branch} con fecha {date}"
|
||
|
||
Consideraciones sobre XML y codificación (encoding):
|
||
|
||
Cuando se especifica la opción --xml, se muestra por consola el resultado
|
||
como un texto XML. Por defecto se utiliza la codificación estándar del
|
||
sistema operativo. Es posible que si hay caracteres extraños (tildes o
|
||
eñes), no se visualicen correctamente en la consola. Pero si se redirige la
|
||
salida a un fichero, el contenido se visualizará correctamente.
|
||
Cuando se especifican simultáneamente las opciones --xml y --file, se
|
||
utiliza por defecto la codificación UTF-8.
|
||
|
||
Ejemplos:
|
||
|
||
cm find revision
|
||
cm find revision "where changeset = 23 and owner = 'user'"
|
||
cm find branch "on repository 'rep1'"
|
||
cm find label "on repositories 'rep1', 'rep:default@localhost:8084'"
|
||
cm find branch "where parent = 'br:/main' on repository 'rep1'"
|
||
cm find revision "where item = 'item:.'" --format="{item}#{branch}"
|
||
cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml
|
||
|
||
== CMD_DESCRIPTION_FINDCHANGED ==
|
||
Obtiene una lista de los ficheros que se han modificado fuera del control de
|
||
Plastic SCM. Este comando se considera obsoleto y se mantiene únicamente por
|
||
retrocompatibilidad. Reemplazado por cm status.
|
||
|
||
== CMD_USAGE_FINDCHANGED ==
|
||
fuera del control de Plastic
|
||
|
||
Sintaxis:
|
||
|
||
cm findchanged [opciones][ruta]
|
||
|
||
ruta: Ruta inicial de búsqueda.
|
||
|
||
Opciones:
|
||
|
||
-R|-r|--recursive Descender recursivamente dentro de directorios.
|
||
--checkcontent Comparar los ficheros por el contenido.
|
||
--onlychanged Con esta opción los elementos desprotegidos no serán
|
||
devueltos entre los cambiados.
|
||
|
||
== CMD_HELP_FINDCHANGED ==
|
||
Notas:
|
||
|
||
El comando findchanged se utiliza para identificar los items que se han
|
||
modificado en el espacio de trabajo. Si no se utiliza opción
|
||
–checkcontent solamente se comparan los timestamp para obtener los ficheros
|
||
cambiados. Si se utiliza la opción –checkcontent, se compara el contenido del
|
||
fichero.
|
||
|
||
Cuando por alguna razón no podemos obtener conexión con el servidor y se
|
||
trabaja desconectado, y se modifica una serie de ficheros, se puede utilizar
|
||
este comando para identificar los elementos cambiados.
|
||
|
||
Ejemplos:
|
||
|
||
cm findchanged .
|
||
cm findchanged -R . | cm checkout - (desprotege los elementos cambiados)
|
||
|
||
== CMD_DESCRIPTION_FINDCHECKEDOUT ==
|
||
Obtiene un listado de desprotecciones pendientes. Este comando está deprecado y
|
||
se mantiene únicamente por retrocompatibilidad. Reemplazado por cm status.
|
||
|
||
== CMD_USAGE_FINDCHECKEDOUT ==
|
||
Sintaxis:
|
||
|
||
cm findcheckouts [opciones]
|
||
|
||
Opciones:
|
||
|
||
--all: Muestra desprotecciones de todos los usuarios.
|
||
--format=cadena: Cadena de formato de salida.
|
||
Ver notas para más información.
|
||
|
||
== CMD_HELP_FINDCHECKEDOUT ==
|
||
Notas:
|
||
|
||
Este comando se utiliza para encontrar las protecciones pendientes en un
|
||
espacio de trabajo. Se puede combinar con el comando 'checkin' para
|
||
proteger todos los elementos desprotegidos, utilizando la redirección de
|
||
la salida estándar. Vea los ejemplos para más información.
|
||
|
||
Este comando acepta una cadena de formato para mostrar la salida.
|
||
Cada parámetro de salida se identifica con un número, y el usuario se puede
|
||
referir a él escribiéndolo entre los símbolos '{' y '}'.
|
||
|
||
Los parámetros de salida de este comando son los siguientes:
|
||
0: Fecha de modificación.
|
||
1: Propietario.
|
||
2: Información del espacio de trabajo.
|
||
3: Máquina.
|
||
4: Ruta del ítem.
|
||
5: Información de repositorio y rama.
|
||
|
||
Éstas son cadenas de formato válidas:
|
||
--format={0}{1}{2}{3}{4}{5}
|
||
--format="El fichero {4} está desprotegido por el usuario {1}"
|
||
|
||
Ejemplos:
|
||
|
||
cm findcheckouts
|
||
cm findcheckouts --all
|
||
cm findcheckouts --format={4} | cm checkin -
|
||
(Protege todos los items desprotegidos)
|
||
cm findcheckouts --format={4} | cm uncheckout -
|
||
(Deshace las desprotecciones de todos los items desprotegidos)
|
||
|
||
== CMD_DESCRIPTION_FINDPRIVATE ==
|
||
Obtiene un listado de items privados en el espacio de trabajo. Este comando
|
||
está deprecado y se mantiene únicamente por retrocompatibilidad. Reemplazado
|
||
por cm status.
|
||
|
||
== CMD_USAGE_FINDPRIVATE ==
|
||
Sintaxis:
|
||
|
||
cm findprivate [opciones][ruta]
|
||
|
||
rutas: Ruta inicial de búsqueda.
|
||
|
||
Opciones:
|
||
|
||
-R|-r|--recursive Descender recursivamente dentro de directorios.
|
||
--exclusions Ignora los elementos excluidos.
|
||
|
||
== CMD_HELP_FINDPRIVATE ==
|
||
Notas:
|
||
|
||
Si no se proporciona una ruta, se tomará el directorio actual.
|
||
|
||
Este comando es útil para añadir solamente los elementos privados de una
|
||
ruta al repositorio, utilizando la redirección de la salida estándar.
|
||
Ver ejemplos.
|
||
|
||
Ejemplos:
|
||
|
||
cm findprivate .
|
||
cm findprivate -R | cm add - --coparent
|
||
(busca recursivamente items privados, y los añade al
|
||
repositorio desprotegiendo los padres si es necesario)
|
||
|
||
== CMD_DESCRIPTION_GETCONFIG ==
|
||
Obtiene la información de configuración solicitada.
|
||
|
||
== CMD_USAGE_GETCONFIG ==
|
||
Sintaxis:
|
||
|
||
cm getconfig setting
|
||
|
||
setting: Parámetro de configuración que se quiere consultar.
|
||
Los parámetros disponibles son:
|
||
setfileasreadonly : indica si los ficheros protegidos se dejan en sólo lectura.
|
||
location: devuelve la ruta del fichero de configuración del cliente.
|
||
extensionworkingmode: devuelve el modo de trabajo de la extensión.
|
||
extensionprefix: devuelve el prefijo de la extensión configurada.
|
||
defaultrepserver: devuelve el servidor de repositorios configurado por defecto.
|
||
|
||
Devuelve el valor de la clave solicitada.
|
||
|
||
== CMD_HELP_GETCONFIG ==
|
||
Ejemplos:
|
||
|
||
cm getconfig setfileasreadonly
|
||
|
||
== CMD_DESCRIPTION_GETFILE ==
|
||
Obtiene una revisión especificada.
|
||
|
||
== CMD_USAGE_GETFILE ==
|
||
Sintaxis:
|
||
|
||
cm cat spec [opciones]
|
||
|
||
spec: Especificación de la revisión. Usa 'cm help objectspec' para obtener
|
||
más información sobre especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--file=fichero: Fichero de salida, opcional. Si no se especifica
|
||
el resultado, se escribe en la salida estándar.
|
||
--debug: Cuando se especifica la revisión de un directorio, el
|
||
comando muestra su id de revisión y sus permisos.
|
||
|
||
== CMD_HELP_GETFILE ==
|
||
Notas:
|
||
|
||
Una especificación de revisión se define como:
|
||
|
||
[rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
|
||
[rev:]revid:rev_id[@repSpec]
|
||
[rev:]serverpath:ruta_de_servidor#(brSpec|csetSpec|lbSpec)[@repSpec]
|
||
|
||
brSpec: br:NOMBRE_RAMA[#LAST]
|
||
csetSpec: cs:NUMERO_CSET
|
||
lbSpec: lb:NOMBRE_ETIQUETA
|
||
repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
|
||
|
||
Ejemplos:
|
||
|
||
Obtener la última revisión de la rama main del ítem fichero.txt:
|
||
cm cat fichero.txt#br:/main
|
||
|
||
Obtener la revisión del changeset 3 del ítem fichero.txt y escribirlo en el
|
||
fichero tmp.txt:
|
||
cm cat fichero.txt#cs:3 --file=tmp.txt
|
||
|
||
Obtener la revisión id 1230:
|
||
cm cat revid:1230@rep:myrepos@repserver:london:8084
|
||
|
||
Obtener el fichero /src/foo.c en el último changeset de la rama
|
||
br:/main/task003 del repositorio 'myrepo':
|
||
cm cat serverpath:/src/foo.c#br:/main/task003@myrepo
|
||
|
||
== CMD_DESCRIPTION_GETREVISION ==
|
||
Trae una revisión especifica al espacio de trabajo actual
|
||
|
||
== CMD_USAGE_GETREVISION ==
|
||
Sintaxis:
|
||
|
||
cm getrevision revision_spec
|
||
|
||
revision_spec: Especificación de la revisión que se desea obtener. Usa
|
||
'cm help objectspec' para obtener más información sobre especificaciones.
|
||
|
||
== CMD_HELP_GETREVISION ==
|
||
Notas:
|
||
|
||
Una especificación de revisión se define como:
|
||
|
||
[rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
|
||
[rev:]revid:[#(brSpec|csetSpec|lbSpec)][@repSpec]
|
||
|
||
brSpec: br:NOMBRE_RAMA[#LAST]
|
||
csetSpec: cs:NUMERO_CSET
|
||
lbSpec: lb:NOMBRE_ETIQUETA
|
||
repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
|
||
|
||
Ejemplos:
|
||
|
||
cm getrevision fichero.txt#cs:3 (Establece la revisión del changeset 3 del
|
||
fichero.txt)
|
||
|
||
== CMD_DESCRIPTION_GETSTATUS ==
|
||
Obtiene el estado de un ítem.
|
||
|
||
== CMD_USAGE_GETSTATUS ==
|
||
Sintaxis:
|
||
|
||
cm getstatus [opciones] rutas
|
||
|
||
rutas: Rutas de los items sobre los que se desea consultar su estado.
|
||
|
||
Opciones:
|
||
|
||
-R|-r|--recursive Descender recursivamente dentro de directorios.
|
||
|
||
== CMD_HELP_GETSTATUS ==
|
||
Notas:
|
||
|
||
Los estados posibles de un ítem son los siguientes:
|
||
privado: El ítem no está controlado por Plastic SCM.
|
||
desprotegido: El ítem está desprotegido, y por tanto controlado por Plastic SCM.
|
||
protegido: El ítem está protegido, y por tanto controlado por Plastic SCM.
|
||
|
||
Ejemplos:
|
||
|
||
cm getstatus fichero1.txt fichero2.txt
|
||
|
||
== CMD_DESCRIPTION_GETTASKBRANCHES ==
|
||
Obtiene las ramas asociadas con la tarea especificada.
|
||
|
||
== CMD_USAGE_GETTASKBRANCHES ==
|
||
Sintaxis:
|
||
|
||
cm gettaskbranches tarea [opciones]
|
||
|
||
tarea: el identificador de la tarea.
|
||
|
||
Opciones:
|
||
|
||
--format=cadena: Cadena de formato de salida.
|
||
--dateformat: Formato de las fechas.
|
||
|
||
== CMD_HELP_GETTASKBRANCHES ==
|
||
Notas:
|
||
|
||
Este comando admite una cadena de formato para mostrar la salida.
|
||
|
||
Los parametros de salida de este comando son los siguientes:
|
||
tab: Introduce un tabulador.
|
||
newline: Introduce una nueva línea.
|
||
name: El nombre de la rama.
|
||
owner: El propietario de la rama.
|
||
date: La fecha en la que fue creada la rama.
|
||
type: El tipo de la rama ('T' si es smart o 'F' si no lo es).
|
||
parent: La rama padre.
|
||
comment: El comentario de la rama.
|
||
repname: El repositorio donde se encuentra la rama.
|
||
repserver: El nombre del servidor.
|
||
|
||
Ejemplos:
|
||
|
||
cm gtb 4311
|
||
cm gtb 4311 --format="br:{name}"
|
||
cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss"
|
||
|
||
== CMD_DESCRIPTION_GETWWI ==
|
||
Muestra información acerca del selecetor del espacio de trabajo.
|
||
|
||
== CMD_USAGE_GETWWI ==
|
||
Uso:
|
||
|
||
cm wi [ruta_workspace]
|
||
|
||
ruta_workspace: Ruta en disco del workspace a consultar.
|
||
|
||
== CMD_HELP_GETWWI ==
|
||
Notas:
|
||
Este comando muestra información acerca de la configuración del selector
|
||
del espacio de trabajo (en qué repositorio, rama y etiqueta se está
|
||
trabajando).
|
||
|
||
Ejemplos:
|
||
cm wi c:\mywk
|
||
|
||
== CMD_DESCRIPTION_GWP ==
|
||
Obtiene información acerca del workspace a partir de un path.
|
||
|
||
== CMD_USAGE_GWP ==
|
||
Uso:
|
||
|
||
cm getworkspacefrompath | gwp <ruta> [--format=str_format]
|
||
|
||
ruta Fichero o directorio en disco.
|
||
|
||
Opciones:
|
||
--format Devuelve el mensaje de salida con un formato determinado.
|
||
Más información en las notas.
|
||
|
||
== CMD_HELP_GWP ==
|
||
Notas:
|
||
|
||
Este comando muestra por pantalla información del workspace al que
|
||
pertenece una ruta determinada.
|
||
|
||
Este comando acepta una cadena especificando el formato con el que se
|
||
debe mostrar la salida. Los parámetros de salida son los siguientes:
|
||
{0} | {wkname} Nombre del workspace.
|
||
{1} | {wkpath} Ruta del workspace.
|
||
{2} | {machine} Nombre de la máquina del workspace.
|
||
{3} | {owner} Propietario del workspace.
|
||
{4} | {guid} GUID del workspace.
|
||
|
||
{tab} Inserta un tabulador.
|
||
{newline} Inserta un salto de línea.
|
||
|
||
Ejemplos:
|
||
|
||
cm gwp c:\myworkspace\code\file1.cpp --format="Nombre del wkspace: {wkname}"
|
||
|
||
== CMD_DESCRIPTION_HELP ==
|
||
Muestra ayuda acerca de un comando.
|
||
|
||
== CMD_USAGE_HELP ==
|
||
Sintaxis:
|
||
|
||
cm help nombre_comando
|
||
|
||
== CMD_HELP_HELP ==
|
||
|
||
== CMD_DESCRIPTION_IOSTATS ==
|
||
Muestra estadísticas de rendimiento relativas al hardware
|
||
|
||
== CMD_USAGE_IOSTATS ==
|
||
Sintaxis:
|
||
|
||
cm iostats [server_spec] list_of_tests [options]
|
||
|
||
server_spec: Servidor válido de PlasticSCM para ejecutar las pruebas de red,
|
||
tales como "serverUploadTest" y/o "serverDownloadTest".
|
||
Si no se especifica ningún parámetro, se intentará usar el servidor
|
||
configureado por defecto.
|
||
Usa 'cm help objectspec' para aprender cómo indicar la especificación
|
||
del servidor.
|
||
|
||
list_of_tests: Test disponibles:
|
||
|
||
--serverUploadTest: mide la velocidad de subida de datos a través de la
|
||
red desde el cliente de Plastic SCM al servidor.
|
||
|
||
--serverDownloadTest: mide la velocidad de bajada de datos a través de
|
||
la red desde el servidor de Plastic SCM al cliente.
|
||
|
||
--diskTest: mide la velocidad de escritura y lectura a disco.
|
||
|
||
--systemNetworkUsage: muestra el uso actual de los recursos de red del
|
||
sistema. (Se usan contadores de rendimiento del sistema operativo).
|
||
(Sólo disponible en plataformas Windows).
|
||
|
||
--systemDiskUsage: muestra el uso actual de los discos físico del
|
||
sistema. (Se usan contadores de rendimiento del sistema operativo).
|
||
(Sólo disponible en plataformas Windows).
|
||
|
||
Opciones (options):
|
||
|
||
--netTotalMB: cantidad de datos de usuario (en MegaBytes) que se
|
||
transmitirán en un test de red, tales como"serverDownloadTest"
|
||
o "serverUploadTest".
|
||
Debe ser un valor comprendido entre "4" y "512" (por defecto: 16).
|
||
|
||
--networkIterations: indica el número de iteraciones para los tests de red:
|
||
"serverUploadTest" o "serverDownloadTest".
|
||
Debe ser un valor comprendido entre "1" y "100". (por defecto: 1).
|
||
|
||
--diskDataSize: cantidad de datos (en MegaBytes) que se escribirán y leerán
|
||
en el test de disco ("diskTest").
|
||
Debe ser un valor comprendido entre "100" y "4096". (por defecto: 512).
|
||
|
||
--diskTestPath: Ruta donde el test de disco escribe los datos para la
|
||
realización de la prueba. Si no se especifica ningún parámetro, se
|
||
intentará usar un directorio dentro del directorio temporal del sistema.
|
||
|
||
--systemDisplayTime: Espacio de tiempo (en segundos) en el que se muestra el uso
|
||
de los recursos del sistema. Éste parámetro es tenido en cuenta para los tests:
|
||
"systemNetworkUsage" y "systemDiskUsage".
|
||
Debe ser un valor comprendido entre "1" y "3600". (por defecto: 5 segundos).
|
||
|
||
--systemDisplayTimeInterval: Periodo de tiempo (en segundos) entre las muestras
|
||
que se toman sobre el uso de los recursos del sistema. Este parámetro
|
||
es tenido en cuenta para los tests: "systemNetworkUsage" y "systemDiskUsage".
|
||
Debe ser un valor comprendido entre "1" y "60". (por defecto: 1 segundo).
|
||
|
||
Ejemplo:
|
||
|
||
cm iostats MYSERVER:8087 --serverUploadTest --serverDownloadTest --netTotalMB=32
|
||
|
||
== CMD_HELP_IOSTATS ==
|
||
Notas:
|
||
|
||
Éste comando necesita un servidor de Plastic SCM que se usará para las
|
||
pruebas de velocidad de la red ("serverUploadTest" y/o
|
||
"serverDownloadTest").
|
||
|
||
El parámetro "--diskTestPath" debe apuntar a una ruta que pertenezca a la
|
||
unidad física de disco que se pretende probar.
|
||
Si no se especifica ninguna ruta, el comando intentará utilizar la ruta
|
||
de almacenamiento temporal del sistema.
|
||
La unidad de disco del directorio de pruebas de disco debe contener suficiente
|
||
espacio libre para ejecutar la prueba.
|
||
|
||
Durante la ejecución del comando se puede experimentar una caída de rendimiento
|
||
de la máquina debido a las pruebas realizadas.
|
||
|
||
== CMD_DESCRIPTION_ISSUETRACKER ==
|
||
Obtiene, actualiza o busca el estado de una tarea del sistema de incidencias especificado.
|
||
|
||
== CMD_USAGE_ISSUETRACKER ==
|
||
Sintaxis:
|
||
|
||
cm issuetracker <name> status get <task_id> <parameter>+
|
||
cm issuetracker <name> status update <task_id> <status> <parameter>+
|
||
cm issuetracker <name> status find <status> <parameter>+
|
||
cm issuetracker <name> connection check <parameter>+
|
||
|
||
name: Nombre del sistema de seguimiento de incidencias contra
|
||
el que se va a conectar.
|
||
Sólo Jira está soportado por el momento.
|
||
task_id: Número de la tarea que se quiere consultar o actualizar.
|
||
status: Un estado de tarea válido en el sistema especificado.
|
||
|
||
Parámetros de Jira (son todos obligatorios):
|
||
|
||
--user=user El usuario a autenticar.
|
||
--password=pwd La contraseña a autenticar.
|
||
--host=url La url del sistema de seguimiento de incidencias.
|
||
--projectkey=clave La clave del proyecto en Jira.
|
||
|
||
== CMD_HELP_ISSUETRACKER ==
|
||
Ejemplos:
|
||
|
||
cm issuetracker jira status get 11 --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
|
||
(Obtiene el estado de la tarea 11 para el proyecto PRJ)
|
||
|
||
cm issuetracker jira status update 11 "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
|
||
(Actualiza el estado a "Done" de la tarea 11 para el proyecto PRJ)
|
||
|
||
cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
|
||
(Obtiene los ids de tarea cuyo estado es "Done" para el proyecto PRJ)
|
||
|
||
cm issuetracker jira connection check --user=user@mail.es --password=pwd --host=https://user.atlassian.net
|
||
(Comprueba si los parámetros de configuración son válidos o no)
|
||
|
||
== CMD_DESCRIPTION_LICENSEINFO ==
|
||
Muestra información de la licencia y de su uso.
|
||
|
||
== CMD_USAGE_LICENSEINFO ==
|
||
Sintaxis:
|
||
|
||
cm licenseinfo | li [--server=repserverspec] [--inactive] [--active] [--sort={name|status}]
|
||
|
||
Opciones:
|
||
|
||
--server: Obtiene la información de la licencia para el servidor
|
||
especificado. Si no se especifica ningún servidor, el
|
||
comando se ejecutará contra el servidor configurado en
|
||
el cliente.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre especificaciones.
|
||
--inactive Muestra únicamente usuarios inactivos en la sección de
|
||
"uso de licencia".
|
||
--active Muestra únicamente usuarios activos en la sección de
|
||
"uso de licencia".
|
||
--sort Ordena usuarios usando el campo especificado:
|
||
'name' o 'status'.
|
||
|
||
== CMD_HELP_LICENSEINFO ==
|
||
Notas:
|
||
|
||
Se muestra información acerca de la fecha de expiración, los usuarios
|
||
activos y no activos, etc.
|
||
|
||
Ejemplos:
|
||
|
||
cm licenseinfo
|
||
cm licenseinfo --server=myserver:8084
|
||
|
||
== CMD_DESCRIPTION_LINKTASK ==
|
||
Enlaza un changeset a tareas pertenecientes a un control de tareas.
|
||
|
||
== CMD_USAGE_LINKTASK ==
|
||
Sintaxis:
|
||
|
||
cm linktask changesetSpec extensionPrefix taskKey
|
||
|
||
changesetSpec: Especificación completa del changeset para ser enlazado a una
|
||
tarea en el sistema de control de tareas. Usa 'cm help objectspec' para
|
||
obtener más información sobre especificaciones.
|
||
|
||
extensionPrefix: Prefijo del sistema de control de tareas configurado.
|
||
|
||
taskKey: Identificador de la tarea para asociar al changeset especificado.
|
||
|
||
== CMD_HELP_LINKTASK ==
|
||
Ejemplos:
|
||
|
||
cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1
|
||
|
||
== CMD_DESCRIPTION_LOCK_LIST ==
|
||
Muestra los elementos bloqueados (checkouts exclusivos) en el servidor especificado.
|
||
|
||
== CMD_USAGE_LOCK_LIST ==
|
||
Sintaxis:
|
||
|
||
cm lock list [revspec [revspec ...]] [flags]
|
||
|
||
revspec: especificación de revisión. Usa 'cm help objectspec' para aprender
|
||
cómo indicar las especificaciones de las revisiones.
|
||
Opciones:
|
||
|
||
flags:
|
||
--server=<server>: muestra los elementos bloqueados en el
|
||
servidor, sobreescribiendo el valor por defecto (tomado del espacio
|
||
de trabajo actual o del fichero client.conf).
|
||
Usa 'cm help objectspec' para más información sobre especificaciones.
|
||
|
||
--onlycurrentuser: Filtra los resultados mostrando únicamente los
|
||
bloqueos efectuados por el usuario actual de Plastic SCM.
|
||
|
||
--onlycurrentworkspace: Filtra los resultados mostrando únicamente los
|
||
bloqueos efectuados en el espacio de trabajo actual. (Se cotejan
|
||
los resultados por nombre de espacio de trabajo).
|
||
|
||
--ignorecase: Ignora mayúsculas y minúsculas cuando una servepath spec
|
||
es usada. Con esta opción el comando funcionará para "/src/foo.c"
|
||
incluso si el usuario indica"/sRc/fOO.c".
|
||
|
||
== CMD_HELP_LOCK_LIST ==
|
||
Ejemplos:
|
||
|
||
cm lock list
|
||
cm lock ls --server=DIGITALIS:8084
|
||
cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
|
||
cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser
|
||
cm lock ls --onlycurrentuser
|
||
cm lock ls --onlycurrentuser --onlycurrentworkspace
|
||
|
||
Notas:
|
||
|
||
El comando muestra una lista de los elementos actualmente bloqueados en el
|
||
servidor por defecto. También acepta una lista de especificaciones de
|
||
revisión; en ese caso, solo se mostrarán los elementos bloqueados que
|
||
estén asociados a al menos una de las revisiones especificadas como
|
||
argumentos del comando. Adicionalmente, se puede utilizar el parámetro
|
||
opcional --server=<server> para modificar el servidor que se
|
||
consultará por defecto.
|
||
|
||
El comando muestra una línea por cada bloqueo almacenado en el servidor,
|
||
con la siguiente información:
|
||
GUID del elemento bloqueado.
|
||
Nombre de usuario que realizó el bloqueo.
|
||
Ruta del elemento bloqueado (formato de ruta de servidor).
|
||
Nombre del espacio de trabajo donde se realizó el bloqueo.
|
||
|
||
== CMD_DESCRIPTION_LISTUSERS ==
|
||
Lista los usuarios y grupos conocidos por el servidor.
|
||
|
||
== CMD_USAGE_LISTUSERS ==
|
||
Sintaxis:
|
||
|
||
cm listusers server [opciones]
|
||
|
||
server: especificación del servidor de repositorios.
|
||
Usa 'cm help objectspec' para más información sobre especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--onlyusers (-u): Lista sólo los usuarios.
|
||
--onlygroups (-g): Lista sólo los grupos.
|
||
--filter : Lista sólo aquellos usuarios y/o grupos que coincidan con el
|
||
filtro de busqueda indicado.
|
||
|
||
== CMD_HELP_LISTUSERS ==
|
||
Ejemplos:
|
||
|
||
cm listusers localhost:8084
|
||
cm listusers localhost:8084 -u
|
||
|
||
== CMD_DESCRIPTION_LOCATION ==
|
||
Muestra la ruta completa donde se ubica el ejecutable del cliente.
|
||
|
||
== CMD_USAGE_LOCATION ==
|
||
Sintaxis:
|
||
|
||
cm location
|
||
|
||
== CMD_HELP_LOCATION ==
|
||
|
||
== CMD_DESCRIPTION_LOCK ==
|
||
Use este comando para administrar workspaces.
|
||
|
||
== CMD_USAGE_LOCK ==
|
||
Sintaxis:
|
||
|
||
cm lock command [options]
|
||
|
||
Comandos:
|
||
|
||
list | ls
|
||
unolck
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm lock comando --usage
|
||
cm lock comando --help
|
||
|
||
== CMD_HELP_LOCK ==
|
||
Ejemplos:
|
||
|
||
cm lock list
|
||
cm lock
|
||
(list es opcional si no hay argumentos)
|
||
cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
|
||
cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
|
||
== CMD_DESCRIPTION_LOG ==
|
||
Devuelve información sobre las revisiones creadas en la rama del changeset
|
||
especificado, o de un intervalo de changesets.
|
||
|
||
== CMD_USAGE_LOG ==
|
||
Sintaxis:
|
||
|
||
cm log [repSpec|csSpec] [--from|-f=csSpecFrom] [--allbranches|-a]
|
||
[--csFormat=format] [--itemFormat=format] [--xml[=outputfile]]
|
||
[--encoding] [--repositorypaths | --fullpaths]
|
||
|
||
repSpec: Especificación del repositorio del cual se obtendrá información de
|
||
las revisiones en sus changesets. Usa 'cm help objectspec' para más información.
|
||
csSpec: Especificación del changeset del cual se obtendrá la información de
|
||
sus revisiones. Usa 'cm help objectspec' para más información.
|
||
|
||
Opciones:
|
||
|
||
--from, -f=csSpecFrom: Especificación del changeset a partir del cual se
|
||
mostrará información de revisiones. Dicho changeset no se incluye en la
|
||
salida. Ignorado si se indica una especificación de un repositorio.
|
||
--allbranches, -a: Muestra información de los changesets creados en un
|
||
intervalo especificado para cualquier rama.
|
||
--ancestors: muestra la información acerca de los changesets alcanzables
|
||
siguiendo los enlaces de parentesco y de merge para el changeset dado
|
||
([csSpec]). Si el changeset from ([csSpecFrom]) también es proporcionado,
|
||
este será usado como límite inferior para todos los paths.
|
||
Notas: los cambios de los changeset no se mostrarán con esta opción.
|
||
--csFormat=format: Especificación del formato en el cual se desea obtener
|
||
la información de los changesets.
|
||
--itemFormat=format: Especificación del formato en el cual se desea obtener
|
||
la información de los items involucrados en cada changeset.
|
||
--xml: Permite volcar la salida del comando en formato xml a la salida
|
||
estándar. También se permite especificar un fichero de salida
|
||
(--xml=output.xml).
|
||
--fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace
|
||
absolutas siempre que sea posible.
|
||
--repositorypaths: imprime rutas de repositorio en lugar de rutas
|
||
de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
|
||
--encoding: si se utiliza con la opción --xml, permite especificar el
|
||
encoding con el que se guardará la salida del comando. Consulte la
|
||
documentación de la MSDN para obtener la tabla completa de codificaciones
|
||
soportadas y su formato; al final de la página en la columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_LOG ==
|
||
Notas:
|
||
|
||
Si no se especifica ni changeset ni opción, mostrará información de todos
|
||
los changeset creados en el último mes en cualquier rama.
|
||
Si solamente se incluye la opción -f=[csSpecFrom], se mostrará la
|
||
información de todos los changesets desde el especificado hasta el momento
|
||
actual en la rama en la cual se creó dicho changeset.
|
||
Si se especifica la opción -a sin un intervalo, a todos los efectos el
|
||
comando funcionará exactamente igual que si solamente se especificara
|
||
[csSpec].
|
||
Si se utiliza la opción -f=[csSpecFrom], la salida muestra información
|
||
desde el changeset [csSpecFrom]+1 en adelante.
|
||
El repositorio que se utiliza para mostrar la información de los changesets
|
||
es el repositorio cargado en el path desde el cual se lanza el comando.
|
||
|
||
Este comando acepta una cadena de formato para mostrar la salida.
|
||
Se puede especificar un formato para la información de los changeset y
|
||
otro para la información de los ítems.
|
||
Cada parámetro de salida se identifica con un descriptor, y el usuario se
|
||
puede referir a él escribiéndolo entre los símbolos '{' y '}'.
|
||
|
||
Los parámetros de salida de este comando son los siguientes:
|
||
csFormat=
|
||
tab: Introduce un tabulador.
|
||
newline: Introduce una nueva línea.
|
||
changesetid: Número de changeset.
|
||
branch: Información de rama.
|
||
date: Fecha de creación del changeset.
|
||
owner: Propietario del changeset.
|
||
comment: Comentarios del changeset.
|
||
items: Items afectados en el changeset.
|
||
repository: Nombre del repositorio donde se encuentra el changeset.
|
||
repserver: Nombre del servidor.
|
||
itemFormat=
|
||
tab: Introduce un tabulador.
|
||
newline: Introduce una nueva línea.
|
||
path: Ruta del ítem en disco.
|
||
branch: Información de rama.
|
||
owner: Propietario del changeset.
|
||
date: Fecha de creación del changeset.
|
||
shortstatus: Formato corto. Ver más abajo.
|
||
fullstatus: Formato largo. Ver más abajo.
|
||
|
||
Formato corto y su correspondiente formato largo:
|
||
A = Added.
|
||
C = Changed.
|
||
M = Moved.
|
||
D = Deleted.
|
||
Éstas son cadenas de formato válidas:
|
||
--csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
|
||
--itemFormat="{newline}El ítem {path} se ha cambiado en la rama {branch} en el changeset {changesetid}."
|
||
|
||
Ejemplos:
|
||
|
||
cm log
|
||
(Muestra información de todos los changesets creados en el último mes en
|
||
cualquier rama).
|
||
|
||
cm log cs:16
|
||
(Muestra la información de los cambios realizados en el changeset 16 en la
|
||
rama en que se creó dicho changeset).
|
||
|
||
cm log cs:16 --csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
|
||
(Muestra la información el el formato especificado).
|
||
|
||
cm log --from=cs:20 cs:50
|
||
(Muestra información de todos los cambios de cada changeset comprendido
|
||
entre el 21 y el 50 en la rama br:/main).
|
||
|
||
cm log --from=cs:20 cs:50 -a
|
||
(Muestra información de todos los cambios de cada changeset comprendido
|
||
entre el 21 y el 50 en todas las ramas del repositorio).
|
||
|
||
cm log rep:myrep@localhost:8084
|
||
(Muestra la información de todos los changeset de otro repositorio diferente
|
||
al configurado en el selector del workspace. Puede ejecutarse fuera de
|
||
un workspace).
|
||
|
||
== CMD_DESCRIPTION_LS ==
|
||
Lista el contenido de un workspace o de un árbol de changeset, rama o selector.
|
||
|
||
== CMD_USAGE_LS ==
|
||
Sintaxis:
|
||
|
||
cm ls [opciones][rutas]
|
||
|
||
rutas: Rutas de los items para obtener el listado.
|
||
|
||
Opciones:
|
||
--format=cadena: cadena de formato
|
||
--symlink: aplica la operación al propio symlink y no a su destino
|
||
--selector: obtiene el contenido del selector del workspace actual
|
||
--selector="selector": obtiene el contenido del selector especificado
|
||
--tree=spec: lista el árbol de un changeset (a partir de su número o guid)
|
||
o de una rama (a partir de su nombre completo). Usa 'cm help objectspec'
|
||
para aprender cómo indicar una especificación.
|
||
-R|-r|--recursive: recorre los directorios recursivamente
|
||
--xml: Permite volcar la salida del comando en formato xml a la salida
|
||
estándar. También se permite especificar un fichero de salida
|
||
(--xml=output.xml).
|
||
--encoding: si se utiliza con la opción --xml, permite especificar el
|
||
encoding con el que se guardará la salida del comando. Consulte la
|
||
documentación de la MSDN para obtener la tabla completa de codificaciones
|
||
soportadas y su formato; al final de la página en la columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_LS ==
|
||
Notas:
|
||
|
||
Las rutas se pueden escribir con metacaracteres (*, ?, ...)
|
||
|
||
La salida del comando 'ls' se puede formatear usando una 'cadena de formato'
|
||
en la cual cada parámetro se identifica mediante un nombre (o un número para
|
||
mantener compatibilidad con las versiones anteriores).
|
||
|
||
La cadena de formato por defecto es:
|
||
"{<size>,10} {<date>:dd/MM/yyyy} {<date>:HH:mm} \
|
||
{<type>,-6} {<location>,-12} {<co>,-5} \
|
||
{name} {symlinktarget}"
|
||
|
||
También se pueden especificar los nombres como {nombre} para cadenas de
|
||
formato más sencillas:
|
||
"{size} {date} {name}"
|
||
|
||
Los nombres de los parámetros válidos para la cadena de formato son:
|
||
size 0
|
||
date 1
|
||
type 2
|
||
location 3 imprime br:branch#cset
|
||
checkout 4
|
||
co 4
|
||
name 5
|
||
changeset 6
|
||
cset 6
|
||
fullpath 7
|
||
path 7
|
||
repspec 8
|
||
owner 9
|
||
formattedsize 10
|
||
revid 11
|
||
parentrevid 12
|
||
itemid 13
|
||
brid 14
|
||
repid 15
|
||
server 16
|
||
symlinktarget 17
|
||
hash 18
|
||
chmod 19
|
||
wkpath 20 imprime un path relativo a la raíz del workspace
|
||
branch 21
|
||
newlocation 22 imprime cset@branch
|
||
guid 23 imprime el guid de cada elemento (tarda más tiempo)
|
||
itemguid 24
|
||
transformed 25 muestra las reglas aplicadas en cada elemento que
|
||
haya sufrido transformación.
|
||
|
||
Se puede personalizar la salida del comando ls sin necesidad de especificar
|
||
--format cada vez, definiendo la variable de entorno PLASTIC_LS_FORMAT.
|
||
|
||
Ejemplos:
|
||
|
||
cm ls
|
||
cm ls c:\workspace\src
|
||
cm ls --format={name} (muestra nombres de ficheros y directorios)
|
||
cm ls --symlink (muestra información de los symlinks y no del fichero o
|
||
directorio al que apunta. Disponible en entornos Linux/Mac/Unix)
|
||
|
||
cm ls code --selector (muestra el contenido del subdirectorio 'code' cargado
|
||
del selector asociado al workspace actual)
|
||
|
||
cm ls /code --selector="rep 'arevalo' path '/' branch '/main'" (muestra el
|
||
contenido del subdirectorio '/code' cargado del selector especificado.
|
||
Es importante destacar que el path se especifica en "formato servidor")
|
||
|
||
cm ls /code --tree=44@arevalo@cyl:7070 (lista el contenido del
|
||
subdirectorio /code en el changeset 44 del repositorio 'arevalo' en el
|
||
servidor 'cyl:7070')
|
||
|
||
cm ls /code --tree=br:/main/scm13596@arevalo@cyl:7070 (lista el contenido del
|
||
subdirectorio /code en el último changeset de la rama /main/scm13596
|
||
del repositorio 'arevalo' en el servidor 'cyl:7070')
|
||
|
||
cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@arevalo@cyl:7070
|
||
(lista el subdirectorio /code en el changeset con guid
|
||
ae1390ed-7ce9-4ec3-a155-e5a61de0dc77
|
||
en el repositorio 'arevalo' del servidor 'cyl:7070')
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_LIST ==
|
||
Muestra la información relativa a los triggers de un determinado tipo.
|
||
|
||
== CMD_USAGE_TRIGGER_LIST ==
|
||
Sintaxis:
|
||
|
||
cm trigger list [subtipo-tipo] [opciones]
|
||
|
||
subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
|
||
Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
|
||
trigger disponibles. Algunos ejemplos son:
|
||
|
||
before-mkbranch
|
||
after-mkwokspace
|
||
after-setselector
|
||
|
||
Opciones:
|
||
|
||
--server=servidor: Lista los triggers del servidor especificado.
|
||
--format: formato de salida.
|
||
|
||
== CMD_HELP_TRIGGER_LIST ==
|
||
Notas:
|
||
Si no se especifica tipo, muestra todos los triggers del servidor
|
||
configurado en el cliente.
|
||
|
||
Formato de salida:
|
||
{0}: Posición.
|
||
{1}: Nombre del trigger.
|
||
{2}: Ruta del ejecutable.
|
||
{3}: Propietario.
|
||
{4}: Tipo.
|
||
{5}: Filtro del trigger.
|
||
|
||
Ejemplos:
|
||
cm trigger list after-mklabel
|
||
cm tr ls before-mkbranch --server=myserver:8084
|
||
|
||
== CMD_DESCRIPTION_MANIPULATESELECTOR ==
|
||
Permite cambiar el selector para reflejar cambios en los comandos.
|
||
|
||
== CMD_USAGE_MANIPULATESELECTOR ==
|
||
Uso:
|
||
|
||
cm manipulateselector [wkpath | wkspec] [options]
|
||
|
||
path: Ruta del espacio de trabajo.
|
||
wkspec: Especificación del espacio de trabajo. Usa 'cm help objectspec'
|
||
para más información sobre especificaciones.
|
||
|
||
Opciones:
|
||
--atdate=date: Devuelve un selector que recreará el espacio de trabajo con
|
||
los contenidos que se cargarían en la fecha especificada.
|
||
|
||
== CMD_HELP_MANIPULATESELECTOR ==
|
||
Notas:
|
||
|
||
Si no se indica alguna de las rutas o especificaciones de espacio de
|
||
trabajo el comando supondrá el directorio actual como ruta al espacio de
|
||
trabajo.
|
||
|
||
Ejemplos:
|
||
|
||
cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss
|
||
|
||
== CMD_DESCRIPTION_MERGE ==
|
||
Mezcla el contenido de una rama con otra.
|
||
|
||
== CMD_USAGE_MERGE ==
|
||
Sintaxis:
|
||
|
||
cm merge spec_origen [--merge] [--cherrypicking] [--forced]
|
||
[--mergetype=merge_type]
|
||
[--interval-origin=csetspec | --ancestor=csetspec]
|
||
[--keepsource | --ks] [--keepdestination | --kd]
|
||
[--automaticresolution=<conflict-types>+]
|
||
[--subtractive] [--mount] [--printcontributors]
|
||
[--noprintoperations] [--silent]
|
||
[(--to=brspec | --destination=brspec) [--shelve]]
|
||
[-c=str_comment | --commentsfile=<comments_file>]
|
||
[--resolveconflict --conflict=index
|
||
--resolutionoption=src|dst|<rename --resolutioninfo=strname>
|
||
--mergeresultfile=path --solvedconflictsfile=path]
|
||
[--nointeractiveresolution]
|
||
[--machinereadable [--startlineseparator=sep]
|
||
[--endlineseparator=sep] [--fieldseparator=sep]]
|
||
|
||
spec_origen Especificación del origen del merge. Este puede ser:
|
||
- una rama: [br:]/nombre_rama
|
||
- una etiqueta: lb:nombre_etiqueta
|
||
- un changeset: cs:numero_changeset
|
||
- un shelve: sh:numero_shelve
|
||
Usa 'cm help objectspec' para más información sobre
|
||
especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--merge Realiza el merge. Si no se especifica esta opción,
|
||
se muestran los conflictos encontrados.
|
||
--cherrypicking Realiza el merge de los cambios incluidos en los
|
||
changesets origen. Esta opción no se considera si
|
||
el origen del merge es una etiqueta.
|
||
--forced No comprueba si el origen y el destino ya están
|
||
conectados.
|
||
Esta opción solo es válida para el merge de intervalo
|
||
y para el cherrypicking.
|
||
--mergetype Especifica el tipo de merge. Puede ser uno de los
|
||
siguientes: onlyone, onlysrc, onlydst, try, forced.
|
||
--interval-origin Especificación del changeset que queremos que actúe
|
||
como origen del intervalo, de manera que el merge
|
||
introducirá los cambios realizados desde el
|
||
changeset común hasta el changeset especificado
|
||
como origen del merge.
|
||
--ancestor Alias para --interval-origin.
|
||
--keepsource Acepta todos los cambios del contribuidor origen
|
||
para elementos con conflictos.
|
||
--keepdestination Preserva los cambios del contribuidor destino
|
||
para elementos con conflictos.
|
||
--automaticresolution Opción para resolver conflictos de directorio. Esta
|
||
opción permite elegir si el contribuidor origen
|
||
(source) o el contribuidor destino (destination)
|
||
debe ser seleccionado automáticamente para
|
||
resolver el conflicto.
|
||
Debes especificar los tipos de conflictos separados
|
||
por punto y coma ";".
|
||
Más información en las notas.
|
||
--subtractive Se utiliza para quitar cambios ya introducidos en
|
||
el sistema, ya sea por un checkin o por un merge.
|
||
El parámetro que se pasa al comando (spec_origen)
|
||
es el origen desde donde se quieren eliminar los
|
||
cambios. Puede ser la especificación de un
|
||
changeset o de un intervalo de ellos. En el caso
|
||
de un intervalo de changesets, se utiliza la opción
|
||
--interval-origin para definir el origen del
|
||
intervalo.
|
||
--mount El punto de montaje del respositorio especificado.
|
||
--printcontributors Imprime los contribuidores (base, origen y destino).
|
||
--noprintoperations Resuelve las mezclas de manera silenciosa sin
|
||
mostrar información sobre la resolución.
|
||
--silent No muestra ninguna salida.
|
||
--to | --destination Realiza una operación de merge-to a la rama de
|
||
destino especificada, con resolución de conflictos
|
||
completa. Una mezcla "merge-to" (o mezcla sin
|
||
workspace) es una mezcla hecha en el lado del
|
||
servidor. Mientras que en mezclas normales el
|
||
destino es el workspace, en una operación de
|
||
"merge-to" se debe especificar el destino (por
|
||
eso se llama "to", 'hacia' en inglés).
|
||
En la siguiente página se puede encontrar más
|
||
información sobre esta funcionalidad:
|
||
https://www.plasticscm.com/download/help/mergeto
|
||
--shelve Crea un shelve con los cambios del resultado del
|
||
merge (incluida la trazabilidad) en lugar de crear
|
||
un changeset. Esta opción no es válida cuando el
|
||
origen del merge es un shelve. Esta opción sólo
|
||
está disponible para el merge en el lado del
|
||
servidor (merge-to). Por ello, se requieren las
|
||
opciones "--to" y "--merge".
|
||
--no-dst-changes Asegura que el contribuidor destino no tiene cambios
|
||
(que el changeset destino es también el antecesor
|
||
común). Cuando hay cambios en el destino, no se
|
||
permite hacer el merge.
|
||
-c Añade un comentario al changeset creado en la
|
||
operación de mezcla.
|
||
--commentsfile Carga el comentario del fichero especificado y lo
|
||
añade al changeset creado en la operación de
|
||
mezcla.
|
||
--resolveconflict (Usado principalmente por plugins. Más información
|
||
en las notas.)
|
||
Usado para resolver un conflicto de directorio.
|
||
--conflict Usado con '--resolveconflict', especifica el
|
||
índice del conflicto a resolver empezando por 1.
|
||
--resolutionoption Usado con '--resolveconflict', indica el tipo de
|
||
resolución de conflicto. Puede ser una de las
|
||
siguientes opciones: src, dst, rename.
|
||
Más información en las notas.
|
||
--resolutioninfo Usado con '--resolveconflict', proporciona el
|
||
nombre que se usará cuando la opción
|
||
'--resolutionoption' es "rename".
|
||
--mergeresultfile Usado con '--resolveconflict', guarda en un fichero
|
||
la información del resultado de la mezcla entre
|
||
diferentes llamadas. El fichero especificado se
|
||
crea durante la primera llamada y se actualiza en
|
||
cada siguiente llamada.
|
||
--solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero
|
||
la información de los conflictos solucionados
|
||
entre diferentes llamadas. El fichero especificado
|
||
se crea durante la primera llamada y se actualiza
|
||
en cada siguiente llamada.
|
||
--nointeractiveresolution (Usado principalmente por plugins. Más información
|
||
en las notas.)
|
||
Evita preguntar al usuario cuando hay un conflicto
|
||
manual. Así, por ejemplo, un conflicto de directorio
|
||
no podrá ser resuelto.
|
||
--machinereadable (Usado principalmente por plugins. Más información
|
||
en las notas.)
|
||
Muestra la salida en un formato fácil de tratar.
|
||
--startlineseparator Usado con '--machinereadable', especifica cómo
|
||
deben comenzar las líneas. Por defecto, una cadena
|
||
de texto vacía.
|
||
--endlineseparator Usado con '--machinereadable', especifica cómo
|
||
deben terminar las líneas. Por defecto, una cadena
|
||
de texto vacía.
|
||
--fieldseparator Usado con '--machinereadable', especifica cómo
|
||
deben separarse los campos. Por defecto, un
|
||
espacio en blanco.
|
||
|
||
== CMD_HELP_MERGE ==
|
||
Notas:
|
||
|
||
Este comando se utiliza para meclar cambios entre dos ramas, o entre una
|
||
etiqueta y una rama. El destino del merge siempre debe ser una rama.
|
||
El origen del merge se especifica como argumento.
|
||
El destino de la rama es (salvo en el merge-to) el contenido actual del
|
||
workspace.
|
||
Por ejemplo, para mostrar los elementos que serán mezclados desde la rama
|
||
task001 a la rama principal, el selector debe apuntar a la rama principal,
|
||
el espacio de trabajo debe estar actualizado, y entonces ejecutar:
|
||
cm merge br:/task001
|
||
|
||
Para que el merge se realice, se añade el modificador "--merge":
|
||
cm merge br:/task001 --merge
|
||
|
||
El origen del merge es la especificación de un objeto (rama, etiqueta,
|
||
changeset o shelve).
|
||
Usa 'cm help objectspec' para más información sobre especificaciones.
|
||
|
||
Para resolver automáticamente conflictos de directorio debes usar la opción
|
||
"--automaticresolution" y especificar el tipo de conflicto seguido por el
|
||
contribuidor (origen o destino) que se seleccionará durante el merge.
|
||
(Recuerda separar cada par "tipo de conflicto"-"contribuidor" con punto y
|
||
coma (;).)
|
||
Por ejemplo:
|
||
cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src
|
||
(La operación de merge desde el changeset 2634 resuelve los conflictos
|
||
"eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src")
|
||
en ambos conflictos.)
|
||
- El sufijo "-src" añadido después del tipo de conflicto indica al comando
|
||
merge que debe mantener los cambios del contribuidor origen (source).
|
||
- El sufijo "-dst" indicará que se mantendrán los cambios del contribuidor
|
||
destino (destination).
|
||
Esta es la lista de tipos de conflictos que soporta el comando merge:
|
||
"movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete",
|
||
"deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove",
|
||
"cyclemove", "all".
|
||
El valor "all" sobrescribe al resto de opciones. En el siguiente ejemplo,
|
||
el conflicto "eviltwin-dst" será ignorado:
|
||
cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst
|
||
Consulta el siguiente enlace para aprender más sobre conflictos de merge:
|
||
https://www.plasticscm.com/download/help/directorymerges
|
||
|
||
Estas son las opciones para el argumento --mergetype:
|
||
onlyone Merge automático si solo uno de los contribuidores modificó
|
||
el elemento.
|
||
onlysrc Merge automático si solo el contribuidor origen modificó
|
||
el elemento.
|
||
onlydst Merge automático si solo el contribuidor destino modificó
|
||
el elemento.
|
||
try Merge automático si solo un contribuidor ha modificado la
|
||
parte del fichero en conflicto (para cada conflicto).
|
||
forced Intentar resolver siempre los conflictos no automáticos.
|
||
|
||
Estas son las opciones que se usan principalmente por plugins e integraciones:
|
||
- "--resolveconflict" para resolver un conflicto de directorio. Se
|
||
deben usar las siguientes opciones:
|
||
- "--conflict" es el índice del conflicto que se quiere resolver
|
||
(empezando por 1).
|
||
- "--resolutionoption" indica el tipo de resolución de conflicto.
|
||
Puede ser:
|
||
- "src" para mantener el cambio del origen y descartar el
|
||
cambio del destino
|
||
- "dst" para mantener el cambio del destino y descartar el
|
||
cambio del origen
|
||
- "rename" (solo si el tipo de conflicto soporta esta
|
||
resolución), para renombar el destino al nombre
|
||
proporcionado en la opción "--resolutioninfo".
|
||
- "--resolutioninfo" para proporcionar el nombre a usar
|
||
con el tipo de resolución "rename"
|
||
- "--mergeresultfile" y "--solvedconflictsfile", ambos se usan
|
||
para guardar informacación de la mezcla entre las diferentes
|
||
llamadas.
|
||
- "nointeractiveresolution" indica a la mezcla que no pregunte al usuario
|
||
en caso de necesitarse una resolución manual de un conflicto.
|
||
- "--machinereadable" y "--startlineseparator", "--endlineseparator",
|
||
"fieldseparator" se usan para imprimir la salida a un formato fácil
|
||
de leer, tratar o parsear.
|
||
Por ejemplo:
|
||
cm merge --machinereadable --startlineseparator=start@_@line
|
||
--endlineseparator=new@_@line --fieldseparator=def#_#sep
|
||
--mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp
|
||
--solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp
|
||
--resolveconflict --conflict=1 --resolutionoption=rename --resolutioninfo=bin_dst
|
||
br:/main/task --merge
|
||
|
||
Ejemplos:
|
||
|
||
cm merge br:/task001
|
||
(No realiza la mezcla, simplemente escribe los elementos que van a ser
|
||
mezclados.)
|
||
|
||
cm merge br:/task001 --merge
|
||
(Realiza el merge desde la rama task001.)
|
||
|
||
cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2
|
||
(Cherrypick del intervalo de changesets (2,5].)
|
||
|
||
cm merge cs:8 --merge --subtractive --keepdestination
|
||
(Merge sustractivo del changeset 8, preservando los cambios del destino
|
||
para aquellos elementos con conflictos.)
|
||
|
||
cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI"
|
||
(Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la
|
||
rama task001 hasta la rama main, con un comentario.)
|
||
|
||
cm merge br:/main/task001 --to=br:/main --merge --shelve
|
||
(Realiza el merge en el lado del servidor desde la rama task001 a la rama
|
||
main y deja el resultado en un shelve.)
|
||
|
||
cm merge sh:2 --to=br:/main --merge --no-dst-changes
|
||
(Aplica el shelve 2 en la rama main solo si fue creado desde la cabeza
|
||
actual de main.)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
|
||
Crea un atributo nuevo.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm attribute create nombre
|
||
|
||
nombre: Nombre del atributo.
|
||
|
||
Opciones:
|
||
|
||
-c: Añade un comentario al atributo creado.
|
||
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
|
||
|
||
== CMD_HELP_ATTRIBUTE_CREATE ==
|
||
Ejemplos:
|
||
|
||
cm attribute create Estado
|
||
|
||
== CMD_DESCRIPTION_BRANCH ==
|
||
Use este comando para administrar ramas.
|
||
|
||
== CMD_USAGE_BRANCH ==
|
||
Sintaxis:
|
||
|
||
cm branch command [options]
|
||
|
||
Comandos:
|
||
|
||
[(create)|delete|rename|history|showmain|showmerges]
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm branch command --usage
|
||
cm branch command --help
|
||
|
||
== CMD_HELP_BRANCH ==
|
||
Ejemplos:
|
||
|
||
cm branch /main/scm21345
|
||
cm branch create /main/scm21345
|
||
cm branch delete /main/scm21345
|
||
cm branch rename /main/scm21345 scm21346
|
||
cm branch history /main/scm21345
|
||
cm branch showmain
|
||
cm branch showmerges file.txt
|
||
|
||
== CMD_DESCRIPTION_BRANCH_CREATE ==
|
||
Crea una rama en el repositorio actual.
|
||
|
||
== CMD_USAGE_BRANCH_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm branch | br [create | mk] brspec [--changeset=csetspec | --label=lbspec]
|
||
[-c=str_comment | -commentsfile=<comments_file>]
|
||
|
||
brspec Nombre o especificación de la nueva rama.
|
||
Usa 'cm help objectspec' para más información sobre
|
||
especificaciones.
|
||
|
||
Opciones:
|
||
|
||
--changeset Changeset usado como punto de inicio de la nueva rama.
|
||
Especificación del changeset: [cs:]cs_number.
|
||
--label Etiqueta usada como punto de inicio de la nueva rama.
|
||
Usa 'cm help objectspec' para más información sobre
|
||
especificaciones.
|
||
-c Rellena el comentario de la nueva rama con el texto
|
||
especificado.
|
||
--commentsfile Rellena el comentario de la nueva rama con el contenido
|
||
del fichero de texto especificado.
|
||
|
||
== CMD_HELP_BRANCH_CREATE ==
|
||
Notas:
|
||
|
||
Para crear una rama de primer nivel, especifique el nombre sin jerarquía.
|
||
Por ejemplo:
|
||
|
||
cm br /dev
|
||
|
||
Si no se especifica el parámetro 'changeset', se utilizará el último
|
||
changeset de la rama madre. En caso de que la rama sea de primer nivel, se
|
||
utilizará como base el changeset 0.
|
||
|
||
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
|
||
|
||
cm branch main/task001 -c="Este es el comentario"
|
||
cm branch main/task001 -m "Este es el comentario"
|
||
|
||
Se puede escoger qué editor se lanzará para escribir el comentario
|
||
mediante la variable de entorno PLASTICEDITOR. Si dicha variable de entorno
|
||
tiene un valor, y no se especifica un comentario, el editor escogido se
|
||
abrirá automáticamente para que se espefique el comentario.
|
||
|
||
Ejemplos:
|
||
|
||
cm branch task001
|
||
cm branch create task001
|
||
cm branch mk task001
|
||
cm br mk task001
|
||
(Crea la rama de primer nivel 'task001' en el repositorio al que apunta
|
||
el workspace actual.)
|
||
|
||
cm branch br:/task001/task002
|
||
(Crea la rama 'task002' como hija de 'task001'.)
|
||
|
||
cm br /main/task001@myrep@myserver:8084 -c="my comment"
|
||
(Crea la rama 'task001' como hija de 'main' en el repositorio
|
||
'myrepo@myserver:8084' con el comentario 'my comment'.)
|
||
|
||
cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt
|
||
(Crea la rama 'task001' tomando como base el changeset '2837' de la rama
|
||
'main' con el comentario contenido en el fichero 'commenttask001.txt'.)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_DELETE ==
|
||
Borra una o más ramas.
|
||
|
||
== CMD_USAGE_BRANCH_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm branch | br delete | rm <spec_rama>+
|
||
|
||
spec_rama: Ramas a borrar, separadas por espacios.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de ramas.
|
||
|
||
== CMD_HELP_BRANCH_DELETE ==
|
||
Notas:
|
||
|
||
Este comando borra una o más ramas.
|
||
|
||
Ejemplos:
|
||
|
||
cm branch delete /main/task001
|
||
(Borra la rama con nombre 'task001' que sea hija de 'main' en el
|
||
repositorio al que apunta el workspace actual.)
|
||
|
||
cm br rm main/task002 /main/task012@reptest@myserver:8084
|
||
(Borra la rama '/main/task002' del repositorio al que apunta el workspace
|
||
actual, y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_RENAME ==
|
||
Renombra una rama.
|
||
|
||
== CMD_USAGE_BRANCH_RENAME ==
|
||
Sintaxis:
|
||
|
||
cm branch | br rename spec_rama nuevo_nombre
|
||
|
||
spec_rama: Especificación de la rama que se va a renombrar.
|
||
Usa 'cm help objectspec' para obtener más información sobre
|
||
la especificación de ramas.
|
||
nuevo_nombre Nuevo nombre para la rama.
|
||
|
||
== CMD_HELP_BRANCH_RENAME ==
|
||
Notas:
|
||
|
||
Este comando renombra una rama.
|
||
|
||
Ejemplos:
|
||
|
||
cm branch rename /main/task0 task1
|
||
(Renombra la rama '/main/task0' a '/main/task1'.)
|
||
|
||
cm br rename br:/main@reptest@server2:8084 secondary
|
||
(Renombra la rama principal del repositorio 'reptest' a 'secondary'.)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_HISTORY ==
|
||
Muestra la historia de una rama (merges y punto de partida).
|
||
|
||
== CMD_USAGE_BRANCH_HISTORY ==
|
||
Sintaxis:
|
||
|
||
cm branch | br history spec_rama
|
||
[--dateformat=date_format] [--machinereadable]
|
||
|
||
spec_rama Especificación de la rama para obtener la historia.
|
||
Usa 'cm help objectspec' para obtener más información.
|
||
|
||
Opciones:
|
||
|
||
--dateformat Formato utilizado para mostrar fechas.
|
||
--machinereadable Devuelve el resultado en un formato sencillo de
|
||
parsear.
|
||
|
||
== CMD_HELP_BRANCH_HISTORY ==
|
||
Ejemplos:
|
||
|
||
cm branch history br:/main/scm001@myrepository@myserver:8084
|
||
(Muestra la historia de '/main/scm001' en el repositorio 'myrepository'.)
|
||
|
||
cm br history main --dateformat="yyyy, dd MMMM" --machinereadable
|
||
(Muestra la historia de 'main' con un formato de fecha determinado y con
|
||
un formato sencillo de parsear.)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
|
||
Muestra la rama principal del repositorio.
|
||
Este es un comando de automatización, diseñado para automatizar el comando cm.
|
||
Muy probablemente la rama principal de sus repositorios sea /main.
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMAIN ==
|
||
Sintaxis:
|
||
|
||
cm branch | br showmain [repspec] [--encoding=name]
|
||
[--format=format_str] [--dateformat=date_format]
|
||
|
||
repspec Especificación del repositorio donde buscar la rama principal.
|
||
Si no se especifica, se utilizará el repositorio al que apunte
|
||
el workspace actual.
|
||
|
||
Opciones:
|
||
|
||
--encoding Permite especificar la codificación con el que se
|
||
guardará la salida del comando. Consulte la
|
||
documentación de la MSDN para obtener la tabla completa
|
||
de codificaciones soportadas y su formato; al final de
|
||
la página en la columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
--format Devuelve el mensaje de salida con un formato determinado.
|
||
Más información en las notas.
|
||
--dateformat Formato utilizado para mostrar fechas.
|
||
|
||
== CMD_HELP_BRANCH_SHOWMAIN ==
|
||
Notas:
|
||
|
||
Este comando muestra la rama principal de un repositorio.
|
||
|
||
Este comando acepta una cadena especificando el formato con el que se
|
||
debe mostrar la salida. Los parámetros de salida son los siguientes:
|
||
{id} Id de la rama.
|
||
{comment} Comentario.
|
||
{date} Fecha.
|
||
{owner} Propietario.
|
||
{name} Nombre.
|
||
{parent} Nombre de la rama madre.
|
||
{repository} Repositorio.
|
||
{repname} Nombre del repositorio.
|
||
{repserver} Servidor.
|
||
{changeset} Id del último changeset de la rama.
|
||
|
||
Ejemplos:
|
||
|
||
cm branch showmain
|
||
(Muestra la rama principal del repositorio del workspace actual.)
|
||
|
||
cm branch showmain repo@repserver:8084
|
||
(Muestra la rama principal del repositorio 'repo' en el servidor
|
||
'repserver:8084'.)
|
||
|
||
cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
|
||
(Muestra la rama principal del repositorio, con las fechas en un determinado
|
||
formato, y la salida está codificada en utf-8.)
|
||
|
||
cm br showmain --format="{id} - {name}"
|
||
(Muestra la rama principal del repositorio, devolviendo únicamente su id y
|
||
nombre.)
|
||
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
|
||
Muestra información sobre elementos pendientes en ramas a mezclar.
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMERGES ==
|
||
Este es un comando de automatización, diseñado para automatizar el comando cm.
|
||
|
||
Sintaxis:
|
||
|
||
cm branch | br showmerges <item_path>+
|
||
[--format=format_str] [--dateformat=date_format]
|
||
|
||
Opciones:
|
||
|
||
--format Devuelve el mensaje de salida con un formato determinado.
|
||
Más información en las notas.
|
||
--dateformat Formato utilizado para mostrar fechas.
|
||
|
||
== CMD_HELP_BRANCH_SHOWMERGES ==
|
||
Notas:
|
||
|
||
Este comando acepta una cadena especificando el formato con el que se
|
||
debe mostrar la salida. Los parámetros de salida son los siguientes:
|
||
{id} Id de la rama.
|
||
{comment} Comentario.
|
||
{date} Fecha.
|
||
{name} Nombre.
|
||
{owner} Propietario.
|
||
{parent} Nombre de la rama madre.
|
||
{parentid} Id de la rama madre.
|
||
{repid} Id del repositorio.
|
||
{repository} Repositorio.
|
||
{repname} Nombre del repositorio.
|
||
{repserver} Servidor.
|
||
|
||
Ejemplos:
|
||
|
||
cm branch showmerges file.txt
|
||
(Muestra las ramas involucradas en el merge pendiente del fichero file.txt.)
|
||
|
||
cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy"
|
||
(Muestra las ramas involucradas en el merge, mostrando solo la fecha y el
|
||
nombre, con las fechas en un determinado formato.)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY ==
|
||
Administra repositorios.
|
||
|
||
== CMD_USAGE_REPOSITORY ==
|
||
Sintaxis:
|
||
|
||
cm repository | repo commmand [options]
|
||
|
||
Comandos:
|
||
|
||
create | mk
|
||
delete | rm
|
||
list | ls
|
||
rename
|
||
add
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm repository command --usage
|
||
cm repository command --help
|
||
|
||
== CMD_HELP_REPOSITORY ==
|
||
Ejemplos:
|
||
|
||
cm repository
|
||
cm repository list
|
||
cm repository newrepo
|
||
cm repository create newrepo
|
||
cm repository rename oldname newname
|
||
cm repository add C:\repo\
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_CREATE ==
|
||
Crea un repositorio en un servidor.
|
||
|
||
== CMD_USAGE_REPOSITORY_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm repository rep_name
|
||
cm repository servidor <nombre_repositorio>+
|
||
cm repository [create | mk] rep_name
|
||
|
||
servidor Especificación del servidor.
|
||
Usa 'cm help objectspec' para más información sobre
|
||
especificaciones.
|
||
nombre_repositorio Nombre del nuevo repositorio.
|
||
|
||
== CMD_HELP_REPOSITORY_CREATE ==
|
||
Ejemplos:
|
||
|
||
cm repository MyRep
|
||
cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
|
||
cm repo create Rep01
|
||
cm repo mk list
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_DELETE ==
|
||
Borra un repositorio del servidor.
|
||
|
||
== CMD_USAGE_REPOSITORY_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm repository delete | rm repositoryspec
|
||
|
||
repositoryspec Especificación del repositorio a borrar.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de repositorios.
|
||
|
||
== CMD_HELP_REPOSITORY_DELETE ==
|
||
Nota:
|
||
|
||
Elimina un repositorio del servidor de repositorios.
|
||
No borra los datos del sistema gestor de bases de datos,
|
||
simplemente desconecta el repositorio del sistema de modo
|
||
que ya no sea accesible (los datos pueden ser añadidos de
|
||
nuevo, véase 'cm repository add').
|
||
|
||
Ejemplos:
|
||
|
||
cm repository delete myrepository@repserver:myserver:8084
|
||
cm repository rm myrepository@myserver:8084
|
||
cm repo rm myrepository
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_LIST ==
|
||
Lista los repositorios de un servidor.
|
||
|
||
== CMD_USAGE_REPOSITORY_LIST ==
|
||
Sintaxis:
|
||
|
||
cm repository
|
||
cm repository list [servidor] [--format=str_format]
|
||
|
||
servidor Especificación del servidor.
|
||
Usa 'cm help objectspec' para más información sobre
|
||
especificaciones.
|
||
--format Devuelve la salida en el formato especificado.
|
||
|
||
== CMD_HELP_REPOSITORY_LIST ==
|
||
Notas:
|
||
|
||
Este comando acepta una cadena de texto formateada para mostrar la
|
||
salida.
|
||
|
||
Los parámetros de salida del comando son los siguientes:
|
||
|
||
{repid} | {0} Identificador del repositorio.
|
||
{repname} | {1} Nombre del repositorio.
|
||
{repserver} | {2} Nombre del servidor del repositorio.
|
||
{repowner} | {3} Propietario del repositorio.
|
||
{repguid} | {4} Identificador único del repositorio.
|
||
{tab} Inserta un tabulador.
|
||
{newline} Inserta una nueva línea.
|
||
|
||
Si el valor del formato es "TABLE", la salida se imprimirá en formato
|
||
tabla con los siguientes campos: {repid}, {repname} y {repserver}.
|
||
|
||
Ejemplos:
|
||
|
||
cm repository
|
||
(Lista todos los repositorios.)
|
||
|
||
cm repository list localhost:8084 --format="{1, -20} {3}"
|
||
(Escribe el campo "nombre del repositorio" utilizando 20 espacios,
|
||
alineado a la izquierda, un espacio, y a continuación el propietario.)
|
||
|
||
cm repository ls localhost:8084 --format="{repname, -20} {repowner}"
|
||
(Escribe lo mismo que el ejemplo anterior.)
|
||
|
||
cm repo ls localhost:8084 --format=TABLE
|
||
(Escribe la lista de repositorios en formato tabla con los siguientes
|
||
campos: el id del repositorio, el nombre del repositorio, y el nombre
|
||
del servidor de repositorios.)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_RENAME ==
|
||
Renombra un repositorio.
|
||
|
||
== CMD_USAGE_REPOSITORY_RENAME ==
|
||
Sintaxis:
|
||
|
||
cm repository rename [spec_repositorio] nuevo_nombre
|
||
|
||
spec_repositorio Especificación del repositorio a renombrar.
|
||
Usa 'cm help objectspec' para obtener más
|
||
información sobre la especificación de repositorios.
|
||
nuevo_nombre Nuevo nombre para el repositorio.
|
||
|
||
== CMD_HELP_REPOSITORY_RENAME ==
|
||
Notas:
|
||
|
||
Este comando renombre un repositorio.
|
||
Si no se proporciona ninguna especificación de repositorio, se tomará el
|
||
repositorio actual como spec_repositorio.
|
||
|
||
Ejemplos:
|
||
|
||
cm repository rename desarrollo
|
||
(El repositorio actual se renombra a 'desarrollo'.)
|
||
|
||
cm repo rename rep:default@SERVER:8084 desarrollo
|
||
(El repositorio 'default' del servidor 'SERVER' se renombra a 'desarrollo'.)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_ADD ==
|
||
Añade una base de datos de repositorio al sistema.
|
||
|
||
== CMD_USAGE_REPOSITORY_ADD ==
|
||
Uso:
|
||
|
||
cm repository add databasename nombre repserverspec
|
||
|
||
databasename El nombre de la base de datos a reconectar.
|
||
nombre Nombre del repositorio.
|
||
repserverspec Especificación del servidor de repositorios.
|
||
Usa 'cm help objectspec' para obtener más
|
||
información sobre la especificación de servidores.
|
||
|
||
== CMD_HELP_REPOSITORY_ADD ==
|
||
Nota:
|
||
|
||
Reconecta una base de datos de repositorio al servidor. Puede
|
||
usarse para mover un repositorio de un servidor a otro o para
|
||
restaurar datos.
|
||
|
||
Ejemplos:
|
||
|
||
cm repository add rep_27 myrepository myserver:8084
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_CREATE ==
|
||
Crea un nuevo trigger en un determinado servidor.
|
||
|
||
== CMD_USAGE_TRIGGER_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm trigger create subtipo-tipo nombre script [opciones]
|
||
|
||
subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
|
||
Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
|
||
trigger disponibles. Algunos ejemplos son:
|
||
|
||
before-mkbranch
|
||
after-mkwokspace
|
||
after-setselector
|
||
|
||
nombre: nombre que queremos dar al trigger.
|
||
script: ruta del servidor en la que se encuentra el script
|
||
que deseamos ejecutar. Si esta ruta comienza por "webtrigger ", se
|
||
considerará como web trigger. Consulte la ayuda del comando para obtener
|
||
detalles adicionales.
|
||
|
||
Opciones:
|
||
|
||
--position=posicion: Intenta crear el trigger en la posición especificada
|
||
si esta no esta cogida por otro del mismo tipo.
|
||
--filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
|
||
filtro de busqueda indicado. Se pueden especificar varios filtros
|
||
separados por comas, si es así el el trigger se ejecutará si el elemento
|
||
coincide con cualquiera de los filtros. Si uno de los filtros comienza
|
||
con "rep:", el trigger se ejecutara sólo para las operaciones realizadas
|
||
sobre el repositorio con el nombre especificado (ver ejemplo).
|
||
--server=servidor: Crea el trigger en el servidor especificado. Si no se
|
||
especifica ninguno se crea en el servidor configurado en el cliente.
|
||
|
||
== CMD_HELP_TRIGGER_CREATE ==
|
||
Notas:
|
||
|
||
Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
|
||
como comando de trigger. En este caso, el trigger ejecutará una consulta
|
||
POST contra el URI especificado, en la que el cuerpo de la petición
|
||
contiene un diccionario JSON con las variables de entorno del trigger.
|
||
También estará presente una clave INPUT apuntando a un vector de cadenas de
|
||
texto para aquellos triggers que escriban en la entrada estándar de sus
|
||
comandos asociados.
|
||
|
||
Ejemplos:
|
||
cm trigger create after-setselector "backup" "/path/al/script" --position=4
|
||
|
||
cm tr mk before-mklabel new "/path/al/script" --server=myserver:8084
|
||
|
||
cm tr mk after-mklabel Log "/path/al/script" --filter="rep:myRep,LB*"
|
||
Este trigger se ejecutará sólo si el nombre de la etiqueta creada
|
||
comienza por 'LB' y si está siendo creada en el repositorio 'myrep'.
|
||
|
||
cm tr mk after-checkin Notify "webtrigger http://myserver.org/endpoint"
|
||
|
||
== CMD_DESCRIPTION_MOVE ==
|
||
Mueve o renombra un ítem.
|
||
|
||
== CMD_USAGE_MOVE ==
|
||
Sintaxis:
|
||
|
||
cm move ruta_origen ruta_destino
|
||
|
||
ruta_origen: Ruta origen del ítem.
|
||
ruta_destino: Ruta destino del ítem.
|
||
|
||
== CMD_HELP_MOVE ==
|
||
Notas:
|
||
|
||
Este comando mueve o renombra un ítem en el repositorio.
|
||
Los cambios también se realizan en el sistema de ficheros local.
|
||
Si la ruta de origen es un fichero, el destino puede ser un fichero o un
|
||
directorio. En el primer caso, el fichero se renombra, si no, el ítem se
|
||
mueve al directorio destino.
|
||
Si la ruta de origen es un directorio, la ruta destino ha de serlo también.
|
||
|
||
Requisitos para mover o renombrar un ítem:
|
||
El ítem ha de estar controlado por Plastic SCM.
|
||
El directorio padre del ítem origen y del ítem destino han de estar desprotegidos.
|
||
|
||
Ejemplos:
|
||
|
||
cm move fichero.txt fichero.old (renombra el ítem)
|
||
cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos)
|
||
cm move .\src .\src2 (renombra el directorio)
|
||
|
||
== CMD_DESCRIPTION_LABEL ==
|
||
Este comando permite al usuario efectuar operaciones con etiquetas.
|
||
|
||
== CMD_USAGE_LABEL ==
|
||
Sintaxis:
|
||
|
||
cm label | lb command [options]
|
||
|
||
Comandos:
|
||
|
||
create | mk
|
||
delete | rm
|
||
rename
|
||
|
||
Para obtener más información sobre cada uno de los comandos ejecute:
|
||
cm label command --usage
|
||
cm label command --help
|
||
|
||
== CMD_HELP_LABEL ==
|
||
Ejemplos
|
||
|
||
cm label myNewLabel cs:42
|
||
(el comando 'create' es opcional)
|
||
cm label rename myNewLabel newLabelName
|
||
cm label delete newLabelName
|
||
|
||
== CMD_DESCRIPTION_LABEL_CREATE ==
|
||
Crea una etiqueta nueva o etiqueta una changeset dado.
|
||
|
||
== CMD_USAGE_LABEL_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm label [create] spec_etiqueta [spec_changeset | ruta]
|
||
[--allxlinkedrepositories]
|
||
[-c=str_comment | -commentsfile=<comments_file>]
|
||
|
||
spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para
|
||
obtener más información sobre especificaciones.
|
||
spec_changeset: Nombre o especificación del changeset a etiquetar. Usa
|
||
'cm help objectspec' para obtener más información sobre especificaciones.
|
||
ruta: Ruta del workspace a etiquetar
|
||
|
||
Si no se especifica spec_changeset ni ruta se asumirá el directorio actual
|
||
como workspace a etiquetar.
|
||
|
||
Opciones:
|
||
|
||
--allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios
|
||
enlazados.
|
||
-c: Añade un comentario a la etiqueta creada.
|
||
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
|
||
|
||
== CMD_HELP_LABEL_CREATE ==
|
||
Notas:
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto el editor se abrirá automáticamente
|
||
para que especifique un comentario.
|
||
|
||
Ejemplos:
|
||
|
||
cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt
|
||
cm label BL002 cs:=1203 -c="first release"
|
||
|
||
== CMD_DESCRIPTION_LABEL_DELETE ==
|
||
Borra una o más etiquetas.
|
||
|
||
== CMD_USAGE_LABEL_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm label delete spec_etiqueta1 spec_etiqueta2 ...
|
||
|
||
spec_etiqueta: Etiquetas a borrar, separadas por espacios.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de etiquetas.
|
||
|
||
== CMD_HELP_LABEL_DELETE ==
|
||
Notas:
|
||
|
||
Este comando borra una o más etiquetas creadas previamente.
|
||
|
||
Ejemplos:
|
||
|
||
cm label delete lb:BL001 (Se borra la etiqueta 'BL001')
|
||
cm label delete lb:BL001 lb:BL002
|
||
|
||
== CMD_DESCRIPTION_LABEL_RENAME ==
|
||
Renombra una etiqueta.
|
||
|
||
== CMD_USAGE_LABEL_RENAME ==
|
||
Sintaxis:
|
||
|
||
cm label rename spec_etiqueta nuevo_nombre
|
||
|
||
sepec_etiqueta: Especificación de la etiqueta que se va a renombrar.
|
||
Usa 'cm help objectspec' para obtener más información sobre
|
||
la especificación de etiquetas.
|
||
nuevo_nombre: Nuevo nombre para la etiqueta.
|
||
|
||
== CMD_HELP_LABEL_RENAME ==
|
||
Notas:
|
||
|
||
Este comando renombra una etiqueta.
|
||
|
||
Ejemplos:
|
||
|
||
cm label rename lb:BL001 BL002
|
||
(La etiqueta 'BL001' se renombra a 'BL002')
|
||
|
||
== CMD_DESCRIPTION_OBLITERATE ==
|
||
DEPRECATED
|
||
|
||
== CMD_USAGE_OBLITERATE ==
|
||
|
||
|
||
== CMD_HELP_OBLITERATE ==
|
||
|
||
|
||
== CMD_DESCRIPTION_OBJECTSPEC ==
|
||
Explica cómo escribir object specs (especificaciones de objetos).
|
||
|
||
== CMD_USAGE_OBJECTSPEC ==
|
||
Sintaxis:
|
||
cm objectspec
|
||
Para obtener toda la información sobre cómo construir specs de objetos.
|
||
|
||
== CMD_HELP_OBJECTSPEC ==
|
||
Muchos comandos de Plastic SCM esperan 'object specs' como entrada para
|
||
referirse a un objeto concreto (normalmente una rama, un changeset, un
|
||
repositorio, etc.).
|
||
|
||
Esta documentación describe los diferentes tipos de "specs" disponibles y
|
||
cómo construirlas.
|
||
|
||
Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:".
|
||
El tag se debe indicar para comandos que reciban especificaciones generales
|
||
de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden
|
||
omitir en comandos que solo acepten un tipo de especificación, como por ejemplo
|
||
"cm getfile revision_spec".
|
||
|
||
== Repository server spec (repserverspec) ==
|
||
repserver:name:port
|
||
|
||
Ejemplos:
|
||
cm lrep repserver:skull:8084
|
||
cm lrep skull:8084
|
||
|
||
Nota:
|
||
Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de
|
||
simplemente 'server spec' por motivos históricos. Hace mucho tiempo
|
||
Plastic tenía servidores de workspaces y repositorios separados, y
|
||
el nombre ha sobrevivido.
|
||
|
||
== Repository spec (repspec) ==
|
||
rep:rep_name@[repserverspec]
|
||
|
||
Ejemplos:
|
||
cm showowner rep:codice@localhost:6060
|
||
(Aquí la "rep:" es necesaria porque el comando showowner admite
|
||
todo tipo de objetos).
|
||
|
||
== Branch spec (brspec) ==
|
||
br:[/]br_name[@repspec]
|
||
|
||
Ejemplos:
|
||
cm switch br:/main@rep:plastic@repserver:skull:9095
|
||
(En este caso "br:", "rep:" y "repserver:" no son necesarios así
|
||
que el comando se puede escribir de forma mucho más compacta:
|
||
"cm switch main@plastic@skull:9095" .)
|
||
|
||
cm find revisions "where branch='br:/main/task001'"
|
||
|
||
Nota:
|
||
La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir
|
||
todas las ramas como /main, /main/task001, etc. Pero ahora preferimos
|
||
user formatos más cortos tipo main, main/task001.
|
||
|
||
== Changeset spec (csetspec) ==
|
||
cs:cs_number|cs_guid[@repspec]
|
||
|
||
Se puede especificar el número o el GUID del changeset.
|
||
|
||
Ejemplos:
|
||
cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
|
||
|
||
== Label spec (labelspec) ==
|
||
lb:lb_name[@repspec]
|
||
|
||
Ejemplos:
|
||
cm switch lb:RELEASE2.0
|
||
cm switch lb:RELEASE1.4@myrep@MYSERVER:8084
|
||
|
||
== Revision spec ==
|
||
Hay distintos tipos de specs de revisiones:
|
||
|
||
rev:item_path[#(brspec|csetspec|labelspec)]
|
||
|
||
rev:serverpath:item_path#(brspec|cset_spec|lb_spec)
|
||
|
||
rev:revid:rev_id[@rep_spec]
|
||
|
||
rev:itemid:item_id#(br_spec|cset_spec|lb_spec)
|
||
|
||
Ejemplos:
|
||
cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
|
||
|
||
cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
|
||
serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
|
||
|
||
cm cat revid:1230@rep:myrep@repserver:myserver:8084
|
||
|
||
== Item spec ==
|
||
Se usa muy raras veces.
|
||
item:path
|
||
|
||
Ejemplo:
|
||
cm find revision "where item='item:.'"
|
||
|
||
== Attribute spec ==
|
||
att:att_name[@repspec]
|
||
|
||
Ejemplo:
|
||
cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084
|
||
|
||
== Workspace specs ==
|
||
wk:name@clientmachine
|
||
|
||
Se usa muy poco porque solamente aplica a los comandos relacionados con los
|
||
workspaces. Es útil para indicar el nombre del workspace en lugar del path.
|
||
|
||
Ejemplo:
|
||
cm showselector wk:codebase@modok
|
||
|
||
Nota:
|
||
Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que
|
||
los 'workspace servers' eran una forma de almacenar metadatos de forma
|
||
centralizada. Se eliminaron por cuestiones de rendimiento.
|
||
|
||
== CMD_DESCRIPTION_PARTIAL ==
|
||
Ejecuta comandos en un espacio de trabajo parcial.
|
||
|
||
== CMD_USAGE_PARTIAL ==
|
||
Sintaxis:
|
||
|
||
cm partial comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
configure
|
||
add
|
||
undo
|
||
co | checkout
|
||
unco | undocheckout
|
||
ci | checkin
|
||
mv | move
|
||
rm | remove
|
||
stb | switch
|
||
upd | update
|
||
|
||
Para obtener más información de cada uno de los comandos ejecute:
|
||
cm partial comando --usage
|
||
cm partial comando --help
|
||
|
||
== CMD_HELP_PARTIAL ==
|
||
Ejemplos:
|
||
|
||
cm partial configure +/fondo-azul.png
|
||
cm partial update paisaje-1024.png
|
||
cm partial checkin ojos-verde.png ojos-negro.png
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_ADD ==
|
||
Añade un ítem al repositorio.
|
||
|
||
== CMD_USAGE_PARTIAL_ADD ==
|
||
Sintaxis:
|
||
|
||
cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed]
|
||
[--skipcontentcheck] <rutas>+
|
||
|
||
rutas Rutas de los ítems a añadir separados por espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Usa * para añadir todo el contenido del directorio
|
||
actual.
|
||
|
||
Opciones:
|
||
|
||
-R Añade los ítems recursivamente.
|
||
--silent No muestra ninguna salida.
|
||
--parents Incluye los directorios padre de los ítems indicados en
|
||
la operación.
|
||
--ignorefailed Si un ítem no se puede añadir, la operación de add
|
||
continuará sin él. Importante: si un directorio no se
|
||
puede añadir, su contenido tampoco se añadirá.
|
||
--skipcontentcheck Cuando la extensión no es suficiente para determinar si
|
||
el fichero es de tipo texto o binario, se asumirá que es
|
||
binario en lugar de usar el contenido para detectar el
|
||
tipo.
|
||
== CMD_HELP_PARTIAL_ADD ==
|
||
Notas:
|
||
|
||
Requisitos para añadir ítems:
|
||
- El directorio padre del ítem a añadir debe existir en el repositorio.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial add pic1.png pic2.png
|
||
(Añade los ítems pic1.png y pic2.png.)
|
||
|
||
cm partial add c:\workspace\imagen.png
|
||
(Añade el ítem imagen.png en el directorio c:\workspace.)
|
||
|
||
cm partial add -R c:\workspace\src
|
||
(Añade recursivamente todos los ítems del directorio especificado.)
|
||
|
||
cm partial add --parents ejemplos\diseño01.png
|
||
(Añade el ítem diseño01.png y su directorio padre ejemplos.)
|
||
|
||
cm partial add -R *
|
||
(Recursively adds all the contents of the current directory.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
|
||
Crea una nueva revisión de un ítem.
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKIN ==
|
||
Sintaxis:
|
||
|
||
cm partial checkin | ci [opciones] [<ruta>+]
|
||
|
||
ruta Rutas de los ítems a proteger, separados por espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Usa . para aplicar la operación de checkin al directorio
|
||
actual.
|
||
|
||
Opciones:
|
||
|
||
-c Añade un comentario al changeset creado en la operación
|
||
de protección.
|
||
-commentsfile Añade el comentario existente en el fichero especificado
|
||
añ changeset creado en la operación de protección.
|
||
--all | -a Los ítems cambiados, movidos y borrados localmente en
|
||
las rutas especificadas también son protegidos.
|
||
--applychanged Protege los ítems cambiados localmente junto con los
|
||
ítems desprotegidos.
|
||
--keeplock Mantiene el bloqueo de aquellos elementos que estaban
|
||
bloqueados después de la operación de protección.
|
||
--symlink Realizar la operación de checkin sobre el fichero de
|
||
link y no al que apunta.
|
||
--ignorefailed Los cambios locales que no se pueden aplicar (porque el
|
||
bloqueo (checkout exclusivo) no se puede obtener o
|
||
porque están en conflicto con los cambios del servidor)
|
||
son descartados y el checkin continúa sin ellos.
|
||
|
||
== CMD_HELP_PARTIAL_CHECKIN ==
|
||
Notas:
|
||
|
||
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
|
||
todos los cambios pendientes en el espacio de trabajo.
|
||
- La operación de protección se aplica siempre recursivamente desde la
|
||
ruta indicada.
|
||
- Requisitos para proteger un ítem:
|
||
- El ítem debe estar controlado por Plastic SCM.
|
||
- El ítem ha de estar desprotegido.
|
||
- Si un ítem ha sido cambiado pero no desprotegido, no es necesario
|
||
especificar la opción --applychanged, salvo que en las rutas a ser
|
||
protegidas se incluyan directorios o rutas con wildcards ('*').
|
||
|
||
La revisión ha de tener cambios. Es decir, no se pueden proteger los
|
||
mismos datos.
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto, y no se especifica un comentario al
|
||
hacer checkin, el editor se abrirá automáticamente para que especifique
|
||
un comentario.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial checkin figura.png paisaje.png
|
||
(Protege los ítems figura.png and paisaje.png.)
|
||
|
||
cm partial checkin . -commentsfile=micomentario.txt
|
||
(Protege los ítems de la ruta actual y aplica el comentario existente en el
|
||
fichero micomentario.txt.)
|
||
|
||
cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock
|
||
(Protege el ítem fondo.png, incluye el comentario especificado y mantiene el
|
||
bloqueo.)
|
||
|
||
cm partial checkin --applychanged
|
||
(Protege todos los cambios pendientes en el espacio de trabajo.)
|
||
|
||
cm partial checkin link --symlink
|
||
(Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
|
||
Desprotege los ítems dejándolos preparados para ser modificados.
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKOUT ==
|
||
Síntaxis:
|
||
|
||
cm partial checkout | co [<ruta>+] [--resultformat=str_format]
|
||
[--silent] [--ignorefailed]
|
||
|
||
Opciones:
|
||
|
||
ruta Rutas de los ítems a desproteger, separados por
|
||
espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Usa . para aplicar la operación de checkout al
|
||
directorio actual.
|
||
--resultformat Devuelve la salida en el formato especificado.
|
||
--silent No muestra ninguna salida.
|
||
--ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede
|
||
hacer un checkout exclusivo), la operación de checkout
|
||
continuará sin él.
|
||
|
||
== CMD_HELP_PARTIAL_CHECKOUT ==
|
||
Notas:
|
||
|
||
Para desproteger un ítem:
|
||
- El ítem debe estar controlado por Plastic.
|
||
- El ítem debe estar protegido.
|
||
|
||
Si se han configurado bloqueos en el servidor (existe el fichero lock.conf),
|
||
entonces cada vez que se produzca una desprotección, Plastic comprobará si
|
||
se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout
|
||
exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente.
|
||
Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'.
|
||
Lee la documentación Administrator Guide para más información.
|
||
|
||
Examples:
|
||
|
||
cm partial checkout imagen1.png imagen2.png
|
||
(Desprotege los ítems imagen1.png and imagen2.png.)
|
||
|
||
cm partial co *.png
|
||
(Desprotege todos los ítems png.)
|
||
|
||
cm partial checkout .
|
||
(Desprotege el directorio actual.)
|
||
|
||
cm partial checkout -R c:\workspace\paisaje
|
||
(Desprotege recursivamente el directorio paisaje.)
|
||
|
||
cm partial co diseño01.png --exclusive
|
||
(Desprotege el ítem exclusivamente.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
|
||
Permite configurar tu espacio de trabajo, cargando o descargando elementos.
|
||
|
||
== CMD_USAGE_PARTIAL_CONFIGURE ==
|
||
Sintaxis:
|
||
|
||
cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase]
|
||
[--restorefulldirs]
|
||
|
||
ruta Rutas a cargar o descargar, separadas por espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Todas las rutas deben comenzar con "/".
|
||
|
||
Opciones:
|
||
|
||
--silent No muestra ninguna salida.
|
||
--ignorefailed Ignora cualquier error durante la operación.
|
||
--ignorecase Ignora mayúsculas y minúsculas. Con esta opción el
|
||
comando funcionará para "/Data/Textures" incluso si el
|
||
usuario indica "/data/teXtures".
|
||
--restorefulldirs Resetea una configuración de directorio incorrecta
|
||
(ocurre cuando una operación no parcial es ejecutada en
|
||
un espacio de trabajo parcial).
|
||
Los directorios de esta lista se configuran por
|
||
completo (full check), lo que significa que bajarán
|
||
automáticamente el nuevo contenido durante el update.
|
||
Esta operación no descarga ningún fichero, simplemente
|
||
restaura la configuración de directorio en un espacio
|
||
de trabajo parcial.
|
||
|
||
== CMD_HELP_PARTIAL_CONFIGURE ==
|
||
Notas:
|
||
|
||
El comando siempre asume recursividad.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial configure +/paisaje-gris.png
|
||
(Carga paisaje-gris.png.)
|
||
|
||
cm partial configure -/paisaje-negro.png
|
||
(Descarga paisaje-negro.)
|
||
|
||
cm partial configure +/textura -/textura/textura01.png
|
||
(Carga todo el contenido del directorio textura excepto textura01.png.)
|
||
|
||
cm partial configure -/
|
||
(Descarga todo el directorio de trabajo.)
|
||
|
||
cm partial configure -/ +/
|
||
(Carga todo el directorio de trabajo.)
|
||
|
||
cm partial configure +/figura-64.png --ignorefailed
|
||
(Carga figura-64.png, estuviera o no ya cargado previamente.)
|
||
|
||
cm partial configure +/ --restorefulldirs
|
||
(Fija todos los directorios para que descarguen el nuevo contenido automáticamente.)
|
||
|
||
cm partial configure +/src/lib --restorefulldirs
|
||
(Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_MOVE ==
|
||
Mueve o renombra un archivo o directorio.
|
||
|
||
== CMD_USAGE_PARTIAL_MOVE ==
|
||
Sintaxis:
|
||
|
||
cm partial move | mv src_path dst_path [--format=str_format]
|
||
|
||
src_path Ruta origen del ítem.
|
||
dst_path Ruta destino del ítem.
|
||
|
||
Options:
|
||
|
||
--format Devuelve la salida en el formato especificado.
|
||
|
||
== CMD_HELP_PARTIAL_MOVE ==
|
||
Notas:
|
||
|
||
Este comando mueve o renombra un ítem en el repositorio.
|
||
Los cambios también se aplican localmente.
|
||
|
||
Si la ruta de origen es un fichero, el destino puede ser un fichero o un
|
||
directorio. En el primer caso, el fichero se renombra. En el segundo, el
|
||
fichero se renombra.
|
||
Si la ruta de origen en un directorio, el destino ha de serlo también.
|
||
|
||
El ítem a mover o renombrar debe existir.
|
||
|
||
Formato:
|
||
{0} Ruta de origen.
|
||
{1} Ruta de destino.
|
||
|
||
Examples:
|
||
|
||
cm partial move fichero.png fichero-azul.png
|
||
(Renombra el ítem.)
|
||
|
||
cm partial mv .\fichero-azul.png .\azulFicheros
|
||
(Mueve fichero-azul.png a azulFicheros.)
|
||
|
||
cm partial move .\diseño .\marketing
|
||
(Renombra un directorio.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_RM ==
|
||
Borra un ítem del control de versiones.
|
||
|
||
== CMD_USAGE_PARTIAL_RM ==
|
||
Sintaxis:
|
||
|
||
cm partial remove | rm <ruta>+ [--nodisk]
|
||
|
||
ruta Ítems a borrar, separados por espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
|
||
Opciones:
|
||
|
||
--nodisk Borra del control de versiones, pero mantiene el ítem en
|
||
disco.
|
||
|
||
== CMD_HELP_PARTIAL_RM ==
|
||
Notas:
|
||
|
||
Los ítems se borran de disco. Los ítems borrados son borrados del directorio
|
||
padre en el control de versiones.
|
||
|
||
Requisitos:
|
||
- El ítem debe estar controlado.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial remove src
|
||
(Borra src. Si src es un directorio, equivale a ejecutar:
|
||
cm partial remove -R src.)
|
||
|
||
cm partial remove c:\workspace\pic01.png --nodisk
|
||
(Borra pic01.png del control de versiones, pero lo mantiene en el disco.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_SWITCH ==
|
||
Establece la rama especificada como rama de trabajo.
|
||
|
||
== CMD_USAGE_PARTIAL_SWITCH ==
|
||
Sintaxis:
|
||
|
||
cm switch branch_spec [--report | --silent] [--workspace=path]
|
||
(Establece la rama de trabajo y actualiza el workspace.)
|
||
|
||
cm switch branch_spec --configure <+|-ruta>+ [--silent]
|
||
[--ignorefailed] [--ignorecase] [--workspace=path]
|
||
(Establece la rama de trabajo y configura el workspace como haría el
|
||
comando 'cm partial configure'.)
|
||
|
||
branch_spec Especificación de rama.
|
||
ruta Rutas a cargar o descargar, separadas por espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Todas las rutas deben comenzar con "/".
|
||
|
||
Opciones:
|
||
|
||
--silent No muestra salida.
|
||
--report Imprime una lista de los cambios efectuados una vez
|
||
termina la operación. Pierde efecto si se utiliza
|
||
la opción --silent conjuntamente.
|
||
--configure Configura (carga / descarga rutas) el espacio de
|
||
trabajo después de haber actualizado la rama de trabajo.
|
||
Usa 'cm partial configure --help' para aprender más
|
||
sobre como especificar las rutas a configurar.
|
||
--ignorefailed Ignora cualquier error durante la operación
|
||
de configuración.
|
||
--ignorecase Ignora mayúsculas y minúsculas en las rutas a
|
||
configurar. Con esta opción el comando funcionará
|
||
para "/Data/Textures" incluso si el usuario indica
|
||
"/data/teXtures".
|
||
--workspace=path Ruta del espacio de trabajo a cambiar.
|
||
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
|
||
redirige la salida estándar.
|
||
|
||
Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones
|
||
de ramas.
|
||
|
||
== CMD_HELP_PARTIAL_SWITCH ==
|
||
Notas:
|
||
|
||
Este comando permite a los usuarios especificar una rama, como rama de
|
||
trabajo. Después de actualizar la rama, actualiza el espacio de trabajo
|
||
a la nueva rama como haría un 'cm partial update'. Sin embargo, si se
|
||
especifica la opción --configure, permite configurar el espacio de trabajo
|
||
teniendo en cuenta los elementos cargados en la nueva rama como haría un
|
||
'cm partial configure'.
|
||
|
||
Ejemplos:
|
||
|
||
cm switch br:/main/task
|
||
(Establece /main/task como rama de trabajo y actualiza el espacio de
|
||
trabajo.)
|
||
|
||
cm switch br:/main/task --configure +/art/images
|
||
(Establece /main/task como rama de trabajo y configura el directorio
|
||
/art/images.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNCO ==
|
||
Deshace la desprotección de un ítem.
|
||
|
||
== CMD_USAGE_PARTIAL_UNCO ==
|
||
Sintaxis:
|
||
|
||
cm partial undocheckout | unco <ruta>+ [--silent]
|
||
|
||
ruta Ítems sobre los que aplicar la operación, separados por
|
||
espacios.
|
||
Usa comillas (") para especificar rutas con espacios.
|
||
Usa . para aplicar la operación al directorio actual.
|
||
|
||
Opciones:
|
||
|
||
--silent No muestra ninguna salida.
|
||
|
||
== CMD_HELP_PARTIAL_UNCO ==
|
||
Notas:
|
||
|
||
Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la
|
||
desprotección usando este comando.
|
||
Se puede deshacer la desprotección tanto a ficheros como a carpetas.
|
||
El ítem se actualizará al estado anterior previo a ser desprotegido.
|
||
|
||
Requisitos:
|
||
- El ítem debe estar controlado.
|
||
- El ítem debe estar desprotegido.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial undocheckout .
|
||
(Deshace las desprotecciones del directorio actual.)
|
||
|
||
cm partial undocheckout pic1.png pic2.png
|
||
cm unco c:\workspace\diseño01.png
|
||
(Deshace las desprotecciones de los ítems especificados.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNDO ==
|
||
Deshace cambios en un workspace.
|
||
|
||
== CMD_USAGE_PARTIAL_UNDO ==
|
||
Syntaxis:
|
||
|
||
cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
|
||
[Opciones de salida]
|
||
|
||
path Rutas de los ficheros o carpetas a los que aplicar
|
||
la operación, separados por espacios. Se pueden
|
||
utilizar comillas (") para especificar rutas con
|
||
espacios. Si no se especifica ninguna ruta, por
|
||
defecto la operación se ejecutará sobre los ficheros
|
||
en el directorio actual.
|
||
|
||
Opciones:
|
||
|
||
--symlink Aplica la operación de undo al enlace simbólico y
|
||
no a su destino.
|
||
-r Ejecuta el undo de manera recursiva.
|
||
|
||
Filtros:
|
||
|
||
Si ninguna de estas opciones está presente, por defecto se deshacen todos
|
||
los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
|
||
opciones.
|
||
Si un fichero o directorio tiene uno o más de los tipos de cambio
|
||
especificados, todos los cambios en ese fichero o directorio serán
|
||
deshechos.
|
||
Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
|
||
está tanto movido como checkedout, ambos cambios se desharán.
|
||
|
||
--checkedout Selecciona ficheros y directorios marcados para
|
||
cambios.
|
||
--unchanged Selecciona ficheros sin modificaciones en su
|
||
contenido.
|
||
--changed Selecciona ficheros y directorios cambiados o
|
||
marcados para cambios.
|
||
--deleted Selecciona ficheros y directorios eliminados.
|
||
--moved Selecciona ficheros y directorios movidos.
|
||
--added Selecciona ficheros y directorios añadidos.
|
||
|
||
Opciones de salida:
|
||
|
||
--silent | --machinereadable [--startlineseparator=sep]
|
||
[--endlineseparator=sep] [--fieldseparator=sep]
|
||
|
||
--silent No muestra ninguna salida.
|
||
--machinereadable Muestra la salida en un formato fácil de tratar.
|
||
--startlineseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían comenzar las líneas.
|
||
--endlineseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían terminar las líneas.
|
||
--fieldseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían separarse las líneas.
|
||
|
||
== CMD_HELP_PARTIAL_UNDO ==
|
||
Notas:
|
||
|
||
El comand undo es peligroso - deshace trabajo de una manera irreversible.
|
||
Una vez que el undo termina, no hay manera posible de recuperar el estado
|
||
anterior de los ficheros y directorios afectados. Si no se especifica
|
||
ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
|
||
los elementos del directorio actual, pero NO de manera recursiva.
|
||
Estos comandos son equivalentes ejecutados desde el directorio /src:
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
$ cm partial undo
|
||
$ cm partial undo *
|
||
$ cm partial undo file.txt code.cs /test
|
||
|
||
$ cm partial undo .
|
||
$ cm partial undo /src file.txt code.cs
|
||
|
||
Si se quiere que la operación sea recursiva, se necesita especificar la
|
||
opción -r.
|
||
|
||
Para deshacer todos los cambios debajo de un directorio (incluyendo los
|
||
cambios sobre el propio directorio):
|
||
|
||
$ cm partial undo dirpath -r
|
||
|
||
Si dirpath es la ruta de un workspace, todos los cambios dentro del
|
||
workspace serán deshechos.
|
||
|
||
Examples:
|
||
|
||
$ cm partial undo . -r
|
||
(Deshace todos los cambios en el directorio actual de manera recursiva. Si
|
||
se ejecuta desde la raíz del workspace, deshace todos los cambios en el
|
||
workspace completo.)
|
||
|
||
$ cm partial co file.txt
|
||
$ cm partial undo file.txt
|
||
(Deshace el checkout en file.txt.)
|
||
|
||
$ echo content >> file.txt
|
||
$ cm partial undo file.txt
|
||
(Deshace el cambio local en file.txt.)
|
||
|
||
$ cm partial undo src
|
||
(Deshace los cambios en el directorio src y en todos los ficheros
|
||
controlados que contenga)
|
||
|
||
$ cm partial undo src/*
|
||
(Deshace los cambios en todos los elementos contenidos en src, sin afectar
|
||
al propio directorio. Por la expansión del wildcard, es equivalente a
|
||
'cm partial undo src/file1.txt src/file2.txt').
|
||
|
||
$ cm partial undo *.cs
|
||
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
|
||
directorio actual.)
|
||
|
||
$ cm partial undo *.cs -r
|
||
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
|
||
directorio actual, y en cada directorio por debajo de una manera recursiva.)
|
||
|
||
$ cm partial co file1.txt file2.txt
|
||
$ echo content >> file1.txt
|
||
$ cm partial undo --unchanged
|
||
(Deshace el checkout en file2.txt por no estar modificado, ignorando
|
||
file1.txt ya que tiene cambios locales.)
|
||
|
||
$ echo content >> file1.txt
|
||
$ echo content >> file2.txt
|
||
$ cm partial co file1.txt
|
||
$ cm partial undo --checkedout
|
||
(Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
|
||
ya que no está en checkout.)
|
||
|
||
$ cm partial add file.txt
|
||
$ cm partial undo file.txt
|
||
(Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
|
||
|
||
$ rm file1.txt
|
||
$ echo content >> file2.txt
|
||
$ cm partial add file3.txt
|
||
$ cm partial undo --deleted --added *
|
||
(Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
|
||
el cambio en file2.txt.)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UPDATE ==
|
||
Actualiza el espacio de trabajo parcial.
|
||
|
||
== CMD_USAGE_PARTIAL_UPDATE ==
|
||
Sintaxis:
|
||
|
||
cm partial update [<ruta>+]
|
||
[--changeset=número]
|
||
[--silent | --report]
|
||
|
||
ruta Rutas a actualizar, separadas por espacios. Las dobles
|
||
comillas (") deben usarse para especificar rutas que
|
||
contienen espacios.
|
||
Si se usa . entonces se actualiza el directorio actual.
|
||
Si no se especifica ninguna ruta, entonces se actualiza todo
|
||
el espacio de trabajo parcial.
|
||
|
||
Opciones:
|
||
|
||
--changeset Actualiza el espacio de trabajo parcial al changeset
|
||
especificado.
|
||
--silent No muestra salida.
|
||
--report Imprime una lista de los cambios efectuados una vez que
|
||
termina la operación. Esta opción no tiene efecto si se
|
||
utiliza la opción --silent.
|
||
--dontmerge No procesa los conflictos de fichero. El resto de cambios
|
||
se procesan con normalidad. Esta opción puede ser útil en
|
||
automatización para evitar interacción con el usuario.
|
||
|
||
|
||
== CMD_HELP_PARTIAL_UPDATE ==
|
||
Notas:
|
||
|
||
El comando update actualiza los ficheros desactualizados.
|
||
|
||
El comando update siempre asume recursividad.
|
||
|
||
Si todas las rutas especificadas son ficheros dentro del mismo xlink y
|
||
se usa la opción --changeset, entonces las versiones a actualizar se buscan
|
||
dentro del changeset del repositorio del xlink.
|
||
|
||
Ejemplos:
|
||
|
||
cm partial update
|
||
(Actualiza todo el espacio de trabajo parcial.)
|
||
|
||
cm partial update .
|
||
(Actualiza todos los hijos del directorio actual.)
|
||
|
||
cm partial update fichero1.txt
|
||
(Actualiza el fichero fichero1.txt.)
|
||
|
||
cm partial update fichero1.txt fichero2.txt
|
||
(Actualiza los ficheros fichero1.txt y fichero2.txt.)
|
||
|
||
cm partial update src --report
|
||
(Actualiza todos los hijos del directorio src, mostrando una lista de los
|
||
cambios aplicados al finalizar.)
|
||
|
||
cm partial update src --changeset=4
|
||
(Actualiza todos los hijos del directorio src, al contenido
|
||
que cargaban en el changeset 4.)
|
||
|
||
cm partial update xlink/first.png --changeset=4
|
||
(Actualiza el fichero xlink/first.png al contenido que cargaba en el
|
||
changeset 4 del repositorio del xlink.)
|
||
|
||
== CMD_DESCRIPTION_PATCH ==
|
||
Genera un parche a partir de una spec o aplica un parche generado en el workspace actual.
|
||
|
||
== CMD_USAGE_PATCH ==
|
||
Sintaxis:
|
||
|
||
cm patch [source_spec] source_spec
|
||
[--output=output_file] [--tool=/path/to/diff]
|
||
|
||
cm patch --apply patch_file [--tool=/path/to/patch]
|
||
|
||
source_spec Especificación de rama o changeset
|
||
output_file Fichero que contendrá la salida del comando. Se
|
||
mostrará en pantalla si no se especifica.
|
||
|
||
Opciones:
|
||
|
||
--output Indica el fichero de destino para almacenar los
|
||
contenidos del parche.
|
||
--tool Especifica la ruta hacia la herramienta necesaria para
|
||
ejecutar la operación (diff o patch).
|
||
|
||
== CMD_HELP_PATCH ==
|
||
Notas:
|
||
|
||
Este comando genera un fichero patch que contiene las diferencias de una
|
||
rama o un changeset, así como las diferencias entre changesets. Encuentra
|
||
diferencias para ficheros tanto de texto como binarios.
|
||
|
||
El parámetro --apply permite aplicar los contenidos de un fichero patch
|
||
en el workspace actual.
|
||
|
||
Limitaciones:
|
||
|
||
Si el fichero de salida de patch ya existe, el comando no lo
|
||
sobreescribirá.
|
||
|
||
Si el fichero con modificaciones en el patch no existe, el comando no
|
||
creará uno nuevo para aplicar los cambios.
|
||
|
||
Importante:
|
||
|
||
Este comando requiere las utilidades Diff y Patch, disponibles
|
||
en http://gnuwin32.sourceforge.net/packages/patch.htm y
|
||
http://gnuwin32.sourceforge.net/packages/diffutils.htm
|
||
|
||
Tras su instalación se recomienda agregar su ubicación a la variable
|
||
de entorno PATH.
|
||
|
||
Ejemplos:
|
||
|
||
cm patch cs:4@default@localhost:8084
|
||
(Muestra en pantalla las diferencias del changeset 4 en formato patch.)
|
||
|
||
cm patch br:/main --output=file.patch
|
||
(Obtiene un fichero file.patch con las diferencias de la rama "main".)
|
||
|
||
cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe
|
||
(Misma operación con un ejecutable indicado explícitamente.)
|
||
|
||
cm patch cs:2@default cs:4@default
|
||
(Muestra en pantalla las diferencias entre los changeset 2 y 4.)
|
||
|
||
cm patch --apply file.patch --tool=C:\gnu\patch.exe
|
||
(Aplica el parche contenido en file.patch al workspace actual con un
|
||
ejecutable indicado explícitamente.)
|
||
|
||
== CMD_DESCRIPTION_QUERY ==
|
||
Ejecuta una consulta SQL contra la base de datos del servidor.
|
||
|
||
== CMD_USAGE_QUERY ==
|
||
Uso:
|
||
|
||
cm query comandosql [--outputfile=ruta]
|
||
[--solveuser=nombre_columna1,nombre_columna2,...]
|
||
[--solvepath=nombre_columna1,nombre_columna2,...]
|
||
[--columnwidth=valor]
|
||
|
||
--outputfile: Escribe en un fichero el resultado de la consulta.
|
||
--solveuser: Indica al intérprete de consultas que la(s) columna(s)
|
||
especificada(s) contiene(n) usuarios. Se tratarán de resolver
|
||
identificadores de usuario a nombres de usuario.
|
||
--solvepath: Indica al intérprete de consultas que la(s) columna(s)
|
||
especificadas(s) contiene(n) identificadores de ítem. Se tratarán de
|
||
resolver los identificadores a rutas de disco.
|
||
--columnwidth: Especifica la anchura de cada columna del resultado de la
|
||
consulta.
|
||
|
||
== CMD_HELP_QUERY ==
|
||
Notas:
|
||
|
||
Este comando permite a los usuarios ejecutar consultas SQL directamente
|
||
contra la base de datos del servidor.
|
||
A continuación se detalla el esquema (tablas y campos de cada tabla)
|
||
disponibles para realizar consultas.
|
||
|
||
ITEMS
|
||
OBJECTID (integer)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
REVISIONS
|
||
OBJECTID (integer)
|
||
SIZEBYTES (integer)
|
||
ITEMID (integer)
|
||
BRANCHID (integer)
|
||
CHANGESET (integer)
|
||
COMMENT (string)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
CHECKOUTS
|
||
REVISIONID (integer)
|
||
WORKSPACESERVER (string)
|
||
CLIENTMACHINE (string)
|
||
EXCLUSIVE (char)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
BRANCHES
|
||
OBJECTID (integer)
|
||
NAME (string)
|
||
PARENTBRANCHID (integer)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
LABELS
|
||
OBJECTID (integer)
|
||
NAME (string)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
LABELEDREVISIONS
|
||
LABELID (integer)
|
||
REVISIONID (integer)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
LINKS
|
||
OBJECTID (integer)
|
||
NAME (string)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
LINKEDOBJECTS
|
||
LINKID (integer)
|
||
SOURCEOBJECTID (integer)
|
||
DESTINATIONOBJECTID (integer)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
ATTRIBUTES
|
||
OBJECTID (integer)
|
||
NAME (string)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
OBJECTSWITHATTRIBUTES
|
||
ATTRIBUTEID (integer)
|
||
SOURCEOBJECTID (integer)
|
||
ATTRIBUTEVALUE (string)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
CHANGESETS
|
||
CHANGESETNUMBER (integer)
|
||
CREATIONDATE (datetime)
|
||
OWNER (string)
|
||
|
||
Además, a la hora de escribir consultas, existen dos functiones predefinidas
|
||
para trabajar con usuarios y rutas de disco.
|
||
Estas funciones son las siguientes:
|
||
|
||
* SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que
|
||
maneja Plastic SCM.
|
||
* SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid.
|
||
|
||
Para mostrar el resultado de las consultas de forma legible al usuario, se
|
||
puede indicar al intérprete de consultas que convierta identificadores de
|
||
usuario a nombres de usuario, e identificadores de ítem a rutas de disco.
|
||
Para ello se utilizan las opciones:
|
||
|
||
--solveuser=nombre_columna
|
||
--solvepath=nombre_columna
|
||
|
||
Se pueden especificar varios nombres de columnas separados por comas.
|
||
|
||
Ejemplos:
|
||
|
||
cm query "SELECT * FROM revision"
|
||
|
||
cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s
|
||
where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'"
|
||
|
||
cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)"
|
||
|
||
cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s
|
||
WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
|
||
Borra uno o más atributos.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm attribute delete spec_atributo1 spec_atributo2 ...
|
||
|
||
spec_atributo Atributos a borrar, separados por espacios.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de atributos.
|
||
|
||
|
||
== CMD_HELP_ATTRIBUTE_DELETE ==
|
||
Notas:
|
||
|
||
|
||
Este comando borra uno o más atributos creados previamente.
|
||
Los parámetros son especificaciones de atributos, dados en el formato
|
||
att:nombre.
|
||
|
||
Ejemplos:
|
||
|
||
cm attribute delete att:Status
|
||
(Borra el atributo 'Status'.)
|
||
|
||
cm att rm status att:integrated@reptest@server2:8084
|
||
(Borrar los atributos 'status' e 'integrated'.)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
|
||
Borra un atributo que ha sido fijado previamente en un objeto.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_UNSET ==
|
||
Sintaxis:
|
||
|
||
cm attribute unset spec_atributo spec_objeto
|
||
|
||
spec_atributo Especificación del atributo.
|
||
spec_objeto Especificación del objeto sobre el que fijar
|
||
el atributo.
|
||
Se pueden fijar atributos sobre ramas, changesets,
|
||
shelvesets, etiquetas, items y revisiones.
|
||
|
||
Usa 'cm help objectspec' para obtener más información sobre especificación
|
||
de objetos.
|
||
|
||
== CMD_HELP_ATTRIBUTE_UNSET ==
|
||
Notas:
|
||
|
||
Un atributo que ha sido fijado previamente a un objeto puede ser borrado
|
||
con este comando. Se borra la realización del atributo en el objeto pero
|
||
no el atributo.
|
||
|
||
Usa 'cm help objectspec' para aprender cómo indicar especificaciones de
|
||
objetos.
|
||
|
||
Ejemplo:
|
||
|
||
cm attribute unset att:Status br:/main/SCM105
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
|
||
Renombra un atributo.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_RENAME ==
|
||
Sintaxis:
|
||
|
||
cm attribute rename spec_atributo nuevo_nombre
|
||
|
||
spec_atributo: Especificación del atributo que se va a renombrar.
|
||
Usa 'cm help objectspec' para obtener más información sobre
|
||
la especificación de atributos.
|
||
nuevo_nombre: Nuevo nombre para el atributo.
|
||
|
||
== CMD_HELP_ATTRIBUTE_RENAME ==
|
||
Notas:
|
||
|
||
Este comando renombra un atributo.
|
||
|
||
Ejemplos:
|
||
|
||
cm attribute rename att:Status state
|
||
(El atributo 'Status' se renombra a 'state')
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
|
||
Editar el comentario de un atributo.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_EDIT ==
|
||
Sintaxis:
|
||
|
||
cm attribute edit spec_atributo nuevo_comentario
|
||
|
||
spec_atributo: Especificación del atributo objetivo del cambio.
|
||
Usa 'cm help objectspec' para obtener más información sobre
|
||
la especificación de atributos.
|
||
nuevo_comentario: Nuevo comentario para el atributo. También puedes
|
||
especificar una lista de valores por defecto para el
|
||
atributo.
|
||
|
||
== CMD_HELP_ATTRIBUTE_EDIT ==
|
||
Notas:
|
||
|
||
Este comando cambia el comentario de un atributo.
|
||
|
||
Para especificar la lista de valores por defecto para un atributo, solo
|
||
tienes que incluir un texto como este en el comentario del atributo:
|
||
'default: valor_uno, "valor dos", valor3, "Valor final"'.
|
||
|
||
Ejemplos:
|
||
|
||
cm attribute edit att:status "The status of a branch in the CI pipeline."
|
||
(Edita el comentario del atributo "status".)
|
||
|
||
cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed"
|
||
(Edita el comentario del atributo "status". Y también especifica una lista
|
||
de valores. De este modo, cuando apliques el atribute "status" a un objeto,
|
||
podrás seleccionar uno de los siguientes valores: "open", "resolved" o
|
||
"reviewed".)
|
||
|
||
== CMD_DESCRIPTION_REPLICATE ==
|
||
ATENCIÓN: Este comando se ha declarado obsoleto.
|
||
|
||
Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push'
|
||
(equivalente a 'replicate --push').
|
||
|
||
Replica datos desde un repositorio remoto.
|
||
|
||
== CMD_USAGE_REPLICATE ==
|
||
Uso:
|
||
|
||
cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions]
|
||
cm replicate hydrate br_spec [src_rep_spec] [authOptions]
|
||
cm replicate hydrate cs_spec [src_rep_spec] [authOptions]
|
||
cm replicate br_spec --package=packagename [--changeset=número]
|
||
cm replicate dst_rep_spec --import=packagename
|
||
|
||
br_spec: la rama para ser replicada/hidratada. Es una especificación
|
||
completa de rama con el siguiente formato:
|
||
br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
|
||
|
||
cs_spec: changeset para ser hidratado. Es una espec. de changeset:
|
||
cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
|
||
|
||
src_rep_sec: repositorio origen de los datos. Es una especificación
|
||
completa de repositorio:
|
||
rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
|
||
|
||
dst_rep_sec: repositorio destino de la replica. Es una especificación
|
||
completa de repositorio:
|
||
rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
|
||
|
||
Opciones:
|
||
|
||
--package para crear un paquete de replicación.
|
||
--import para importar un paquete concreto.
|
||
--nodata para replicar los cambios de una rama sin replicar sus datos. Esta
|
||
opción no se puede usar para la réplica con paquetes ni con la opción
|
||
--push.
|
||
|
||
Opciones de traducción:
|
||
|
||
--trmode=[copy | name | table] para especificar cómo tratar los
|
||
nombres de usuario cuando se importen los datos en el
|
||
repositorio de destino:
|
||
* copy -> es el utilizado por defecto. Copia los SEIDs en el
|
||
repositorio de destino.
|
||
* name -> realiza una traducción por nombre entre el modo
|
||
de autentificación de origen y el de destino.
|
||
* table -> se usará una tabla de traducción en la que se
|
||
especifican los nombres de origen y cómo han de quedar
|
||
en el destino.
|
||
|
||
--trtable=[translationTable]
|
||
una tabla de traducción es un fichero que contiene entradas
|
||
en la forma nombre antiguo;nombre nuevo.
|
||
|
||
Opciones de autentificación:
|
||
|
||
Hay dos formas de especificar los datos de autentificación:
|
||
|
||
1) Especificando un fichero de autentificación.
|
||
|
||
--authfile=fichero, un fichero que contiene dos líneas: el modo de
|
||
autentificación en la primera línea y los datos de autentificación
|
||
(ver --authdata) o una cadena vacía en la segunda.
|
||
|
||
2) Especificando la autentificación mediante parámetros.
|
||
|
||
Para ello hay que especificar el modo de autentificación mediante el
|
||
modificador:
|
||
|
||
--authmode=[NameWorkingMode | NameIDWorkingMode |
|
||
LDAPWorkingMode | ADWorkingMode | UPWorkingMode]
|
||
|
||
Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede
|
||
especificar los datos de autentificación de dos formas:
|
||
|
||
2.1) Para UPWorkingMode o LDAPWorkingMode:
|
||
|
||
--authdata=datos_de_autentificación
|
||
|
||
Ejemplos:
|
||
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
|
||
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
|
||
|
||
2.2) Solamente para UPWorkingMode:
|
||
|
||
--user=usuario
|
||
--password=contraseña
|
||
|
||
== CMD_HELP_REPLICATE ==
|
||
Notas:
|
||
|
||
El comando 'replicate' replica datos desde una rama hacia un
|
||
repositorio de destino. Todos los datos de la rama de origen, incluyendo
|
||
revisiones, ítems, changesets, etiquetas, revisiones de código, links
|
||
y seguridad serán replicados.
|
||
|
||
Su cliente Plastic SCM debe estar configurado para trabajar con el
|
||
repositorio de destino.
|
||
|
||
La replicación también gestiona la 'reconciliación' de ramas que han
|
||
sido modificadas tanto en origen como en destino, mediante la creación
|
||
de 'ramas de entrega' (fetch branches) que podrán ser integradas
|
||
posteriormente para resolver los conflictos.
|
||
|
||
La replicación puede funcionar en tres modos diferentes:
|
||
|
||
1- Comunicación directa entre servidores: lo que significa que el servidor
|
||
de destino se comunicará con el de origen para sincronizar la rama
|
||
especificada.
|
||
|
||
2- Generación de paquete de exportación: el cliente se conectará
|
||
únicamente con el destino para generar un paquete de replicación con los
|
||
datos y los metadatos de la rama especificada. Se usará el modificador
|
||
--package. El usuario podrá especificar, opcionalmente, un changeset
|
||
inicial desde el cual generar la replicación.
|
||
|
||
3- Importar un paquete generado previamente, usando la opción --import.
|
||
|
||
En los modos 1 y 2 será necesaria la autentificación contra el servidor
|
||
de origen. El comando 'replicate' acepta parámetros para especificar los
|
||
diferentes modos de autentificación.
|
||
|
||
Ejemplos:
|
||
|
||
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090
|
||
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name
|
||
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt
|
||
|
||
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe
|
||
Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe'
|
||
|
||
cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data
|
||
Creará un paquete de replicación
|
||
|
||
cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data
|
||
Importará el paquete creado con anterioridad
|
||
|
||
cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230
|
||
Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230
|
||
|
||
cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata
|
||
Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos.
|
||
|
||
cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084
|
||
Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES.
|
||
|
||
Nota adicional:
|
||
La tabla de traducción tiene entradas (una por línea) con el siguiente
|
||
formato:
|
||
nombre antiguo;nombre nuevo
|
||
|
||
== CMD_DESCRIPTION_PULL ==
|
||
Replica datos desde un repositorio remoto.
|
||
|
||
== CMD_USAGE_PULL ==
|
||
Uso:
|
||
|
||
cm pull src_br_spec dst_rep_spec
|
||
[--preview] [--nodata] [translateOptions]
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
(Replicación directa entre servidores. Hace pull de una rama desde un
|
||
repositorio.)
|
||
|
||
cm pull dst_rep_spec --package=pack_file [AuthOptions]
|
||
(Replicación basada en paquetes. Importa el paquete en el servidor de
|
||
destino.)
|
||
|
||
cm pull hydrate dst_br_spec [src_rep_spec]
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
(Introduce los datos restantes para todos los changesets de una rama
|
||
replicada previamente con la opción --nodata. Si no se especifica un
|
||
repositorio del que obtener los datos, Plastic intentará usar el origen
|
||
de replicación original de la rama.)
|
||
|
||
cm pull hydrate dst_cs_spec [src_rep_spec]
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
(Introduce los datos restantes para un changeset replicado previamente
|
||
con la opción --nodata. Si no se especifica un repositorio del que obtener
|
||
los datos, Plastic intentará usar el origen de replicación original de
|
||
la rama.)
|
||
|
||
src_br_spec La rama a ser replicada desde un repositorio remoto.
|
||
dst_br_spec La rama a ser hidratada.
|
||
Especificación de ramas:
|
||
[br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
|
||
dst_cs_spec El changeset a ser hidratado.
|
||
Especificación de changesets:
|
||
cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
|
||
dst_rep_spec El repositorio de destino.
|
||
Especificación de repositorio:
|
||
[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
|
||
--package El fichero de donde se importa un paquete de replicación
|
||
creado anteriormente.
|
||
Es útil para mover datos entre servidores sin una
|
||
conexión de red directa.
|
||
Consule 'cm push' para crear paquetes de replicación.
|
||
|
||
Opciones:
|
||
|
||
--preview Proporciona información sobre qué cambios serán traídos
|
||
durante el pull, pero no se ejecuta ninguna acción más.
|
||
Esta opción es útil para comprobar qué datos serán
|
||
replicados antes de ejecutar el pull.
|
||
--user, --password Credenciales para utilizar en caso de que el modo de
|
||
autenticación de los servidores origen y destino
|
||
difieran, y no exista un profile para autenticarse
|
||
contra el remoto.
|
||
--nodata Replica los metadatos de una rama sin replicar los
|
||
datos. Esta opción no se puede utilizar al importar un
|
||
paquete de replicación.
|
||
|
||
Opciones de traducción (translateOptions):
|
||
|
||
--trmode={copy|name|table}
|
||
El servidor de origen y de destino pueden utilizar modos distintos de
|
||
autenticación. Este argumento especifica cómo se han de traducir los
|
||
nombres de usuario del origen al destino.
|
||
- copy El modo por defecto, indica que los nombres de usuario serán
|
||
simplemente copiados.
|
||
- name Los nombres de usuario serán emparejados entre origen y
|
||
destino por coincidencia.
|
||
- table Se utilizará una tabla de traducción (más información a
|
||
continuación).
|
||
|
||
--trtable={translation_table_file}
|
||
Si el modo de traducción es 'table', entonces una tabla de traducción
|
||
es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
|
||
Cuando la rama se escribe en el repositorio de destino, los objetos
|
||
creados por un usuario identificado por "nombreantiguo" en el
|
||
repositorio de origen serán asignados al usuario identificado por
|
||
"nombrenuevo" en el repositorio de destino.
|
||
|
||
Opciones de autentificación (AuthOptions):
|
||
|
||
Hay dos formas de especificar los datos de autentificación:
|
||
|
||
1) Especificando la autentificación mediante parámetros:
|
||
|
||
--authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
|
||
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
El parámetro '--authdata' es el contenido del campo <SecurityConfig>
|
||
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
|
||
puede ser generado desde la GUI de Plastic SCM (Windows).
|
||
|
||
Si se utiliza UPWorkingMode, se puede especificar simplemente:
|
||
|
||
--authmode=UPWorkingMode --user=user --password=pwd
|
||
|
||
2.1) Para UPWorkingMode o LDAPWorkingMode:
|
||
|
||
--authdata=datos_de_autentificación
|
||
|
||
Ejemplos:
|
||
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
|
||
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
|
||
|
||
2.2) Solamente para UPWorkingMode:
|
||
|
||
--user=usuario
|
||
--password=contraseña
|
||
|
||
1) Especificando un fichero de autentificación. Se pueden tener varios
|
||
ficheros de autenticación, uno por servidor al que se conecte,
|
||
conteniendo las credenciales específicas para dicho servidor.
|
||
|
||
--authfile=fichero
|
||
Contiene 2 líneas:
|
||
Línea 1) modo de autenticación, igual que para --authmode.
|
||
Línea 2) datos de autenticación, igual que para --authdata.
|
||
|
||
== CMD_HELP_PULL ==
|
||
Notas:
|
||
|
||
El comando pull replica ramas (junto a sus changesets) entre un repositorio
|
||
origen y otro destino. Los repositorios pueden encontrarse en diferentes
|
||
servidores.
|
||
|
||
Hay dos operaciones de replicación: push y pull.
|
||
|
||
Una operación de 'pull' significa que la operación de replicación hará que
|
||
el servidor destino obtenga datos desde el origen. El cliente se conectará
|
||
con el servidor destino, y, desde ese host, establecerá una conexión con el
|
||
repositorio origen para recuperar los datos pedidos. Durante el pull, será
|
||
el servidor destino el que se conecte al origen.
|
||
|
||
Aunque en un escenario distribuido típico el desarrollador haga pùsh de los
|
||
cambios en su servidor local al servidor central, también puede ser
|
||
necesario hacer pull de los últimos cambios en el servidor central al
|
||
servidor local.
|
||
|
||
La replicación puede resolver situaciones en las que se hagan cambios
|
||
concurrentes en la misma rama en dos repositorios replicados:
|
||
|
||
- Push: si se intenta hacer push de datos locales a un repositorio que tenga
|
||
datos más nuevos que los que se están enviando, el sistema pedirá hacer
|
||
pull de los últimos cambios, resolver el merge resultante y, finalmente,
|
||
tratar de repetir el push.
|
||
|
||
- Pull: cuando se hace pull de changesets de una rama remota, estos estarán
|
||
correctamente enlazados a sus changesets padre. Si el changeset que se ha
|
||
traído no es un hijo del último changeset de la rama, entonces aparecerá
|
||
un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
|
||
dicho de otro modo, más de un changeset final de rama. Será necesario
|
||
hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
|
||
|
||
El pull puede funcionar de dos modos:
|
||
|
||
1) Comunicación directa entre servidores: lo que significa que el servidor
|
||
de destino se comunicará con el de origen para sincronizar la rama
|
||
especificada.
|
||
|
||
2) Importación de un paquete de replicación generado con push, con la opción
|
||
--package.
|
||
|
||
El modo 1) requere que el usuario que ejecute el comando esté autenticado
|
||
contra el servidor remoto, bien o usando la autenticación por defecto en
|
||
el fichero client.conf, mediante un profile creado previamente, o
|
||
especificando los argumentos --authmode y --authdata (o --user y --password
|
||
en caso de que el modo de autenticación sea UPWorkingMode).
|
||
|
||
El modo 2) require usar un paquete de replicación generado previamente con
|
||
el comando push.
|
||
|
||
Recuerde que la replicación pull funciona de una manera indirecta. Cuando
|
||
se ejecuta, el comando pide al repositorio destino que se conecte con el
|
||
origen para obtener la rama especificada.
|
||
|
||
Sin embargo, esto se puede hacer de manera directa utilizando el comando
|
||
push, que hará que sea el repositorio origen quien envíe los datos
|
||
directamente al destino.
|
||
|
||
Ejemplos:
|
||
|
||
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084
|
||
(Hace pull de la rama principal de remoteserver a myserver. En este caso,
|
||
ambos servidores están configurados con el mismo modo de autenticación.)
|
||
|
||
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(Hace pull de la misma rama que antes, pero ahora el servidor remoto está
|
||
configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
|
||
se puede conectar de una máquina Linux a un servidor Windows configurado
|
||
para usar Active Directory. Para ello, se especificará el usuario y la
|
||
contraseña cifrada.)
|
||
|
||
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
|
||
(Hace pull de la misma rama, pero ahora ambos usuarios están autenticados
|
||
en el servidor remoto mediante el sistema de gestión de usuarios integrado
|
||
en Plastic SCM.)
|
||
|
||
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata
|
||
(Hace pull de la rama principal de remoteserver a myserver pero sin datos.)
|
||
|
||
cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(Introduce los datos de todos los changesets de la rama principal obteniendo
|
||
dichos datos del repositorio en remoteserver.)
|
||
|
||
cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(Introduce los datos del changeset 122169 en myserver obteniendo dichos
|
||
datos del repositorio en remoteserver.)
|
||
|
||
Nota adicional:
|
||
La tabla de traducción tiene entradas (una por línea) de la forma:
|
||
nombre antiguo;nombre nuevo
|
||
|
||
== CMD_DESCRIPTION_PUSH ==
|
||
Replica datos hacia un repositorio remoto.
|
||
|
||
== CMD_USAGE_PUSH ==
|
||
Uso:
|
||
|
||
cm push src_br_spec dst_rep_spec
|
||
[--preview] [translateOptions]
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
(Replicación directa entre servidores. Hace push de una rama hacia un
|
||
repositorio.)
|
||
|
||
cm push src_br_spec --package=pack_file [AuthOptions]
|
||
(Replicación basada en paquetes. Crea un paquete de replicación con la
|
||
rama especificada.)
|
||
|
||
src_br_spec La rama a ser replicada desde un repositorio remoto.
|
||
Especificación de ramas:
|
||
[br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
|
||
dst_cs_spec El changeset a ser hidratado.
|
||
Especificación de changesets:
|
||
cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
|
||
dst_rep_spec El repositorio de destino.
|
||
Especificación de repositorio:
|
||
[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
|
||
--package Exporta un paquete de replicación al fichero especificado.
|
||
Es útil para mover datos entre servidores sin una
|
||
conexión de red directa.
|
||
|
||
Opciones:
|
||
|
||
--preview Proporciona información sobre qué cambios serán enviados
|
||
durante el push, pero no se ejecuta ninguna acción más.
|
||
Esta opción es útil para comprobar qué datos serán
|
||
replicados antes de ejecutar el push.
|
||
--user, --password Credenciales para utilizar en caso de que el modo de
|
||
autenticación de los servidores origen y destino
|
||
difieran, y no exista un profile para autenticarse
|
||
contra el remoto.
|
||
--nodata Replica los metadatos de una rama sin replicar los
|
||
datos. Esta opción no se puede utilizar al exportar un
|
||
paquete de replicación.
|
||
|
||
Opciones de traducción (translateOptions):
|
||
|
||
--trmode={copy|name|table}
|
||
El servidor de origen y de destino pueden utilizar modos distintos de
|
||
autenticación. Este argumento especifica cómo se han de traducir los
|
||
nombres de usuario del origen al destino.
|
||
- copy El modo por defecto, indica que los nombres de usuario serán
|
||
simplemente copiados.
|
||
- name Los nombres de usuario serán emparejados entre origen y
|
||
destino por coincidencia.
|
||
- table Se utilizará una tabla de traducción (más información a
|
||
continuación).
|
||
|
||
--trtable={translation_table_file}
|
||
Si el modo de traducción es 'table', entonces una tabla de traducción
|
||
es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
|
||
Cuando la rama se escribe en el repositorio de destino, los objetos
|
||
creados por un usuario identificado por "nombreantiguo" en el
|
||
repositorio de origen serán asignados al usuario identificado por
|
||
"nombrenuevo" en el repositorio de destino.
|
||
|
||
Opciones de autentificación (AuthOptions):
|
||
|
||
Hay dos formas de especificar los datos de autentificación:
|
||
|
||
1) Especificando la autentificación mediante parámetros:
|
||
|
||
--authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
|
||
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
El parámetro '--authdata' es el contenido del campo <SecurityConfig>
|
||
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
|
||
puede ser generado desde la GUI de Plastic SCM (Windows).
|
||
|
||
Si se utiliza UPWorkingMode, se puede especificar simplemente:
|
||
|
||
--authmode=UPWorkingMode --user=user --password=pwd
|
||
|
||
2.1) Para UPWorkingMode o LDAPWorkingMode:
|
||
|
||
--authdata=datos_de_autentificación
|
||
|
||
Ejemplos:
|
||
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
|
||
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
|
||
|
||
2.2) Solamente para UPWorkingMode:
|
||
|
||
--user=usuario
|
||
--password=contraseña
|
||
|
||
1) Especificando un fichero de autentificación. Se pueden tener varios
|
||
ficheros de autenticación, uno por servidor al que se conecte,
|
||
conteniendo las credenciales específicas para dicho servidor.
|
||
|
||
--authfile=fichero
|
||
Contiene 2 líneas:
|
||
Línea 1) modo de autenticación, igual que para --authmode.
|
||
Línea 2) datos de autenticación, igual que para --authdata.
|
||
|
||
== CMD_HELP_PUSH ==
|
||
Notas:
|
||
|
||
El comando pull replica ramas (junto a sus changesets) entre un repositorio
|
||
origen y otro destino. Los repositorios pueden encontrarse en diferentes
|
||
servidores.
|
||
|
||
Hay dos operaciones de replicación: push y pull.
|
||
|
||
Una operación de 'push' significa que la operación de replicación enviará
|
||
datos desde el repositorio origen al repositorio destino. En este caso, el
|
||
cliente se conectará al repositorio origen, recuperando los datos para ser
|
||
replicados, y entonces los enviará al repositorio destino. Mientras que el
|
||
origen necesita tener conectividad con el destino, el destino no se
|
||
conectará con el origen.
|
||
|
||
En un escenario distribuido típico el desarrollador hace push de los
|
||
cambios en su servidor local al servidor central. También puede ser
|
||
necesario hacer pull de los últimos cambios en el servidor central al
|
||
servidor local.
|
||
|
||
La replicación puede resolver situaciones en las que se hagan cambios
|
||
concurrentes en la misma rama en dos repositorios replicados:
|
||
|
||
- Push: si se intenta hacer push de datos locales a un repositorio que tenga
|
||
datos más nuevos que los que se están enviando, el sistema pedirá hacer
|
||
pull de los últimos cambios, resolver el merge resultante y, finalmente,
|
||
tratar de repetir el push.
|
||
|
||
- Pull: cuando se hace pull de changesets de una rama remota, estos estarán
|
||
correctamente enlazados a sus changesets padre. Si el changeset que se ha
|
||
traído no es un hijo del último changeset de la rama, entonces aparecerá
|
||
un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
|
||
dicho de otro modo, más de un changeset final de rama. Será necesario
|
||
hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
|
||
|
||
El push puede funcionar de dos modos:
|
||
|
||
1) Comunicación directa entre servidores: lo que significa que el servidor
|
||
de origen se comunicará con el de destino para sincronizar la rama
|
||
especificada.
|
||
|
||
2) Exportación de un paquete de replicación: El cliente únicamente se
|
||
conectará con el origen y generará un paquete de replicación que contenga
|
||
tanto los datos como los metadatos para la rama especificada. Para ello
|
||
se utilizará el argumento --package.
|
||
|
||
Ambos modos requeren que el usuario ejecutando el comando esté autenticado
|
||
contra el servidor, bien o usando la autenticación por defecto en el fichero
|
||
client.conf, mediante un profile creado previamente, o especificando los
|
||
argumentos --authmode y --authdata (o --user y --password en caso de que
|
||
el modo de autenticación sea UPWorkingMode).
|
||
|
||
La replicación push funciona de una manera directa. Cuando se ejecuta, el
|
||
comando replicará la rama seleccionada del origen al destino, en vez de
|
||
pedir al repositorio destino que se conecte al repositorio origen para
|
||
obtener la rama especificada (como hace pull).
|
||
|
||
Ejemplos:
|
||
|
||
cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084
|
||
(Hace push de la rama main desde myserver a remoteserver. En este caso,
|
||
ambos servidores están configurados con el mismo modo de autenticación.)
|
||
|
||
cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(Hace push de la misma rama que antes, pero ahora el servidor remoto está
|
||
configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
|
||
se puede conectar de una máquina Linux a un servidor Windows configurado
|
||
para usar Active Directory. Para ello, se especificará el usuario y la
|
||
contraseña cifrada.)
|
||
|
||
cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
|
||
(Hace push de la misma rama, pero ahora ambos usuarios están autenticados
|
||
en el servidor remoto mediante el sistema de gestión de usuarios integrado
|
||
en Plastic SCM.)
|
||
|
||
Nota adicional:
|
||
La tabla de traducción tiene entradas (una por línea) de la forma:
|
||
nombre antiguo;nombre nuevo
|
||
|
||
== CMD_DESCRIPTION_CLONE ==
|
||
Clona un repositorio remoto.
|
||
|
||
== CMD_USAGE_CLONE ==
|
||
Sintaxis:
|
||
|
||
cm clone src_rep_spec [dst_rep_spec | repserver:dst_repserver_spec]
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
[TranslateOptions]
|
||
(Clonado directo repositorio-a-repositorio.)
|
||
|
||
cm clone src_rep_spec --package=pack_file
|
||
[--user=usr_name [--password=pwd] | AuthOptions]
|
||
(Clonado utilizando un paquete intermedio, que se podrá importar
|
||
posteriormente al repositorio destino mediante un pull.)
|
||
|
||
src_rep_spec Repositorio origen de la operación de clonado.
|
||
dst_rep_spec Repositorio destino de la operación de clonado.
|
||
Si existe, debe estar vacío. Si no existe, será creado
|
||
automáticamente.
|
||
Si no se especifica, el comando utilizará el servidor
|
||
de repositorios por defecto.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de repositorios.
|
||
dst_repserver_spec Servidor de repositorios destino de la operación de
|
||
clonado. Si existe un repositorio con el mismo nombre
|
||
que src_rep_spec, debe estar vacío. Si no existe, será
|
||
creado automáticamente.
|
||
Si no se especifica, el comando utilizará el servidor
|
||
de repositorios por defecto.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación servidores de repositorio.
|
||
pack_file Ruta de destino del paquete.
|
||
|
||
Options:
|
||
|
||
--user, --password Credenciales para utilizar en caso de que el modo de
|
||
autenticación de los servidores origen y destino
|
||
difieran, y no exista un profile para autenticarse
|
||
contra el remoto.
|
||
--package Exporta un paquete de replicación al fichero
|
||
especificado.
|
||
Es útil para mover datos entre servidores sin una
|
||
conexión de red directa.
|
||
El paquete resultante ha de ser importado mediante el
|
||
comand pull.
|
||
|
||
Opciones de traducción (TranslateOptions):
|
||
|
||
--trmode={copy|name|table}
|
||
El servidor de origen y de destino pueden utilizar modos distintos de
|
||
autenticación. Este argumento especifica cómo se han de traducir los
|
||
nombres de usuario del origen al destino.
|
||
- copy El modo por defecto, indica que los nombres de usuario serán
|
||
simplemente copiados.
|
||
- name Los nombres de usuario serán emparejados entre origen y
|
||
destino por coincidencia.
|
||
- table Se utilizará una tabla de traducción (más información a
|
||
continuación).
|
||
|
||
--trtable={translation_table_file}
|
||
Si el modo de traducción es 'table', entonces una tabla de traducción
|
||
es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
|
||
Cuando la rama se escribe en el repositorio de destino, los objetos
|
||
creados por un usuario identificado por "nombreantiguo" en el
|
||
repositorio de origen serán asignados al usuario identificado por
|
||
"nombrenuevo" en el repositorio de destino.
|
||
|
||
Opciones de autentificación (AuthOptions):
|
||
|
||
Hay dos formas de especificar los datos de autentificación:
|
||
|
||
1) Especificando la autentificación mediante parámetros:
|
||
|
||
--authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
|
||
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
El parámetro '--authdata' es el contenido del campo <SecurityConfig>
|
||
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
|
||
puede ser generado desde la GUI de Plastic SCM (Windows).
|
||
|
||
Si se utiliza UPWorkingMode, se puede especificar simplemente:
|
||
|
||
--authmode=UPWorkingMode --user=user --password=pwd
|
||
|
||
2.1) Para UPWorkingMode o LDAPWorkingMode:
|
||
|
||
--authdata=datos_de_autentificación
|
||
|
||
Ejemplos:
|
||
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
|
||
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
|
||
|
||
2.2) Solamente para UPWorkingMode:
|
||
|
||
--user=usuario
|
||
--password=contraseña
|
||
|
||
1) Especificando un fichero de autentificación. Se pueden tener varios
|
||
ficheros de autenticación, uno por servidor al que se conecte,
|
||
conteniendo las credenciales específicas para dicho servidor.
|
||
|
||
--authfile=fichero
|
||
Contiene 2 líneas:
|
||
Línea 1) modo de autenticación, igual que para --authmode.
|
||
Línea 2) datos de autenticación, igual que para --authdata.
|
||
|
||
== CMD_HELP_CLONE ==
|
||
Notas:
|
||
|
||
El comando clone replica ramas (junto a sus changesets, etiquetas, atributos,
|
||
reviews, etc.) desde un repositorio origen a otro repositorio destino.
|
||
Los repositorios pueden encontrarse en diferentes servidores.
|
||
|
||
El repositorio destino puede existir de antemano, pero si contiene datos
|
||
previos, la operación de clone fallará.
|
||
|
||
La operación de clone NO clona submódulos, ni repositorios que se encuentren
|
||
debajo de un xLink.
|
||
|
||
Ejemplos:
|
||
|
||
cm clone awesomeProject@tardis@cloud
|
||
(Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud
|
||
en un repositorio local del mismo nombre.)
|
||
|
||
cm clone repo@server.home:9095 repo-local
|
||
(Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el
|
||
servidor de repositorios por defecto del usuario.)
|
||
|
||
cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095
|
||
(Clona 'project' desde '192.168.111.130:8084' en
|
||
'project@192.168.111.200:9095'.)
|
||
|
||
cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt
|
||
(Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero
|
||
para autenticarse contra el servidor remoto, y traduciendo los usuarios
|
||
siguiendo la tabla de traducción especificada.)
|
||
|
||
cm clone project@server.home:9095 --package=project.plasticpkg
|
||
cm mkrep project@mordor.home:8084
|
||
cm pull --package=project.plasticpkg project@mordor.home:8084
|
||
(Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg',
|
||
que se importa posteriormente en el repositorio 'project' de
|
||
'mordor.home:8084' mediante una operación de pull.)
|
||
|
||
Nota adicional:
|
||
La tabla de traducción tiene entradas (una por línea) de la forma:
|
||
nombre antiguo;nombre nuevo
|
||
|
||
== CMD_DESCRIPTION_REVERT ==
|
||
Carga en el espacio de trabajo la revisión especificada y desprotege el elemento.
|
||
|
||
== CMD_USAGE_REVERT ==
|
||
Sintaxis:
|
||
|
||
cm revert cset_spec
|
||
|
||
cset_spec Especificación del changeset que contiene la revisión del ítem
|
||
cuyo contenido se desea cargar en el espacio de trabajo.
|
||
Usa 'cm help objectspec' para obtener más información sobre la
|
||
especificación de changesets.
|
||
|
||
== CMD_HELP_REVERT ==
|
||
Notas:
|
||
|
||
El ítem ha de esta estar protegido.
|
||
|
||
Ejemplos:
|
||
|
||
cm revert dir#cs:0
|
||
cm revert C:\mywks\dir\file1.txt#cs:23456
|
||
|
||
== CMD_DESCRIPTION_REVISION_HISTORY ==
|
||
Muestra la historia de revisiones de un ítem.
|
||
|
||
== CMD_USAGE_REVISION_HISTORY ==
|
||
Sintaxis:
|
||
|
||
cm history [opciones] rutas
|
||
|
||
rutas: Rutas de los ítems a mostrar, separadas por comas.
|
||
También pueden ser especificaciones de revisiones en servidor.
|
||
Usa comillas (") para indicar rutas que contengan espacios.
|
||
Usa 'cm help objectspec' para obtener más información sobre la
|
||
especificación de estas rutas.
|
||
|
||
Opciones:
|
||
|
||
-R: Descender recursivamente dentro de los directorios.
|
||
--long: Muestra información adicional.
|
||
--format: Muestra la salida con el formato especificado.
|
||
No compatible con la opción '--long'. Significado:
|
||
{0} fecha, {1} changeset, {2} rama, {3} etiquetas,
|
||
{4} comentario, {5} propietario, {6} revisionid
|
||
--symlink: Efectúa la operación "history" sobre el fichero de link y
|
||
no sobre el ítem al que apunta
|
||
--xml: Permite volcar la salida del comando en formato xml a la salida
|
||
estándar. También se permite especificar un fichero de salida
|
||
(--xml=output.xml).
|
||
--encoding: si se utiliza con la opción --xml, permite especificar el
|
||
encoding con el que se guardará la salida del comando. Consulte la
|
||
documentación de la MSDN para obtener la tabla completa de codificaciones
|
||
soportadas y su formato; al final de la página en la columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_REVISION_HISTORY ==
|
||
Notas:
|
||
|
||
Este comando muestra una lista con todas revisiones de un ítem determinado.
|
||
Para cada una de ellas se muestra la rama a la que pertenece, comentarios
|
||
de checkin y información sobre las etiquetas.
|
||
|
||
Este comando acepta formato para mostrar la salida.
|
||
Los parámetros que acepta son los siguientes:
|
||
{0} | {date} Fecha.
|
||
{1} | {changesetid} Número de changeset.
|
||
{2} | {branch} Rama.
|
||
{4} | {comment} Comentario.
|
||
{5} | {owner} Propietario.
|
||
{6} | {id} Id de revisión.
|
||
{7} | {repository} Repositorio.
|
||
{8} | {server} Servidor.
|
||
{9} | {repspec} Especificación de repositorio.
|
||
{tab} Inserta un tabulador.
|
||
{newline} Inserta una nueva línea.
|
||
|
||
Ejemplos
|
||
|
||
cm history fichero1.txt fichero2.txt
|
||
cm history c:\workspace
|
||
cm history link --symlink
|
||
(Recupera la historia del fichero de link y no sobre el elemento al que
|
||
apunta)
|
||
|
||
cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
|
||
(Recupera la historia del elemento /src/foo/bar.c presente en el último
|
||
changeset de la rama /main/task001 del repositorio 'myserver')
|
||
|
||
== CMD_DESCRIPTION_REVISION_TREE ==
|
||
Muestra un árbol de revisiones para el ítem dado.
|
||
|
||
== CMD_USAGE_REVISION_TREE ==
|
||
Sintaxis:
|
||
|
||
cm tree ruta
|
||
|
||
ruta: Ruta del ítem sobre el que se mostrará el árbol.
|
||
|
||
Opciones:
|
||
|
||
--symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem
|
||
al que apunta.
|
||
|
||
== CMD_HELP_REVISION_TREE ==
|
||
Ejemplos:
|
||
|
||
cm tree fichero1.txt
|
||
cm tree c:\workspace
|
||
cm tree link --symlink
|
||
(Efectúa la operación sobre el fichero de link
|
||
y no sobre el que apunta, disponible en entornos UNIX).
|
||
|
||
== CMD_DESCRIPTION_RM ==
|
||
Use este comando para borrar ficheros y directorios.
|
||
|
||
== CMD_USAGE_RM ==
|
||
Sintaxis:
|
||
|
||
cm remove | em comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
controlled (opcional)
|
||
private
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm remove comando --usage
|
||
cm remove comando --help
|
||
|
||
== CMD_HELP_RM ==
|
||
Ejemplos:
|
||
|
||
cm remove \fichero_controlado.txt
|
||
cm remove private \fichero_privado.txt
|
||
|
||
== CMD_DESCRIPTION_RM_CONTROLLED ==
|
||
Borra un ítem del control de versiones.
|
||
|
||
== CMD_USAGE_RM_CONTROLLED ==
|
||
Sintaxis:
|
||
|
||
cm remove [opciones] rutas
|
||
|
||
rutas: Rutas de los ítem a borrar.
|
||
|
||
Opciones:
|
||
|
||
-R: Descender recursivamente dentro de directorios.
|
||
|
||
== CMD_HELP_RM_CONTROLLED ==
|
||
Notas:
|
||
|
||
El ítem nunca borra del disco.
|
||
|
||
Requisitos para borrar:
|
||
|
||
El ítem ha de estar controlado en Plastic SCM.
|
||
El directorio padre debe estar desprotegido.
|
||
El elemento no debe estar desprotegido.
|
||
Si el ítem es un directorio, no debe tener desprotecciones pendientes.
|
||
|
||
Ejemplos:
|
||
|
||
cm remove src (borra el directorio 'src')
|
||
cm remove c:\workspace\fichero.txt
|
||
|
||
== CMD_DESCRIPTION_RM_PRIVATE ==
|
||
Borra ficheros y directorios privados.
|
||
|
||
Advertencia: este comando elimina permanentemente ficheros y directorios, y no
|
||
son recuperables. Es recomendable utilizar antes la opción '--dry-run' para
|
||
comprobar qué ficheros y directorios serán afectados por el comando.
|
||
|
||
== CMD_USAGE_RM_PRIVATE ==
|
||
Sintaxis:
|
||
|
||
cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run]
|
||
|
||
ruta Ruta del fichero o directorio a borrar.
|
||
Se pueden usar comillas (") para especificar rutas que
|
||
contengan espacios.
|
||
|
||
Opciones:
|
||
|
||
--r Elimina ficheros privados recursivamente dentro de
|
||
directorios controlados.
|
||
--ignored También se elimina ficheros y directorios ignorados y
|
||
cloaked.
|
||
--verbose Muestra todos las rutas afectadas.
|
||
--dry-run Ejecuta el comando sin hacer cambios en disco.
|
||
|
||
== CMD_HELP_RM_PRIVATE ==
|
||
Notas:
|
||
|
||
Si la ruta especificada corresponde a un fichero o directorio privados, este
|
||
será eliminado de disco.
|
||
Si la ruta corresponde a un fichero bajo control de versiones, el comando
|
||
fallará.
|
||
Si la ruta pertenece a un directorio bajo control de versiones, el comando
|
||
fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán
|
||
todos los ficheros y directorios privados dentro del directorio controlado
|
||
especificado.
|
||
|
||
Ejemplos:
|
||
|
||
cm remove private private_directory
|
||
(Eliminina el directorio 'private_directory'.)
|
||
|
||
cm remove private c:\workspace\controlled_directory
|
||
(Falla, pues el directorio 'controlled_directory' no es privado.)
|
||
|
||
cm remove private -r c:\workspace\controlled_directory
|
||
(Elimina todos los ficheros y directorios privados dentro de
|
||
'controlled_directory'.)
|
||
|
||
cm rm private --dry-run --verbose c:\workspace\controlled_directory -r
|
||
(Muestra todas las rutas afectadas por la operación de borrado de elementos
|
||
privados dentro de 'controlled_directory' sin borrar nada.)
|
||
|
||
cm rm private --verbose c:\workspace\controlled_directory -r
|
||
(Muestra todas las rutas afectadas por la operación de borrado de elementos
|
||
privados dentro de 'controlled_directory', ejecutando el borrado.)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_DELETE ==
|
||
Elimina un trigger identificado por un tipo y una posicion de un servidor dado.
|
||
|
||
== CMD_USAGE_TRIGGER_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm trigger delete subtipo-tipo posicion [opciones]
|
||
|
||
subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
|
||
Teclee 'cm showtriggertypes' para ver una lista completa de los tipos
|
||
de trigger disponibles. Algunos ejemplos son:
|
||
|
||
before-mkbranch
|
||
after-mkwokspace
|
||
after-setselector
|
||
|
||
posicion: posicion que se le asigno al trigger en el momento de su creación.
|
||
|
||
Opciones:
|
||
|
||
--server=servidor: Elimina el trigger del servidor especificado.
|
||
Si no se especifica ninguno lo elimina en aquél configurado
|
||
en el cliente.
|
||
|
||
== CMD_HELP_TRIGGER_DELETE ==
|
||
Ejemplos:
|
||
cm trigger delete after-setselector 4
|
||
cm tr rm after-setselector 4
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_SET ==
|
||
Fija un atributo al objeto indicado.
|
||
|
||
== CMD_USAGE_ATTRIBUTE_SET ==
|
||
Sintaxis:
|
||
|
||
cm attribute set spec_atributo spec_objeto valor_atributo
|
||
|
||
spec_atributo Especificación del atributo.
|
||
spec_objeto Especificación del objeto sobre el que fijar el atributo.
|
||
Objetos válidos para este comando son: rama, changeset,
|
||
shelveset, etiqueta, item y revisión.
|
||
valor_atributo Valor con el que se quiere fijar el atributo indicado
|
||
para ese objeto.
|
||
|
||
Usa 'cm help objectspec' para obtener más información sobre especificaciones.
|
||
|
||
== CMD_HELP_ATTRIBUTE_SET ==
|
||
Notas:
|
||
|
||
A los objetos se les puede fijar un atributo para poder guardar información
|
||
adicional en el objeto.
|
||
Se pueden fijar atributos sobre los siguientes objetos:
|
||
ramas, changesets, shelvesets, etiquetas, items y revisiones.
|
||
|
||
Ejemplo:
|
||
|
||
cm attribute set att:Status br:/main/SCM105 Integrated
|
||
|
||
== CMD_DESCRIPTION_SETOWNER ==
|
||
Establece el propietario de un objeto.
|
||
|
||
== CMD_USAGE_SETOWNER ==
|
||
Sintaxis:
|
||
|
||
cm setowner | sto --user=usuario | --group=grupo spec_objeto
|
||
|
||
--user Nombre de usuario. Nuevo propietario del objeto.
|
||
--group Nombre de grupo. Nuevo propietario del objeto.
|
||
spec_objeto Especificación del objeto sobre el que asignar el nuevo
|
||
propietario.
|
||
Se puede asignar nuevo usuario a los siguientes objetos:
|
||
repserver, repositorio, rama, changeset, etiqueta, item,
|
||
revisión y atributo.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de objetos.
|
||
|
||
== CMD_HELP_SETOWNER ==
|
||
Notas:
|
||
|
||
Es posible modificar el propietario de un objeto mediante el comando
|
||
setowner. El propietario de un objeto puede ser un usuario o un grupo.
|
||
Para especificar un usuario se utiliza la opción –-user=xxx y para
|
||
especificar un grupo se utiliza la opción -–group=xxx. El objeto que se
|
||
quiere modificar se especifica mediante una especificación de objeto.
|
||
|
||
Se puede modificar el propietario de los siguientes objetos:
|
||
servidor de repositorios, repositorio, rama, changeset, etiqueta, item,
|
||
revisión y atributo.
|
||
|
||
Ejemplos:
|
||
|
||
cm setowner --user=danipen repserver:localhost:8084
|
||
(establece a 'danipen' como propietario del servidor de repositorios)
|
||
cm sto --group=development rep:principal@PlasticServer:8084
|
||
(establece al grupo 'development' como el propietario del repositorio 'principal')
|
||
|
||
== CMD_DESCRIPTION_SETSELECTOR ==
|
||
Establece un selector para un espacio de trabajo.
|
||
|
||
== CMD_USAGE_SETSELECTOR ==
|
||
Sintaxis:
|
||
cm setselector [opciones] [wk_ruta | wk_spec]
|
||
|
||
wk_ruta Ruta del espacio de trabajo sobre el que establecer el
|
||
selector.
|
||
wk_spec Especificación del espacio de trabajo sobre el que
|
||
establecer el selector.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre especificaciones de espacios de trabajo.
|
||
|
||
Opciones:
|
||
--file Fichero del que cargar un selector.
|
||
--ignorechanges Ignora el mensaje de aviso de cambios pendientes que se
|
||
muestra si existen cambios pendientes cuando se
|
||
actualiza el espacio de trabajo.
|
||
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
|
||
redirige la salida estándar.
|
||
|
||
== CMD_HELP_SETSELECTOR ==
|
||
Notas:
|
||
|
||
Este comando establece un selector para un espacio de trabajo determinado.
|
||
|
||
Un workspace necesita información acerca de dónde obtener las revisiones
|
||
con las que trabajará el usuario. Para especificar esa información se
|
||
utilizan los selectores.
|
||
|
||
Mediante un selector se puede indicar, por ejemplo, que se carguen las
|
||
revisiones desde una rama determinada o desde la rama ‘main’, desde una
|
||
etiqueta, y especificar la rama donde se alojarán las desprotecciones.
|
||
|
||
Si no se especifica ningún fichero del que cargar el selector se abrirá
|
||
un editor de texto.
|
||
|
||
Indicar una ruta o una especificación de workspace es opcional. Si no se
|
||
especifica ninguno el selector se fijará para el espacio de trabajo en
|
||
el que se encuentra el usuario.
|
||
|
||
Un selector de ejemplo:
|
||
|
||
repository "default" // indica el repositorio con el que se trabaja
|
||
path "/" // se aplica al path raíz
|
||
branch "/main" // se obtendrán las últimas revisiones de br:/main
|
||
checkout "/main" // los checkouts se ubicarán en la rama br:/main
|
||
|
||
Ejemplos:
|
||
|
||
cm setselector
|
||
cm setselector --file=c:\selectores\miRama.xml
|
||
cm setselector --file=c:\selectores\rama5.xml MiWorkspace
|
||
cm setselector wk:workspace_projA@BEARDTONGUE
|
||
|
||
== CMD_DESCRIPTION_SHELVE ==
|
||
El comando shelve almacena el contenido de las revisiones en checkout.
|
||
|
||
== CMD_USAGE_SHELVE ==
|
||
Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'.
|
||
|
||
Sintaxis:
|
||
|
||
cm shelve [opciones] [rutas]
|
||
|
||
rutas: rutas de los items a guardar.
|
||
|
||
Opciones:
|
||
--apply=shelve_spec : Restaura los contenidos almancenados en el
|
||
repositorio, identificados por "shelve_spec" en el espacio de trabajo
|
||
local.
|
||
--delete=shelve_spec: Elimina los contenidos almancenados en el repositorio
|
||
identificados por "shelve_spec"
|
||
--all (-a): Los ítems cambiados, movidos y borrados localmente, en las
|
||
rutas dadas, también serán guardados.
|
||
--dependencies: Incluir las dependencias de los cambios locales entre los
|
||
ítems a guardar.
|
||
-c=comentarios: Añade un comentario al shelve creado en la operación.
|
||
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
|
||
--mount: El punto de montaje del respositorio especificado.
|
||
--encoding=codificación: Especifica la codificación de los ficheros de
|
||
origen (por ejemplo, UTF-8 o Unicode)
|
||
--comparisonmethod=tipo: cualquiera de las siguientes opciones:
|
||
IgnoreEol: Ignora diferencias de final de línea.
|
||
IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
|
||
IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
|
||
blanco.
|
||
NotIgnore: Detecta diferencias de final de línea y espacios en
|
||
blanco.
|
||
|
||
== CMD_HELP_SHELVE ==
|
||
|
||
Notas:
|
||
|
||
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
|
||
todos los cambios pendientes en el espacio de trabajo.
|
||
|
||
- La operación de shelve se aplica siempre recursivamente desde la
|
||
ruta indicada.
|
||
|
||
- Requisitos para hacer shelve de un ítem:
|
||
* El ítem debe estar controlado por Plastic SCM.
|
||
* El ítem ha de estar desprotegido.
|
||
|
||
Ejemplos:
|
||
|
||
cm shelve
|
||
cm shelve fichero1.txt fichero2.txt
|
||
|
||
Comentarios:
|
||
|
||
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
|
||
cm shelve -c="my comment"
|
||
cm shelve -m "my comment"
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto, y no se especifica un comentario al
|
||
crear una shelve, el editor se abrirá automáticamente para que especifique
|
||
un comentario.
|
||
|
||
Ejemplo: Aplicar un shelve almacenado en el repositorio:
|
||
cm shelve --apply=sh:3
|
||
|
||
Ejemplo: Eliminar un shelve almacenado en el repositorio
|
||
cm shelve --delete=sh:3
|
||
|
||
Ejemplo: Shelve 'changelist'
|
||
|
||
cm status --short --changelist=pending_to_review | cm shelve -
|
||
(El comando listará los paths en el changelist llamado 'pending_to_review'
|
||
y dicha lista será redirigida a la entrada del comando 'shelve').
|
||
|
||
== CMD_DESCRIPTION_SHELVESET ==
|
||
Use este comando para administrar shelvesets.
|
||
|
||
== CMD_USAGE_SHELVESET ==
|
||
Sintaxis:
|
||
|
||
cm shelveset comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
create | mk
|
||
delete | rm
|
||
apply
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm shelveset command --usage
|
||
cm shelveset command --help
|
||
|
||
== CMD_HELP_ATTRIBUTE ==
|
||
Ejemplos:
|
||
|
||
cm shelveset create -c="my comment"
|
||
cm shelveset delete sh:3
|
||
cm shelve apply sh:3
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_CREATE ==
|
||
El comando shelve almacena los cambios pendientes.
|
||
|
||
== CMD_USAGE_SHELVESET_CREATE ==
|
||
Sintaxis:
|
||
cm shelveset create [opciones] [rutas]
|
||
|
||
rutas: rutas de los items a guardar.
|
||
|
||
Opciones:
|
||
--all (-a): Los ítems cambiados, movidos y borrados localmente, en las
|
||
rutas dadas, también serán guardados.
|
||
--dependencies: Incluir las dependencias de los cambios locales entre los
|
||
ítems a guardar.
|
||
-c=comentarios: Añade un comentario al shelve creado en la operación.
|
||
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
|
||
|
||
== CMD_HELP_SHELVESET ==
|
||
Ejemplos:
|
||
|
||
cm shelveset create -c="my comment"
|
||
cm shelveset delete sh:3
|
||
cm shelve apply sh:3
|
||
|
||
== CMD_HELP_SHELVESET_CREATE ==
|
||
El comando shelveset create almacena los ítems en checkout especificados
|
||
dentro del repositorio. De este modo el contenido queda almacenado en el
|
||
servidor sin necesidad de hacer check in.
|
||
|
||
Notas:
|
||
|
||
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
|
||
todos los cambios pendientes en el espacio de trabajo.
|
||
|
||
- La operación de shelve se aplica siempre recursivamente desde la
|
||
ruta indicada.
|
||
|
||
- Requisitos para hacer shelve de un ítem:
|
||
* El ítem debe estar controlado por Plastic SCM.
|
||
* El ítem ha de estar desprotegido.
|
||
|
||
Ejemplos:
|
||
|
||
cm shelveset create
|
||
cm shelveset fichero1.txt fichero2.txt
|
||
|
||
Comentarios:
|
||
|
||
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
|
||
cm shelveset -c="my comment"
|
||
cm shelveset -m "my comment"
|
||
|
||
Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
|
||
ejecutable de un editor de texto, y no se especifica un comentario al
|
||
crear una shelve, el editor se abrirá automáticamente para que especifique
|
||
un comentario.
|
||
|
||
Ejemplo: Shelve 'changelist'
|
||
|
||
cm status --short --changelist=pending_to_review | cm shelveset -
|
||
(El comando listará los paths en el changelist llamado 'pending_to_review'
|
||
y dicha lista será redirigida a la entrada del comando 'shelve').
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_DELETE ==
|
||
El comando shelveset delete borra un shelveset.
|
||
|
||
== CMD_USAGE_SHELVESET_DELETE ==
|
||
Sintaxis:
|
||
cm shelveset delete shelve_spec
|
||
|
||
shelve_spec: Elimina los contenidos almancenados en el repositorio
|
||
identificados por "shelve_spec"
|
||
|
||
== CMD_HELP_SHELVESET_DELETE ==
|
||
El comando shelveset delete borra un shelveset creado anteriormente.
|
||
|
||
Ejemplo: Eliminar un shelve almacenado en el repositorio
|
||
|
||
cm shelveset delete sh:3
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_APPLY ==
|
||
El comando shelveset apply restaura los contenidos almancenados en el
|
||
repositorio.
|
||
|
||
== CMD_USAGE_SHELVESET_APPLY ==
|
||
Sintaxis:
|
||
cm shelveset apply shelve_spec [opciones]
|
||
|
||
shelve_spec: Restaura los contenidos almancenados en el repositorio
|
||
identificados por "shelve_spec"
|
||
|
||
Opciones:
|
||
--mount: El punto de montaje del respositorio especificado.
|
||
--encoding=codificación: Especifica la codificación de los ficheros de
|
||
origen (por ejemplo, UTF-8 o Unicode)
|
||
--comparisonmethod=tipo: cualquiera de las siguientes opciones:
|
||
IgnoreEol: Ignora diferencias de final de línea.
|
||
IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
|
||
IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
|
||
blanco.
|
||
NotIgnore: Detecta diferencias de final de línea y espacios en
|
||
blanco.
|
||
|
||
== CMD_HELP_SHELVESET_APPLY ==
|
||
El comando shelveset apply restaura los contenidos almancenados en el
|
||
repositorio.
|
||
|
||
Ejemplo: Aplicar un shelve almacenado en el repositorio:
|
||
|
||
cm shelveset apply sh:3
|
||
|
||
== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
|
||
Muestra la lista de objetos disponibles y sus atributos correspondientes.
|
||
|
||
== CMD_USAGE_SHOW_FIND_OBJECTS ==
|
||
Sintaxis:
|
||
|
||
cm showfindobjects
|
||
|
||
== CMD_HELP_SHOW_FIND_OBJECTS ==
|
||
Objetos y atributos disponibles:
|
||
|
||
attribute:
|
||
Se puede buscar atributos filtrando por los siguientes campos:
|
||
|
||
Type : string.
|
||
Value : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Comment : string.
|
||
SrcObj : object spec.
|
||
ID : integer.
|
||
|
||
attributetype:
|
||
Se puede buscar tipos de atributo filtrando por los siguientes campos:
|
||
|
||
Name : string.
|
||
Value : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Comment : string.
|
||
Source : object spec.
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
branch:
|
||
Se puede buscar ramas filtrando por los siguientes campos:
|
||
|
||
Name : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Changesets : fecha (de los changesets en la rama).
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Attribute : string.
|
||
AttrValue : string.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
Parent : branch spec.
|
||
Comment : string.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Item : item spec or item id (integer).
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
changeset:
|
||
Se puede buscar changesets filtrando por los siguientes campos:
|
||
|
||
Branch : branch spec.
|
||
ChangesetId : integer.
|
||
Attribute : string.
|
||
AttrValue : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía
|
||
para más info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Comment : string.
|
||
OnlyWithRevisions : boolean.
|
||
ReturnParent : boolean.
|
||
Parent : changeset id (integer).
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
label:
|
||
Se puede buscar etiquetas filtrando por los siguientes campos:
|
||
|
||
Name : string.
|
||
Attribute : string.
|
||
AttrValue : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Branch : branch spec.
|
||
Branchid : integer.
|
||
Changeset : changeset id (integer).
|
||
Comment : string.
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
merge:
|
||
Se puede buscar merges filtrando por los siguientes campos:
|
||
|
||
SrcBranch : branch spec.
|
||
SrcChangeset : changeset id (integer).
|
||
DstBranch : branch spec.
|
||
DstChangeset : changeset id (integer).
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para
|
||
más info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Type : string.
|
||
Los posibles valores son 'merge', 'cherrypick',
|
||
'cherrypicksubstractive', 'interval', 'intervalcherrypick'
|
||
e 'intervalcherrypicksubstractive'
|
||
ID : integer.
|
||
|
||
replicationlog:
|
||
Se puede buscar replication log filtrando por los siguientes campos:
|
||
|
||
Branch : branch spec.
|
||
RepositoryName : string.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para
|
||
más info.
|
||
Server : string.
|
||
Package : boolean.
|
||
ID : integer.
|
||
|
||
review:
|
||
Se puede buscar code reviews filtrando por los siguientes campos:
|
||
|
||
Status : string.
|
||
Assignee : string.
|
||
Title : string.
|
||
Target : object spec.
|
||
TargetId : integer.
|
||
TargetType : string.
|
||
Los posibles valores son 'branch' y 'changeset'.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Id : integer.
|
||
|
||
revision:
|
||
Se puede buscar revisiones filtrando por los siguientes campos:
|
||
|
||
Branch : branch spec.
|
||
Changeset : changeset id (integer).
|
||
Item : string o integer.
|
||
ItemId : integer.
|
||
Attribute : string.
|
||
AttrValue : string.
|
||
Archived : boolean.
|
||
Comment : string.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía
|
||
para más info.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
Parent : revision id (integer).
|
||
ReturnParent : boolean.
|
||
Shelve : shelve id (integer).
|
||
Size : integer (en bytes).
|
||
Type : string.
|
||
Los posibles valores son 'dir', 'bin' y 'txt'.
|
||
WorkspaceCheckoutId : integer.
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
shelve:
|
||
Se puede buscar shelves filtrando por los siguientes campos:
|
||
|
||
Owner : usuario.
|
||
Admite el usuario especial 'me'.
|
||
Date : fecha.
|
||
Consulte la sección "constantes de fecha" en esta guía para más
|
||
info.
|
||
Attribute : string.
|
||
AttrValue : string.
|
||
Comment : string.
|
||
GUID : Identificador Global Único.
|
||
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
||
Parent : integer.
|
||
ShelveId : integer.
|
||
ID : integer.
|
||
|
||
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
|
||
en esta guía para más información sobre:
|
||
ReplLogId
|
||
ReplSrcDate
|
||
ReplSrcId
|
||
ReplSrcRepository
|
||
ReplSrcServer
|
||
|
||
|
||
Campos relacionados con la réplica:
|
||
Muchos objetos mantienen información de replicación, lo que significa que
|
||
Plastic mantiene el rastro de dónde se crearon originalmente.
|
||
|
||
Los campos que se pueden utilizar son:
|
||
|
||
ReplSrcServer : Significa "servidor origen de la réplica", y es el
|
||
servidor de donde se trajeron los objetos.
|
||
|
||
Ejemplo:
|
||
cm find branch "where replsrcserver='skull.codicefactory.com:9095'"
|
||
|
||
ReplSrcRepository : string. Significa "repositorio origen de la réplica",
|
||
y es el repositorio de donde se trajeron los objetos.
|
||
|
||
Ejemplo:
|
||
cm find branch "where \
|
||
replsrcserver = 'skull.codicefactory.com:9095' \
|
||
and replsrcrepository = 'codice'"
|
||
|
||
ReplLogId : integer. El identificador de la operación de réplica. En
|
||
Plastic, cada vez que un objeto nuevo se crea de una réplica,
|
||
también se crea un nuevo 'replicationlog'.
|
||
|
||
Ejemplo:
|
||
cm find replicationlog
|
||
324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T
|
||
327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T
|
||
329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T
|
||
|
||
Ahora se pueden buscar las ramas creadas en la réplica 327255, en
|
||
caso de haber alguna:
|
||
|
||
cm find branch "where replogid=327255"
|
||
|
||
ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo
|
||
lugar. Los objetos replicados mantienen la fecha en la que
|
||
fueron creados originalmente, por lo que este campo es útil
|
||
si se necesita buscar objetos que fueron replicados en un
|
||
determinado marco temporal.
|
||
|
||
Ejemplo:
|
||
cm find replicationlog "where date > 'one week ago'"
|
||
8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
|
||
|
||
Ahora se puede verificar que la rama replicada se creó antes de la
|
||
propia operación de réplica:
|
||
|
||
cm find branch "where repllogid = 8780433"
|
||
8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
|
||
|
||
ReplSrcId: integer. Es el ID del servidor origen de la réplica
|
||
(ReplSrcServer). Este ID se puede descubrir buscando objetos
|
||
de tipo 'replicationsource' con el comando 'cm find'.
|
||
|
||
Ejemplo:
|
||
cm find replicationsource
|
||
7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
|
||
8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
|
||
|
||
Ahora se pueden buscar los changesets replicados desde
|
||
codice@AFRODITA:8087 de la siguiente forma:
|
||
|
||
cm find changesets "where replsrcid = 7860739"
|
||
|
||
|
||
Constantes de fecha:
|
||
Se pueden usar fechas formateadas siguiendo la configuración de localización
|
||
del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato
|
||
'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas.
|
||
|
||
Sin embargo, también se pueden utilizar las siguientes constantes para
|
||
facilitar la escritura de las queries:
|
||
'today' : la fecha de hoy.
|
||
'yesterday' : la fecha de ayer.
|
||
'this week' : la fecha del lunes de la semana actual.
|
||
'this month' : la fecha del primer día del mes actual.
|
||
'this year' : la fecha del 1 de enero del año actual.
|
||
'one day ago' : un día antes de la fecha actual.
|
||
'one week ago' : una semana antes de la fecha actual.
|
||
'one month ago' : un mes antes de la fecha actual.
|
||
'n days ago' : 'n' días antes de la fecha actual.
|
||
'n months ago' : 'n' meses antes de la fecha actual.
|
||
'n years ago' : 'n' años antes de la fecha actual.
|
||
|
||
Las siguientes cláusulas 'where' son válidas para campos que admitan fechas:
|
||
'(...) where date > 'today' (...)'
|
||
'(...) where date < 'yesterday' (...)'
|
||
'(...) where date > 'this week' (...)'
|
||
'(...) where date > 'this month' (...)'
|
||
'(...) where date < 'one day ago' and date > '3 days ago' (...)'
|
||
'(...) where date < 'one week ago' and date > '3 weeks ago' (...)'
|
||
'(...) where date < 'one month ago' and date > '3 months ago' (...)'
|
||
'(...) where date > '1 year ago' (...)'
|
||
|
||
También se puede forzar un determinado formato de fecha en el comando
|
||
'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más
|
||
información.
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
|
||
Muestra la lista de los tipos de triggers disponibles.
|
||
|
||
== CMD_USAGE_TRIGGER_SHOWTYPES ==
|
||
Sintaxis:
|
||
|
||
cm trigger showtypes
|
||
|
||
== CMD_DESCRIPTION_SHOWACL ==
|
||
Muestra la ACL (Lista de Control de Acceso) de un elemento.
|
||
|
||
== CMD_USAGE_SHOWACL ==
|
||
Sintaxis:
|
||
|
||
cm showacl [opciones] spec_objeto
|
||
|
||
spec_objeto Especificación del objeto sobre el que mostrar el ACL.
|
||
Objetos válidos para este comando son repserver,
|
||
repositorio, rama, changeset, etiqueta, item y atributo.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de objetos.
|
||
|
||
Opciones:
|
||
|
||
--extended Muestra información detallada.
|
||
--xml Permite volcar la salida del comando en formato xml
|
||
a la salida estándar. También se permite especificar
|
||
un fichero de salida (--xml=output.xml).
|
||
--encoding Si se utiliza con la opción --xml, permite especificar
|
||
el encoding con el que se guardará la salida del
|
||
comando. Por ejemplo: --encoding=utf-8
|
||
Consulte la documentación de la MSDN para obtener la
|
||
tabla completa de codificaciones soportadas y su formato;
|
||
al final de la página en la columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_SHOWACL ==
|
||
Notas:
|
||
|
||
Este comando se utiliza para obtener una lista de permisos de un usuario o
|
||
un grupo sobre un elemento del repositorio.
|
||
|
||
Ejemplos:
|
||
|
||
cm showacl repserver:PlasticServer:8084
|
||
cm showacl br:/main --extended
|
||
|
||
== CMD_DESCRIPTION_SHOWCOMMANDS ==
|
||
Muestra todos los comandos disponibles.
|
||
|
||
== CMD_USAGE_SHOWCOMMANDS ==
|
||
Sintaxis:
|
||
|
||
cm showcommands
|
||
|
||
== CMD_HELP_SHOWCOMMANDS ==
|
||
|
||
== CMD_DESCRIPTION_SHOWOWNER ==
|
||
Muestra el propietario de un elemento del repositorio.
|
||
|
||
== CMD_USAGE_SHOWOWNER ==
|
||
Sintaxis:
|
||
|
||
cm showowner spec_objeto
|
||
|
||
spec_objeto Especificación del objeto para mostar su propietario.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de objetos.
|
||
El objeto debe ser uno de los siguientes: repserver,
|
||
repositorio, rama, changeset, etiqueta, atributo,
|
||
revisión e item.
|
||
|
||
== CMD_HELP_SHOWOWNER ==
|
||
Notas:
|
||
|
||
Este comando muestra el propietario de un elemento del repositorio.
|
||
Puede ser un usuario o un grupo.
|
||
El propietario se puede modificar con el comando 'cm setowner'.
|
||
|
||
Ejemplos:
|
||
|
||
cm showowner repserver:PlasticServer:8084
|
||
cm showowner rev:fichero.cs#br:/main#LAST
|
||
|
||
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
|
||
Muestra la lista de los permisos disponibles.
|
||
|
||
== CMD_USAGE_SHOWPERMISSIONS ==
|
||
Sintaxis:
|
||
|
||
cm showpermissions
|
||
|
||
== CMD_HELP_SHOWPERMISSIONS ==
|
||
Ejemplos:
|
||
|
||
cm showpermissions
|
||
|
||
== CMD_DESCRIPTION_SHOWSELECTOR ==
|
||
Muestra el selector del espacio de trabajo actual.
|
||
|
||
== CMD_USAGE_SHOWSELECTOR ==
|
||
Sintaxis:
|
||
|
||
cm showselector [wk_ruta | wk_spec]
|
||
|
||
wk_ruta Ruta del espacio de trabajo para mostrar su selector
|
||
wk_spec Especificación del espacio de trabajo para mostrar su
|
||
selector.
|
||
Usa 'cm help objectspec' para obtener más información sobre
|
||
especificaciones de espacios de trabajo.
|
||
|
||
== CMD_HELP_SHOWSELECTOR ==
|
||
Notas:
|
||
|
||
Si no se especifica una ruta o un especificador de espacio de trabajo,
|
||
el comando tomará como ruta el directorio actual.
|
||
|
||
Ejemplos:
|
||
|
||
cm showselector c:\workspace
|
||
cm showselector
|
||
cm showselector > miSelector.txt
|
||
cm showselector wk:build_wk@BUILDER
|
||
|
||
== CMD_DESCRIPTION_SUPPORT ==
|
||
Este comando permite al usuario efectuar operaciones de soporte.
|
||
|
||
== CMD_USAGE_SUPPORT ==
|
||
Sintaxis:
|
||
|
||
cm support comando [opciones]
|
||
|
||
Comandos:
|
||
|
||
bundle
|
||
|
||
Para obtener más información sobre cada uno de los comandos ejecute:
|
||
cm support comando --usage
|
||
cm support comando --help
|
||
|
||
== CMD_HELP_SUPPORT ==
|
||
Ejemplos:
|
||
|
||
cm support
|
||
cm support bundle
|
||
cm support bundle c:\outputfile.zip
|
||
|
||
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
|
||
Crea el paquete de soporte con los ficheros de log relevantes.
|
||
Este paquete se puede adjuntar cuando se solicita la ayuda, cuando
|
||
se pregunte por información extra o cuando se envíe un error.
|
||
|
||
== CMD_USAGE_SUPPORT_BUNDLE ==
|
||
Sintaxis:
|
||
|
||
cm support bundle [outputfile]
|
||
|
||
Opciones:
|
||
|
||
outputfile Crea el paquete de soporte en la ruta especificado.
|
||
|
||
== CMD_HELP_SUPPORT_BUNDLE ==
|
||
Notas:
|
||
|
||
Este comando permite al usuario crear un paquete de soporte con los
|
||
ficheros de log relevantes. Es posible especificar un fichero de salida.
|
||
|
||
Ejemplos:
|
||
|
||
cm support bundle
|
||
(Crea el paquete de soporte en el directorio temporal)
|
||
|
||
cm support bundle c:\outputfile.zip
|
||
(Crea el paquete de soporte en la ruta especificado)
|
||
|
||
== CMD_DESCRIPTION_SWITCH ==
|
||
Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado.
|
||
|
||
== CMD_USAGE_SWITCH ==
|
||
Sintaxis:
|
||
|
||
cm switch brspec | csetspec | lbspec | shspec [--repository=name]
|
||
[--workspace=path]
|
||
|
||
Opciones:
|
||
|
||
--workspace Ruta del espacio de trabajo a cambiar.
|
||
--repository Repositorio al que se va a cambiar.
|
||
|
||
Usa 'cm help objectspec' para aprender más sobre cómo indicar
|
||
especificaciones de changesets, ramas y etiquetas.
|
||
|
||
== CMD_HELP_SWITCH ==
|
||
Notas:
|
||
|
||
Este comando permite a los usuarios actualizar el espacio de trabajo
|
||
con el contenido del objeto especificado (rama, etiqueta o changeset).
|
||
|
||
Ejemplos:
|
||
|
||
cm switch br:/main
|
||
cm switch lb:Rel1.1
|
||
cm switch Rel2.0
|
||
cm switch cs:4375
|
||
cm switch 5632
|
||
cm switch sh:2
|
||
|
||
== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
|
||
Establece la rama especificada como rama de trabajo.
|
||
|
||
== CMD_USAGE_SWITCH_TO_BRANCH ==
|
||
Sintaxis:
|
||
|
||
cm switchtobranch [opciones] [spec_rama]
|
||
|
||
spec_rama: Especificación de rama.
|
||
|
||
Opciones:
|
||
|
||
--label=nombre | --changeset=número: Carga las revisiones de la etiqueta
|
||
o changeset especificado. Si no se especifica spec_rama, una de
|
||
estas opciones es obligatoria.
|
||
|
||
--workspace | -wk=path: Ruta del espacio de trabajo a cambiar.
|
||
|
||
== CMD_HELP_SWITCH_TO_BRANCH ==
|
||
Notas:
|
||
|
||
Este comando permite a los usuarios especificar una rama, como rama de
|
||
trabajo. Adicionalmente se puede especificar una etiqueta o un changeset,
|
||
desde la cual se cargarán las revisiones.
|
||
Si no se especifica rama, se ha de especificar una etiqueta o un changeset
|
||
obligatoriamente. Consulte el manual para obtener más información.
|
||
Si no se especifica repositorio, la rama se fija sobre el repositorio
|
||
actual.
|
||
|
||
Ejemplos:
|
||
|
||
cm switchtobranch br:/main
|
||
cm switchtobranch br:/main/tarea001
|
||
cm switchtobranch --label=BL050
|
||
(Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado)
|
||
|
||
== CMD_DESCRIPTION_SYNC ==
|
||
Sincroniza con Git
|
||
|
||
== CMD_USAGE_SYNC ==
|
||
Sintaxis:
|
||
|
||
cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author]
|
||
[[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value]
|
||
|
||
repspec Especificación del repositorio.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de repositorios.
|
||
git (Default).
|
||
|
||
Opciones:
|
||
|
||
url URL del repositorio remoto
|
||
(http(s):// o git:// o una URL ssh).
|
||
--user Nombre de usuario para la URL especificada.
|
||
--pwd Contraseña para la URL especificada.
|
||
--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent
|
||
Opciones para detectar ítems movidos, del mismo modo que
|
||
lo hace la GUI de Plastic SCM.
|
||
--author Usa los valores de nombre y fecha (timestamp) del autor
|
||
en git (git committer by default).
|
||
--skipgitlfs Ignora la configuración de Git LFS que haya en el
|
||
fichero '.gitattributes'. Se comporta como si no
|
||
tuviese soporte de Git LFS.
|
||
|
||
== CMD_HELP_SYNC ==
|
||
Notas:
|
||
|
||
En caso de sincronizar con un servidor que no requiera credenciales, tras
|
||
la primera sincronización no es necesario introducir el parámetro URL.
|
||
Este comando no soporta repositorios locales.
|
||
|
||
En el caso de usar el protocolo SSH, es necesario tener añadido al PATH
|
||
el cliente por línea de comandos 'ssh' y que esté correctamente configurado
|
||
para conectarse al servidor remoto (claves públicas/privadas).
|
||
|
||
Ejemplos:
|
||
|
||
cm sync default@localhost:8087 git git://localhost/repository
|
||
|
||
== CMD_DESCRIPTION_TRIGGER ==
|
||
Use este comando para administrar triggers.
|
||
|
||
== CMD_USAGE_TRIGGER ==
|
||
Sintaxis:
|
||
|
||
cm trigger | tr command [opciones]
|
||
|
||
Comandos:
|
||
|
||
create | mk
|
||
delete | rm
|
||
edit
|
||
list | ls
|
||
showtypes
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm trigger command --usage
|
||
cm trigger command --help
|
||
|
||
== CMD_HELP_TRIGGER ==
|
||
Ejemplos:
|
||
|
||
cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
|
||
cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
|
||
cm tr ls before-mkbranch --server=myserver:8084
|
||
cm tr rm after-setselector 4
|
||
cm tr showtypes
|
||
|
||
== CMD_DESCRIPTION_TUBE ==
|
||
Ejecuta comandos relacionados con Plastic Tube.
|
||
|
||
== CMD_USAGE_TUBE ==
|
||
Sintaxis:
|
||
|
||
cm tube config -u=user -p=password
|
||
|
||
cm tube create remoteuser
|
||
cm tube remove remoteuser
|
||
|
||
cm tube local
|
||
cm tube remote
|
||
|
||
cm tube share <repository_spec>+ -u=remoteuser -a=access_mode
|
||
cm tube unshare <repository_spec>+ -u=remoteuser
|
||
|
||
cm tube connect
|
||
cm tube disconnect
|
||
cm tube status
|
||
|
||
Opciones:
|
||
|
||
-u Usuario de Tube (el usuario de plasticscm.com)
|
||
-p Password del usuario
|
||
-a Acceso: pull, push o ambos (pull | push | pull,push)
|
||
rep_spec Especificación del repositorio.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de repositorios.
|
||
|
||
== CMD_HELP_TUBE ==
|
||
Notas:
|
||
|
||
config
|
||
Configura Plastic SCM para usar Plastic Tube con el usuario y password
|
||
especificados.
|
||
|
||
create
|
||
Crea el Tube remoteuser -> myuser.
|
||
El usuario 'myuser' permite a 'remoteuser' conectarse al servidor
|
||
de 'myuser'.
|
||
Pueden establecerse conexiones de 'remoteuser' a 'myuser'.
|
||
Sólo pueden crearse un Tube de otro usuario al usuario actual de
|
||
Plastic Tube.
|
||
remove
|
||
Elimina el Tube remoteuser -> myuser.
|
||
|
||
local
|
||
Lista los repositorios locales compartidos en el servidor local y los
|
||
usuarios con quien son compartidos.
|
||
remote
|
||
Lista los repositorios remotamente compartidos que son compartidos con
|
||
el usuario actual de Plastic Tube.
|
||
|
||
share
|
||
Comparte el repositorio(s) local con el usuario y remoto y los permisos
|
||
especificados.
|
||
unshare
|
||
Deja de compartir el repositorio local con el usuario remoto.
|
||
|
||
connect
|
||
Conecta el servidor de Plastic SCM a Plastic Tube.
|
||
disconnect
|
||
Desconecta el servidor de Plastic SCM de Plastic Tube.
|
||
status
|
||
Muestra si el servidor de Plastic SCM está conectado a Plastic Tube.
|
||
|
||
Ejemplos:
|
||
|
||
cm tube config -u=ruben@codicesoftware.com -p=rubenpassword
|
||
|
||
cm tube create pablo@codicesoftware.com
|
||
('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube)
|
||
cm tube remove pablo@codicesoftware.com
|
||
|
||
cm tube local
|
||
cm tube remote
|
||
|
||
cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push
|
||
cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push
|
||
cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com
|
||
|
||
cm tube connect
|
||
cm tube disconnect
|
||
cm tube status
|
||
|
||
== CMD_DESCRIPTION_UNCO ==
|
||
Deshace la desprotección de un ítem.
|
||
|
||
== CMD_USAGE_UNCO ==
|
||
Sintaxis:
|
||
|
||
cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent]
|
||
|
||
item_path Especificación de los ítems para deshacer la desprotección,
|
||
separados por comas.
|
||
Se pueden usar comillas (") para especificar rutas que
|
||
contengan espacios.
|
||
Use . para aplicar la operación al directorio actual.
|
||
|
||
Opciones:
|
||
|
||
--all (-a) Los ítems especificados que han sido cambiados, movidos y
|
||
borrados localmente también serán deshechos.
|
||
|
||
--symlink Deshace la protección del fichero de link y no al elemento
|
||
al que apunta.
|
||
|
||
--silent No muestra salida.
|
||
|
||
== CMD_HELP_UNCO ==
|
||
Notas:
|
||
|
||
Si se desean descartar los cambios realizados en un ítem desprotegido
|
||
previamente, se utiliza este comando.
|
||
El ítem se cambia a la revisión justamente anterior.
|
||
|
||
Requisitos para deshacer la desprotección:
|
||
|
||
El ítem ha de estar controlado por Plastic
|
||
El ítem ha de estar desprotegido
|
||
|
||
|
||
Ejemplos:
|
||
|
||
cm undocheckout .
|
||
(Desprotege el directorio actual)
|
||
|
||
cm undocheckout fichero1.txt fichero2.txt
|
||
|
||
cm unco c:\workspace\fichero.txt
|
||
|
||
cm undocheckout -R c:\workspace\src
|
||
(Deshace la desprotección de 'src' recursivamente)
|
||
|
||
cm unco link --symlink
|
||
(Efectúa la desprotección sobre el fichero de link y no del que apunta,
|
||
disponible en entornos UNIX)
|
||
|
||
cm unco code\cgame\cg_main.c --all
|
||
(Deshace la desprotección del fichero cambiado)
|
||
|
||
Deshacer 'changelist'. Ejemplo:
|
||
|
||
cm status --short --changelist=pending_to_review | cm undocheckout -
|
||
(El comando listará los paths en el changelist llamado 'pending_to_review'
|
||
y dicha lista será redirigida a la entrada del comando 'uncheckout').
|
||
|
||
== CMD_DESCRIPTION_UNCOUNCHANGED ==
|
||
Deshace la desprotección en elementos que no han cambiado.
|
||
|
||
== CMD_USAGE_UNCOUNCHANGED ==
|
||
Sintaxis:
|
||
|
||
cm uncounchanged [opciones]
|
||
|
||
Opciones:
|
||
|
||
-R|-r|--recursive Descender recursivamente dentro de directorios.
|
||
|
||
== CMD_HELP_UNCOUNCHANGED ==
|
||
Notas:
|
||
|
||
Este comando se aplica desde la raíz del workspace recursivamente.
|
||
|
||
Ejemplos:
|
||
|
||
cm uncounchanged
|
||
|
||
== CMD_DESCRIPTION_UNDELETE ==
|
||
Recupera en el espacio de trabajo la revisión especificada en la ruta dada.
|
||
|
||
== CMD_USAGE_UNDELETE ==
|
||
Sintaxis:
|
||
|
||
cm undelete rev_spec ruta
|
||
|
||
rev_spec: Especificación de la revisión del ítem cuyo contenido se desea
|
||
cargar en el espacio de trabajo.
|
||
path: Ruta donde se va a restaurar.
|
||
|
||
== CMD_HELP_UNDELETE ==
|
||
Notas:
|
||
|
||
El elemento a recuperar no debe de estar ya cargado en el workspace.
|
||
|
||
La operación de recuperar no esta soportada para xlinks.
|
||
|
||
Ejemplo:
|
||
|
||
cm undelete revid:756 C:\mywks\src\foo.c
|
||
cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf
|
||
cm undelete serverpath:/src#br:/main C:\mywks\Dir
|
||
|
||
== CMD_DESCRIPTION_UNDOCHANGE ==
|
||
Deshace los cambios hechos en un fichero.
|
||
|
||
== CMD_USAGE_UNDOCHANGE ==
|
||
Notas:
|
||
|
||
Si se desean descartar los cambios en un ítem, independientemente de su
|
||
estado (desprotegido o modificado sin hacer desprotección), este comando
|
||
vuelve a la revisión anterior. Si se ordena realizar la operación sobre
|
||
un directorio en vez de un fichero la acción se realiza recursivamente por
|
||
defecto.
|
||
|
||
Ejemplo:
|
||
|
||
cm unc . (Descarta los cambios de los ítems del directorio actual).
|
||
cm unc fichero1.txt fichero2.txt
|
||
cm unc c:\workspace\fichero1.txt
|
||
|
||
== CMD_HELP_UNDOCHANGE ==
|
||
Ejemplo:
|
||
|
||
cm unc . (Descarta los cambios de los ítems del directorio actual).
|
||
cm unc fichero1.txt fichero2.txt
|
||
cm unc c:\workspace\fichero1.txt
|
||
|
||
== CMD_DESCRIPTION_LOCK_UNLOCK ==
|
||
Deshace los bloqueos en los elementos del servidor de bloqueos especificado
|
||
|
||
== CMD_USAGE_LOCK_UNLOCK ==
|
||
Sintaxis:
|
||
|
||
cm lock unlock [repserverspec] <guid>+
|
||
|
||
repserverspec Especificación del servidor de repositorio.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de servidores.
|
||
guid Lista de GUIDs de ítems a desbloquear, separados por
|
||
espacios.
|
||
|
||
== CMD_DESCRIPTION_UNDO ==
|
||
Deshace cambios en un workspace.
|
||
|
||
== CMD_USAGE_UNDO ==
|
||
Syntaxis:
|
||
|
||
cm undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
|
||
[Opciones de salida]
|
||
|
||
path Rutas de los ficheros o carpetas a los que aplicar
|
||
la operación, separados por espacios. Se pueden
|
||
utilizar comillas (") para especificar rutas con
|
||
espacios. Si no se especifica ninguna ruta, por
|
||
defecto la operación se ejecutará sobre los ficheros
|
||
en el directorio actual.
|
||
|
||
Opciones:
|
||
|
||
--symlink Aplica la operación de undo al enlace simbólico y
|
||
no a su destino.
|
||
-r Ejecuta el undo de manera recursiva.
|
||
|
||
Filtros:
|
||
|
||
Si ninguna de estas opciones está presente, por defecto se deshacen todos
|
||
los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
|
||
opciones.
|
||
Si un fichero o directorio tiene uno o más de los tipos de cambio
|
||
especificados, todos los cambios en ese fichero o directorio serán
|
||
deshechos.
|
||
Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
|
||
está tanto movido como checkedout, ambos cambios se desharán.
|
||
|
||
--checkedout Selecciona ficheros y directorios marcados para
|
||
cambios.
|
||
--unchanged Selecciona ficheros sin modificaciones en su
|
||
contenido.
|
||
--changed Selecciona ficheros y directorios cambiados o
|
||
marcados para cambios.
|
||
--deleted Selecciona ficheros y directorios eliminados.
|
||
--moved Selecciona ficheros y directorios movidos.
|
||
--added Selecciona ficheros y directorios añadidos.
|
||
|
||
Opciones de salida:
|
||
|
||
--silent | --machinereadable [--startlineseparator=sep]
|
||
[--endlineseparator=sep] [--fieldseparator=sep]
|
||
|
||
--silent No muestra ninguna salida.
|
||
--machinereadable Muestra la salida en un formato fácil de tratar.
|
||
--startlineseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían comenzar las líneas.
|
||
--endlineseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían terminar las líneas.
|
||
--fieldseparator Usado en conjunto con la opción '--machinereadable',
|
||
especifica cómo deberían separarse las líneas.
|
||
|
||
== CMD_HELP_UNDO ==
|
||
Notas:
|
||
|
||
El comand undo es peligroso - deshace trabajo de una manera irreversible.
|
||
Una vez que el undo termina, no hay manera posible de recuperar el estado
|
||
anterior de los ficheros y directorios afectados. Si no se especifica
|
||
ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
|
||
los elementos del directorio actual, pero NO de manera recursiva.
|
||
|
||
Estos comandos son equivalentes ejecutados desde el directorio /src:
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
$ cm undo
|
||
$ cm undo *
|
||
$ cm undo file.txt code.cs /test
|
||
|
||
$ cm undo .
|
||
$ cm undo /src file.txt code.cs
|
||
|
||
Si se quiere que la operación sea recursiva, se necesita especificar la
|
||
opción -r.
|
||
|
||
Para deshacer todos los cambios debajo de un directorio (incluyendo los
|
||
cambios sobre el propio directorio):
|
||
|
||
$ cm undo dirpath -r
|
||
|
||
Si dirpath es la ruta de un workspace, todos los cambios dentro del
|
||
workspace serán deshechos.
|
||
|
||
Ficheros borrados:
|
||
|
||
Para deshacer borrados de fichero o directorios es necesario especificar la
|
||
ruta completa del fichero o directorio, o el directorio padre más la opción
|
||
-r (recursivo).
|
||
|
||
Por ejemplo:
|
||
|
||
$ cm undo .
|
||
(NO deshace los borrados en el directorio actual.)
|
||
|
||
$ cm undo . -r
|
||
(Deshace todos los borrados (y otros cambios) recursivamente del directorio
|
||
actual.)
|
||
|
||
$ cm undo src/file.txt
|
||
(Deshace el borrado (u otro cambio) del fichero src/file.txt.)
|
||
|
||
Ejemplos:
|
||
|
||
$ cm undo . -r
|
||
(Deshace todos los cambios en el directorio actual de manera recursiva. Si
|
||
se ejecuta desde la raíz del workspace, deshace todos los cambios en el
|
||
workspace completo.)
|
||
|
||
$ cm co file.txt
|
||
$ cm undo file.txt
|
||
(Deshace el checkout en file.txt.)
|
||
|
||
$ echo content >> file.txt
|
||
$ cm undo file.txt
|
||
(Deshace el cambio local en file.txt.)
|
||
|
||
$ cm undo src
|
||
(Deshace los cambios en el directorio src y en todos los ficheros
|
||
controlados que contenga)
|
||
|
||
$ cm undo src/*
|
||
(Deshace los cambios en todos los elementos contenidos en src, sin afectar
|
||
al propio directorio. Por la expansión del wildcard, es equivalente a
|
||
'cm undo src/file1.txt src/file2.txt').
|
||
|
||
$ cm undo *.cs
|
||
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
|
||
directorio actual.)
|
||
|
||
$ cm undo *.cs -r
|
||
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
|
||
directorio actual, y en cada directorio por debajo de una manera recursiva.)
|
||
|
||
$ cm co file1.txt file2.txt
|
||
$ echo content >> file1.txt
|
||
$ cm undo --unchanged
|
||
(Deshace el checkout en file2.txt por no estar modificado, ignorando
|
||
file1.txt ya que tiene cambios locales.)
|
||
|
||
$ echo content >> file1.txt
|
||
$ echo content >> file2.txt
|
||
$ cm co file1.txt
|
||
$ cm undo --checkedout
|
||
(Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
|
||
ya que no está en checkout.)
|
||
|
||
$ cm add file.txt
|
||
$ cm undo file.txt
|
||
(Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
|
||
|
||
$ rm file1.txt
|
||
$ echo content >> file2.txt
|
||
$ cm add file3.txt
|
||
$ cm undo --deleted --added *
|
||
(Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
|
||
el cambio en file2.txt.)
|
||
|
||
== CMD_HELP_LOCK_UNLOCK ==
|
||
Ejemplos:
|
||
|
||
cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 bcb98a61-2f62-4309-9a26-e21a2685e075
|
||
|
||
Notas:
|
||
|
||
El comando utilizará el servidor especificado para realizar los desbloqueos.
|
||
Si no se especifica ningún servidor, el comando intentará obtener un
|
||
servidor válido a través del espacio de trabajo actual.
|
||
Si con los pasos anteriores no se pudo calcular ningún servidor, el comando
|
||
utilizará el servidor especificado en la configuración del cliente.
|
||
|
||
Sólo el usuario administrador del servidor de repositorios podrá ejecutar
|
||
el comando "cm unlock".
|
||
|
||
Para la especificación de los GUID's de los elementos, el formato ha de ser
|
||
de 32 dígitos separados por guiones (y opcionalmente, rodeado por llaves):
|
||
|
||
{00000000-0000-0000-0000-000000000000} ó 00000000-0000-0000-0000-000000000000
|
||
|
||
== CMD_DESCRIPTION_UPDATE ==
|
||
Actualiza el espacio de trabajo.
|
||
|
||
== CMD_USAGE_UPDATE ==
|
||
Sintaxis:
|
||
cm update [<ruta> | --last]
|
||
[--changeset=csetspec] [--cloaked] [--dontmerge] [--forced]
|
||
[--ignorechanges] [--override] [--recursewk] [--skipchangedcheck]
|
||
[--silent] [--verbose] [--xml[=output_file]] [--encoding=name]
|
||
|
||
ruta Ruta a actualizar.
|
||
Usa . para aplicar la actualización al directorio actual.
|
||
Omita la ruta para actualizar todo el espacio de trabajo
|
||
Si no se especifica ninguna ruta, entonces se actualiza
|
||
todo el espacio de trabajo parcial.
|
||
--last Antes de la actualización, cambia el selector del
|
||
espacio de trabajo de una configuración de changeset o
|
||
de etiqueta a una configuración de rama.
|
||
El selector se cambia a la rama a la que pertenece el
|
||
changeset o la etiqueta.
|
||
|
||
Opciones:
|
||
|
||
--changeset Actualiza el espacio de trabajo a un changeset concreto.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de changesets.
|
||
--cloaked Incluye los ítems cloaked en la operación de update. Si
|
||
no se utiliza esta opción, aquellos ítems marcados como
|
||
cloaked serán ignorados en la operación.
|
||
--dontmerge En el caso en que se necesite una operación de update
|
||
merge, esta operación no se realizará.
|
||
--forced Fuerza la escritura de todas las revisiones.
|
||
--ignorechanges Ignora el mensaje de aviso de "cambios pendientes" si
|
||
existen cambios pendientes durante la actualización del
|
||
espacio de trabajo.
|
||
--override Se ignoran los ficheros cambiados fuera del control de
|
||
Plastic SCM, sobrescribiendo su contenido con el del
|
||
control de versiones.
|
||
--recursewk Actualiza todos los espacios de trabajo encontrados en
|
||
la actual ruta. Esto es útil para actualizar todos los
|
||
espacios de trabajo contenidos en la ruta especificada.
|
||
--skipchangedcheck El update comprueba si hay cambios locales en el
|
||
workspace antes de empezar. Si siempre haces co antes
|
||
de modificar un fichero, puedes usar esta opción para
|
||
acelarar la operación.
|
||
--silent No muestra ninguna salida.
|
||
--verbose Muestra información adicional.
|
||
--xml Permite volcar la salida del comando en formato xml a la
|
||
salida estándar. También se permite especificar un
|
||
fichero de salida (--xml=output.xml).
|
||
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
|
||
redirige la salida estándar.
|
||
--encoding Si se utiliza con la opción --xml, permite especificar
|
||
el encoding con el que se guardará la salida del
|
||
comando. Consulte la documentación de MSDN para obtener
|
||
la tabla completa de codificaciones soportadas y su
|
||
formato (al final de la página, en la columna "Name"):
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
|
||
== CMD_HELP_UPDATE ==
|
||
Notas:
|
||
|
||
Cuando se trabaja con varias ramas o cuando varias personas trabajan contra
|
||
una rama, la información que tenemos en el espacio de trabajo puede quedar
|
||
desactualizada. El caso más sencillo se da cuando cambiamos de rama. Al
|
||
cambiar el selector apuntando a otra rama, debemos actualizar el espacio de
|
||
trabajo con las revisiones de esa rama.
|
||
|
||
Cuando varias personas trabajan contra una rama, crean revisiones nuevas
|
||
cada poco tiempo y es fundamental poder actualizar el espacio de trabajo
|
||
para obtener las últimas revisiones.
|
||
|
||
Para ello utilizaremos el comando update. Este comando actualiza el espacio
|
||
de trabajo con las revisiones que se le indiquen en el selector.
|
||
|
||
Solamente obtiene los ficheros necesarios. Si la revisión que hay en el
|
||
espacio de trabajo coincide con la que hay en el repositorio no se
|
||
actualiza, a no ser que se utilice la opción -–forced. Si la revisión del
|
||
espacio de trabajo es más nueva que la que hay en el repositorio tampoco
|
||
se actualiza. En este caso no nos valdrá la opción -–forced.
|
||
|
||
NOTA: El comando update siempre asume recursividad.
|
||
|
||
Cuando se especifica la opción --last, no es necesario especificar una ruta.
|
||
En ese caso, el espacio de trabajo del directorio actual es actualizado.
|
||
(Recuerde que al especificar el flag --last puede causar que el selector
|
||
del espacio de trabajo cambie a una rama si previamente apuntaba a un
|
||
changeset o una etiqueta).
|
||
|
||
Ejemplos:
|
||
|
||
cm update (actualiza el espacio de trabajo actual)
|
||
cm update . (obtiene el directorio actual y todos sus hijos)
|
||
cm update . --forced --verbose (fuerza a escibir todas las revisiones,
|
||
y muestra más información)
|
||
cm udpate --last
|
||
|
||
== CMD_DESCRIPTION_VERSION ==
|
||
Muestra el número de versión del cliente.
|
||
|
||
== CMD_USAGE_VERSION ==
|
||
Sintaxis:
|
||
|
||
cm version
|
||
|
||
== CMD_HELP_VERSION ==
|
||
|
||
== CMD_DESCRIPTION_WHOAMI ==
|
||
Muestra el usuario actual de Plastic SCM.
|
||
|
||
== CMD_USAGE_WHOAMI ==
|
||
Sintaxis:
|
||
|
||
cm whoami
|
||
|
||
== CMD_HELP_WHOAMI ==
|
||
|
||
== CMD_USAGE_WKTREENODESTATUS ==
|
||
Uso:
|
||
|
||
cm wktreenodestatus path1, path2, ...
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE ==
|
||
Use este comando para administrar workspaces.
|
||
|
||
== CMD_USAGE_WORKSPACE ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk comando [options]
|
||
|
||
Comandos:
|
||
|
||
list | ls
|
||
create | mk
|
||
delete | rm
|
||
move | mv
|
||
rename
|
||
|
||
Para obtener más información sobre cada comando:
|
||
cm workspace comando --usage
|
||
cm workspace comando --help
|
||
|
||
== CMD_HELP_WORKSPACE ==
|
||
Ejemplos:
|
||
|
||
cm workspace create myWorkspace wk_path
|
||
cm workspace list
|
||
cm workspace delete myWorkspace
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_CREATE ==
|
||
Crea un nuevo workspace.
|
||
|
||
== CMD_USAGE_WORKSPACE_CREATE ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk [create | mk] nombre ruta [rep_spec] [--selector[=selector_file]
|
||
nombre ruta --dynamic --tree=[tree]
|
||
|
||
nombre Nombre del nuevo workspace.
|
||
ruta Ruta de acceso del workspace.
|
||
rep_spec Crea el nuevo workspace con el repositorio especificado.
|
||
Use 'cm help objectspec' para obtener más
|
||
información sobre especificaciones de repositorios.
|
||
|
||
Opciones:
|
||
|
||
--selector Edita el selector para el nuevo workspace.
|
||
Si se especifica selector-file, entonces el selector
|
||
para el nuevo workspace se fiha desde el fichero
|
||
especificado.
|
||
--dynamic Crea un workspace dinámico. Esta funcionalidad es
|
||
todavía experimental, y solo está disponible para
|
||
Windows. Si se usa esta opción, es obligatorio usar el
|
||
parámetro --tree.
|
||
--tree Especifica el punto inicial al que apuntará el
|
||
workspace dinámico. Puede ser una especificación de
|
||
rama, changeset o etiqueta. El workspace continuará
|
||
usando el repositorio de la especificación. Use
|
||
'cm help objectspec' para obtener más información sobre
|
||
la especificación.
|
||
|
||
== CMD_HELP_WORKSPACE_CREATE ==
|
||
Notas:
|
||
|
||
- Un workspace es una vista del repositorio mapeado en el sistema de
|
||
ficheros local, en un directorio especificado. Utilice los comandos
|
||
'cm showselector' y 'cm setselector' para ver y modificar el selector.
|
||
- Si no se especifica rep_spec ni --selector, el workspace cargará
|
||
automáticamente el contenido del primer repositorio (alfabéticamente) del
|
||
servidor configurado en el fichero de configuración client.conf
|
||
- Los workspaces dinámicos son una funcionalidad experimental (sólo Windows),
|
||
y requiere que el programa plasticfs.exe se esté ejecutando en segundo
|
||
plano.
|
||
|
||
Ejemplos:
|
||
|
||
cm workspace create myworkspace c:\workspace
|
||
cm wk mk myworkspace /home/john/wkspace
|
||
(Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace'
|
||
respectivamente.)
|
||
|
||
cm wk mywktest c:\wks\wktest --selector=myselector.txt
|
||
(Crea 'mywktest' utilizando como selector 'myselector.txt'.)
|
||
|
||
cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084
|
||
(Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.)
|
||
|
||
cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084
|
||
(Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el
|
||
repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera
|
||
vez que se monte.)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_DELETE ==
|
||
Borra un workspace.
|
||
|
||
== CMD_USAGE_WORKSPACE_DELETE ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata]
|
||
|
||
ruta Ruta del workspace.
|
||
wkspec Especificación del workspace a borrar.
|
||
Use 'cm help objectspec' para obtener más información sobre la
|
||
especificación de espacios de trabajo.
|
||
|
||
Opciones:
|
||
|
||
--keepmetadata: No elimina los archivos de metadatos del directorio
|
||
.plastic.
|
||
|
||
== CMD_HELP_WORKSPACE_DELETE ==
|
||
Notas:
|
||
|
||
Si no se especifican parámetros, se borrará el workspace actual.
|
||
|
||
Ejemplos:
|
||
|
||
cm workspace delete
|
||
(Elimina el workspace actual)
|
||
|
||
cm wk delete c:\workspace
|
||
cm workspace rm /home/danipen/wks
|
||
cm wk rm wk:MiWorkspace
|
||
cm wk rm wk:MiWorkspace@DIGITALIS
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_LIST ==
|
||
Muestra la lista de workspaces.
|
||
|
||
== CMD_USAGE_WORKSPACE_LIST ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk [list | ls] [--format=str_format]
|
||
|
||
Opciones:
|
||
|
||
--format Devuelve el mensaje de respuesta con el formato
|
||
especificado. Consulte la ayuda para más información.
|
||
|
||
== CMD_HELP_WORKSPACE_LIST ==
|
||
Notas:
|
||
|
||
Este comando acepta una cadena de texto formateada para mostrar la
|
||
salida.
|
||
|
||
Los parámetros de salida del comando son los siguientes:
|
||
|
||
{0} | {wkname} Nombre del workspace.
|
||
{1} | {machine} Nombre de la máquina.
|
||
{2} | {path} Ruta del workspace.
|
||
{3} | {wkid} Identificador único del workspace.
|
||
{4} | {wkspec} Especificación del workspace en el formato:
|
||
'wkname@machine'.
|
||
{tab} Inserta un tabulador.
|
||
{newline} Inserta una nueva línea.
|
||
|
||
Ejemplos:
|
||
|
||
cm wk
|
||
(Lista todos los workspaces.)
|
||
|
||
cm workspace list --format={0}#{3,40}
|
||
cm workspace list --format={wkname}#{wkid,40}
|
||
(Lista todos los workspaces mostrando el nombre del workspaces, el
|
||
símbolo '#' y el identificador del workspace utilizando 40 espacios y
|
||
alineado a la izquierda.)
|
||
|
||
cm wk --format="Workspace {0} in path {2}"
|
||
cm wk --format="Workspace {wkname} in path {path}"
|
||
(Lista todos los workspaces, mostrando los resultados en cadenas
|
||
formateadas.)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_MOVE ==
|
||
Mueve un workspace.
|
||
|
||
== CMD_USAGE_WORKSPACE_MOVE ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk move | mv [wkspec] ruta
|
||
|
||
Opciones:
|
||
|
||
wkspec Especificación del workspace a ser movido.
|
||
Use 'cm help objectspec' para obtener más información sobre la
|
||
especificación de espacios de trabajo.
|
||
ruta La ruta destino a la que mover el workspace.
|
||
|
||
== CMD_HELP_WORKSPACE_MOVE ==
|
||
Notas:
|
||
|
||
Este comando permite al usuario mover workspace a otro lugar en disco.
|
||
|
||
Ejemplos:
|
||
|
||
cm workspace move myWorkspace \new\workspaceDirectory
|
||
(Mueve el workspace a la ruta especificada.)
|
||
|
||
cm wk mv C:\wkspaces\newpath
|
||
(Mueve el workspace de trabajo a 'C:\wkspaces\newpath')
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_RENAME ==
|
||
Cambia el nombre de un workspace.
|
||
|
||
== CMD_USAGE_WORKSPACE_RENAME ==
|
||
Sintaxis:
|
||
|
||
cm workspace | wk rename [nombre_antiguo] nombre_nuevo
|
||
|
||
nombre_antiguo Nombre antiguo del workspace.
|
||
nombre_nuevo Nombre nuevo del workspace.
|
||
|
||
== CMD_HELP_WORKSPACE_RENAME ==
|
||
Notas:
|
||
|
||
Este comando renombra un workspace. Si no se especifica nombre_antiguo,
|
||
el sistema tomará el nombre del workspace actual.
|
||
|
||
Ejemplos:
|
||
|
||
cm workspace rename miworkspace wk2
|
||
(El workspace 'miworkspace' se renombra a 'wk2'.)
|
||
|
||
cm wk rename nuevoNombre
|
||
(El workspace actual se renombra a 'nuevoNombre'.)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACESTATUS ==
|
||
Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene.
|
||
|
||
== CMD_USAGE_WORKSPACESTATUS ==
|
||
Sintaxis:
|
||
|
||
cm status [workspacepath] [opciones] [tipos_de_búsqueda]
|
||
|
||
workspacepath: El path de un workspace determinado o una ruta por debajo
|
||
del mismo. La búsqueda de cambiados se realizará a partir del path
|
||
especificado y de manera recursiva.
|
||
|
||
Opciones generales:
|
||
|
||
--changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME".
|
||
--changelists: Muestra los cambios agrupados en 'changelists'.
|
||
--cutignored: Evita mostrar los contenidos de los directorios ignorados.
|
||
Requiere el tipo de búsqueda --ignored.
|
||
--header: Solo imprimirá la información del changeset cargado en el
|
||
workspace, no realizará la búsqueda de elementos cambiados.
|
||
--noheader: El comando no imprimirá el estado del workspace, sólo
|
||
realizará e imprimirá la búsqueda de elementos cambiados.
|
||
--nomergesinfo: La información de los merges de los cambios no se imprimirá.
|
||
--head: El comando imprimirá el estado del último changeset de la rama.
|
||
--short: Muestra únicamente rutas de elementos que tienen cambios.
|
||
--symlink: Aplica la operación a los enlaces simbólicos en lugar de
|
||
aplicarla a sus destinos.
|
||
--dirwithchanges: Muestra directorios que contienen cambios (ítems
|
||
añadidos, movidos o eliminados en su interior).
|
||
--xml: Permite volcar la salida del comando en formato xml. Por defecto la
|
||
salida sale en la pantalla, pero si se especifica un fichero
|
||
(--xml=output.xml) la salida se vuelca en dicho fichero.
|
||
--encoding: si se utiliza con la opción --xml, permite especificar el
|
||
encoding con el que se guardará la salida del comando. Consulte la
|
||
documentación de la MSDN para obtener la tabla completa de
|
||
codificaciones soportadas y su formato; al final de la página en la
|
||
columna "Name":
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
--wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del
|
||
workspace en vez de rutas relativas al directorio actual.
|
||
--fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas,
|
||
sobreescribiendo cualquier otra configuración acerca de impresión
|
||
de rutas.
|
||
|
||
Opciones del viejo formato:
|
||
|
||
--cset: El comando imprimirá el estado del workspace en el viejo formato.
|
||
--compact: El comando imprimirá el estado del workspace y la búsqueda de
|
||
elementos cambiados en el viejo formato.
|
||
--noheaders: Usado junto con --compact, la información de cada grupo de
|
||
cambiós no se imprimirá. (No aplica al nuevo formato.)
|
||
|
||
Tipos de búsqueda:
|
||
|
||
--added: El comando busca elementos añadidos.
|
||
--checkout: El comando busca elementos en checkout.
|
||
--changed: El comando busca elementos cambiados.
|
||
--copied: El comando busca elementos copiados.
|
||
--replaced: El comando busca elementos reemplazados.
|
||
--deleted: El comando busca elementos borrados.
|
||
--localdeleted: El comando busca elementos borrados localmente.
|
||
--moved: El comando busca elementos movidos.
|
||
--localmoved: El comando busca elementos movidos localmente.
|
||
--percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos
|
||
ficheros para considerarlos el mismo en la búsqueda de movidos
|
||
locales, su valor por defecto es un 20%.
|
||
--txtsameext: Sólo aquellos ficheros de texto que tengan la misma
|
||
extensión serán tenidos en cuenta para la búsqueda de movidos basada
|
||
en la similitud del contenido. Por defecto todos los ficheros de texto
|
||
son procesados.
|
||
--binanyext: Cualquier fichero binario es tenido en cuenta para la
|
||
búsqueda de movidos basada en la similitud del contenido. Por defecto
|
||
sólo aquellos ficheros binarios que tengan la misma extensión
|
||
son procesados.
|
||
--private: El comando busca elementos no controlados.
|
||
--ignored: El comando busca elementos ignorados.
|
||
--hiddenchanged: El comando busca elementos cambiados marcados como
|
||
ocultos (incluye '--changed').
|
||
--cloaked: El comando busca elementos marcados como cloaked.
|
||
--controlledchanged: Este modificador engloba los siguientes parámetros:
|
||
'--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'.
|
||
--all (-a): Este modificador engloba los siguientes parámetros:
|
||
'--controlledchanged' '--changed' '--localdeleted' '--localmoved'
|
||
'--private'.
|
||
|
||
== CMD_HELP_WORKSPACESTATUS ==
|
||
Notas:
|
||
|
||
El comando status muestra el changeset cargado en un workspace
|
||
y si los hay, los cambios que contiene.
|
||
|
||
Se puede utilizar el comando para saber cuál es el changeset con el que se
|
||
está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para
|
||
marcar configuraciones concretas mediante etiquetas de tipo changeset.
|
||
|
||
También es útil para conocer los cambios pendientes que existen dentro
|
||
del workspace, los tipos de cambios que deseamos obtener del workspace pueden
|
||
ser modificados gracias a los parámetros que el comando admite. Por defecto
|
||
se muestran todos los cambios, controlados y locales.
|
||
|
||
El porcentaje de similitud entre dos ficheros usado por el algoritmo de
|
||
cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity'
|
||
o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado
|
||
su valor por por defecto es del 20%.
|
||
|
||
A través de éste comando, también es posible mostrar los cambios agrupados
|
||
en 'changelists' de cliente. El changelist por defecto del sistema (llamado
|
||
'default'), agrupa los cambios que no están contenidos en el resto de
|
||
'changelists', por lo que los cambios que se muestran especificando éste
|
||
'changelist', dependerán del tipo de búsquedas especificados en el comando.
|
||
|
||
La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios
|
||
controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o
|
||
'moved'), por lo que la opción '--controlledchanged' se activará automáticamente
|
||
cuando se muestren 'changelists'.
|
||
|
||
El formato por defecto para la salida en XML es UTF-8. Es posible cambiar
|
||
dicho encoding usando la opción --encoding=otro_encoding.
|
||
|
||
El comando 'status' imprime por defecto rutas relativas al directorio de trabajo,
|
||
a menos que se especifiquen las opciones '--machinereadable' o '--short'
|
||
(en cuyo caso, se imprimen rutas absolutas).
|
||
|
||
Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas
|
||
relativas a la raíz del workspace, a menos que se especifique adicionalmente
|
||
la opción '--fp' (en cuyo caso, se imprimen rutas absolutas).
|
||
|
||
Ejemplos:
|
||
|
||
cm status
|
||
(Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
|
||
y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales,
|
||
movidos, movidos locales, y privados. La busqueda de los elementos se realiza
|
||
sobre el workspace de forma recursiva)
|
||
|
||
cm status --controlledchanged
|
||
(Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
|
||
y los elementos del workspace en checkout, añadidos, copiados, reemplazados,
|
||
borrados, y movidos)
|
||
|
||
cm status --added
|
||
(Ejecutándolo dentro de workspace el comando imprime el changeset cargado
|
||
y solamente los elementos añadidos. La búsqueda de los elementos se realiza
|
||
sobre el workspace de forma recursiva)
|
||
|
||
cm status c:\workspaceLocation\code\client --added
|
||
(El comando imprime el changeset cargado y solamente los elementos añadidos.
|
||
La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva)
|
||
|
||
cm status --changelists
|
||
cm status --changelist
|
||
(El comando muestra todos los cambios en el espacio de trabajo, agrupados
|
||
por 'changelists').
|
||
|
||
cm status --changelist=pending_to_review
|
||
(El comando muestra los cambios que contiene el changelist 'pending_to_review')
|
||
|
||
cm status --changelist=default --private
|
||
(El comando muestra los cambios que contiene el changelist 'default',
|
||
el changelist por defecto del sistema, mostrando elementos privados,
|
||
además de elementos con cambios controlados si los hubiese).
|
||
|
||
cm status --short --changelist=pending_to_review | cm checkin -
|
||
(Se protegen los cambios en el changelist llamado 'pending_to_review').
|
||
|
||
cm status c:\workspaceLocation\code\client --xml=output.xml
|
||
(Guarda la salida del status en el fichero output.xml, en formato XML y
|
||
usando UTF-8.)
|
||
|
||
cm status --ignored
|
||
(Muestra todos los elementos ignorados)
|
||
Salida:
|
||
IG src
|
||
IG src/version.c
|
||
IG out/app.exe
|
||
|
||
cm status --ignored --cutignored
|
||
(Muestra ficheros ignorados cuyo directorio padre no está ignorado y
|
||
directorios ignorados pero no el árbol de sus contenidos)
|
||
Salida:
|
||
IG src
|
||
IG out/app.exe
|
||
|
||
== CMD_DESCRIPTION_XLINK ==
|
||
Crea, edita o muestra un xlink
|
||
|
||
== CMD_USAGE_XLINK ==
|
||
Sintaxis:
|
||
|
||
cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+]
|
||
(Crea un xlink).
|
||
|
||
cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+]
|
||
(Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar
|
||
de apuntar a la raíz por defecto / ).
|
||
|
||
cm xlink -e xlink_path <csetspec | lbspec | brspec>
|
||
(Edita un xlink para cambiar la especificación destino).
|
||
|
||
cm xlink -s|--show xlink_path
|
||
(Muestra la información de un xlink incluyendo las reglas de expansión).
|
||
|
||
cm xlink -ar|--addrules xlink_path <expansion_rules>+
|
||
(Añade al xlink las reglas de expansión proporcionadas).
|
||
|
||
cm xlink -dr|--deleterules xlink_path <expansion_rules>+
|
||
(Borra del xlink las reglas de expansión especificadas).
|
||
|
||
xlink_path Ruta en el espacio de trabajo actual donde se cargan
|
||
los contenidos del repositorio que se va a enlazar
|
||
(cuando se crea un xlink) o que ya está enlazado
|
||
(cuando se edita un xlink).
|
||
csetspec Especificación del changeset que se va a enlazar.
|
||
Determina qué versión y rama se carga en el espacio de
|
||
trabajo para el repositorio enlazado.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de changesets.
|
||
lbspec Especificación de la etiqueta que se va a enlazar.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de etiquetas.
|
||
brspec Especificación de la rama que se va a enlazar.
|
||
Usa el changeset actual a donde la rama especificada
|
||
está apuntando.
|
||
Usa 'cm help objectspec' para obtener más información
|
||
sobre la especificación de ramas.
|
||
-e Indica que el comando va a editar un xlink existente
|
||
para cambiar la especificación del changeset enlazado.
|
||
-s | --show Muestra información sobre el xlink seleccionado.
|
||
-ar | --addrules Añade una o más reglas de expansión al xlink indicado.
|
||
-dr | --deleterules Borra una o más reglas de expansión del xlink indicado.
|
||
expansion_rules Especifica una o más reglas de expansión. Cada regla de
|
||
expansión es un par (rama)-(rama a enlazar)
|
||
br:/main/fix-br:/main/develop/fix
|
||
|
||
Opciones:
|
||
|
||
-w Crea un xlink de escritura. Esto significa que los
|
||
contenidos bajo el xlink se podrán editar mediante el
|
||
uso de autoexpansión de ramas.
|
||
-rs Relative server. Permite crear un xlink a un repositorio
|
||
que es una réplica de otro que existe en un servidor
|
||
central. De este modo se reconcilian automáticamente los
|
||
repositorios replicados con el original.
|
||
|
||
Ejemplos:
|
||
|
||
cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084
|
||
cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084
|
||
cm xlink -s codigo\segundorepositorio
|
||
cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
|
||
cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix
|
||
|
||
== CMD_HELP_XLINK ==
|
||
Notas:
|
||
|
||
Este comando crea un xlink al changeset especificado. Por defecto se
|
||
creará como un xlink de sólo lectura. Esto significa que los contenidos
|
||
correspondientes a otro repositorio cargados por debajo del xlink no
|
||
podrán ser modificados.
|
||
|
||
Para la edición del changeset de un xlink se puede utilizar una sintaxis
|
||
reducida en la que no hay que especificar el resto de parámetros del
|
||
xlink. Solamente es necesario en nuevo changeset al que apuntará.
|
||
|
||
Auto-expansión de ramas:
|
||
|
||
Cuando se realiza un cambio en uno de los repositorios enlazados en modo
|
||
de lectura y escritura (opción -e) es necesario crear una nueva rama en
|
||
dicho repositorio basándose en la rama en la que se está trabajando en el
|
||
repositorio principal. Para determinar el nombre de dicha rama, se aplican
|
||
las siguientes reglas:
|
||
1) Se comprueba si el nombre completo de la rama existe en el
|
||
repositorio enlazado:
|
||
- Si existe, se utiliza dicha rama.
|
||
- Si no existe, Plastic construye el nombre de la rama de esta forma:
|
||
- Nombre de la rama que contiene el changeset enlazado + nombre
|
||
de la rama del repositorio principal.
|
||
- Si existe una rama con dicho nombre, se utiliza como rama de
|
||
trabajo.
|
||
- Si no, se crea una rama nueva con el nombre así construido y
|
||
se establece como base de la rama el changeset enlazado.
|
||
2) Después, se crea una nueva versión del xlink dentro de la nueva rama
|
||
apuntando al nuevo changeset.
|
||
|
||
De este modo, la estructura completa del xlink se mantiene actualizada con
|
||
los últimos cambios en las versiones correctas.
|
||
|
||
Ejemplos:
|
||
|
||
cm xlink code\firstrepo / 1@first@localhost:8084
|
||
(Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual
|
||
donde el changeset '1' en el repositorio 'first' se enlazará).
|
||
|
||
cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087
|
||
(Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el
|
||
espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset
|
||
'1627' del repositorio 'includes' se enlazará como raíz. Esto significa
|
||
que cualquier ítem dentro de '/includes/opengl' se enlazará en
|
||
'opengl\include' mientras que el resto del repositorio se ignorará).
|
||
|
||
cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084
|
||
(Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el
|
||
espacio de trabajo actual donde la etiqueta'LB001' en el repositorio
|
||
'second' se enlazará).
|
||
|
||
cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003
|
||
(Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual
|
||
donde el changeset '3' en el repositorio 'third' se enlazará).
|
||
|
||
cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084
|
||
(Edita el xlink 'code\secondrepo' para cambiar el repositorio destino
|
||
enlazando la rama 'main/task1234' en el repositorio 'second').
|
||
|
||
cm xlink --show code\thirdrepo
|
||
(Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de
|
||
expansión si éstas existen).
|
||
|
||
cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
|
||
(Añade dos reglas de expansión al xlink 'code\secondrepo').
|
||
|
||
cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix
|
||
(Borra la regla de expansión del xlink 'code\secondrepo').
|
||
|
||
cm xlink code\secondrepo / 1@second@localhost:8084
|
||
cm xlink code\secondrepo / lb:LB001@second@localhost:8084
|
||
|
||
== CMD_USAGE_AUTOCOMPLETE ==
|
||
Sintaxis:
|
||
|
||
cm autocomplete install
|
||
Instala el autocompletado de comandos para 'cm' en la shell.
|
||
|
||
cm autocomplete uninstall
|
||
Desinstala el autocompletado de comandos para 'cm' de la shell.
|
||
|
||
cm autocomplete --line <shell_line> --position <cursor_position>
|
||
Devuelve sugerencias de autocompletado para 'shell_line', que deben ser
|
||
insertadas en 'cursor_position'. Este comando no está pensado para ser
|
||
ejecutado por el usuario final, pero está documentado en caso de que se
|
||
quiera extender el soporte de autocompletado a otras shells.
|
||
|
||
shell_line La linea que el usuario ha escrito en la shell cuando se
|
||
pidió el autocompletado.
|
||
En Bash, encuentra en la variable de entorno COMP_LINE.
|
||
En PowerShell, se encuentra en la variable $wordToComplete.
|
||
cursor_position La posición del cursor cuando se pidió el autocompletado.
|
||
En Bash, se encuentra en la variable de entorno COMP_POINT.
|
||
En PowerShell, se encuentra en la variable $cursorPoint.
|