Il FreeBSD Project utilizza GNATS per
gestire i bug e le richieste di cambiamenti. Assicurati di usare
edit-pr numero-pr
su
freefall
quando effettui il commit di una correzione o di
un suggerimento trovato in un PR GNATS per
chiuderlo. È inoltre considerato gentile se trovi il tempo di
chiudere ogni PR associato al tuo commit, se esistono. Puoi anche usare
send-pr(1) tu stesso per proporre qualsiasi cambiamento che pensi
debba essere fatto, a seguito di una maggiore revisione da parte di altre
persone.
Puoi trovare di più su GNATS su:
Puoi far girare una copia locale di GNATS, e poi integrare l'albero
GNATS di FreeBSD in esso tramite CVSup. In seguito puoi usare i comandi
GNATS localmente, o usare altre interfacce, come
tkgnats
. Questo ti permette di interrogare il database
dei PR senza bisogno di essere connesso a Internet.
Se non stai già scaricando l'albero GNATS, aggiungi questa
riga al tuo supfile
, e riesegui cvsup(1).
Nota che siccome GNATS non è sotto
il controllo di CVS non ha tag, quindi se lo stai aggiungendo al tuo
supfile
esistente deve apparire prima di ogni
voce «tag=» dato che queste rimangono attive una volta
impostate.
gnats release=current prefix=/usr
Questo metterà l'albero GNATS di FreeBSD in
/usr/gnats
. Puoi usare un file
refuse per controllare quali categorie ricevere.
Per esempio, per ricevere solo i PR docs
, metti
questa riga in /usr/local/etc/cvsup/sup/refuse
[1].
gnats/[a-ce-z]*
Il resto di questi esempi assume che tu abbia scaricato solo la
categoria docs
. Modificali quando è
necessario, a seconda delle categorie che tieni in sincronia.
Installa il port GNATS da
ports/databases/gnats
. Questo metterà le
varie directory GNATS sotto
$PREFIX/share/gnats
.
Crea un symlink per le directory GNATS che aggiorni tramite CVSup sotto la versione di GNATS che hai installato.
#
cd /usr/local/share/gnats/gnats-db
#
ln -s /usr/gnats/docs
Ripeti tante volte quanto necessario, a seconda di quante categorie GNATS tieni in sincronia.
Aggiorna il file categories
di GNATS con
queste categorie. Il file è
$PREFIX/share/gnats/gnats-db/gnats-adm/categories
.
# Questa categoria è obbligatoria pending:Categoria per i PR errati:gnats-admin: # # Categorie di FreeBSD # docs:Bug di Documentazione:freebsd-doc:
Esegui $PREFIX/libexec/gnats/gen-index
per
ricreare l'indice GNATS. L'output deve essere reindirizzato su
$PREFIX/share/gnats/gnats-db/gnats-adm/index
.
Puoi fare questo periodicamente da cron(8), o eseguire
cvsup(1) da uno script di shell che fa anche questo.
#
/usr/local/libexec/gnats/gen-index \ > /usr/local/share/gnats/gnats-db/gnats-adm/index
Verifica la configurazione interrogando il database dei PR.
Questo comando visualizza i PR docs
aperti.
#
query-pr -c docs -s open
Anche altre interfacce, come quella fornita dal port databases/tkgnats, dovrebbero funzionare correttamente.
Prendi un PR e chiudilo.
Questa procedura funziona solo per permetterti di visualizzare ed
interrogare i PR localmente. Per modificarli o chiuderli dovrai ancora
loggarti su freefall
e farlo da lì.
Questo, ed altri documenti, possono essere scaricati da ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Per domande su FreeBSD, leggi la
documentazione prima di contattare
<questions@FreeBSD.org>.
Per domande su questa documentazione, invia una e-mail a
<doc@FreeBSD.org>.