Firebird Documentation IndexCómo obtener y construir el módulo "manual" de Firebird → Obtener el módulo Firebird manual de SourceForge
Firebird Home Firebird Home Anterior: Cómo obtener y construir el módulo "manual" de FirebirdFirebird Documentation IndexSubir: Cómo obtener y construir el módulo "manual" de FirebirdSiguiente: Construir los documentos de Firebird

Obtener el módulo Firebird manual de SourceForge

¿Qué es CVS?
Clientes CVS
Desproteger el módulo manual

El módulo manual es parte del repositorio CVS de Firebird en SourceForge. Para descargarlo, necesita una aplicación denominada cliente CVS. Esta sección describe los pasos necesarios para obtener el software y el módulo manual. El proceso de construcción de los documentos se explica en la siguiente sección: Construir los documentos de Firebird.

¿Qué es CVS?

CVS significa Sistema de Versiones Concurrentes (Concurrent Versions System). Es una herramienta para administrar desarrollos de software, útil tanto para desarrolladores individuales como para trabajo en equipo. Prácticamente todos los proyectos en SourceForge usan CVS para almacenar y desarrollar su base de código. El árbol CVS de Firebird está dividido en partes llamadas modulos, el módulo "manual" es uno de ellos.

Clientes CVS

El descargar un módulo desde un almacén CVS se denomina desproteger (check out) en términos de CVS. Para hacerlo, Ud. necesita un cliente CVS; existen prácticamente para todos los sistemas operativos. Aquí va una lista de clientes CVS para algunos Sistemas Operativos populares:

Obtenga uno o más de los clientes mencionados e instálelo de acuerdo a las instrucciones que se incluyen en cada uno. Después de eso, Ud. estará listo para desproteger el módulo manual.

Desproteger el módulo manual

