dch - Online nel cloud

PROGRAMMA:

NOME

debchange - Strumento per la manutenzione del file debian/changelog in un pacchetto sorgente

SINOSSI

cambio di debito [Opzioni] [testo ...]
dc [Opzioni] [testo ...]

DESCRIZIONE

cambio di debito o il suo alias dc aggiungerà una nuova riga di commento al changelog di Debian nel
albero sorgente corrente. Questo comando deve essere eseguito dall'interno di quell'albero. Se il testo di
il cambiamento è dato sulla riga di comando, cambio di debito verrà eseguito in modalità batch e aggiungerà semplicemente il
testo, con interruzioni di riga se necessario, nella posizione appropriata in debian/log delle modifiche (O l'
log delle modifiche specificato dalle opzioni, come descritto di seguito). Se non viene specificato alcun testo, allora
cambio di debito eseguirà l'editor come determinato da editor-sensibile per poter modificare il file.
(Le variabili d'ambiente VISIVO ed EDITOR vengono utilizzati in questo ordine per determinare quale
editor da usare.) Editor che comprendono il +n opzione per avviare la modifica su a
la riga specificata utilizzerà questo per spostarsi sulla riga corretta del file per la modifica. Se la
l'editor viene chiuso senza modificare il file temporaneo, cambio di debito uscirà senza toccare
il changelog esistente. Note: che , il changelog is assunto a be codificati con , il UTF-8
codificante. If it is non, problemi può verificarsi. Si prega di consultare la iconv(1) pagina man per scoprirlo
come convertire i log delle modifiche da codifiche legacy. Infine, a changelog or NOTIZIE il file può essere
creato da zero utilizzando il --creare opzione descritta di seguito.

