Este documento contiene la siguiente información:
- Hoja resumen de comandos svn (en pdf).
- Resumen detallado de todos los comandos svn.
- Descripción de la utilización de propiedades svn.
uso: svn [opciones] [pars]
Tipee "svn help " para ayuda en un subcomando específico.
La mayoría de los subcomandos reciben parámetros de tipo archivo y/o directorio. Si no se proveen parámetros a estos comandos, por omisión descenderán recursivamente desde el directorio actual (incluyéndolo).
Subcomandos disponibles:
- add: Pone archivos y directorios bajo control de versiones, agrendándolos para ser añadidos al repositorio. Serán añadidos en el próximo commit.
- blame (praise, annotate, ann): Envía a la salida el contenido de los archivos o URLs especificados, conjuntamente con la información sobre el autor y la revisión.
- cat: Envía a la salida el contenido de los archivos o URLs.
- checkout (co): Obtiene una copia de trabajo desde un repositorio.
- cleanup: Limpiar recursivamente la copia de trabajo, removiendo locks, continuando operaciones inconclusas, etc.
- commit (ci): Envía cambios desde la copia de trabajo al repositorio.
- copy (cp): Duplica algo en la copia de trabajo o en el repositorio, recordando historia.
- delete (del, remove, rm): Elimina archivos y directorios del control de versiones.
- diff (di): Muestra las diferencias entre dos rutas.
- export: Crea una copia no versionada de un árbol.
- help (?, h): Describe el uso de este programa o de sus subcomandos.
- import: Hace commit de un archivo o un árbol de archivos no versionado a un URL.
- info: Muestra información acerca de un archivo o directorio.
- list (ls): Lista las entradas de directorio en el repositorio.
- log: Mostrar el mensaje de bitácora para un set de revisiones y/o archivos.
- merge: Aplica las diferencias entre dos fuentes a una ruta de copia de trabajo.
- mkdir: Crear un nuevo directorio bajo control de versiones.
- move (mv, rename, ren): Mueve y/o cambia el nombre de algo en la copia de trabajo o en el repositorio.
- propdel (pdel, pd): Remover NOMBREPROP de los archivos, directorios, o revisiones.
- propedit (pedit, pe): Editar la propiedad NOMBREPROP con un editor externo en destinos.
- propget (pget, pg): Imprimir el valor de NOMBREPROP en archivos, directorios o revisiones.
- proplist (plist, pl): Lista todas las propiedades de archivos, directorios o revisiones.
- propset (pset, ps): Establece NOMBREPROP a PROPVAL en archivos, directorios o revisiones.
- resolved: Remueve el estado de conflicto de archivos o directorios en copias de trabajo.
- revert: Restituye el archivo de la copia de trabajo (deshace la mayoría de las ediciones locales).
- status (stat, st): Imprime el estatus de archivos y directorios en la copia de trabajo.
- switch (sw): Actualiza la copia de trabajo a un URL distinto.
- update (up): Trae cambios desde el repositorio hacia la copia de trabajo.
Podemos ver una breve explicación acerca de la utilización de propiedades de subversion para introducirlas en los archivos versionados con subversion aquí.
Subversion es una herramienta para control de versiones. Para información adicional, vea http://subversion.tigris.org/
add: Pone archivos y directorios bajo control de versiones, agendándolos para ser añadidos al repositorio. Serán añadidos en el próximo commit.
uso: add RUTA...
Opciones válidas:<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
--force : forzar operación<br/>
--auto-props : activar asignación automática de propiedades<br/>
--no-auto-props : desactivar asignación automática de propiedades<br/>
Inicio
blame (praise, annotate, ann): Envía a la salida el contenido de los archivos o URLs especificados, conjuntamente con la información sobre el autor y la revisión.
uso: blame OBJETIVO...
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-v [--verbose] : mostrar información extra<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
<br/>
Inicio
cat: Envía a la salida el contenido de los archivos o URLs.
uso: cat OBJETIVO...
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
checkout (co): Obtiene una copia de trabajo desde un repositorio.
uso: checkout URL... [RUTA]
Nota: Si se omite la ruta se usará el nombre base del URL como destino. Si se especifica más de un URL, se obtendrán todos en un subdirectorio de RUTA, siendo el nombre de éste el nombre base del URL.
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
cleanup: Limpiar recursivamente la copia de trabajo, removiendo locks, continuando operaciones inconclusas, etc.
uso: cleanup [RUTA...]
Opciones válidas:<br/>
--diff3-cmd arg : usar PAR como comando para combinar<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
commit (ci): Envía cambios desde la copia de trabajo al repositorio.
uso: commit [RUTA...]
Se debe proveer un mensaje de log, aunque puede estar vacío. Si no se hace esto con --message o --file, se iniciará un editor.
Opciones válidas:<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
copy (cp): Duplica algo en la copia de trabajo o en el repositorio, recordando historia.<br/>
uso: copy ORIG DEST<br/>
<br/>
ORIG y DEST pueden ser cada uno una copia de trabajo (CT) o un URL:<br/>
CT -> CT: copia y agenda para añadir (con historia)<br/>
CT -> URL: hace commit inmediatamente de una copia de CT al URL<br/>
URL -> CT: obtiene el URL en la CT, se agenda para adición<br/>
URL -> URL: copia completamente en servidor; para ramas y etiquetas<br/>
<br/>
Opciones válidas:<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
delete (del, remove, rm): Elimina archivos y directorios del control de versiones.<br/>
uso: 1. delete RUTA...<br/>
2. delete URL...<br/>
<br/>
1. Cada ítem especificado con una RUTA es marcado para ser borrado<br/>
en el siguiente commit. Los archivos y directorios a los que nunca<br/>
se les haya hecho commit antes serán borrados inmediatamente de la<br/>
copia de trabajo. Las RUTAs que son, o contienen, ítems modificados o<br/>
no versionados, no serán eliminadas a menos que se use la opción --force.<br/>
<br/>
2. Cada ítem especificado con un URL es eliminado en el repositorio<br/>
mediante un commit inmediato.<br/>
<br/>
Opciones válidas:<br/>
--force : forzar operación<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
diff (di): Muestra las diferencias entre dos rutas.<br/>
uso: 1. diff [-r N[:M]] [OBJETIVO[@REV]...]<br/>
2. [-r N[:M]] --old=OBJTVO-VIEJ[@REV-VIEJ] [--new=OBJTVO-NUEV[@REV_NUEV]] \<br/>
[RUTA...]<br/>
3. diff URL-VIEJ[@REV-VIEJ] URL-NUEV[@REV-NUEV]<br/>
<br/>
1. Muestra los cambios efectuados entre dos revisiones a los OBJETIVOs<br/>
tal como existen en REV. Los OBJETIVOs pueden ser rutas de copia de<br/>
trabajo o URLs.<br/>
<br/>
Por defecto N es BASE si alguno de los objeticos es una ruta de<br/>
copia de trabajo, sino debe ser especificado. M es por defecto la<br/>
versión actual de la copia de trabajo si alguno de los objetivos es<br/>
una ruta de allí, sino es HEAD.<br/>
<br/>
2. Muestra las diferencias entre OBJTVO-VIEJ (tal cual existe/existía en<br/>
REV-VIEJ) y OBJTVO-NUEV (tal cual existe/existía en REV-NUEV). Las<br/>
RUTAs, si se especifican, son relativas a OBJTVO-VIEJ y OBJTVO-NUEV y<br/>
restringen la salida a diferencias de archivos en esas rutas.<br/>
OBJTVO-VIEJ y OBJTVO-NUEV pueden ser rutas de la copia de trabajo o<br/>
URL[@REV]. OBJTVO-NUEV si no se especifica es por defecto OBJTVO-VIEJ.<br/>
-r N hace que REV-VIEJ sea por defecto n, -r N:M hace que REV-VIEJ sea<br/>
por defecto N y que REV-NUEV sea por defecto M.<br/>
<br/>
3. Forma corta de escribir<br/>
'svn diff --old=URL-VIEJ[@REV-VIEJ] --new=URL-NUEV[@REV-NUEV]'<br/>
<br/>
Use simplemente 'svn diff' si quiere ver las modificaciones locales<br/>
hechas en una copia de trabajo.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--old arg : usar PAR como el objetivo más viejo<br/>
--new arg : usar PAR como el objetivo más nuevo<br/>
-x [--extensions] arg : pasar PAR como opciones a GNU diff<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
--diff-cmd arg : usar PAR como comando para mostrar diferencias<br/>
--no-diff-deleted : no mostrar diferencias para archivos borrados<br/>
--notice-ancestry : tomar en cuenta ancestros al calcular diferencias<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir ar g : leer configuración del usuario del directorio PAR
Inicio
export: Crea una copia no versionada de un árbol.<br/>
uso: 1. export [-r REV] URL [RUTA]<br/>
2. export [-r REV] RUTA1 [RUTA2]<br/>
<br/>
1. Exporta un árbol de directorios limpio del repositorio a RUTA,<br/>
especificado por RUTA, en la revisión REV si se especifica, de<br/>
otro modo se exporta HEAD. Si se omite la RUTA, se usa el último<br/>
componente del URL para el nombre del directorio local creado.<br/>
<br/>
2. Exporta un árbol de direcotios limpio a RUTA2 a partir de la copia<br/>
de trabajo especificada por RUTA1, en la revisión REV si especificada,<br/>
si no en WORKING. Si se omite RUTA2, se usa el último componente de<br/>
RUTA1 para el nombre del directorio local creado. Si no se especifica<br/>
REV se preservarán todos los cambios locales, aunque no se copiarán<br/>
archivos que no estén bajo control de versiones.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--force : forzar operación<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
--native-eol arg : usar un marcador de fin de línea diferente al<br/>
estándar del sistema para archivos con svn:eol-style<br/>
como 'native'. PAR puede ser uno de 'LF', 'CR', 'CRLF'
Inicio
import: Hace commit de un archivo o un árbol de archivos no versionado a un URL.<br/>
uso: import [RUTA] URL<br/>
<br/>
Hace un commit recursivo de RUTA a URL.<br/>
Si se omite la ruta se asume '.'. Los directorios padre serán creados<br/>
en el repositorio cuando sea necesario.<br/>
<br/>
Opciones válidas:<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
--auto-props : activar asignación automática de propiedades<br/>
--no-auto-props : desactivar asignación automática de propiedades<br/>
<br/>
Inicio
info: Muestra información acerca de un archivo o directorio.<br/>
uso: info [RUTA...]<br/>
<br/>
Muestra esta información acerca cada RUTA (por omisión: '.').<br/>
<br/>
Opciones válidas:<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
-R [--recursive] : descender recursivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
list (ls): Lista las entradas de directorio en el repositorio.<br/>
uso: list [OBJETIVO...]<br/>
<br/>
Lista cada archivo OBJETIVO y los contenidos de cada directorio OBJETIVO<br/>
tal como existan en el repositorio. Si OBJETIVO es una ruta de una copia<br/>
de trabajo, se usará el URL de repositorio respectivo.<br/>
<br/>
El OBJETIVO por defecto es '.', lo que significa el URL de repositorio<br/>
correspondiente al directorio de trabajo actual.<br/>
<br/>
Con --verbose los siguientes campos muestran el estado del ítem:<br/>
<br/>
Número de revisión del último commit<br/>
Autor del último commit<br/>
Tamaño (en bytes)<br/>
Fecha y hora del último commit<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-v [--verbose] : mostrar información extra<br/>
-R [--recursive] : descender recursivamente<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
log: Mostrar el mensaje de bitácora para un set de revisiones y/o archivos.<br/>
uso: 1. log [RUTA]<br/>
2. log URL [RUTA...]<br/>
<br/>
1. Imprimir el mensaje de bitácora para una RUTA local (por defecto: '.').<br/>
El rango de revisiones por defecto es BASE:1.<br/>
<br/>
2. Imprimir el mensaje de bitácora para las RUTAs (por defecto: '.') bajo URL.<br/>
El rango de revisiones por defecto es HEAD:1.<br/>
<br/>
Con -v, tambien imprimir todas las rutas afectadas con cada mensaje de bitácora.<br/>
Con -q, no imprimir el cuerpo del mensaje de bitácora en si (nótese que esto es compatible con -v).<br/>
<br/>
Cada mensaje de bitácora es impreso solamente una vez, aun cuando mas de uno de las<br/>
rutas afectadas para esa revisión fueron explícitamente solicitadas. Las bitácoras<br/>
siguen la historia de copia por defecto. Use --stop-on-copy para deshabilitar este<br/>
comportamiento, el cual puede ser útil para determinar puntos de bifurcación.<br/>
<br/>
Ejemplos:<br/>
svn log<br/>
svn log foo.c<br/>
svn log http://www.example.com/repo/project/foo.c<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-v [--verbose] : mostrar información extra<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
--stop-on-copy : no atravesar copias al recorrer la historia<br/>
--incremental : proveer salida apta de ser unida a otras salidas<br/>
--xml : salida en XML<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
merge: Aplica las diferencias entre dos fuentes a una ruta de copia de trabajo.<br/>
uso: 1. merge URLfuente1[@N] URLfuente2[@M] [RUTACDT]<br/>
2. merge RUTACDTfuente1@N RUTACDTfuente2@M [RUTACDT]<br/>
3. merge -r N:M FUENTE[@REV] [RUTACDT]<br/>
<br/>
1. En la primera forma los URLs fuente son especificados en las<br/>
revisiones N y M, y se compararán estas dos fuentes. Las revisiones<br/>
son por defecto HEAD si se omiten.<br/>
<br/>
2. En la segunda forma los URLs que corresponden a ls rutas de copia<br/>
de trabajo especificadas definen las fuentes a ser comparadas. Se deben<br/>
especificar las revisiones.<br/>
<br/>
3. En la tercera forma, FUENTE puede ser un URL o un ítem de una copia<br/>
de trabajo, en cuyo caso se usará el URL correspondiente. Este URL,<br/>
en la revisión REV, se comparará tal cual existió entre las<br/>
revisiones N y M. Si no se especifica REV, se asume HEAD.<br/>
<br/>
RUTACDT es la ruta de copia de trabajo que recibirá los cambios.<br/>
Si se omite RUTACDT se usará por defecto '.', a menos que los fuentes<br/>
terminen en nombres idénticos que se correspondan con un archivo<br/>
en '.', en cuyo caso las diferencias se aplicarán a ese archivo.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--force : forzar operación<br/>
--dry-run : intentar la operación, pero no hacer cambios<br/>
--diff3-cmd arg : usar PAR como comando para combinar<br/>
--ignore-ancestry : no tomar en cuenta ancestros al calcular las combinaciones<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
mkdir: Crear un nuevo directorio bajo control de versiones.<br/>
uso: 1. mkdir RUTA...<br/>
2. mkdir URL...<br/>
<br/>
Crear directorios bajo control de versiones.<br/>
<br/>
1. Cada directorio especificado por una RUTA de copia de trabajo es creado localmente<br/>
y programado para su adición en el próximo commit.<br/>
<br/>
2. Cada directorio especificado por un URL es creado en el repositorio via<br/>
un commit inmediato.<br/>
<br/>
En ambos casos, todos los directorios intermedios deben ya existir.<br/>
<br/>
Opciones válidas:<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
move (mv, rename, ren): Mueve y/o cambia el nombre de algo en la copia de trabajo o en el<br/>
repositorio.<br/>
uso: move ORIG DEST<br/>
<br/>
Nota: este subcomando equivale a 'copy' seguido de 'delete'.<br/>
<br/>
ORIG y DEST pueden ser ambos RUTAS de copia de trabajo (CDT) o URLs:<br/>
CDT -> CDT: mueve y marca para añadir (manteniendo historia)<br/>
URL -> URL: cambio de nombre en el servidor directamente.<br/>
<br/>
Opciones válidas:<br/>
-m [--message] arg : especificar PAR como mensaje de commit<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--force : forzar operación<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--force-log : forzar la validez de la fuente del mensaje<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
propdel (pdel, pd): Remover NOMBREPROP de los archivos, directorios, o revisiones.<br/>
uso: 1. propdel NOMBREPROP [RUTA...]<br/>
2. propdel NOMBREPROP --revprop -r REV [URL]<br/>
<br/>
1. Remueve propiedades versionadas en la copia de trabajo.<br/>
2. Remueve propiedades no versionadas remotas en la revisión REV del repositorio.<br/>
<br/>
Opciones válidas:<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-R [--recursive] : descender recursivamente<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--revprop : operar en una propiedad de revisión (use con -r)<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR
Inicio
propedit (pedit, pe): Editar la propiedad NOMBREPROP con un editor externo en destinos.<br/>
uso: 1. propedit NOMBREPROP RUTA...<br/>
2. propedit NOMBREPROP --revprop -r REV [URL]<br/>
<br/>
1. Edita propiedades versionadas en la copia de trabajo.<br/>
2. Edita propiedades no versionadas remotas en la revision REV del repositorio.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--revprop : operar en una propiedad de revisión (use con -r)<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--editor-cmd arg : usar PAR como el editor externo<br/>
--force : forzar operación<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
propget (pget, pg): Imprimir el valor de NOMBREPROP en archivos, directorios o revisiones.<br/>
uso: 1. propget NOMBREPROP [RUTA...]<br/>
2. propget NOMBREPROP --revprop -r REV [URL]<br/>
<br/>
1. Imprime propiedades versionadas en la copia de trabajo.<br/>
2. Imprime propiedades no versionadas remotas en la revision REV del repositorio.<br/>
<br/>
Por defecto, este subcomando agregará un final de linea adicional<br/>
al final de los valores de propiedad para que la salida se vea<br/>
atractiva. Además, cuando sea que haya múltiples rutas envueltas,<br/>
cada valor de propiedad es prefijado con la ruta con la cual está<br/>
asociado. Utilice la opción --strict para deshabilitar estos<br/>
enbellecimientos (útil, por ejemplo, cuando se redireccionan<br/>
valores de propiedad binarios a un archivo).<br/>
<br/>
Opciones válidas:<br/>
-R [--recursive] : descender recursivamente<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--revprop : operar en una propiedad de revisión (use con -r)<br/>
--strict : semántica estricta<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
proplist (plist, pl): Lista todas las propiedades de archivos, directorios o revisiones.<br/>
uso: 1. proplist [RUTA...]<br/>
2. proplist --revprop -r REV [URL]<br/>
<br/>
1. Lista propiedades versionadas en la copia de trabajo.<br/>
2. Lista propiedades remotas no versionadas en la revisión del repos.<br/>
<br/>
Opciones válidas:<br/>
-v [--verbose] : mostrar información extra<br/>
-R [--recursive] : descender recursivamente<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--revprop : operar en una propiedad de revisión (use con -r)<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
propset (pset, ps): Set PROPNAME to PROPVAL on files, dirs, or revisions.<br/>
usage: 1. propset PROPNAME [PROPVAL | -F VALFILE] PATH...<br/>
2. propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL]<br/>
<br/>
1. Creates a versioned, local propchange in working copy.<br/>
2. Creates an unversioned, remote propchange on repos revision.<br/>
<br/>
Note: svn recognizes the following special versioned properties<br/>
but will store any arbitrary properties set:<br/>
svn:ignore - A newline separated list of file patterns to ignore.<br/>
svn:keywords - Keywords to be expanded. Valid keywords are:<br/>
URL, HeadURL - The URL for the head version of the object.<br/>
Author, LastChangedBy - The last person to modify the file.<br/>
Date, LastChangedDate - The date/time the object was last modified.<br/>
Rev, Revision, - The last revision the object changed.<br/>
LastChangedRevision<br/>
Id - A compressed summary of the previous<br/>
4 keywords.<br/>
svn:executable - If present, make the file executable. This<br/>
property cannot be set on a directory. A non-recursive attempt<br/>
will fail, and a recursive attempt will set the property only<br/>
on the file children of the directory.<br/>
svn:eol-style - One of 'native', 'LF', 'CR', 'CRLF'.<br/>
svn:mime-type - The mimetype of the file. Used to determine<br/>
whether to merge the file, and how to serve it from Apache.<br/>
A mimetype beginning with 'text/' (or an absent mimetype) is<br/>
treated as text. Anything else is treated as binary.<br/>
svn:externals - A newline separated list of module specifiers,<br/>
each of which consists of a relative directory path, optional<br/>
revision flags, and an URL. For example<br/>
foo http://example.com/repos/zig<br/>
foo/bar -r 1234 http://example.com/repos/zag<br/>
<br/>
Opciones válidas:<br/>
-F [--file] arg : leer datos del archivo PAR<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
-R [--recursive] : descender recursivamente<br/>
--revprop : operar en una propiedad de revisión (use con -r)<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--encoding arg : el valor está en la codificación de caracteres PAR<br/>
--force : forzar operación<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
resolved: Remueve el estado de conflicto de archivos o directorios en copias de trabajo.<br/>
uso: resolved RUTA...<br/>
<br/>
Nota: Este subcomando no resuelve semánticamente los conflictos, ni<br/>
quita los demarcadores de éstos. Simplemente elimina los archivos<br/>
auxiliares relacionados y permite que la RUTA pueda intervenir de<br/>
nuevo en un commit.<br/>
<br/>
Opciones válidas:<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
-R [--recursive] : descender recursivamente<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
revert: Restituye el archivo de la copia de trabajo (deshace la mayoría<br/>
de las ediciones locales).<br/>
uso: revert RUTA...<br/>
<br/>
Nota: este subcomando no requiere de acceso a la red y resuelve cualquier<br/>
estado de conflicto. Sin embargo no restituye directorios eliminados.<br/>
<br/>
Opciones válidas:<br/>
--targets arg : pasar el contenido del archivo PAR<br/>
como parámetros adicionales<br/>
-R [--recursive] : descender recursivamente<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
status (stat, st): Imprime el estatus de archivos y directorios en la copia de trabajo.<br/>
uso: status [RUTA...]<br/>
<br/>
Sin argumentos, imprime solamenete los ítems modificados localmente (sin acceso a red).<br/>
Con -u, agrega información de revisión de trabajo e información<br/>
del servidor para determinar si el archivo esta actualizado.<br/>
Con -v, imprime la información de revisión completa para cada ítem.<br/>
<br/>
Las primeras cinco columnas de la salida son de un caracter de ancho:<br/>
Primera columna: Indica si el ítem fue agregado, eliminado o cambiado<br/>
' ' no hay modificaciones<br/>
'A' Agregado<br/>
'C' Presenta conflicto<br/>
'D' Eliminado<br/>
'G' Mezclado 'I' Ignorado<br/>
'M' Modificado<br/>
'R' Reemplazado<br/>
'X' Este ítem no esta versionadom, pero es usado por una definición de externals<br/>
'?' ítem no esta bajo control de versiones<br/>
'!' ítem faltante (removido por un comando ajeno a svn) o incompleto<br/>
'~' ítem versionado obstruido por algún otro ítem de un tipo diferente<br/>
Segunda columna: Modificaciones a las propiedades de un archivo o directorio<br/>
' ' no hay modificaciones<br/>
'C' Presenta conflicto<br/>
'M' Modificado<br/>
Tercera columna: Indica si la copia de trabajo esta bloqueada<br/>
' ' no esta bloqueada<br/>
'L' Bloqueada<br/>
Cuarta columna: El commit programado contendrá adición-con-historial<br/>
' ' no hay historial programado con el commit<br/>
'+' historial programado con el commit<br/>
Quinta columna: Indica si el ítem esta cambiado (con switch) con respecto a su padre<br/>
' ' normal<br/>
'S' Cambiado (con switched)<br/>
<br/>
La infromación de actualización aparece en la octava columna (con -u):<br/>
'*' hay una nueva revisión en el servidor<br/>
' ' la copia de trabajo esta actualizada<br/>
<br/>
Los campos restantes son de ancho variable y estan delimitados por espacios:<br/>
La revisión de trabajo (con -u ó -v)<br/>
La ultima revisión y el último autor que efectuaron commit (con -v)<br/>
La ruta a la copia de trabajo siempre es el último campo, asi que<br/>
puede contener espacios en blanco.<br/>
<br/>
Salida de ejemplo:<br/>
svn status wc<br/>
M wc/bar.c<br/>
A + wc/qax.c<br/>
<br/>
svn status -u wc<br/>
M 965 wc/bar.c<br/>
* 965 wc/foo.c<br/>
A + 965 wc/qax.c<br/>
Head revision: 981<br/>
<br/>
svn status --show-updates --verbose wc<br/>
M 965 938 kfogel wc/bar.c<br/>
* 965 922 sussman wc/foo.c<br/>
A + 965 687 joe wc/qax.c<br/>
965 687 joe wc/zig.c<br/>
Head revision: 981<br/>
<br/>
Opciones válidas:<br/>
-u [--show-updates] : mostrar información de actualización<br/>
-v [--verbose] : mostrar información extra<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--no-ignore : no usar la configuración de ignorado (ni de la propiedad svn:ignore ni de los valores por defecto)<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
switch (sw): Actualiza la copia de trabajo a un URL distinto.<br/>
uso: 1. switch URL [RUTA]<br/>
2. switch --relocate DESDE HASTA [RUTA...]<br/>
<br/>
1. Actualiza la copia de trabajo para reflejar un nuevo URL del<br/>
repositorio. Este comportamiento es similar al de 'svn update',<br/>
y es la manera de mover una copia de trabajo a una rama o tag dentro<br/>
del mismo repositorio.<br/>
<br/>
2. Reescribe la metainformación de URL de la copia de trabajo sólo<br/>
para reflejar un cambio sintáctico. Ésto se usa cuando cambia<br/>
el URL de la raíz del repositorio (ya sea el esquema, el nombre<br/>
de host, etc.) pero su copia de trabajo todavía representa el mismo<br/>
directorio del mismo repositorio.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--diff3-cmd arg : usar PAR como comando para combinar<br/>
--relocate : reubicar vía reescritura de URL<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
<br/>
Inicio
update (up): Trae cambios desde el repositorio hacia la copia de trabajo.<br/>
uso: update [RUTA...]<br/>
<br/>
Si no se especifica revisión, actualiza la copia respecto de la revisión<br/>
HEAD. Si sí se especifica, se sincroniza la copia de trabajo a la<br/>
revisión dada por -r.<br/>
<br/>
Para cada ítem actualizado mostrará una línea con un carácter<br/>
que indicará la acción tomada. Éstos son sus significados:<br/>
A Añadido<br/>
D Borrado<br/>
U Actualizado<br/>
C Conflicto<br/>
G Combinado<br/>
<br/>
Un carácter en la primera columna indica una actualización al<br/>
archivo en sí, mientras que las actualizaciones de propiedades se<br/>
muestran en la segunda columna.<br/>
<br/>
Opciones válidas:<br/>
-r [--revision] arg : PAR (algunos comandos también aceptan<br/>
un rango PAR1:PAR2)<br/>
Una revisión puede ser:<br/>
NÚMERO número de la revisión<br/>
"{" FECHA "}" revisión al comienzo de la fecha<br/>
"HEAD" lo último del repositorio<br/>
"BASE" rev base del ítem de la c. de trab.<br/>
"COMMITTED" último commit en o antes de BASE<br/>
"PREV" revisión justo antes de COMMITED<br/>
-N [--non-recursive] : operar en un solo directorio<br/>
-q [--quiet] : imprimir tan poco como sea posible<br/>
--diff3-cmd arg : usar PAR como comando para combinar<br/>
--username arg : especificar PAR como nombre de usuario<br/>
--password arg : especificar PAR como clave<br/>
--no-auth-cache : no almacenar y reusar claves<br/>
--non-interactive : no pedir información interactivamente<br/>
--config-dir arg : leer configuración del usuario del directorio PAR<br/>
Inicio
Propiedades Subversion
De paso quiero resaltar algo que suele pasar algo desapercibido y creo que es de bastante utilidad, que son las propiedades del subversion para meterlas en archivos de texto, código, etc:
La más habitual es $Id$ aunque en algunos ficheros nos puede interesar meter otras: $Date$ $Rev$ ...
Para añadir estas propiedades a un fichero se puede hacer:
*
De forma manual
svn propset svn:keywords Id Nombre_del_fichero
svn propset svn:keywords 'Date Rev Author URL Id' Nombre_del_fichero
*
De forma automática
En los ficheros que subamos nuevos, podemos configurar nuestro svn para que lo haga automáticamente
Para ello:
1 Hay que activar en ~/.subversion/config la propiedad
enable-auto-props = yes
2 Decir a qué ficheros afecta: por ejemplo a los .php
[auto-props]
*.php = svn:keywords=Id
Para utilizarlas basta incluir en el fichero referencias a ellas (entre el signo $) para que el propio subversion las actualice:
Por ejemplo:
#################################################################
# Versión: $Id$
#################################################################
que el svn sustituirá de forma automática a:
#################################################################
# Versión: $Id: cf.mysqlservers 2521 2008-01-22 12:29:14Z jgarcia $
#################################################################
De esta forma sabremos en el propio fichero quien hizo la última actualización y cuando. |
