.\" dpkg manual page - dpkg-parsechangelog(1) .\" .\" Copyright © 1995-1996 Ian Jackson .\" Copyright © 2000 Wichert Akkerman .\" Copyright © 2006, 2012 Guillem Jover .\" Copyright © 2007-2008 Frank Lichtenheld .\" Copyright © 2009 Raphaël Hertzog .\" .\" This is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program. If not, see . . .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH dpkg\-parsechangelog 1 "4 maggio 2012" "Progetto Debian" "utilità dpkg" .SH NOME dpkg\-parsechangelog \- analizza i file changelog Debian . .SH SINTASSI \fBdpkg\-parsechangelog\fP [\fIopzione\fP...] . .SH DESCRIZIONE \fBdpkg\-parsechangelog\fP legge e analizza il registro delle modifiche di un albero sorgente Debian non pacchettizzato e produce in output le informazioni che contiene in una forma leggibile da macchina. . .SH OPZIONI .TP \fB\-l\fP\fIfile\-changelog\fP Specifica il file changelog da cui leggere le informazioni. Il valore predefinito è \fBdebian/changelog\fP. .TP \fB\-F\fP\fIformato\-changelog\fP Specifica il formato del file changelog. In modo predefinito, il formato viene letto da una riga speciale vicino alla fine del file changelog o, se ciò non ha successo, viene usato in modo predefinito il formato \fIdebian\fP standard. Vedere anche \fBFORMATO DEI CHANGELOG\fP. .TP \fB\-L\fP\fIlibdir\fP Specifica una directory aggiuntiva in cui cercare script di analisi. La ricerca viene fatta in questa directory prima che nelle directory predefinite che attualmente sono \fB/usr/local/lib/dpkg/parsechangelog\fP e \fB/usr/lib/dpkg/parsechangelog\fP. .TP \fB\-?\fP, \fB\-\-help\fP Mostra il messaggio sull'uso ed esce. .TP \fB\-\-version\fP Mostra la versione ed esce. .SS "Opzioni di analisi" Le seguenti opzioni possono essere usate per influenzare l'output dell'analizzatore di file changelog, ad esempio l'intervallo di voci o il formato di output. È necessario che siano supportate dallo script di analisi in questione. Vedere anche \fBAVVERTIMENTI\fP. .TP \fB\-\-format\fP\fI formato\-di\-output\fP Imposta il formato di output. I valori attualmente supportati sono \fIdpkg\fP e \fIrfc822\fP. \fIdpkg\fP è il formato di output classico (che esisteva prima di questa opzione) e quello predefinito. Consiste di un paragrafo nel formato di controllo di Debian (vedere \fBdeb\-control\fP(5)). Se è richiesta più di una voce, allora la maggior parte dei campi è presa dalla voce più recente, tranne quando diversamente specificato: .RS .TP \fBSource:\fP\fI nome\-pacchetto\fP .TP \fBVersion:\fP\fI versione\fP .TP \fBDistribution:\fP\fI distribuzione\-target\fP .TP \fBUrgency:\fP\fI urgenza\fP Viene utilizzata l'urgenza più elevata tra tutte le voci incluse, seguita dai commenti concatenati (separati da spazi) da tutte le versioni richieste. .TP \fBMaintainer:\fP\fI autore\fP .TP \fBDate:\fP\fI data\fP .TP \fBCloses:\fP\fI numero\-bug\fP Vengono uniti tutti i campi Closes di tutte le voci incluse. .TP \fBChanges:\fP\fI voci\-changelog\fP Viene concatenato il testo di tutte le voci del registro dei cambiamenti. Per far sì che questo campo sia un campo multiriga in un formato di controllo Debian valido, le righe vuote vengono sostituite da un punto e tutte le righe vengono fatte rientrare di uno spazio. Il contenuto esatto dipende dal formato del changelog. .RE .IP I campi \fBVersion\fP, \fBDistribution\fP, \fBUrgency\fP, \fBMaintainer\fP e \fBChanges\fP sono obbligatori. .IP Potrebbero essere presenti campi aggiuntivi definiti dall'utente. .IP Il formato \fBrfc822\fP usa gli stessi campi ma produce in output un paragrafo separato per ciascuna voce nel changelog, in modo che vengano preservati tutti i metadati di ciascuna voce. .TP \fB\-\-since\fP \fIversione\fP, \fB\-s\fP\fIversione\fP,\fB \-v\fP\fIversione\fP include tutte le modifiche successive a \fIversione\fP. .TP \fB\-\-until\fP \fIversione\fP, \fB\-u\fP\fIversione\fP include tutte le modifiche precedenti a \fIversione\fP. .TP \fB\-\-from\fP \fIversione\fP, \fB\-f\fP\fIversione\fP include tutte le modifiche nella versione \fIversione\fP e successive. .TP \fB\-\-to\fP \fIversione\fP, \fB\-t\fP\fIversione\fP include tutte le modifiche nella versione \fIversione\fP e precedenti. .TP \fB\-\-count\fP \fInumero\fP, \fB\-c\fP\fInumero\fP, \fB\-n\fP\fInumero\fP include \fInumero\fP voci a partire dall'inizio (o dalla fine se \fInumero\fP è minore di 0). .TP \fB\-\-offset\fP \fInumero\fP, \fB\-o\fP\fInumero\fP cambia il punto di inizio per \-\-count, contato a partire dall'inizio (o dalla fine se \fInumero\fP è minore di 0). .TP \fB\-\-all\fP include tutte le modifiche. Nota: quando viene usata questa opzione, le altre non hanno effetto. . .SH "FORMATO DEI CHANGELOG" È possibile usare un formato diverso da quello predefinito, fornendo un analizzatore per tale formato alternativo. Per far sì che \fBdpkg\-parsechangelog\fP possa eseguire un nuovo analizzatore, tra le ultime 40 righe del file di changelog deve essere inclusa una riga che corrisponde alla espressione regolare Perl \(lq\fB\eschangelog\-format:\es+([0\-9a\-z]+)\eW\fP\(rq. La parte tra parentesi deve essere il nome del formato. Per esempio: @@@ changelog\-format: \fIaltroformato\fP @@@ I nomi dei formati dei changelog sono stringhe non vuote di caratteri alfanumerici. Se è presente una riga di questo tipo, allora \fBdpkg\-parsechangelog\fP cercherà un analizzatore chiamato \fB/usr/lib/dpkg/parsechangelog/\fP\fIaltroformato\fP or \fB/usr/local/lib/dpkg/parsechangelog/\fP\fIaltroformato\fP; se non è presente o non è un programma eseguibile si genera un errore. Il formato predefinito per i changelog è \fBdebian\fP e un analizzatore per esso viene fornito in modo predefinito. L'analizzatore verrà invocato con il changelog aperto sullo standard input all'inizio del file. Dovrebbe leggere il file (può scorrerlo se serve) per determinare le informazioni richieste e restituire le informazioni analizzate sullo standard output nel formato specificato dall'opzione \fB\-\-format\fP. Dovrebbe accettare tutte le \fBOpzioni di analisi\fP. Se il formato di changelog che è attualmente analizzato lascia sempre o quasi sempre una riga vuota tra le singole annotazioni delle modifiche, queste righe vuote dovrebbero essere eliminate, in modo da rendere l'output risultante più compatto. Se il formato di changelog non contiene informazioni sulla data o sul nome del pacchetto, questa informazione dovrebbe essere omessa dall'output. L'analizzatore non dovrebbe cercare di crearla o trovarla a partire da altre fonti. Se il changelog non ha il formato atteso, l'analizzatore dovrebbe terminare con uno stato di uscita diverso da zero, piuttosto che cercare di arrangiarsi in qualche modo ed eventualmente generare output non corretto. Un analizzatore di changelog non può interagire in nessun caso con l'utente. . .SH AVVERTIMENTI Tutte le \fBOpzioni di analisi\fP tranne \-v sono gestite solamente in \fBdpkg\fP, versione 1.14.16 e successive. Gli analizzatori di terze parti per i formati di changelog diversi da \fIdebian\fP possono non supportare tutte le opzioni. . .SH FILE .TP \fBdebian/changelog\fP Il file changelog, utilizzato per ottenere le informazioni sul pacchetto sorgente dipendenti dalla versione, come l'urgenza e la distribuzione di un caricamento, i cambiamenti fatti a partire da un particolare rilascio e la versione stessa dei sorgenti.