charla_scm/ejemplos/darcs/1-basico.html

   1 <html>
   2 <head>
   3 <title>darcs :: Ejemplo 1</title>
   4 <link rel="stylesheet" type="text/css" href="../style.css">
   5 </head>
   6 <body>
   7
   8 <h2>Ejemplo 1 - En la cueva</h2>
   9
  10 En este primer ejemplo vamos a hablar de varias de las operaciones que ya
  11 mencionamos. Todas van a ser lineales y aisladas, en el sentido de que van a
  12 trabajar sobre un solo repositorio y de forma secuencial.<p>
  13
  14 Antes que nada, creamos el repositorio<br>
  15
  16 <pre>
  17 <tt class=nota>Creamos el directorio del repo</tt>
  18 # mkdir recetas
  19 # cd recetas
  20
  21 <tt class=nota>Creamos el repo con darcs</tt>
  22 # darcs init
  23
  24 <tt class=nota>Vemos que se crea el directorio especial</tt>
  25 # ls -l
  26 total 8
  27 drwxr-xr-x  6 root root 4096 May 17 22:43 _darcs
  28 #
  29 </pre>
  30
  31 Ahora agregamos el primer archivo<br>
  32
  33 <pre>
  34 <tt class=nota>Creamos un archivo nuevo editandolo</tt>
  35 # vi arroz
  36 #
  37 <tt class=nota>Lo incorporamos al repositorio</tt>
  38 # darcs add arroz
  39 #
  40 </pre>
  41 <p>
  42
  43 Y hacemos un record para grabar el cambio en el repositorio:
  44
  45 <pre>
  46 # darcs record
  47 <tt class=nota>Solo la primera vez nos pregunta nombre y email</tt>
  48 Darcs needs to know what name (conventionally an email address) to use as the
  49 patch author, e.g. 'Fred Bloggs &lt;fred@bloggs.invalid&gt;'.  If you provide one
  50 now it will be stored in the file '_darcs/prefs/author' and used as a default
  51 in the future.  To change your preferred author address, simply delete or edit
  52 this file.
  53
  54 What is your email address? Alberto Bertogli &lt;albertogli@telpin.com.ar&gt;
  55
  56 <tt class=nota>Nos pregunta cambio por cambio que queremos hacer</tt>
  57 <tt class=nota>El primero es la incorporacion del archivo</tt>
  58 addfile ./arroz
  59 Shall I record this patch? (1/2) [ynWsfqadjk], or ? for help: y
  60
  61 <tt class=nota>Y el segundo el contenido del mismo</tt>
  62 hunk ./arroz 1
  63 +
  64 +poner agua a hervir con sal (ponerle poca sal)
  65 +
  66 +cuando hierva agregar el arroz y bajar un poco el fuego
  67 +
  68 +cuando este, sacarlo colandolo bajo agua fria para cortar la coccion
  69 +
  70 +ponerle aceite, puede ser de oliva; poner tambien un chorrin en la fuente
  71 +antes, abajo del arroz
  72 +
  73 +cuatro tazas de agua x una de arroz
  74 +una taza de arroz por persona (salen 2 platos)
  75 +
  76 +
  77 Shall I record this patch? (2/2) [ynWsfqadjk], or ? for help: y
  78 <tt class=nota>Ahora nos pide un nombre corto para el patch</tt>
  79 What is the patch name? Agregamos una receta para el arroz
  80 <tt class=nota>Y, opcionalmente, podemos poner una descripcion larga</tt>
  81 Do you want to add a long comment? [yn] n
  82 Finished recording patch 'Agregamos una receta para el arroz'
  83 </pre>
  84
  85 Vemos el historial de cambios<br>
  86
  87 <pre>
  88 # darcs changes
  89 Tue May 17 22:45:00 ART 2005  Alberto Bertogli <albertogli@telpin.com.ar>
  90   * Agregamos una receta para el arroz
  91 #
  92 </pre>
  93
  94 Ahora hagamos un cambio chico editando un poco el contenido, y antes de hacer
  95 un record queremos ver el diff, asi nos aseguramos que este todo bien; despues
  96 lo grabamos con un record.<br>
  97
  98 <pre>
  99 <tt class=nota>Editamos un poco</tt>
 100 # vi arroz
 101 #
 102 <tt class=nota>Vemos los cambios</tt>
 103 # darcs diff -u
 104 diff -rN -u old-recetas/arroz new-recetas/arroz
 105 --- old-recetas/arroz   2005-05-17 23:32:18.000000000 -0300
 106 +++ new-recetas/arroz   2005-05-17 23:32:49.000000000 -0300
 107 @@ -1,5 +1,5 @@
 108
 109 -poner agua a hervir con sal (ponerle poca sal)
 110 +poner agua a hervir con poca sal
 111
 112  cuando hierva agregar el arroz y bajar un poco el fuego
 113
 114 @@ -8,7 +8,7 @@
 115  ponerle aceite, puede ser de oliva; poner tambien un chorrin en la fuente
 116  antes, abajo del arroz
 117
 118 -cuatro tazas de agua x una de arroz
 119 +cuatro tazas de agua por una de arroz
 120  una taza de arroz por persona (salen 2 platos)
 121
 122 #
 123 <tt class=nota>Nos parecio bien lo que ibamos a cambiar, asi que hacemos el
 124 record</tt>
 125 # darcs record
 126 hunk ./arroz 2
 127 -poner agua a hervir con sal (ponerle poca sal)
 128 +poner agua a hervir con poca sal
 129 Shall I record this patch? (1/2) [ynWsfqadjk], or ? for help: y
 130 hunk ./arroz 11
 131 -cuatro tazas de agua x una de arroz
 132 +cuatro tazas de agua por una de arroz
 133 Shall I record this patch? (2/2) [ynWsfqadjk], or ? for help: y
 134 What is the patch name? Unos pequeños cambios.
 135 Do you want to add a long comment? [yn] y
 136 <tt class=nota>Aca abre el editor de texto y escribimos una descripcion un
 137 poco mas larga</tt>
 138 Finished recording patch 'Unos pequeños cambios.'
 139 #
 140 </pre>
 141
 142 Ahora hacemos otros cambios mas que creemos que estan bien, pero despues
 143 llamamos a nuestra mama y ella nos grita "Horror! No hagas eso nene que se te
 144 va a quemar todo", asi que queremos volver a como estabamos antes de
 145 empezar.<br>
 146 Vamos a mostrar ahora la salida un poco resumida, para no cargar de cosas que
 147 ya vimos y no son relevantes.<br>
 148
 149 <pre>
 150 <tt class=nota>Primero editamos</tt>
 151 # vi arroz
 152 # darcs diff -u
 153 [...]
 154 #
 155 <tt class=nota>Aca llamamos a nuestra mama, y se horroriza. Volvemos todo para
 156 atras, hasta el ultimo record que hicimos</tt>
 157 # darcs revert
 158 <tt class=nota>(nos muestra los cambios uno por uno, como cuando hacemos un
 159 record, y elegimos que volvemos atras y que no)</tt>
 160 [...]
 161 Shall I revert this patch? (1/1) [ynWsfqadjk], or ? for help: y
 162 Do you really want to do this? y
 163 Finished reverting.
 164 #
 165 </pre>
 166
 167 Pero claro, a medida que pasa el tiempo nos vamos poniendo mas cancheros con
 168 el arroz, y decidimos que la receta del arroz tal como esta ahi deberia
 169 llamarse "arroz-solo", asi que la renombramos.
 170
 171 <pre>
 172 # darcs mv arroz arroz-solo
 173 # ls -l
 174 total 16
 175 4 -rw-r--r--  1 root root  347 May 17 23:51 arroz-solo
 176 4 drwxr-xr-x  6 root root 4096 May 18 00:14 _darcs
 177 #
 178 </pre>
 179
 180 Bueno, ya vimos bastante acerca de como trabajar solos, salgamos un poco al
 181 mundo y veamos que hay ahi afuera.<p>
 182
 183 </body>
 184 </html>
 185