Commit 096a3a7b authored by Elena Grandi's avatar Elena Grandi
Browse files

Improve explanations on how to manage version numbers

parent 214b5af8
......@@ -108,29 +108,51 @@ Versionamento
-------------
Per poter pubblicare il pacchetto, è necessario incrementare il numero
di versione.
di versione nel file ``debian/changelog``.
Le guide di sviluppo degli specifici pacchetti danno indicazioni sulla
policy di versionamento, ma nella maggior parte dei casi sarà da
incrementare il patch level (es. da 9.0.5-1 a 9.0.6-1).
.. note:: Nei pacchetti contenenti programmi in python è generalmente
necessario mantenere aggiornato il numero di versione anche in
``setup.py``; come per debsrc sopra questo dovrebbe essere citato nel
README dei pacchetti.
Il programma ``dch``, permette di automatizzare l'editing del file
``debian/changelog`` che contiene la versione del pacchetto.
* Eseguire il comando ``dch -i`` che aprirà, tramite l'editor di
default, il changelog, dove verrà inserita automaticamente una nuova
entry con il numero di versione aumentato di 1.
Nel caso non si sia tra elencati tra i Maintainer e Uploaders in
``debian/control`` verrà impostato un numero di versione con ``+nmu``
(Non Maintainer Upload); correggerlo per incrementare normalmente ed
eliminare la riga relativa dall'elenco delle modifiche.
* Quando si iniziano a fare modifiche usare il comando ``dch -v
<nuova_versione>`` per creare una nuova stanza ed aprire il changelog
nell'editor di default.
* Modificare ``UNRELEASED`` con ``unstable`` nella prima riga; questo si
può fare anche con il comando ``dch -r``.
Verrà impostato il numero di versione richiesto e la release speciale
``UNRELEASED`` che indica che le modifiche sono ancora in lavorazione.
* Descrivere la modifica effettuata, possibilmente indicando il ticket
di riferimento da cui nasce la richiesta di modifica
Si può anche usare ``dch`` senza opzioni: in questo modo se l'ultima
stanza risulta ``UNRELEASED`` il file verrà aperto così com'è, mentre
se l'ultima stanza riporta una release come ``unstable`` ne viene
creata una nuova incrementando il numero di versione.
.. note:: Nei pacchetti contenenti programmi in python è generalmente
necessario mantenere aggiornato il numero di versione anche in
``setup.py``; come per debsrc sopra questo dovrebbe essere citato nel
README dei pacchetti.
Attenzione che in quest'ultimo caso dch potrebbe non essere in grado
di indovinare la versione corretta: verificare e nel caso correggere.
Inoltre, nel caso in cui non si sia elencati tra i Maintainer e
Uploaders in ``debian/control`` verrà aggiunta una riga ``Non
Maintainer Upload`` che per noi non è rilevante e va tolta.
Nel caso in cui più persone facciano modifiche, dch provvederà a
suddividerle in sezioni intestate con il nome della persona che ha
effettuato la modifica.
* Descrivere le modifiche effettuate, possibilmente indicando i ticket
di riferimento da cui nascono le richieste di modifica.
* Man mano che si fanno modifiche, descriverle se necessario nel
changelog, usando ``dch`` senza opzioni, come descritto sopra.
* Quando si è pronti a pubblicare il pacchetto, modificare ``UNRELEASED``
con ``unstable`` nella prima riga; questo si può fare anche con il
comando ``dch -r``.
Build
-----
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment