Documentazione - Progetto GNU - Free Software Foundation (FSF)

Documentazione del Progetto GNU

[ Catalano | Inglese | Italiano | Portoghese | Spagnolo ]

Sommario

Per favore aiutateci a scrivere la documentatione

Per avere assistenza su come iniziare, si contattino i Coordinatori dei Volontari GNU. Si veda anche scrivere software libero, dove è presente una lista di progetti che necessitano di documentazione.

Gli Standard GNU di programmazione hanno un'eccellente sezione su come documentare i programmi, inoltre il Manuale di Texinfo contiene molte dritte e suggerimenti. La pagina sulle licenze contiene sia il testo integrale della licenza GNU per la documentazione libera sia una discussione su questo argomento.

Come ottenere la documentazione GNU

La documentazione GNU è disponibile in diversi modi. I nostri manuali sono distribuiti con il permesso di essere copiati e modificati. Il più vecchio tra i libri liberamente distribuibili è il Diamond Sutra, pubblicato in Cina nell'anno 868. Per un'introduzione alla documentazione libera si veda il saggio di Richard Stallman Software libero e manuali liberi.

Si possono ordinare manuali stampati e schede di riferimento dalla FSF.
Si possono consultare i manuali on line.
Si possono scaricare via FTP da un vicino sito.
Il sorgente Texinfo o TeX di quasi tutti i manuali e le schede di riferimento GNU è incluso nello stesso archivio compresso contenente il codice sorgente del programma e non viene distribuito separatamente.
Si possono scaricare le versioni Postscript o HTML da questi siti di documentazione del software libero
Si può fotocopiare la documentazione stampata di un amico.

Chi non intende acquistare manuali o schede di riferimento dalla FSF è invitato a considerare la possibilità di fare una donazione, per aiutarci a scrivere più documentazione.

Descrizione dei manuali GNU che stampiamo come libri

Qui sono presenti le descrizioni di tutti i manuali GNU pubblicati e stampati dalla FSF come libri. Si veda più avanti i codici ISBN delle edizioni attuali. Se si vogliono acquistare libri GNU per uso personale, si usi il modulo d'ordine della FSF, sia per le edizioni aggiornate che per alcune edizioni precedenti. Si contatti la FSF se si ha intenzione di acquistare le pubblicazioni della FSF per la rivendita.

Molti dei manuali GNU sono stati tradotti in giapponese e vengono pubblicati in Giappone. Preghiamo chiunque abbia notizie di altre pubblicazioni di contattare la FSF.

Abbiamo bisogno di volontari per mantenere aggiornate queste informazioni.
Queste descrizioni devono essere migliorate. Ognuna di queste va ampliata con il testo contenuto nell'ultima di copertina del relativo manuale e/o con il testo contenuto all'interno della copertina e/o con il testo introduttivo di ciascun manuale e/o in qualsiasi altro modo conveniente.
Ogni manuale stampato dovrebbe avere la sua pagina, contenente miniature ed immagini a dimensione reale del dorso, copertina e ultima di copertina; dovrebbe anche avere dei collegamenti verso il Modulo d'Ordine FSF, alla pagina di questo sito, sotto http://www.gnu.org/software/*/, che descriva il software in questione, e probabilmente anche ad altre pagine. E' auspicabile che ogni manuale abbia anche una pagina storica che descriva le precedenti edizioni.

