Prima di segnalare un bug, occorre assicurarsi che sia davvero un bug. La documentazione va riletta attentamente, per controllare se dice che è possibile fare quel che si sta tentando di fare. Se non è chiaro se sia possibile fare quella particolare cosa o no, occorre segnalarlo; in questo caso si tratta di un bug nella documentazione!
Prima di segnalare un bug o di tentare di risolverlo personalmente, si tenti
di isolarlo preparando un programma awk
il più piccolo possibile, con
un file-dati in input che possa riprodurre il problema. Dopo averlo fatto, si
spedisca il programma e il file-dati, insieme a informazioni sul tipo di
sistema Unix in uso, il compilatore usato per compilare gawk
, e i
risultati esatti che gawk
ha prodotto. Inoltre andrebbe specificato
cosa ci si aspettava che il programma facesse; questo è di aiuto per decidere
se il problema è un problema di documentazione.
È importante includere il numero di versione di gawk
in uso.
Questa informazione si può ottenere con il comando ‘gawk --version’.
Una volta pronta la descrizione precisa del problema, si spedisca un messaggio di posta elettronica a “bug-gawk at gnu dot org”.
I manutentori di gawk
sono i destinatari, e riceveranno la
segnalazione di errore. Sebbene sia possibile spedire messaggi direttamente ai
manutentori, è preferibile usare l’indirizzo sopra fornito perché quella
mailing list rimane in archivio presso il Progetto GNU. Tutti i messaggi
devono essere in inglese. È questo il solo linguaggio che tutti i manutentori
conoscono. Inoltre, occorre accertarsi di spedire tutti i messaggi in formato
testo, e non (o non soltanto) in formato HTML.
NOTA: Molte distribuzioni di GNU/Linux e i vari sistemi operativi basati su BSD hanno un loro proprio canale per segnalare i bug. Se si segnala un bug usando il canale della distribuzione, una copia del messaggio andrebbe inviata anche a “bug-gawk at gnu dot org”.
Questo per due ragioni. La prima è che, sebbene alcune distribuzioni inoltrino i messaggi sui problemi “verso l’alto” alla mailing list GNU, molte non lo fanno, e quindi c’è una buona probabilità che i manutentori di
gawk
non vedano affatto il messaggio relativo al bug! La seconda ragione è che la posta diretta alla mailing list GNU è archiviata, e il poter disporre di ogni cosa all’interno del progetto GNU consente di avere a disposizione tutte le informazioni rilevanti senza dover dipendere da altre organizzazioni.
Suggerimenti non correlati a bug sono pure sempre benvenuti. Se si hanno domande riguardo a qualcosa di non chiaro nella documentazione o a proposito di funzionalità oscure, si scriva alla mailing list dei bug; si proverà a essere di aiuto nei limiti del possibile.