#
# Mini howto
# ----------
#


cd /tmp					# Me posiciono donde quiero dejar mi
					# repositorio local

# Ahora traigo una copia fresca de todo el proyecto llamado "pinball" y lo dejo
# en un directorio local llamado "pinball" (/tmp/pinball en este ejemplo.
svn co svn+ssh://chopin/var/www/svn/pinball pinball


cd pinball/			# Ingreso al directorio de la copia local del
				# proyecto

vi README			# Edito el archivo README que ya existia

svn diff			# Me muestra que ha sido modificado con
				# respecto al ultimo commit.

vi TODO				# Edito TODO el cual es un archivo nuevo.

svn diff			# Me muestra que solo README ha sido modificado
				# esto es debido a que TODO todavia no ha sido 
				# incluido en el proyecto.

svn info			# Me muestra informacion del repositorio

svn status			# Muestra todo lo que ha sido modificado y todo
				# lo nuevo, por lo que el archivo TODO deberia 
				# aparecer tambien con un simbolo '?'

svn add TODO README		# Agrego TODO y README al repositorio local. En
				# este caso el comando deberia decir que README
				# ya se encontraba en el proyecto y que solo
				# agrega a TODO.

svn status			# Muestra el status, ahora TODO debería
				# aparecer como agregado.

svn commit			# Hace un commit de todo, del repositorio local
				# y lleva las modificaciones al repositorio
				# remoto. Aquí se va a iniciar 'vi' porque cada
				# commit necesita tener un log que explique
				# porque se han modificado agregado archivos.
				# Conviene hacer una linea corta explicando 
				# brevemente los cambios.

# Realiza un commit de un unico archivo con el log incluido
# Util para agregar comentarios separados por cada actualizacion.
# (Un svn commit solo agregara un unico comentario para un conjunto de
#  actualizaciones).
svn commit doc/como-svn.txt -m "Se agregan los links de la documentacion oficial"


IMPORTANTISIMO:
---------------

svn update			# Trae las ultimas actualizaciones. Es
				# necesario antes de trabajar cada vez
				# y hacer un commit. NUNCA empezar a editar
				# un repositorio local sin hacer primero un
				# svn update


Documentacion oficial:
----------------------
http://svnbook.red-bean.com/en/1.4/svn-book.html
http://subversion.tigris.org/faq.html


Cosas sueltas
-------------

# Agrego todo lo que hay en el directorio 'a' al repositorio remoto.
svn import a svn+ssh://chopin/var/www/svn/pinball