Lo GNU Emacs Manual (14ª Edizione per la Versione 20.7) tratta dell'utilizzo di Emacs come editor. Spiega le sue caratteristiche avanzate, comprese la modalità struttura e la ricerca con l'utilizzo di espressioni regolari. Spiega inoltre come utilizzare le modalità speciali per scrivere codice in linguaggi come C++ e TeX; come utilizzare l'utility tags; come compilare e correggere il codice; come impostare le proprie combinazioni di tasti ed altre personalizzazioni elementari.
Lo GNU Emacs Lisp Reference Manual (per la versione 21 di GNU Emacs) e lo GNU Emacs Lisp Reference, Japanese Edition (Revisione della bozza giapponese 1.0, dall'Edizione Inglese 2.4 per la Versione 19.29) coprono in profondità questo linguaggio di programmazione, trattando i tipi di dati, le strutture di controllo, le funzioni, le macro, le tabelle sintattiche, le ricerche combinate, le modalità, le fineste, le mappe di tasti, la compilazione lisp e l'interfacciamento col sistema operativo. Il sorgente è prelevabile dalla directory FTP ftp://etlport.etl.go.jp/pub/doc/gnu-jp/elisp-manual/.
Programming in Emacs Lisp: An Introduction (Edizione 1.05) è rivolto alle persone che non sono necessariamente interessate alla programmazione, ma che voglino personalizzare o estendere il loro ambiente d'elaborazione. Se lo si legge con Emacs nella modalità Info, si possono far partire direttamente i programmi di esempio.
Using and Porting GNU CC (per la Versione 2.95) spiega come installare ed usare il compilatore C di GNU e come fare il porting verso altri sistemi. Questo libro elenca le nuove caratteristiche e le incompatibilità di GCC, pertanto chi non ha grande familiarità con il C ha anche bisogno di un buon manuale di riferimento per questo linguaggio. Il libro copre anche G++, il compilatore C++ di GNU.
Lo GNU C Library Reference Manual (per le Versioni 2.x) descrive le funzionalità della libreria, comprese quelle che in Unix sono note come "funzioni di libreria" e le "chiamate di sistema". Attualmente questo manuale viene pubblicato come un set di 2 volumi che insieme superano le 1100 pagine! Si prega di inviare eventuali correzioni a bug-glibc-manual@gnu.org. Il manuale non si occupa delle librerie del C++.
Debugging with GDB (per la Versione 5.0) spiega come eseguire i propri programmi sotto il controllo del GNU Debugger, come esaminare ed alterare i dati, come modificare il flusso di controllo di un programma e come usare GDB attraverso GNU Emacs.
GNU Make (per la Versione 3.79) descrive make di GNU, un programma usato per costruire parti di altri programmi. Il manuale spiega come scrivere i "makefile", che specificano come un programma va compilato ed il modo in cui i suoi file dipendono tra di loro. E' compreso un capitolo introduttivo per gli utenti inesperti ed una sezione sulla generazione automatica delle dipendenze.
Il Bison Manual (Edizione del Novembre 1999 per la Versione 1.29) spiega come scrivere grammatiche non contestuali per il programma Bison che le converte in analizzatori scritti in codice C. Non è necessaria alcuna nozione preliminare sulla generazione di analizzatori.
Il manuale di Flex (Edizione 1.03 per la Versione 2.3.7) spiega come scrivere gli elementi di definizione di un analizzatore lessicale per il programma flex, in modo da crearne uno scritto in C++ o C che riconosca gli schemi definiti. Non è necessaria alcuna conoscenza preliminare sugli analizzatori.
GAWK: The GNU Awk User's Guide (Edizione 2 per la Versione 3 di GAWK) spiega come usare GAWK. E' scritto per chi non ha mai usato awk e descrive le caratteristiche di questo potente linguaggio di manipolazione di stringhe e record.
Texinfo: the GNU Documentation Format (per la Versione 4) descrive il linguaggio di markup che serve a redigere la nostra documentazione in linea (Info) e le copie tipografighe. Spiega come costruire tabelle, liste, capitoli, note, indici e riferimenti incrociati; spiega anche come individuare gli errori.
Il Termcap Manual (3ª Edizione, rivista, per la Versione 1.3) è conosciuto come "Il doppio di quello che si sia mai voluto sapere su termcap". Questo manuale si occupa in dettaglio del formato del database di termcap, della definizione delle capacità dei terminali e del processo di interrogazione di una descrizione di terminale. Questo testo è essenzialmente diretto ai programmatori.

Codici ISBN dei libri GNU disponibili

Qui elenchiamo i numeri ISBN (Numeri Standard Internazionali) dei Libri per i manuali GNU che sono attualmente disponibili, pubblicati dalla FSF.

Facciamo presente che molte delle edizioni non più in stampa sono ottenibili tramite la FSF, alcune in perfette condizioni e cellofanate, altre attraverso le librerie.

GNU Software for MS-Windows and MS-DOS (libro/cdrom): ISBN: 1-882114 57 4
GNU Emacs Manual, per la Versione 20.7: ISBN: 1-882114 07 8
GNU Emacs Lisp Reference Manual, per la Versione 21 di Emacs: ISBN: 1-882114 73 6
Programming in Emacs Lisp: An Introduction: ISBN: 1-882114-42-6
Using and Porting GNU CC, per la Versione 2.95: ISBN: 1-882114-38-8
GNU C Library Reference Manual, per le Versioni 2.x (2 volumi): ISBN: 1-882114-54-X
Debugging with GDB: The GNU Source-Level Debugger, per la Versione 5: ISBN: 1-882114 77 9
GNU Make: A Program for Directing Recompilation, per la Versione 3.79: ISBN: 1-882114 81 7
Bison Manual: Using the YACC-compatible Parser Generator, per la Versione 1.29: ISBN: 1-882114 44 2
Flex: The Lexical Scanner Generator, per la Versione 2.3.7: ISBN: 1-882114 21 3
GAWK: The GNU Awk User's Guide, 2ª Edizione: ISBN: 1-882114 27 2
Texinfo: The GNU Documentation Format, per la Versione 4: ISBN: 1-882114 67 1
The Termcap Manual: The Termcap Library and Data Base, 3ª Edizione: ISBN: 1-882114 87 6

Libri non-GNU

Ci occupiamo di una pagina che elenca libri di documentazione libera non pubblicati dalla FSF.

Ritorna alla pagina principale di GNU.

Per informazioni e domande sulla FSF e GNU rivolgersi, possibilmente in inglese, a gnu@gnu.org. Altri modi per contattare la FSF.

Commenti su queste pagine web a webmasters@gnu.org, altre domande a gnu@gnu.org.

La copia letterale e la distribuzione di questo articolo nella sua integrità sono permesse con qualsiasi mezzo, a condizione che questa nota sia riprodotta.

Aggiornato: $Date: 2006/06/13 18:26:48 $ $Author: puigpe $