================
README del yagot
================

Això és un joc per passar-s’ho bé. És completament experimental i mai arribarà
a la versió 1.0.

--------------
Enllaços útils
--------------

:A la plana del wiki: 	http://bulma.net/wiki/doku.php?id=yagot:index
:Article sobre darcs: 	http://bulma.net/body.phtml?nIdNoticia=2333
:Article sobre rst: 	http://bulma.net/body.phtml?nIdNoticia=2291
:Coding style:		http://lxr.linux.no/source/Documentation/CodingStyle

-------------
El repositori
-------------

Podeu accedir al codi font fent:
darcs get http://bulma.net/~paurullan/yagot/
Allà feis directament les modificacions que volgueu.
Per enviar els canvis primer els heu de desar:
``darcs record``
(recomano usar els paràmetres -a i -l, ó -al)
``darcs send -a``

És important tenir un servidor de correu correctament configurat. En cas de no
tenir-lo useu el paràmetre ``-o`` (``--output``) del ``darcs send``. Això vos
genera el pedaç que s’havia d’enviar. Evidentment llavors l’enviau manualment a
paurullan@bulma.net.

* help: l’utilíssima ajuda en línea.

* add: imprescindible si volem afegir material.

* remove: desvincula de l’arbre sense esborrar el fitxers. Si esborressím el
  fitxer directament també desapareixeria de l’arbre i quedaria constància del
  borrat.

* mv: mou, de veres i no com fa svn o cvs, fitxers.

* (un)revert: desfà o refà els canvis a l’arbre. Recordau que és el revert el
  que heu d’executar si heu esborrat accidentalment fitxers.

* (un)record: desa els canvis a un pedaç o aplica l’invers d’algun pedaç (és a
  dir, desfà els canvis del pedaç ja aplicat).

* whatsnew: mostra les diferències entre la situació actual i la darrera
  actualització.

* resolv: marca la resoŀlució de conflictes.

* tag: deixa una marca a l’historial de l’arbre. En realitat és un record sense
  modificacions als elements.

* changes: mostra l’historial de canvis.

* dist: fa un tar.gz del trunk de l’arbre.

* send: envia els pedaços generats pel record al mantenidor del repositori.

* apply: aplicam algun pedaç que ens hagin enviat.

* pull: actualitza el repositori amb base al passat com a paràmetre.
  Aquesta ordre deixa marcat el darrer repositori, així que no farà falta
  tornar a escriurer-lo si no canvia la localització.

* push: puja els canvis gravats al servidor pare.

* get: feim una branca del repositori objectiu.

* put: complementari del get. Ens ficam a un repositori i el paràmetre és la
  localització del nou repositori.


----------------
ReStructuredText
----------------

El rst és un llenguatge de marques molt útil per documentació. S’escriu sobre
text pla i es sol afegir l’extensió .rst. Heu d’instaŀlar el python-docutils i
podreu trobar la seva documentació al /usr/share/doc/python-docutils.

/usr/share/doc/python-docutils/docs/howto/rst-directives.html
/usr/share/doc/python-docutils/docs/howto/rst-roles.html

Igualment he posat el quickref al directori de la documentació. Així no hi ha
excusa d’usar-lo.

-------------------
Capsaleres procmail
-------------------

Les capsaleres que genera el darcs quan s’envia un correu són:
X-Mail-Originator: Darcs Version Control System
X-Darcs-Version: 1.0.8 (release)
DarcsURL: http://bulma.net/~paurullan/yagot

Això fa que podeu afegir al .procmailrc aquestes línees:
:0
* ^DarcsURL: http://bulma.net/~paurullan/yagot
repositori-yagot/

Igualment mai exepte el _darcs/prefs/author o _darcs/prefs/email rebrà el
correu, però no ve malament saber-ho.