HACKING.it.txt revision cf247409a1bd3875e764c3371b42b7342184d054
Compilare la versione SVN
=========================
Esegui `grep Build-Depends debian/control` per avere una lista dei pacchetti (Debian)
necessari per la compilazione.
inkscape.spec.in contiene una lista parziale dei requisiti:
grep Requires inkscape.spec.in
Al momento, questa lista contiene un solo pacchetto; se usi usa distribuzione
basata su RPM, sei pregato di aggiornare le linee Requires/BuildRequires in modo
da aiutare gli altri utenti della tua stessa distribuzione. Se non hai accesso in
scrittura al SVN, puoi inviare una patch al sistema di gestione delle patch
Consulta http://wiki.inkscape.org/wiki/index.php/CompilingInkscape per informazioni
pi� generali sulla compilazione, incluso come trovare i pacchetti necessari per la
propria distribuzione e alcuni suggerimenti per gli sviluppatori.
Contribuire a Inkscape
========================
Inkscape accetta volentieri i tuoi contributi per lo sviluppo
di un programma di disegno completamente compatibile con SVG
per la comunit� Open Source.
Mentre diversi sviluppatori lavorano per correggere i bug o implementare
nuove funzioni, � comunque necessario che anche i non programmatori contribuiscano
a rendere Inkscape uno strumento utile e potente.
Probabilmente tu hai gi� un'idea a proposito di cosa potresti occuparti.
In caso contrario, questi sono solo alcuni suggerimenti:
* Controlla un bug, correggilo e manda una patch ("diff -uNrp" o "cvs diff -up")
* Scegli una funzione che ti piacerebbe fosse implementata e sviluppala
* Se parli un'altra lingua che non sia l'inglese, lavora sul file per l'i18n della tua
lingua disponibile nella cartella po/
* Scopri nuovi bug e segnalali
* Rispondi a domande dei nuovi utenti su Jabber, IRC o mailing list
* Scrivi un articolo per pubblicizzare Inkscape
* Scrivi un HOWTO su qualche trucco o tecnica che trovi utile
Accesso SVN
==========
Consulta http://inkscape.org/svn.php per i modi di accesso al svn,
tra la consultazione del SVN client web.
L'acceso in scrittura al SVN viene dato a tutti quelli che dimostrino interesse
nello sviluppo del codice. La prova � semplice: fornisci un paio di contributi e richiedi
l'accesso.
Implementazione delle patch
===============
Il nostro motto per i cambiamenti del codice � "Prima sviluppa, poi parla".
Quando qualcuno ha un'idea, invece di parlarne a lungo e senza risultati, �
meglio che prosegua e sviluppi qualcosa (anche solo un prototipo).
Questo verr� incorporato nel ramo di sviluppo per essere testato, migliorato
e commentato. Lo schema � semplice: il migliore modo per giudicare un'idea �
vederla in azione.
Stile del codice
============
Consulta le Linee Guida per lo Stile del codice
(http://www.inkscape.org/doc/coding_style.php) se hai delle domande specifiche
sullo stile. Se non fosse sufficiente, adeguati allo stile del codice gi� presente,
in modo da avere un minimo di coerenza.
Makefile
=========
Tutti i Makefile sotto alla directory src sono grosso modo fusi in un unico src/Makefile.am
che attinge dai vari Makefile_insert delle directory.
Esso � comunque un'unico file, per cui le definizioni delle variabili (anche di
INCLUDES ecc.) sono condivise, e le variabili definite in un
Makefile_insert possono essere usate in un altro.
Quindi, prendi in considerazione il consiglio di aggiungere un prefisso (tipo `blah_')
al nome delle variabili definite in blah/Makefile_insert (se il loro ambito � locale), o
inserisci le definizioni in src/Makefile.am. In particolare,
controlla che check_PROGRAMS, DISTCLEANFILES, etc. siano in src/Makefile.am.