cambio di debito supporta anche la produzione automatica di voci del registro delle modifiche che chiudono i bug, utilizzando il
--chiude opzione. Questo di solito interroga il BTS, il Debian Bug Tracking System (vedi
https://bugs.debian.org/) to determine the title of the bug and the package in which it
si verifica. Questo comportamento può essere fermato dando a --noquery opzione o impostando il
variabile di configurazione DEBCHANGE_QUERY_BTS a no, come descritto sotto. In entrambi i casi, il
editor (come descritto sopra) sarà sempre invocato per dare l'opportunità di modificare il
voci e il log delle modifiche sarà accettato indipendentemente dal fatto che vengano apportate modifiche. Un
una voce aggiuntiva nel log delle modifiche può essere fornita sulla riga di comando in aggiunta alle voci di chiusura.

Al massimo uno di --aggiungere, --incremento, --modificare, --pubblicazionee --nuova versione può essere specificato
come elencato di seguito. Se non sono specificate opzioni, cambio di debito userà l'euristica per indovinare
se il pacchetto è stato rilasciato con successo o meno e comportati come se --incremento
era stato specificato se il pacco è stato rilasciato, o altrimenti come se --aggiungere è stata
specificato.

È possibile utilizzare due diversi insiemi di euristiche, controllate da --release-euristica
opzione o il DEBCHANGE_RELEASE_HEURISTIC variabile di configurazione. Il predefinito changelog
euristica presuppone che il pacchetto sia stato rilasciato a meno che il suo registro delle modifiche non contenga NON RILASCIATO
nel campo della distribuzione. Se questa euristica è abilitata, la distribuzione sarà predefinita
a NON RILASCIATO nelle nuove voci del log delle modifiche e il --maintrailer l'opzione descritta di seguito sarà
essere automaticamente abilitato. Questo può essere utile se un pacchetto può essere rilasciato da diversi
manutentori, o se non conservi i log di caricamento. Il supplente ceppo euristica determina
se un pacchetto è stato rilasciato cercando un'appropriata duplicare(1) o dput(1) registro
file nella directory principale. Verrà emesso un avviso se il file di registro viene trovato ma a
il caricamento riuscito non viene registrato. Ciò potrebbe essere dovuto al fatto che è stato eseguito il caricamento precedente
con una versione di duplicare prima della 2.1 o perché il caricamento non è riuscito.

Se uno dei due --incremento or --nuova versione viene utilizzato, il nome e l'e-mail per la nuova versione verranno
essere determinato come segue. Se la variabile d'ambiente DEBNOME COMPLETO è impostato, questo sarà
usato per il nome completo del manutentore; se no, allora NOME sarà verificato. Se l'ambiente
variabile DEBEMAIL è impostato, questo verrà utilizzato per l'indirizzo e-mail. Se questa variabile ha
la forma "nome ", allora anche il nome del manutentore verrà preso da qui se nessuno dei due
DEBNOME COMPLETO né NOME è impostato. Se questa variabile non è impostata, lo stesso test viene eseguito su
la variabile d'ambiente E-MAIL. Successivamente, se il nome completo non è stato ancora determinato,
quindi utilizzare getpwuid(3) per determinare il nome dal file di password. Se fallisce, usa il
voce precedente del log delle modifiche. Per l'indirizzo email, se non è stato impostato da DEBEMAIL or
E-MAIL, poi guarda dentro /etc/nomeposta, quindi prova a crearlo dal nome utente e dall'FQDN,
altrimenti usa l'indirizzo email nella voce del changelog precedente. In altre parole, è un
buona idea impostare DEBEMAIL ed DEBNOME COMPLETO quando si utilizza questo script.

È incluso il supporto per i log delle modifiche che registrano le modifiche da parte di più co-manutentori di a
pacchetto. Se una voce viene aggiunta alle voci della versione corrente e il manutentore è
diverso dal manutentore che è indicato come colui che ha eseguito le voci precedenti, quindi
le righe verranno aggiunte al registro delle modifiche per indicare quali manutentori hanno apportato quali modifiche.
Attualmente è supportato solo uno dei tanti stili di registrazione di queste informazioni,
in cui il nome del manutentore che ha apportato una serie di modifiche appare su una riga prima del
modifiche, tra parentesi quadre. Questo può essere attivato e disattivato utilizzando il
--[no]multimanutenzione opzione o il DEBCHANGE_MULTIMAINT opzione file di configurazione; il predefinito
è abilitarlo. Nota che se una voce è già stata contrassegnata in questo modo, allora questo
opzione sarà silenziosamente ignorata.

Se il nome della directory dell'albero dei sorgenti ha la forma pacchetto-versione, poi cambio di debito volere
prova anche a rinominarlo se il numero di versione (upstream) cambia. Questo può essere prevenuto
tramite la configurazione di ricerca --conserva riga di comando o opzione del file di configurazione come descritto di seguito.

If --force-cattiva-versione or --allow-versione-inferiore si usa, cambio di debito non si fermerà se
la nuova versione è inferiore a quella attuale. Questo è particolarmente utile mentre lo fai
backport.

elenco Nome verifica

In comune con molti altri script in devscript pacchetto, cambio di debito salirà il
albero di directory finché non trova a debian/log delle modifiche file. Come protezione contro i file randagi
causando potenziali problemi, esaminerà il nome della directory padre una volta trovata
, il debian/log delle modifiche file e controlla che il nome della directory corrisponda al pacchetto
nome. Il modo esatto in cui lo fa è controllato da due variabili del file di configurazione
DEVSCRIPTS_CHECK_DIRNAME_LEVEL ed DEVSCRIPTS_CHECK_DIRNAME_REGEX, e il loro corrispondente
opzioni della riga di comando --check-livello-dirname ed --check-dirname-regex.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL può assumere i seguenti valori:

0 Non controllare mai il nome della directory.

1 Controlla il nome della directory solo se abbiamo dovuto cambiare directory nella nostra ricerca per
debian/log delle modifiche. Questo è il comportamento predefinito.

2 Controlla sempre il nome della directory.

Il nome della directory viene verificato verificando se il nome della directory corrente (come determinato
by pwd(1)) corrisponde alla regex fornita dall'opzione del file di configurazione
DEVSCRIPTS_CHECK_DIRNAME_REGEX o dall'opzione della riga di comando --check-dirname-regex regex.
Qui regex è una regex Perl (vedi perla(3perl)), che sarà ancorato all'inizio
e la fine. Se regex contiene un '/', quindi deve corrispondere al percorso completo della directory. Se
no, allora deve corrispondere al nome completo della directory. Se regex contiene la stringa ´PACCHETTO',
questo sarà sostituito dal nome del pacchetto sorgente, come determinato dal changelog. Il
il valore predefinito per l'espressione regolare è: ´PACCHETTO(-.+)?', abbinando così i nomi delle directory come
PACCHETTO ed PACCHETTO-versione.

Il log delle modifiche predefinito da modificare è debian/log delle modifiche; tuttavia, questo può essere modificato usando
, il --log delle modifiche or --notizia opzioni o il CHANGELOG variabile d'ambiente, come descritto
qua sotto.

VERSIONI

--aggiungere, -a
Aggiungi una nuova voce del log delle modifiche alla fine delle voci della versione corrente.

--incremento, -i
Incrementa il componente finale del numero di rilascio di Debian o, se questo è un
pacchetto Debian nativo, il numero di versione. Su Ubuntu o Tanglu, anche questo
cambia il suffisso da buildX a ubuntu1/tanglu1. Utilizzo -R, --ricostruire per un no
modificare l'incremento di ricostruzione. Questo crea una nuova sezione all'inizio del
log delle modifiche con intestazioni e piè di pagina appropriati. Inoltre, se questa è una nuova versione di
un pacchetto Debian nativo, il nome della directory è cambiato per riflettere questo. Se
DEBCHANGE_RELEASE_HEURISTIC is changelog (predefinito) e la versione corrente è
NON RILASCIATO, questo cambierà solo la versione della stanza del changelog corrente.
Altrimenti, questo creerà una nuova stanza del log delle modifiche con la nuova versione.

--nuova versione versione, -v versione
Questo specifica il numero di versione (inclusa la parte di rilascio di Debian) in modo esplicito
e si comporta come il --incremento opzione sotto altri aspetti. Cambierà anche il
nome della directory se il numero della versione a monte è cambiato. Se
DEBCHANGE_RELEASE_HEURISTIC is changelog (predefinito) e la versione corrente è
NON RILASCIATO, questo cambierà solo la versione della stanza del changelog corrente.
Altrimenti, questo creerà una nuova stanza del log delle modifiche con la nuova versione.

--modificare, -e
Modifica il log delle modifiche in un editor.

--pubblicazione, -r
Finalizzare il registro delle modifiche per un rilascio. Aggiorna il timestamp del log delle modifiche. Se la
la distribuzione è impostata su NON RILASCIATO, cambialo nella distribuzione dalla precedente
voce del log delle modifiche (o un'altra distribuzione come specificato da --distribuzione). Se ci
non ci sono precedenti voci del log delle modifiche e non è stata una distribuzione esplicita
specificato, instabile verrà utilizzato.

--forza-salvataggio-al-rilascio
Quando --pubblicazione viene utilizzato, viene aperto un editor per consentire l'ispezione del changelog.
L'utente è tenuto a salvare il file per accettare il changelog modificato, altrimenti
l'originale verrà mantenuto (impostazione predefinita).

--nessun-salvataggio-forzato-al-rilascio
Non farlo. Si noti che potrebbe essere fornita una voce fittizia del registro delle modifiche per ottenere
lo stesso effetto - eg cambio di debito --pubblicazione "". La voce non verrà aggiunta al
changelog ma la sua presenza sopprimerà l'editor.

--creare
Questo creerà un nuovo debian/log delle modifiche file (o NOTIZIE se l' --notizia opzione è
Usato). Devi essere nella directory di primo livello per usare questo; nessun nome di directory
verrà effettuato il controllo. È possibile specificare il nome e la versione del pacchetto
usando il --pacchetto ed --nuova versione opzioni, determinate dal nome della directory
usando il --danomedir opzione o inserito manualmente nel generato changelog
file. Il nome del manutentore è determinato dall'ambiente, se possibile,
e la distribuzione è specificata usando il --distribuzione opzione o nel
generato changelog file.

--vuoto
Se usato in combinazione con --creare, sopprimere l'aggiunta automatica di an
"inizialmente rilasciare" voce del log delle modifiche (in modo che la successiva invocazione di cambio di debito aggiunge
la prima voce). Nota che questo causerà a dpkg-parsechangelog avviso sul
successiva invocazione a causa della mancanza di modifiche.

--pacchetto pacchetto
Questo specifica il nome del pacchetto da usare nel nuovo changelog; questo potrebbe essere solo
utilizzato in combinazione con il --creare, --incremento ed --nuova versione opzioni.

--nmu, -n
Incrementa il numero di rilascio di Debian per un caricamento senza manutentore aggiungendo
un ".1" a un numero di versione non NMU (a meno che il pacchetto non sia nativo Debian, in cui
Astuccio "+nmu1" viene aggiunto) o incrementando un numero di versione NMU e aggiungendo un NMU
commento sul registro delle modifiche. Questo accade automaticamente se il confezionatore non è né nel
Manutentore né l' Caricatori campo in debian / control, salvo che DEBCHANGE_AUTO_NMU is
impostato no oppure --no-auto-nmu viene utilizzata l'opzione.

--bin-nmu
Incrementare il numero di rilascio di Debian per un caricamento binario non-maintainer di uno dei due
aggiungendo un "+b1" a un numero di versione non binNMU o incrementando un binNMU
numero di versione e aggiungi un commento al log delle modifiche binNMU.

--qa, -q
Incrementa il numero di rilascio di Debian per un caricamento del team QA Debian e aggiungi a QA
caricare commento sul registro delle modifiche.

--ricostruire, -R
Incrementa il numero di rilascio di Debian per una ricostruzione senza modifiche aggiungendo "build1"
o incrementando un numero di versione di ricostruzione.

--sicurezza, -s
Incrementa il numero di rilascio di Debian per un Debian Security Team non manutentore
carica e aggiungi un Sicurezza Team caricare commento sul registro delle modifiche.

--squadra Incrementa il numero di rilascio di Debian per un caricamento di squadra e aggiungi a Team caricare
commento sul registro delle modifiche.

--a monte, -U
Non aggiungere nome-distro1 alla versione su una distribuzione derivata. Incrementa il
versione Debian.

--bpo Incrementa il numero di rilascio di Debian per un caricamento su jessie-backports e aggiungi a
commento del log delle modifiche al caricamento del backport.

--Locale, -lsuffisso
Aggiungi un suffisso al numero di versione di Debian per una build locale.

--force-cattiva-versione, -b
Forza un numero di versione inferiore a quello corrente (ad esempio, durante il backport).

--allow-versione-inferiore modello
Consenti a un numero di versione di essere inferiore a quello attuale se la nuova versione corrisponde
il modello specificato.

--forza-distribuzione
Forza l'utilizzo della distribuzione fornita, anche se non corrisponde all'elenco di
distribuzioni note (ad es. per distribuzioni non ufficiali).

--auto-nmu
Tentativo di determinare automaticamente se una modifica al registro delle modifiche rappresenta un
Caricamento non manutentore. Questa è l'impostazione predefinita.

--no-auto-nmu
Disabilita il rilevamento automatico dell'NMU. Equivalente a impostazione DEBCHANGE_AUTO_NMU a no.

--danomedir, -d
Questo prenderà il numero di versione upstream dal nome della directory, che dovrebbe essere
del modulo pacchetto-versione. Se il numero della versione upstream è aumentato dal
voce del registro delle modifiche più recente, verrà inserita una nuova voce con il numero di versione
versione-1 (o versione se il pacchetto è nativo Debian), con la stessa epoca del
versione precedente del pacchetto. Se il numero della versione upstream è lo stesso, questa opzione
si comporterà allo stesso modo di -i.

--chiude nnnnn[,nnnnn ...]
Aggiungi voci del log delle modifiche per chiudere i numeri di bug specificati. Invoca anche l'editor
dopo aver aggiunto queste voci. Genererà avvisi se il BTS non può essere contattato
(E --noquery non è stato specificato), o se ci sono problemi con il bug
rapporto localizzato.

--[no]domanda
Dovremmo tentare di interrogare il BTS durante la generazione di voci di chiusura?

--conserva, -p
Conserva il nome della directory dell'albero di origine se il numero di versione upstream (o il
numero di versione di un pacchetto nativo Debian) cambia. Vedi anche la configurazione
sezione variabili di seguito.

--no-preservare, --nessuna conservazione
Non conservare il nome della directory dell'albero di origine (impostazione predefinita).

--venditore venditore
Sostituisci l'ID del distributore sul valore predefinito restituito da dpkg-vendor. Questo nome è
utilizzato per l'euristica applicata alle nuove versioni del pacchetto e per il controllo di integrità del
distribuzione di destinazione.

--distribuzione dist, -D dist
Usa la distribuzione specificata nella voce del log delle modifiche in corso di modifica, invece di
utilizzando la distribuzione della voce del registro delle modifiche precedente per le nuove voci o per l'esistente
valore per le voci esistenti.

--urgenza urgenza, -u urgenza
Usa l'urgenza specificata nella voce del log delle modifiche che stai modificando, invece di usare il
predefinito "medie" per le nuove voci o il valore esistente per le voci esistenti.

--log delle modifiche filetto, -c filetto
Questo modificherà il log delle modifiche filetto invece dello standard debian/log delle modifiche. Questo
l'opzione sovrascrive qualsiasi CHANGELOG impostazione variabile d'ambiente. Inoltre, nessuna directory
l'attraversamento o il controllo verranno eseguiti quando viene utilizzata questa opzione.

--notizia [file di notizie]
Questo modificherà file di notizie (per impostazione predefinita, debian/NOTIZIE) invece del normale registro delle modifiche.
Verrà eseguita la ricerca nella directory. Il changelog sarà esaminato al fine di
determinare la versione corrente del pacchetto.

--[no]multimanutenzione
Dovremmo indicare che parti di una voce del registro delle modifiche sono state fatte da diversi
manutentori? L'impostazione predefinita è sì; vedi la discussione sopra e anche il
DEBCHANGE_MULTIMAINT opzione del file di configurazione di seguito.

--[no]multimaint-merge
Se tutte le modifiche apportate dallo stesso autore devono essere unite nello stesso log delle modifiche
sezione? L'impostazione predefinita è no; vedi la discussione sopra e anche il
DEBCHANGE_MULTIMAINT_MERGE opzione del file di configurazione di seguito.

--manutenzione, -m
Non modificare i dettagli del mantenitore precedentemente elencati nel changelog. Questo è
utile in particolare per gli sponsor che desiderano aggiungere automaticamente un messaggio di sponsorizzazione
senza interrompere gli altri dettagli del changelog. Nota che potrebbe esserci qualcosa
interazioni interessanti se è in uso la modalità multi-manutentore; probabilmente desidererai
per controllare manualmente il log delle modifiche prima di caricarlo in questi casi.

--controllo, -M
Usa i dettagli del manutentore dal debian / control Manutentore campo piuttosto che
variabili ambientali rilevanti (DEBNOME COMPLETO, DEBEMAIL, eccetera.). Questa opzione potrebbe essere
utile per ripristinare i dettagli del manutentore principale nel trailer del log delle modifiche dopo a
modifica fasullo (ad esempio quando -m era previsto ma dimenticato) o quando si rilascia un pacchetto in
il nome del manutentore principale (es. il team).

--[no]maintrailer, -t
If maintrailer è impostato, eviterà di modificare la riga del trailer del log delle modifiche esistente
(cioè i dettagli del manutentore e del timbro della data), a meno che non venga utilizzato con opzioni che richiedono
il trailer da modificare (es --creare, --pubblicazione, -i, --qa, ecc.) Questa opzione
differisce dalla --manutenzione in quanto utilizzerà la modalità multi-manutentore se appropriato,
ad eccezione della modifica del trailer. Vedi anche il DEBCHANGE_MAINTTTRAILER
opzione del file di configurazione di seguito.

--check-livello-dirname N
Vedi la sezione sopra "elenco Nome verifica" per una spiegazione di questa opzione.

--check-dirname-regex regex
Vedi la sezione sopra "elenco Nome verifica" per una spiegazione di questa opzione.

--no-conf, --noconf
Non leggere alcun file di configurazione. Questo può essere usato solo come prima opzione
dato sulla riga di comando.

--release-euristica ceppo|changelog
Controlla come cambio di debito determina se un pacchetto è stato rilasciato, al momento di decidere
se creare una nuova voce del registro delle modifiche o aggiungere una voce del registro delle modifiche esistente.

--Aiuto, -h
Visualizza un messaggio di aiuto ed esci con successo.

--versione
Visualizza le informazioni sulla versione e sul copyright ed esci con successo.

CONFIGURAZIONE VARIABILI

I due file di configurazione /etc/devscripts.conf ed ~/.devscripts provengono da questo
per impostare le variabili di configurazione. Le opzioni della riga di comando possono essere utilizzate per sovrascrivere
impostazioni del file di configurazione. Le impostazioni delle variabili d'ambiente vengono ignorate per questo scopo.
Le variabili attualmente riconosciute sono:

DEBCHANGE_CONSERVA
Se è impostato su sì, allora è lo stesso di --conserva parametro della riga di comando
in uso.

DEBCHANGE_QUERY_BTS
Se è impostato su no, allora è lo stesso di --noquery parametro della riga di comando
in uso.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL, DEVSCRIPTS_CHECK_DIRNAME_REGEX
Vedi la sezione sopra "elenco Nome verifica"per una spiegazione di questi
variabili. Nota che queste sono variabili di configurazione a livello di pacchetto e lo faranno
quindi influenzare tutti devscript script che ne verificano il valore, come descritto in
le rispettive manpage e in devscripts.conf(5).

DEBCHANGE_RELEASE_HEURISTIC
Controlla come cambio di debito determina se un pacchetto è stato rilasciato, al momento di decidere
se creare una nuova voce del registro delle modifiche o aggiungere una voce del registro delle modifiche esistente.
Può essere sia ceppo or changelog.

DEBCHANGE_MULTIMAINT
Se impostato su no, cambio di debito non introdurrà distinzioni di più manutentori quando a
un manutentore diverso aggiunge una voce a un registro delle modifiche esistente. Vedi la discussione
sopra. L'impostazione predefinita è sì.

DEBCHANGE_MULTIMAINT_MERGE
Se impostato su sì, quando si aggiungono modifiche in modalità a più manutentori cambio di debito controllerò
se esistono modifiche precedenti da parte dell'attuale manutentore e aggiungi le nuove modifiche a
il blocco esistente anziché creare un nuovo blocco. L'impostazione predefinita è no.

DEBCHANGE_MAINTTTRAILER
Se è impostato su no, allora è lo stesso di --nomaintrailer riga di comando
parametro utilizzato.

DEBCHANGE_TZ
Usa questo fuso orario per le voci del log delle modifiche. L'impostazione predefinita è il fuso orario dell'utente/sistema come
mostrato da `quando -R` e influenzato dalla variabile d'ambiente TZ.

DEBCHANGE_LOWER_VERSION_PATTERN
Se questo è impostato, allora è lo stesso di --allow-versione-inferiore riga di comando
parametro utilizzato.

DEBCHANGE_AUTO_NMU
Se è impostato su no poi cambio di debito non tenterà di determinare automaticamente
se la stanza del log delle modifiche corrente rappresenta un NMU. L'impostazione predefinita è sì. Vedere
la discussione del --nmu opzione sopra.

DEBCHANGE_FORCE_SAVE_ON_RELEASE
Se è impostato su no, allora è lo stesso di --nessun-salvataggio-forzato-al-rilascio command
parametro di linea utilizzato.

DEBCHANGE_VENDOR
Usa questo fornitore invece di quello predefinito (output di dpkg-vendor). Vedere --venditore per
dettagli.

AMBIENTE

DEBEMAIL, E-MAIL, DEBNOME COMPLETO, NOME
Vedere la descrizione sopra dell'uso di queste variabili d'ambiente.

CHANGELOG
Questa variabile specifica il log delle modifiche da modificare al posto di debian/log delle modifiche. No
l'attraversamento o il controllo della directory viene eseguito quando questa variabile è impostata. Questo
la variabile è sovrascritta da --log delle modifiche impostazione della riga di comando.

VISIVO, EDITOR
Queste variabili d'ambiente (in questo ordine) determinano l'editor usato da sensato-
editore.

Usa dch online utilizzando i servizi onworks.net