GAZIE - Informazioni per gli sviluppatori

Questo documento è scritto per aiutare tutti quelli che vogliono partecipare a sviluppare e (o) testare Gazie.

1. Come prelevare i sorgenti dalla CVS.

Esistono due tipi di accesso: anonimo e con l'autenticazione. Se voi state leggendo questo documento, probabilmente a voi interessa il primo :-)

Per accedere al CVS da Linux (o UNIX in generale) è necessario creare la directory nella quale vogliamo scaricare i sorgenti. Entrate in questa directory e digitate:

Alla domanda di password premete INVIO.

Poi scrivete:

Gazie verrà scaricata nella directory CORRENTE.

Consiglio vivamente a tutti i non esperti di CVS di non usare il client grafico per i pimi accessi in quanto l'accesso dalla console permette di comprendere meglio il funzionamento della CVS.

Se il vostro sistema operativo è Windows la probabile soluzione può essere TortoiseCVS. Ecco l'esempio di compilazione della maschera per l'accesso al repository con questo programma.

Un'altra alternativa può essere Eclipse. Purtroppo il loro sito non è particolarmente "user-friendly", per questo motivo vi indico il link diretto alla pagina di download. Al giorno d'oggi (19.02.2005) questa è l'ultima versione stabile. La sezione che interesa a voi è "Platform Runtime Binary" e non "Eclipse SDK". La versione SDK è la versione completa di tutti i sorgenti e le documentazioni e vi può interessare solo se siete programmatori Java e volete contribuire al progetto Eclipse. Ho scritto una piccola descrizione su come conettersi al SourceForge da Eclipse.

Per tutti gli interessati ad approffondire il discorso di CVS ecco Open Source Development with CVS, 3rd Edition testo in inglese, gratis o Mini guida in italiano. Sul sito di stesso SourceForge esiste una guida esauriente Basic Introduction to CVS and SourceForge.net (SF.net) Project CVS Services. Consiglio a tutti di dare almeno uno sguardo veloce a questo documento.

2. Come contribuire una patch.

Dopo aver modificato i sorgenti voi potete creare la patch che permetterà di mostrare il vostro lavoro agli altri. In questo momento è necessario essere collegati ad internet.

Di nuovo vi mostro solo come si fa dal terminal:

Prelevate di nuovo i sorgenti da SourceForge (in un altra directoria) e provate ad applicare la vostra patch:

Se tutto è andato come ci si aspettava, inviate la patch utilizzando l'apposita pagina su SourceForge.

Consiglio fortemente a tutti di leggere "Best Practices for Working with Open-Source Developers" dal libro "The Art of Unix Programming" di Eric Steven Raymond.

3. Standard di programmazione

Per semplificare la collaborazione di più persone sullo stesso codice è importante usare lo stesso Standard di programmazione. Come standard di programmazione usate quello di Pear. Lo potete consultare qua dove per comodità troverete tutte le regole stampate sulla stessa pagina. Vi consiglio di stampare le regole e all'inizio di averle sempre sotto mano. Questo non è il mio standard preferito e non è lo standard usato da Antonio De Vincentiis quindi andrà bene anche per voi :-).

4. Registrazione sul SourceForge

Per la collaborazione sul progetto la registrazione non è obbligatoria, però sarebbe meglio perché permette di identificare la persona che contribuisce il codice.