Benvenuto tra gli utenti di pgDesigner !

pgDesigner è un programma open source per il disegno grafico di database per
PostgreSQL. Il codice è scritto con la versione di sviluppo del linguaggio
Gambas.

Ulteriori informazioni su http://pgdesigner.sourceforge.net

Per gli utenti di lingua italiana è presente anche un forum su
http://www.ldrweb.net

Per i riferimenti sul linguaggio Gambas, fare riferimento al sito ufficiale
http://gambas.sourceforge.net
-------------------------------------------------------------------------------
** NOTE IMPORTANTI

Leggere attentamente il ChangeLog allegato, in particolare la versione di
Gambas2 con cui è stato compilato il programma pgDesigner. Dato che la versione
Gambas2 è considerata ancora in fase di sviluppo, ogni nuovo rilascio comporta
spesso la riscrittura o la modifica di alcune funzionalità delle routine, per
cui si rende necessario utilizzare la corretta versione come indicato nel
ChangeLog. E' altresì possibile che l'applicazione abbia problemi di
compilazione anche con versioni di Gambas2 successive a quella indicata.

Per il funzionamento di pgDesigner sono necessari i seguenti componenti di
Gambas2:

  gb
  gb.compress
  gb.db
  gb.draw
  gb.eval
  gb.form
  gb.gui
  gb.qt
  gb.qt.ext
  gb.qt.kde
  gb.qt.kde.html
  gb.settings
  gb.xml
  
Quindi è necessario installare tutte le librerie necessarie, contenenti questi
componenti.

-------------------------------------------------------------------------------
** DISTRIBUZIONI LINUX

Oltre al file compresso, per Fedora è disponibile anche il pacchetto rpm, in
modo da facilitarne l'installazione su questo tipo di distribuzione.

Per l'installazione su Debian fare riferimento alla guida, scritta dall'amico
Piotr, su http://www.ldrweb.net

Per le altre distribuzioni, non ho modo di testarne la funzionalità, per cui
sarei molto grato a chi potesse fornire consigli utili relativamente alle
modalità di installazione o a problemi di compilazione.

Per problemi relativi al linguaggio Gambas, fare riferimento al sito ufficiale
http://gambas.sourceforge.net
-------------------------------------------------------------------------------
** LINGUAGGIO

Istruzioni per l'impostazione della lingua in pgDesigner.

pgDesigner è stato scritto in italiano, per cui la lingua di default è
l'italiano. Tutti le etichette e i messaggi verranno visualizzati in questa
lingua. Per poter selezionare una delle lingue previste è necessario definirla
nella variabile di ambiente LANG. Nel caso si voglia utilizzare pgDesigner in
una lingua diversa, ad esempio l'inglese (USA), è necessario impostare questa
variabile con l'identificativo della lingua, ad esempio "en_US", come da
esempio seguente:

# LANG=en_US gbx2 ./pgDesigner.gambas
oppure
# LANG=en_US ./pgDesigner.gambas

Il comando seguente, grazie all'amico Tomasz Krzeminski, è necessario su Debian
per avviare pgDesigner in lingua inglese:

# LANG=en_US LANGUAGE=en_US gbx2 ./pgDesigner.gambas
oppure
# LANG=en_US LANGUAGE=en_US ./pgDesigner.gambas

Dalla versione 0.0.40 è stata aggiunta una finestra di dialogo introduttiva,
che permette all'utente di selezionare una delle lingue previste dal programma.
Per default, la lingua di default viene ricavata dalla configurazione della
shell dell'utente; se questo non è possibile, viene proposta la lingua di
default che è l'italiano.
-------------------------------------------------------------------------------
** HELP

Istruzioni per l'installazione del pacchetto Help.

Date le dimensioni raggiunte dal pacchetto pgDesigner, ho creduto di fare cosa
buona separare il manuale utente in linea dal resto del programma.
L'accesso al manuale in questione è sempre possibile tramite accesso al web, in
questo caso verrà effettuato un collegamento al sito ufficiale
http://pgdesigner.sourceforge.net.
Per installare il manuale sul proprio computer è necessario seguire una
semplice procedura:
1) installare il pacchetto con i binari;
2) posizionarsi nella directory dove è stato installato il pacchetto del
   programma (normalmente /usr/share/pgDesigner);
3) decomprimere il file compresso pgDesigner-help-<versione>.tar.bz2
-------------------------------------------------------------------------------
** NOTE

Istruzioni per l'avvio di pgDesigner da riga di comando.

Dalla versione 1.0.2, è possibile avviare pgDesigner con apertura automatica di
file di progetto esistenti.
In questo è sufficiente digitare il comando di avvio del programma, seguito dal
o dai file che si desidera precaricare durante l'avvio; questi file, se non si
verificano problemi, saranno subito disponibili dopo l'avvio:

# ./pgDesigner.gambas /<path>/<filename.[ini|xml]> ...

E' possibile definire più di un file, ognuno verrà caricato allo stesso modo
del caricamento dal menu dell'applicazione.
Ogni file deve essere completo della directory su cui risiede e
dell'estensione, mentre tra un file ed il successivo deve essere presente
almeno uno spazio.
-------------------------------------------------------------------------------

Un saluto !

Luigi Carlotto.
