Documentazione

Queste risorse, sebbene diffusamente incomplete, dovrebbero guidarvi attraverso la comprensione di PDF Clown. Saranno aggiornate quanto regolarmente possibile: contributi contenutistici (commenti e domande, tutorials, esempi originali, etc.) sono caldamente benvenuti (non siate timidi!).

Guida utente

PDF Clown Project 0.0.7 User Guide

Note

I contenuti di questa guida sono attualmente incompleti, da migliorare in seguito (scusate!).

API

PDF Clown Project 0.0 API (hosted on SourceForge.net).

Riferimenti

Numerazione di versione

Note

I prodotti Open Source e specialmente Software Libero, vista la loro più marcata inclinazione tecnica rispetto al software proprietario, hanno tipicamente uno stile più rigoroso nel marcare i loro rilasci: la numerazione di versione non è uno specchietto commerciale per allodole, quindi non dovreste attendervi numeri in rapida crescita (versione 1.0, 2.0, 3.0... 10.0...). Considerate le funzionalità, NON il numero di versione!

La numerazione di versione dei rilasci di PDF Clown segue lascamente la convenzione attualmente adottata dal progetto Linux kernel: il numero di versione consiste di quattro numeri (sintassi XSBNF: { A '.' B '.' C { '.' D}? }, ad esempio 0.0.1 oppure 0.0.3.2):

  • il numero A denota la versione principale. Viene cambiato solo quando avvengono variazioni concettuali importanti;
  • il numero B denota la revisione principale. Viene cambiato quando rilevanti nuove funzionalità sono introdotte per implementare un passaggio previsto dal Percorso di sviluppo. Perciò un ciclo di rilascio tipicamente ruota attorno alla medesima revisione principale;
  • il numero C denota la revisione minore. Viene cambiato quando nuove funzionalità (ed eventualmente correzioni) sono introdotte per implementare incrementalmente porzioni della medesima revisione principale;
  • il numero D denota un rilascio di sola correzione che affronta difetti rilevanti tali da richiedere correzione immediata.

Come sopra notato, un ciclo di rilascio è pianificato da un passaggio di Percorso di sviluppo e denotato da una revisione principale. Entro la medesima revisione principale esistono due distribuzioni, corrispondenti a distinti pacchetti (package) presenti nel File Release System di SourceForge.net:

  • la distribuzione Stable (PDFClown-stable package): questo è il rilascio di produzione di PDF Clown, quello che raccomandiamo tipicamente di usare. Attualmente, non è stata ancora rilasciata alcuna distribuzione Stable di PDF Clown, poiché lo sviluppo è ancora in corso;
  • la distribuzione Development (PDFClown-devel package): questo è il rilascio instabile di PDF Clown, l'istantanea del lavoro in corso, utile per afferrare le ultimissime novità, ma senza qualsivoglia garanzia che la sua struttura sia preservata attraverso i successivi rilasci. Attualmente, tutti i rilasci di PDF Clown sono apparsi in questa distribuzione.

Un ciclo di rilascio è composto da due fasi principali, mappate sulle summenzionate distribuzioni:

  1. la fase di sviluppo (corrispondente alla distribuzione Development);
  2. la fase di rilascio (ufficiale) (corrispondente alla distribuzione Stable).

I rilasci avvenuti durante la fase di sviluppo sono suffissati da termini convenzionali di pre-rilascio ("PreAlpha", "Alpha", "Beta", "RC" = Release Candidate), mentre i rilasci ufficiali sono suffissati dal termine "Stable".