A. Revisioni

L'elenco esatto delle successive revisioni è nel modulo manual nell'albero CVS; si può vedere anche http://sourceforge.net/cvs/?group_id=9028

Diario delle Revisioni
0.1	2 nov 2003	PV	Prima bozza pubblicata col titolo How to get and build the Firebird manual module.
0.2	31 gen 2004	PV	Spostati i sorgenti nel CVS.
1.0	8 mar 2004	PV	Prima versione ufficiale nel sito di Firebird.
1.1	26 feb 2005	PV	Le seguenti modifiche sono state fatte tra il marzo 2004 ed il febbraio 2005: Aggiunte note sui messaggi d'errore nella costruzione dei PDF. Aggiunte informazioni sulla costruzione dei sottoinsiemi e nelle varie lingue. Aggiunta nota per il post processing dei PDF. Modificato il titolo in Getting and building the Firebird manual module. Molti piccoli miglioramenti. Aggiunta la cronistoria delle revisioni ed numero di versione. Modificata la licenza d'uso in Public Documentation License.
1.1.1	8 apr 2005	PV	Aggiunti alcuni titoli abbreviati per scopi estetici. Il resto dei contenuti non cambia.
1.2	9 feb 2006	PV	Rimosso «Firebird» dal titolo della seconda sezione. Aggiunte informazioni su come recuperare le librerie, in quanto non fanno più parte del CVS. Create le sottosezioni per i parametri di "build"; aggiunte informazioni per costruire altri insiemi e per impostare i parametri nel file `build.xml`. Modificato docwritehowto `link` in `ulink`, poiché gli articoli d'ora in poi andranno in PDF diversi.
1.2.1	15 mag 2006	PV	Sostituiti `cvs.sf.net` (3x) e `cvs.sourceforge.net` (6x) con `firebird.cvs.sourceforge.net` per adattarsi alla nuova configurazione in SF. Aggiunti anche «in unica linea» sopra due esempi che ora vanno a capo nel PDF.
1.2.1-it	6 lug 2006	UM	Prima versione in italiano di Umberto Masotti.
1.3	17 lug 2006	PV	Modificate tutte gli elementi `sectN` in elementi `section`. Abbreviato l'ID dell'Introduzione e assegnati gli ID a tutte le sezioni figlie. Correzioni nel testo inglese: RDMS -> RDBMS, parallell -> parallel, OS'es -> OSes, CD's -> CDs, wil -> will, envvar -> envar, linewrapped -> line-wrapped. Nella sezione Fare il SSH checkout con CVS a linea di comando, al terzo punto: convertito `<quote>` intorno a «username» in `<replaceable>`, e nell'esempio di comando la parola «username» è stata contornata da `<replaceable>`. Nella sezione Fare il SSH checkout con altri programmi client, alla descrizione di cvsroot la parola «username» evidenziata con `<replaceable>`. Alla nota nella sezione Generare i documenti HTML e PDF è stato aggiunto un titolo, e aggiunta una frase alla fine del secondo punto. Corretta la data della rev. 1.1.1 nella storia delle revisioni: 2004 -> 2005. Aggiunta una lunga sezione sul miglioramento dei PDF.
1.4	03 ago 2006	ND	Sono state aggiunte alcune avvertenze riguardo la gestione dei firewall e la porta 2401, ed inoltre come comportarsi nel caso in cui Sourceforge autonomamente decida di modificare la password d'accesso dell'utente.
1.4-it	24 ago 2006	UM	Seconda revisione in italiano, con le modifiche della 1.3 e della 1.4 di PV e di ND e piccoli ritocchi di linguaggio.
1.4.1	23 ago 2006	PV	Aggiunto un avviso per evitare di fare il check out su una copia preesistente.
1.5	29 apr 2007	PV	Oltre al modulo del manuale, c'è altra documentazione su Firebird? – Cambiato il secondo paragrafo e la lista con i link. Devo proprio ricostruire i manuali da solo? – Cambiato il primo paragrafo e tolti tutti i link seguenti. Da dove recuperare gli strumenti – Cambiato il testo nella sezione perchè ora si scarica tutto in `manual/lib` e `manual/tools`. Come impostare l'ambiente operativo per il processo di ricostruzione dei documenti – Modifiche nel secondo elemento in lista. Generare i documenti HTML e PDF – Nella nota finale, cambiato il testo e aggiunto il link nel secondo elemento in lista. Manuali parziali con `-Did` – Cambiato il paragrafo che comincia con «Come conoscere l'ID?» Costruire un diverso insieme con `-Dbase` – Aggiunto il riferimento all'insieme dei `papers`. Argomento avanzato: perfezionare i PDF – Aggiornati i paragrafi introduttivi, inclusa la lista dei difetti. Schema generale per la sistemazione – Aggiornato l'ultimo elemento in lista nella nota. Testate vedove – Modificato pesantemente, e aggiunto l'id; parte spostata in una nuova sottosezione Quando manca il DocBook ID. Spazi nei nomi di file, nelle URL, ecc. – Eliminato. Righe di tabella o di elementi in lista interrotti – Modificato il titolo, aggiunto l'id, modificati paragrafi «Problema» e «Causa». Spazi orrizontali enormemente larghi – Aggiunto l'id. Inserire spazi di dimensione zero – Aggiunto l'id, rifatti completamente i primi due elementi in lista e rimosso il terzo. Contenuti di pagina compressi, troncati o scombussolati in un qualche altro modo – Aggiunto. Riferimenti su XSL-FO – Cambiata la versione FOP nell'ultimo paragrafo. License noticeLicenza d'uso – (C) 2003–2006 -> 2003–2007.
1.5-it	9 mag 2007	UM	Terza revisione italiana, con le modifiche fino alla rev. 1.5 di PV. Messo il link alla versione italiana di Scrivere documenti per Firebird.
1.6	24 Oct 2009	PV	Fare il "check out" del modulo del manuale – Aggiunto un avviso per non mettere la copia locale in un percorso contenente spazi o altri caratteri suscettibili di «conversione» nelle URL. Messi gli avvisi in una lista, mettendo un titolo esplicito, e modificato il paragrafo precedente. Generare i documenti HTML e PDF – Aggiunto l'avviso a non utilizzare percorsi contenenti caratteri che possono cambiare a causa della codifica URL, e spiegato come aggirare il problema. Messi gli id alle cinque sottosezioni. Manuali parziali con `-Did`, Costruire un diverso insieme con `-Dbase`, Impostare valori di default in `build.xml` e Come viene ricostruito il PDF – Sostituito `-Drootid` con `-Did` e `-Dbasename` con `-Dbase` in tutte queste sezioni. Manuali parziali con `-Did` – Modificato il primo paragrafo. Costruire un diverso insieme con `-Dbase` – Modificato il paragrafo che inizia con «Nel frattempo...». Se qualcosa non va – Aggiunto un paragrafo sul problemi dei caratteri non sicuri nel percorso dei file perchè vengono codificati come URL. Quando manca il DocBook ID – Dato un id a questa sottosezione. Inserire spazi di dimensione zero – Cambiata la frase del secondo elemento in lista. Licenza d'uso – (C) 2003–2007 -> 2003–2009.
1.6.1	26 Oct 2009	PV	Generare i documenti HTML e PDF – Aggiustati gli ID di questa sezione e di cinque delle sue sottosezioni, che contenevano la parola «`buidling`» invece di «`building`»: `docbuildhowto-buidling-output-docs` `docbuildhowto-buidling-non-english` `docbuildhowto-buidling-subsets` `docbuildhowto-buidling-other-basesets` `docbuildhowto-buidling-defaults` `docbuildhowto-buidling-conclusion` Se qualcosa non va – Aggiustato il link a Generare i documenti HTML e PDF: `buidling` -> `building`. Nella stessa frase, le parole «alla fine di» sono state cambiate con «in», perchè la destinazione del link non è alla fine della sezione (è subito prima della prima sottosezione). Quando manca il DocBook ID – Rimosso i'attributo ID dall'elemento del titolo, perchè non è necessario e perchè era un duplicato dell'ID della sezione e pertanto non valido.
1.6.1-it	26 ott 2009	UM	Quarta revisione italiana, con le modifiche fino alla rev. 1.6.1 di PV.