Commit 78c4ba57 authored by Elena Grandi's avatar Elena Grandi
Browse files

Improvements to the package building docs

parent f2bf72cb
......@@ -84,7 +84,7 @@ quanto segue a ``~/.ssh/config``::
2048 MD5:bd:88:bd:5f:bc:52:03:0b:88:d9:0c:2b:86:59:dc:92 root@isolda (RSA)
Cowbuilder
''''''''''
^^^^^^^^^^
.. note::
cowbuilder e pbuilder sono degli strumenti per gestire delle chroot
......@@ -240,6 +240,30 @@ Il programma ``dch``, permette di automatizzare l'editing del file
con ``unstable`` nella prima riga; questo si può fare anche con il
comando ``dch -r``.
Verifica dello stato del repository e push
------------------------------------------
Prima di effettuare la build, accertarsi di aver committato tutte le
modifiche effettuate, di non avere file spuri e di essere sul branch
corretto (``master`` o ``fuss/master`` a seconda dell'età del progetto),
ad esempio con il comando::
$ git status
Committare quindi eventuali modifiche rimanenti, indicando se possibile
nel commit log il numero di ticket associato alla modifica, con la
dicitura "refs #NUMERO"::
$ git add -p <file modificati>
$ git add <file aggiunti>
$ git commit -m "<modifiche effettuate>. refs #NumeroTicket"
Inoltre o subito prima o subito dopo la build, ma prima dell'upload, è
importante pushare tali commit, in modo da essere sicuri che nel
frattempo non avvengano conflitti con commit altrui::
$ git push
Build
-----
......@@ -300,20 +324,25 @@ Per installare le dipendenze mancanti si può usare il comando::
Un altro comando utile è ``dpkg -c <nomefile>.deb`` per verificare i
file presenti nel pacchetto.
Commit e push
-------------
lintian
^^^^^^^
Eseguire il commit su git di tutte le modifiche apportate, indicando se
possibile nel commit log il numero di ticket associato alla modifica,
con la dicitura "refs #NUMERO".
Uno strumento di diagnostica molto dettagliato è ``lintian``, che
analizza i pacchetti generati alla ricerca di problemi di vario tipo e
si lancia con::
Un metodo veloce è eseguire::
lintian --pedantic -Iiv <pacchetto>.changes
$ git commit -a -m "<modifiche effettuate>. refs #NumeroTicket"
Un limite di questo strumento è che è basato sugli standard di Debian e
in alcuni casi gli errori potrebbero essere falsi positivi per gli
standard fuss.
e successivamente eseguire il push con::
In particolare si possono ignorare i seguenti tag.
$ git push
* ``changelog-should-mention-nmu``
* ``source-nmu-has-incorrect-version-number``
ed altri che verranno successivamente aggiunti a questo elenco.
Upload
------
......
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