HACKING.it.txt

   1 Compilare la versione SVN
   2 =========================
   3 Esegui `grep Build-Depends debian/control` per avere una lista dei pacchetti (Debian)
   4 necessari per la compilazione.
   5
   6 inkscape.spec.in contiene una lista parziale dei requisiti:
   7
   8   grep Requires inkscape.spec.in
   9
  10 Al momento, questa lista contiene un solo pacchetto; se usi usa distribuzione
  11 basata su RPM, sei pregato di aggiornare le linee Requires/BuildRequires in modo
  12 da aiutare gli altri utenti della tua stessa distribuzione. Se non hai accesso in
  13 scrittura al SVN, puoi inviare una patch al sistema di gestione delle patch
  14 <https://bugs.launchpad.net/inkscape>.
  15
  16 Consulta http://wiki.inkscape.org/wiki/index.php/CompilingInkscape per informazioni
  17 più generali sulla compilazione, incluso come trovare i pacchetti necessari per la
  18 propria distribuzione e alcuni suggerimenti per gli sviluppatori.
  19
  20
  21 Contribuire a Inkscape
  22 ========================
  23 Inkscape accetta volentieri i tuoi contributi per lo sviluppo
  24 di un programma di disegno completamente compatibile con SVG
  25 per la comunità Open Source.
  26
  27 Mentre diversi sviluppatori lavorano per correggere i bug o implementare
  28 nuove funzioni, è comunque necessario che anche i non programmatori contribuiscano
  29 a rendere Inkscape uno strumento utile e potente.
  30 Probabilmente tu hai già un'idea a proposito di cosa potresti occuparti.
  31 In caso contrario, questi sono solo alcuni suggerimenti:
  32
  33    * Controlla un bug, correggilo e manda una patch ("diff -uNrp" o "cvs diff -up")
  34    * Scegli una funzione che ti piacerebbe fosse implementata e sviluppala
  35    * Se parli un'altra lingua che non sia l'inglese, lavora sul file per l'i18n della tua
  36      lingua disponibile nella cartella po/
  37    * Scopri nuovi bug e segnalali
  38    * Rispondi a domande dei nuovi utenti su Jabber, IRC o mailing list
  39    * Scrivi un articolo per pubblicizzare Inkscape
  40    * Scrivi un HOWTO su qualche trucco o tecnica che trovi utile
  41
  42
  43 Accesso SVN
  44 ==========
  45 Consulta http://inkscape.org/svn.php per i modi di accesso al svn,
  46 tra la consultazione del SVN client web.
  47
  48 L'acceso in scrittura al SVN viene dato a tutti quelli che dimostrino interesse
  49 nello sviluppo del codice. La prova è semplice: fornisci un paio di contributi e richiedi
  50 l'accesso.
  51
  52
  53 Implementazione delle patch
  54 ===============
  55 Il nostro motto per i cambiamenti del codice è "Prima sviluppa, poi parla".
  56 Quando qualcuno ha un'idea, invece di parlarne a lungo e senza risultati, è
  57 meglio che prosegua e sviluppi qualcosa (anche solo un prototipo).
  58 Questo verrà incorporato nel ramo di sviluppo per essere testato, migliorato
  59 e commentato. Lo schema è semplice: il migliore modo per giudicare un'idea è
  60 vederla in azione.
  61
  62
  63 Stile del codice
  64 ============
  65 Consulta le Linee Guida per lo Stile del codice
  66 (http://www.inkscape.org/doc/coding_style.php) se hai delle domande specifiche
  67 sullo stile. Se non fosse sufficiente, adeguati allo stile del codice già presente,
  68 in modo da avere un minimo di coerenza.
  69
  70 Makefile
  71 =========
  72 Tutti i Makefile sotto alla directory src sono grosso modo fusi in un unico src/Makefile.am
  73 che attinge dai vari Makefile_insert delle directory.
  74
  75 Esso è comunque un'unico file, per cui le definizioni delle variabili (anche di
  76 INCLUDES ecc.) sono condivise, e le variabili definite in un
  77 Makefile_insert possono essere usate in un altro.
  78
  79 Quindi, prendi in considerazione il consiglio di aggiungere un prefisso (tipo `blah_')
  80 al nome delle variabili definite in blah/Makefile_insert (se il loro ambito è locale), o
  81 inserisci le definizioni in src/Makefile.am.  In particolare,
  82 controlla che check_PROGRAMS, DISTCLEANFILES, etc. siano in src/Makefile.am.
  83