Hay dos formas de desproteger el módulo manual: como un usuario anónimo, o con su nombre de usuario de SourceForge. El último método se denomina desprotección SSH (porque utiliza una sesión segura (Secure SHell) o desprotección EXT (porque utiliza SSH como un protocolo EXTerno).

Cualquiera puede desproteger anónimamente. Los miembros del proyecto Firebird pueden también desproteger usando su usuario de SourceForge. (Si Ud. tiene una cuenta de SF pero no es miembro del proyecto Firebird, puede desproteger en forma anónima).

Si Ud. es un miembro del proyecto, generalmente querrá desproteger con su usuario de SF porque

  1. La desprotección anónima no está siempre al día (el retardo puede ir de varias horas a varios días);

  2. Si Ud. va a contribuir por su cuenta al módulo manual, entonces debe desproteger con su usuario de SF o no tendrá la posibilidad de enviar sus cambios de vuelta al servidor (commit o upload).

En las siguientes subsecciones describiremos ambos métodos, comenzando con la desprotección anónima. O puede ir directamente a la sección sobre desprotección SSH.

Desprotección Anónima

El proceso de desprotección depende del cliente que utilice. Le daremos instrucciones exactas para CVS de línea de comandos, e información genérica para ser usada con los otros clientes.

Desprotección anónima usando CVS de línea de comandos
  1. Si Ud. está en un entorno gráfico, abra una ventana de comandos.

  2. Primero, debe verificar la clave con el servidor y almacenarla localmente. Ejecute el comando:

    cvs -d:pserver:[email protected]:/cvsroot/firebird login

    Cuando se le pregunte por una clave (password), simplemente presione Enter (Entrar), dado que la clave para el usuario "anonymous" está vacía. Su cliente CVS almacenará la clave para uso posterior, de manera que puede saltear este paso en el futuro, mientras no se haya autenticado con otras claves en el interín.

  3. Ahora puede obtener el módulo manual. Ejecute el comando:

    cvs -z6 -d:pserver:[email protected]:/cvsroot/firebird checkout manual

    Si todo va bien, se creará un directorio llamado manual debajo de su directorio actual, y el árbol de fuentes del manual será descargado en él. Ahora ya puede generar los documentos - más información en la sección siguiente, Construir los documentos de Firebird.

Desprotección anónima usando otros clientes

Hay demasiada variación como para dar instrucciones exactas para todos los clientes CVS aquí. Consulte la ayuda o documentación para su propio cliente. Los elementos que se le pedirán en algún momento son:

protocol (protocolo)

debe ser pserver (password server)

authentication method (método de autenticación)

lo mismo que en protocol

server (servidor)

cvs.sourceforge.net

repository (almacén)

/cvsroot/firebird

user name (nombre de usuario)

anonymous

module name (nombre del módulo)

manual

cvsroot

generalmente una combinación del servidor y el almacén, algunas veces incluye también al nombre de usuario adelante de lo demás (por ejemplo en WinCvs): cvs.sourceforge.net:/cvsroot/firebird o [email protected]:/cvsroot/firebird

Complete los datos necesarios y ejecute el comando desproteger de su cliente. Si la desprotección es correcta, Ud. tendrá ahora una copia local del módulo manual en su computadora y estará listo para construir los documentos. Siga el tema en la sección siguiente, Construir los documentos de Firebird.

Desprotección SSH (con su usuario de SF)

Para poder realizar una desprotección SSH, debe tener en su sistema un cliente seguro. En la mayoría de los sistemas Unix, así como en Mac OS X, OpenSSH se instala por defecto. Si no, verifique los CDs de su distribución o descárguelo de http://www.openssh.com. Este sitio contiene referencias a otros productos SSH para Sistemas Operativos no soportados por OpenSSH. No obstante, observe que instalar y configurar SSH en algunas plataformas (incluyendo Windows) no es una tarea trivial. Puede hacer más fácil su vida eligiendo un cliente CVS que tenga SSH incluido, como TortoiseCVS para Windows.

En cuanto a la desprotección en sí: al igual que con las desprotecciones anónimas, el procedimiento depende del cliente que utilice. Nuevamente, daremos instrucciones exactas para CVS de línea de comandos, y sólo información genérica para otros clientes.

Desprotección SSH usando CVS de línea de comandos
  1. Si está en un entorno gráfico, abra una ventana de comandos.

  2. Primero, asegúrese de tener definida una variable llamada CVS_RSH con el valor “ssh” (o como se llame su cliente SSH). Cómo hacer esto depende de su sistema operativo. En una ventana de comandos DOS/Windows, escriba set CVS_RSH=ssh. En Linux/bash: export CVS_RSH=ssh.

    Ud. puede querer hacer permanente esta variable de entorno, de tal manera que pueda saltear este paso en el futuro. Cómo hacer esto depende de su sistema operativo. Consulte la documentación del mismo si es necesario.

  3. Ejecute el siguiente comando para obtener el módulo manual (sustituya “nombre_usuario” con su propio nombre de usuario de SourceForge):

    cvs -z6 -d:ext:[email protected]:/cvsroot/firebird checkout manual

    Ingrese su clave cuando se le solicite.

    Si todo va bien, se creará un directorio llamado manual debajo de su directorio actual, y el árbol de fuentes del manual será descargado en él. Ahora ya puede generar los documentos. Siga el tema en la sección siguiente, Construir los documentos de Firebird.

Desprotección SSH usando otros clientes

Hay demasiada variación como para dar instrucciones exactas para todos los clientes CVS aquí. Consulte la ayuda o documentación para su propio cliente. Los elementos que se le pedirán en algún momento son:

protocol (protocolo)

debe ser ext (o SSH, o SSL)

authentication method (método de autenticación)

lo mismo que en protocol

server (servidor)

cvs.sourceforge.net

repository (almacén)

/cvsroot/firebird

user name (nombre de usuario)

su nombre de usuario en SourceForge

module name (nombre del módulo)

manual

cvsroot

generalmente una combinación del servidor y el almacén, algunas veces incluye también al nombre de usuario adelante de lo demás (por ejemplo en WinCvs): cvs.sourceforge.net:/cvsroot/firebird o [email protected]:/cvsroot/firebird

Complete los datos necesarios y ejecute el comando desproteger de su cliente. Si la desprotección es correcta, Ud. tendrá ahora una copia local del módulo manual en su computadora y estará listo para generar los documentos. También puede enviar los cambios que haga localmente, de vuelta al almacén.

Anterior: Cómo obtener y construir el módulo "manual" de FirebirdFirebird Documentation IndexSubir: Cómo obtener y construir el módulo "manual" de FirebirdSiguiente: Construir los documentos de Firebird
Firebird Documentation IndexCómo obtener y construir el módulo "manual" de Firebird → Obtener el módulo Firebird manual de SourceForge