B.4.1 Segnalare Bug

Prima di segnalare un bug, occorre assicurarsi che sia davvero un bug. Per prima cosa, si deve verificare se si sta usando l’ultima versione di gawk. Molti bug (di solito difficili da scoprire) sono corretti in ogni nuova versione, e se la versione in uso è piuttosto datata, il problema può essere stato risolto nel frattempo.

In secondo luogo, si dovrebbe controllare se, con l’impostare la variabile LC_ALL come LC_ALL=C produce il funzionamento atteso da parte del programma. Se è questo il caso, il problema dipende dalla localizzazione, e può non essere veramente un bug.

In terzo luogo, va riletta attentamente la documentazione, 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!

Infine, 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.

Si tenga presente: Si chiede di seguire le GNU Kind Communication Guidelines – Linee guida GNU per una comunicazione gentile nella corrispondenza con la lista (e anche in quella fuori dalla lista).