PHPDOC-es

¿Cómo Trabajar con el CVS de PHP.net?

Aqui podeis encontrar informacion sobre como la traducción de la documentacion oficial de PHP esta organizada en el CVS de php.net.

Servidor: cvs.php.net
Modulo documentacion en ingles: phpdoc [Interface web]
Modulo documentacion en castellano: phpdoc-es [Interface web]

El modulo con el que trabajamos en la traduccion se llama phpdoc-es. Cuando os bajeis por primera vez este modulo, se os grabara en un subdirectorio llamado phpdoc-es. Dentro de este subdirectorio encontrareis:

Ficheros, directorios y definiciones necesarias para generar todos los formatos de la documentacion.
Directorio en/: Contiene la documentacion en ingles.
Directorio es/: Contiene la traduccion en castellano. La estructura es similar a la encontrada en el directorio en/.

Todas las actualizaciones en el CVS se deben hacer sola y exclusivamente sobre el directorio es/. (Al menos hasta que controleis al 200% como funciona el CVS, como esta organizada la documentacion y como se trabaja en el proyecto de documentacion de PHP).

Para empezar a trabajar con el CVS debeis tener una cuenta en el mismo. Para ello pasaros por http://www.php.net/cvs-php.php y rellenar el formulario al final de la pagina. Una vez conseguida la cuenta CVS tendreis que hacer lo siguiente para bajaros una copia del modulo phpdoc-es a vuestro ordenador:

Definir la variable CVSROOT ([usuario] es vuestra cuenta de usuario en el CVS):
```
 [rafael@home]$ export CVSROOT=:pserver:[usuario]@cvs.php.net:/repository
```
Definir la variable EDITOR con vuestro editor preferido:
```
 [rafael@home]$ export EDITOR=emacs
```

Crear el fichero ~/.cvsrc con estas lineas:

 cvs -z3
 update -d -P
 checkout -P
 diff -u

Conectaros al CVS:
```
 [rafael@home]$ cvs login
```
Bajaros por primera vez el modulo de la traduccion del CVS. Para ello ir o crear el directorio donde quereis tener este modulo y ejecutar:
```
 [rafael@CVSDIR]$ cvs co phpdoc-es
```
Cuando termineis de trabajar con el CVS teneis que desconectaros:
```
 [rafael@CVSDIR]$ cvs logout
```

Una vez que teneis el modulo descargado en vuestro ordenador existen dos comandos que utilizareis todo el tiempo. UPDATE para actualizar la copia en vuestro ordenador con los ultimos cambios que otros usuarios han hecho en el repositorio CVS. Y COMMIT que se utiliza para actualizar el repositorio CVS con los cambios que hayais efectuado localmente en vuestro ordenador.

Para actualizar vuestra copia con los cambios que otros han hecho en el CVS (UPDATE):
```
 [rafael@CVSDIR]$ cd phpdoc-es
 [rafael@phpdoc-es]$ cvs update
```
Para actualizar el CVS con los cambios que hayais efectuado localmente (COMMIT):
```
 [rafael@CVSDIR]$ cd phpdoc-es
 [rafael@phpdoc-es]$ cvs ci es/
```

Hispalinux tiene un pequeño tutorial sobre CVS muy bueno con los pasos minimos para empezar a trabajar con el. Tambien existen programas graficos para no tener que trabajar en linea de comandos. El que yo uso y recomiendo a los que quieran trabajar con un CVS se llama TKCVS, facil de usar, muy completo y facil de instalar si tenemos cvs y Tcl/Tk instalado en nuestro ordenador.