From 2a52e8c56b71fa894c52ff93d6b98c39c00dc4e2 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Wed, 26 Aug 2009 17:23:58 +0200 Subject: [ Nicolas François ] * Cleaned up the first patch draft from KURASAWA Nozomu to finally get po4a support for translating the man pages. Many thanks to both for this excellent work! (Closes: #441608) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/makefile | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) (limited to 'doc/makefile') diff --git a/doc/makefile b/doc/makefile index 6ea1c1343..e12de7228 100644 --- a/doc/makefile +++ b/doc/makefile @@ -26,22 +26,27 @@ TARGET = binary include $(COPY_H) #.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr -doc: doc.fr doc.ja doc.pl doc.pt_BR doc.es +doc: po4a + for dir in $(SUBDIRS); do\ + $(MAKE) -C $$dir $@; \ + done -doc.fr: %.fr: - $(MAKE) -C fr $* +.PHONY: update-po po4a +update-po: + po4a --previous --no-backups --force --no-translations po4a.conf -doc.pt_BR: %.pt_BR: - $(MAKE) -C pt_BR $* +clean: po4a-clean clean-subdirs -doc.es: %.es: - $(MAKE) -C es $* +clean-subdirs: + for dir in $(SUBDIRS); do\ + $(MAKE) -C $$dir $@; \ + done -doc.ja: %.ja: - $(MAKE) -C ja $* +po4a-clean: + po4a --previous --rm-backups --rm-translations po4a.conf -doc.pl: %.pl: - $(MAKE) -C pl $* +po4a: + po4a --previous --no-backups po4a.conf ifdef DOXYGEN DOXYGEN_SOURCES = $(shell find $(BASE)/apt-pkg -not -name .\\\#* -and \( -name \*.cc -or -name \*.h \) ) -- cgit v1.2.3-70-g09d2 From b01390eaa5750f28f258308b546f398ea5d89e3c Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Thu, 27 Aug 2009 15:28:28 +0200 Subject: * buildlib/po4a_manpage.mak, doc/makefile, configure: - simplify the makefiles needed for po4a manpages Add a bit more autodetection to the buildsystem to be able to add only half translated languages (only a few man pages, not all) and try to reduce the overhead needed to add new languages. --- buildlib/defaults.mak | 1 + buildlib/environment.mak.in | 7 +++-- buildlib/po4a_manpage.mak | 54 ++++++++++++++++++++++++++++++++++ configure.in | 6 ++++ debian/changelog | 2 ++ doc/ja/makefile | 70 ++------------------------------------------- doc/makefile | 28 ++++++++++++------ 7 files changed, 91 insertions(+), 77 deletions(-) create mode 100644 buildlib/po4a_manpage.mak (limited to 'doc/makefile') diff --git a/buildlib/defaults.mak b/buildlib/defaults.mak index 8c57da05b..5373ee5cf 100644 --- a/buildlib/defaults.mak +++ b/buildlib/defaults.mak @@ -83,6 +83,7 @@ PYTHON_H = $(BASE)/buildlib/python.mak COPY_H = $(BASE)/buildlib/copy.mak YODL_MANPAGE_H = $(BASE)/buildlib/yodl_manpage.mak SGML_MANPAGE_H = $(BASE)/buildlib/sgml_manpage.mak +PO4A_MANPAGE_H = $(BASE)/buildlib/po4a_manpage.mak XML_MANPAGE_H = $(BASE)/buildlib/xml_manpage.mak FAIL_H = $(BASE)/buildlib/fail.mak PODOMAIN_H = $(BASE)/buildlib/podomain.mak diff --git a/buildlib/environment.mak.in b/buildlib/environment.mak.in index 4e47692f5..b3afca0ad 100644 --- a/buildlib/environment.mak.in +++ b/buildlib/environment.mak.in @@ -36,8 +36,11 @@ DOCBOOK2MAN := @DOCBOOK2MAN@ # XML for the man pages XMLTO := @XMLTO@ -# XML for the man pages -XMLTO := @XMLTO@ +# po4a for the man pages +XSLTPROC := @XSLTPROC@ + +# po4a for the man pages +PO4A := @PO4A@ # Gettext settings GMSGFMT = @GMSGFMT@ diff --git a/buildlib/po4a_manpage.mak b/buildlib/po4a_manpage.mak new file mode 100644 index 000000000..3ea4e2cb5 --- /dev/null +++ b/buildlib/po4a_manpage.mak @@ -0,0 +1,54 @@ +# -*- make -*- + +# This handles man pages with po4a. We convert to the respective +# output in the source directory then copy over to the final dest. This +# means po4a is only needed if compiling from bzr + +# Input +# $(LC) - The language code of the translation + +# See defaults.mak for information about LOCAL + +# generate a list of accepted man page translations +SOURCE = $(patsubst %.xml,%,$(wildcard *.$(LC).?.xml)) +INCLUDES = apt.ent + +# Do not use XMLTO, build the manpages directly with XSLTPROC +ifdef XSLTPROC + +STYLESHEET=./style.$(LC).xsl + +LOCAL := po4a-manpage-$(firstword $(SOURCE)) +$(LOCAL)-LIST := $(SOURCE) + +# Install generation hooks +doc: $($(LOCAL)-LIST) +veryclean: veryclean/$(LOCAL) + +$($(LOCAL)-LIST) :: % : %.xml $(INCLUDES) + echo Creating man page $@ + $(XSLTPROC) -o $@ $(STYLESHEET) $< # why xsltproc doesn't respect the -o flag here??? + mv -f $(subst .$(LC),,$@) $@ + +# Clean rule +.PHONY: veryclean/$(LOCAL) +veryclean/$(LOCAL): + -rm -rf $($(@F)-LIST) apt.ent apt.$(LC).8 \ + $(addsuffix .xml,$($(@F)-LIST)) + +HAVE_PO4A=yes +endif + +# take care of the rest +SOURCE := $(SOURCE) apt.$(LC).8 +INCLUDES := + +ifndef HAVE_PO4A +# Strip from the source list any man pages we dont have compiled already +SOURCE := $(wildcard $(SOURCE)) +endif + +# Chain to the manpage rule +ifneq ($(words $(SOURCE)),0) +include $(MANPAGE_H) +endif diff --git a/configure.in b/configure.in index 0dd1beb1a..eb3ec0426 100644 --- a/configure.in +++ b/configure.in @@ -190,6 +190,12 @@ AC_PATH_PROG(DOCBOOK2MAN,docbook2man) dnl Check for the XML tools needed to build man pages AC_PATH_PROG(XMLTO,xmlto) +dnl Check for the XSLTProc tool needed to build man pages together with po4a +AC_PATH_PROG(XSLTPROC,xsltproc) + +dnl Check for the po4a tool needed to build man pages +AC_PATH_PROG(PO4A,po4a) + dnl Check for graphviz AC_CHECK_PROG([HAVE_DOT], [dot], [YES], [NO]) AC_PATH_PROG([DOT], [dot], []) diff --git a/debian/changelog b/debian/changelog index f978eb367..c3f9881ac 100644 --- a/debian/changelog +++ b/debian/changelog @@ -39,6 +39,8 @@ apt (0.7.22.3) unstable; urgency=low * doc/Doxyfile.in: - update file with doxygen 1.6.1 (current unstable) - activate DOT_MULTI_TARGETS, it is default on since doxygen 1.5.9 + * buildlib/po4a_manpage.mak, doc/makefile, configure: + - simplify the makefiles needed for po4a manpages [ George Danchev ] * cmdline/apt-cache.cc: diff --git a/doc/ja/makefile b/doc/ja/makefile index da566cc96..f44bb1c0f 100644 --- a/doc/ja/makefile +++ b/doc/ja/makefile @@ -5,71 +5,7 @@ SUBDIR=doc/ja # Bring in the default rules include ../../buildlib/defaults.mak -# Do not use XMLTO, build the manpages directly with XSLTPROC -XSLTPROC=/usr/bin/xsltproc -STYLESHEET=./style.ja.xsl - - -# Man pages -SOURCE = apt-cache.ja.8 apt-get.ja.8 apt-cdrom.ja.8 apt.conf.ja.5 \ - sources.list.ja.5 apt-config.ja.8 apt-sortpkgs.ja.1 \ - apt-ftparchive.ja.1 apt_preferences.ja.5 apt-extracttemplates.ja.1 \ - apt-key.ja.8 apt-secure.ja.8 apt-mark.ja.8 - -INCLUDES = apt.ent - -doc: $(SOURCE) - -clean: clean-manpages - -clean-manpages: - rm -f $(SOURCE) \ - $(patsubst %.ja.1,%.1,$(SOURCE)) \ - $(patsubst %.ja.5,%.5,$(SOURCE)) \ - $(patsubst %.ja.8,%.8,$(SOURCE)) - -$(SOURCE) :: % : %.xml $(INCLUDES) - echo Creating man page $@ - $(XSLTPROC) -o $@ $(STYLESHEET) $< - -apt-cache.ja.8:: apt-cache.8 - cp $< $@ - -apt-get.ja.8:: apt-get.8 - cp $< $@ - -apt-cdrom.ja.8:: apt-cdrom.8 - cp $< $@ - -apt.conf.ja.5:: apt.conf.5 - cp $< $@ - -apt-config.ja.8:: apt-config.8 - cp $< $@ - -sources.list.ja.5:: sources.list.5 - cp $< $@ - -apt-sortpkgs.ja.1:: apt-sortpkgs.1 - cp $< $@ - -apt-ftparchive.ja.1:: apt-ftparchive.1 - cp $< $@ - -apt_preferences.ja.5:: apt_preferences.5 - cp $< $@ - -apt-extracttemplates.ja.1:: apt-extracttemplates.1 - cp $< $@ - -apt-key.ja.8:: apt-key.8 - cp $< $@ - -apt-secure.ja.8:: apt-secure.8 - cp $< $@ - -apt-mark.ja.8:: apt-mark.8 - cp $< $@ - - +# Language Code of this translation +LC=ja +include $(PO4A_MANPAGE_H) diff --git a/doc/makefile b/doc/makefile index e12de7228..2a2663fb3 100644 --- a/doc/makefile +++ b/doc/makefile @@ -1,7 +1,7 @@ # -*- make -*- BASE=.. SUBDIR=doc -SUBDIRS= fr ja pl pt_BR es +SUBDIRS= $(dir $(wildcard */makefile)) # Bring in the default rules include ../buildlib/defaults.mak @@ -26,27 +26,39 @@ TARGET = binary include $(COPY_H) #.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr -doc: po4a +doc: for dir in $(SUBDIRS); do\ $(MAKE) -C $$dir $@; \ done -.PHONY: update-po po4a -update-po: - po4a --previous --no-backups --force --no-translations po4a.conf - -clean: po4a-clean clean-subdirs +clean: clean-subdirs +veryclean: veryclean-subdirs clean-subdirs: for dir in $(SUBDIRS); do\ - $(MAKE) -C $$dir $@; \ + $(MAKE) -C $$dir clean; \ + done + +veryclean-subdirs: + for dir in $(SUBDIRS); do\ + $(MAKE) -C $$dir veryclean; \ done +ifdef PO4A +doc: po4a + +clean: po4a-clean + +.PHONY: update-po po4a +update-po: + po4a --previous --no-backups --force --no-translations po4a.conf + po4a-clean: po4a --previous --rm-backups --rm-translations po4a.conf po4a: po4a --previous --no-backups po4a.conf +endif ifdef DOXYGEN DOXYGEN_SOURCES = $(shell find $(BASE)/apt-pkg -not -name .\\\#* -and \( -name \*.cc -or -name \*.h \) ) -- cgit v1.2.3-70-g09d2 From 0e65be59ac218d9479d429ab6cf24e072fdb819b Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Wed, 30 Sep 2009 19:15:38 +0200 Subject: move the it translation of the guide to its own subdirectory for consitents and sake of the universe reasons --- doc/guide.it.sgml | 585 --------------------------------------------------- doc/it/guide.it.sgml | 585 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/it/makefile | 11 + doc/makefile | 2 +- 4 files changed, 597 insertions(+), 586 deletions(-) delete mode 100644 doc/guide.it.sgml create mode 100644 doc/it/guide.it.sgml create mode 100644 doc/it/makefile (limited to 'doc/makefile') diff --git a/doc/guide.it.sgml b/doc/guide.it.sgml deleted file mode 100644 index 2dc46e263..000000000 --- a/doc/guide.it.sgml +++ /dev/null @@ -1,585 +0,0 @@ - - - -Guida dell'utente di APT - -Jason Gunthorpe jgg@debian.org -Traduzione di Eugenia Franzoni eugenia@linuxcare.com - -$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $ - - -Guida per l'uso del gestore di pacchetti APT. - - - -Copyright © Jason Gunthorpe, 1998. - -

Ed. italiana Copyright © Eugenia Franzoni, 2000. - -

-"APT" e questo documento sono software libero, e li si pu ridistribuire -e/o modificare secondo i termini della Licenza Pubblica Generica GNU -(GPL), pubblicata dalla Free Software Foundation, nella versione 2 o -(se preferite) qualsiasi versione successiva. - -

"APT" and this document are free software; you can redistribute them and/or -modify them 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. - -

-Per ulteriori dettagli sui sistemi GNU/Linux si veda il testo -completo della licenza nel file -/usr/share/common-licenses/GPL. - - - - - - -Descrizione generale - -

-Il pacchetto APT al momento contiene due sezioni, il metodo APT -dselect e l'interfaccia utente a linea di comando apt-get; -entrambi danno modo di installare e rimuovere pacchetti, e di scaricarne -altri da Internet. - -Anatomia del sistema di pacchettizzazione -

-Il sistema di pacchettizzazione di Debian contiene un gran numero di -informazioni associate a ciascun pacchetto, per assicurarsi che si -integri facilmente ed in maniera pulita nel sistema; la pi -importante di esse il sistema di dipendenze. - -

-Il sistema di dipendenze permette ai singoli programmi di fare uso -degli elementi condivisi del sistema, quali le librerie; per -ridurre il numero di elementi che l'utente medio debba installare, -le porzioni di programmi che non vengono usate spesso vengono poste -in pacchetti separati. Inoltre, possibile avere pi di una scelta per -cose quali i programmi di posta elettronica, i server X e cos via. - -

-Il primo passo per capire il sistema di dipendenze la -comprensione del concetto di dipendenza semplice: un pacchetto richiede -che un altro sia installato insieme ad esso per poter -funzionare. - - -

-Ad esempio, mail-crypt un'estensione di emacs che aiuta a criptare le -mail con PGP. Se PGP non installato, mail-crypt inutile, quindi -mail-crypt ha una dipendenza semplice da PGP. Inoltre, dato che si tratta -di un'estensione di emacs, mail-crypt dipende anche da emacs, senza il -quale totalmente inutile. - -

-L'altro tipo di dipendenza importante da capire la dipendenza di -conflitto; con questa, un pacchetto che venga installato insieme ad un -altro pacchetto non funziona, e si hanno seri problemi al sistema. -Come esempio, si consideri un programma di trasporto della posta, -quale sendmail, exim o qmail: non possibile averne due contemporaneamente, -perch entrambi hanno bisogno di restare in ascolto sulla stessa porta di rete -per ricevere la posta. Tentare di installarne due danneggerebbe seriamente il -sistema, quindi ciascun programma di trasporto della posta ha una -dipendenza di conflitto con tutti gli altri. - -

-Come ulteriore complicazione, c' la possibilit che un pacchetto -voglia prendere il posto di un altro; ad esempio, exim e sendmail per molte -cose sono identici, dato che entrambi gestiscono la posta e comprendono -un'interfaccia comune, quindi il sistema di pacchettizzazione deve dichiarare -che sono entrambi agenti di trasporto della posta, e che gli altri -pacchetti a cui serve uno dei due devono dipendere da un pacchetto -fittizio agente-di-trasporto-della-posta. Quando si modificano -a mano i pacchetti, questo pu portare a moltissima confusione. - -

-In ciascun momento una singola dipendenza pu essere soddisfatta o meno -dai pacchetti gi installati; APT cerca di risolvere i problemi -di dipendenze con un buon numero di algoritmi automatici, che aiutano -a selezionare i pacchetti da installare. - - - - - - -apt-get - -

-apt-get fornisce un modo semplice di installare i pacchetti dalla -linea di comando. Diversamente da dpkg, apt-get non -capisce i nomi dei file .deb, ma utilizza il vero nome dei pacchetti, -e pu installare archivi .deb solo da una fonte. - -

-La prima Se state usando un proxy server http, dovete prima ancora -impostare la variabile d'ambiente http_proxy; vedere -sources.list(5). -cosa da fare prima di usare apt-get impostare l'elenco dei -pacchetti dalle fonti in modo che il programma sappia quali pacchetti -sono disponibili. Lo si fa con apt-get update. Ad esempio, - -

- -# apt-get update -Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages -Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages -Reading Package Lists... Done -Building Dependency Tree... Done - - -

-Dopo aver aggiornato l'elenco si possono usare molti comandi: - -upgrade -Upgrade tenter di fare un aggiornamento indolore del sistema completo, -senza installare nuovi pacchetti o rimuoverne di esistenti, e senza -aggiornare un pacchetto che possa rovinarne altri. Upgrade far un elenco -di tutti i pacchetti che non avr potuto aggiornare, cosa che in genere -significa che questi dipendono da nuovi pacchetti o vanno in conflitto -con altri. Per forzare la loro installazione si pu usare -dselect o apt-get install. - -install -Install viene usato per installare i singoli pacchetti dando il loro nome. -Il pacchetto viene automaticamente scaricato ed installato, cosa molto utile -se gi se ne conosce il nome e non si vuole entrare in grafica per -selezionarlo. Al comando si possono passare anche pi pacchetti, che saranno -tutti scaricati. L'installazione automatica cerca di risolvere i problemi -di dipendenze con gli altri pacchetti elencati, stampa un riassunto e -chiede conferma se si devono modificare altri pacchetti che non siano quelli -sulla linea di comando. - -dist-upgrade -Dist-upgrade fa un aggiornamento completo, progettato in modo da rendere -semplici gli aggiornamenti tra versioni di Debian. Usa un algoritmo -sofisticato per determinare il miglior insieme di pacchetti da installare, -aggiornare e rimuovere per arrivare alla versione pi aggiornata -del sistema possibile. In alcune situazioni pu essere vantaggioso usare -dist-upgrade invece che sprecare tempo a risolvere manualmente le -dipendenze con dselect. Una volta completato dist-upgrade, si pu -usare dselect per installare eventuali pacchetti che sono stati -tralasciati. - -

- importante controllare attentamente cosa intende fare dist-upgrade, -dato che le sue decisioni a volte possono essere abbastanza sorprendenti. - - -

-apt-get ha diverse opzioni a linea di comando, che vengono -documentate dettagliatamente nella sua pagina man, -. L'opzione pi utile --d, che non installa i file scaricati: se il sistema deve -scaricare un gran numero di pacchetti, non bene farglieli installare -subito, in caso dovesse andare male qualcosa. Dopo aver usato -d, -gli archivi scaricati possono essere installati semplicemente dando di -nuovo lo stesso comando senza l'opzione -d. - - - - - -DSelect -

-Il metodo APT di dselect fornisce tutte le funzionalit di APT -all'interno dell'interfaccia grafica di selezione dei pacchetti -dselect. dselect viene usato per selezionare i pacchetti -da installare o rimuovere, ed APT li installa. - -

-Per abilitare il metodo APT dovete selezionare [A]ccess in dselect -e scegliere il metodo APT; vi verr chiesto un insieme di fonti -(Sources), cio di posti da cui scaricare gli archivi. -Tali fonti possono essere siti Internet remoti, mirror locali di Debian -o CDROM; ciascuna di esse pu fornire una parte dell'archivio Debian, -ed APT le combiner insieme in un set completo di pacchetti. Se avete un -CDROM una buona idea indicare quello per primo, e poi i mirror, in modo -da avere accesso alle ultime versioni; APT user in questo modo automaticamente -i pacchetti sul CDROM prima di scaricarli da Internet. - -

- - Set up a list of distribution source locations - - Please give the base URL of the debian distribution. - The access schemes I know about are: http file - - For example: - file:/mnt/debian, - ftp://ftp.debian.org/debian, - http://ftp.de.debian.org/debian, - - - URL [http://llug.sep.bnl.gov/debian]: - - -

-La configurazione delle fonti inizia chiedendo la base dell'archivio Debian, -propone come default un mirror HTTP, e poi chiede la distribuzione -da scaricare. - -

- - Please give the distribution tag to get or a path to the - package file ending in a /. The distribution - tags are typically something like: stable unstable testing non-US - - Distribution [stable]: - - -

-La distribuzione (``distribution'') fa riferimento alla versione Debian -dell'archivio: stable l'ultima rilasciata, ed unstable - quella di sviluppo. non-US disponibile solo su alcuni mirror, -e contiene dei pacchetti in cui viene usata della tecnologia di criptazione -o altre cose che non possano essere esportate dagli Stati Uniti; importare -questi pacchetti negli US per legale. - -

- - Please give the components to get - The components are typically something like: main contrib non-free - - Components [main contrib non-free]: - - -

-L'elenco dei componenti (``components'') si riferisce alla lista di -sotto-distribuzioni da scaricare. Ciascuna distribuzione viene divisa in -base al copyright del software: la main contiene pacchetti la cui licenza -soddisfa le DFSG, mentre contrib e non-free contengono software che ha -diverse restrizioni sull'uso e sulla distribuzione. - -

-Si possono inserire un qualsiasi numero di fonti, e lo script di -configurazione continuer a chiedere fino a che abbiate specificato tutti gli -elementi che volete. - -

-Prima di cominciare ad usare dselect necessario aggiornare -l'elenco dei pacchetti disponibili selezionando [U]pdate dal men: -si tratta di un sovrainsieme di ci che fa apt-get update, -che rende l'informazione scaricata disponibile a -dselect. [U]pdate deve essere fatto anche se prima stato dato -apt-get update. - -

-Si pu a questo punto continuare selezionando i pacchetti desiderati -usando [S]elect e poi installando con [I]nstall. Se si usa il metodo APT, -i comandi [C]onfig e [R]emove non hanno significato, dato che entrambe le -fasi sono contenute in [I]nstall. - -

-Per default APT rimuover automaticamente i pacchetti che sono stati installati -con successo. Per modificare questo comportamento, si inserisca -Dselect::clean "prompt"; in /etc/apt/apt.conf. - - - - - -L'interfaccia - -

-Entrambi i metodi, dselect APT ed apt-get, condividono la -stessa interfaccia; si tratta di un sistema semplice che indica in genere -cosa sta per fare, e poi lo fa. - -Il metodo dselect in realt un insieme di script di wrapper ad -apt-get. Il metodo fornisce delle funzionalit maggiori del -solo apt-get. - -Dopo la stampa di un riassunto delle operazioni che saranno fatte, -APT stampa dei messaggi informativi sullo stato del sistema, in modo che -possiate avere davanti agli occhi a quale punto dell'operazione si trova, -e quanto ancora si deve aspettare. - - -Avvio - -

-Prima di ciascuna operazione, eccetto l'aggiornamento della lista, APT -compie alcune operazioni per prepararsi, oltre a dei controlli dello -stato del sistema. In qualsiasi momento le stesse operazioni possono essere -fatte con apt-get check -

- -# apt-get check -Reading Package Lists... Done -Building Dependancy Tree... Done - - -

-La prima cosa che fa leggere tutti i file dei pacchetti in memoria, -usando uno schema di caching in modo da rendere la stessa operazione pi -veloce la seconda volta che la si fa. Se alcuni dei file dei pacchetti -non vengono trovati, sono ignorati e viene stampato un avvertimento -all'uscita di apt-get. - -

-L'operazione finale consiste in un'analisi dettagliata delle -dipendenze del sistema: viene controllato che tutte le dipendenze dei -singoli pacchetti installati o non scompattati siano soddisfatte. -Se vengono individuati dei problemi, viene stampato un resoconto, -ed apt-get esce senza eseguire alcuna operazione. - -

- -# apt-get check -Reading Package Lists... Done -Building Dependancy Tree... Done -You might want to run apt-get -f install' to correct these. -Sorry, but the following packages have unmet dependencies: - 9fonts: Depends: xlib6g but it is not installed - uucp: Depends: mailx but it is not installed - blast: Depends: xlib6g (>= 3.3-5) but it is not installed - adduser: Depends: perl-base but it is not installed - aumix: Depends: libgpmg1 but it is not installed - debiandoc-sgml: Depends: sgml-base but it is not installed - bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed - cthugha: Depends: svgalibg1 but it is not installed - Depends: xlib6g (>= 3.3-5) but it is not installed - libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1) - - -

-In questo esempio il sistema ha molti problemi, tra cui uno piuttosto serio -con la libreadlineg2. Per ciascun pacchetto che ha dipendenze non soddisfatte, -viene stampata una linea che indica il pacchetto che crea il problema e -quali problemi ci sono. Viene inclusa inoltre una breve spiegazione -del perch il pacchetto ha un problema di dipendenze. - -

-Ci sono due modi in cui un sistema possa arrivare in uno stato problematico -di questo genere: il primo causato dal fatto che dpkg possa -mancare alcune relazioni sottili tra pacchetti durante un aggiornamento -del sistemaAPT considera comunque tutte le dipendenze note, -e cerca di prevenire problemi ai pacchetti; il secondo possibile -se l'installazione di un pacchetto fallisce, ed in questo caso possibile -che un pacchetto venga scompattato senza che tutti quelli da cui dipende -siano stati installati. - -

-La seconda possibilit meno seria della prima, dato che APT gestisce -l'ordine di installazione dei pacchetti; in entrambi i casi l'opzione --f di apt-get gli far trovare una soluzione e lo far -continuare. Il metodo APT di dselect comprende sempre l'opzione --f per permettere di configurare facilmente anche i pacchetti con -script errati. - -

-Se viene usata per l'opzione -f per correggere un sistema in uno -stato molto problematico, possibile che anche con l'opzione il programma -fallisca, subito o durante la sequenza di installazione. In entrambi i casi - necessario usare dpkg a mano (probabilmente usando delle opzioni -di forzatura) per correggere quanto basta per poter fare continuare APT. - - - -Il resoconto sullo stato - -

-Prima di procedere, apt-get presenter un resoconto delle operazioni -che sta per fare. In genere tale resoconto varier con il tipo di operazioni -da fare, ma ci sono alcuni elementi comuni: in tutti i casi gli elenchi -dipendono dallo stato finale delle cose, e tengono conto dell'opzione --f e di altre attivit rilevanti per il comando da eseguire. - -L'elenco dei pacchetti Extra -

- -The following extra packages will be installed: - libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl - mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base - bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy - squake pgp-i python-base debmake ldso perl libreadlineg2 - ssh - - -

-L'elenco dei pacchetti Extra mostra tutti i pacchetti che verranno installati -o aggiornati oltre a quelli indicati sulla linea di comando. Viene generato -solo per il comando install. I pacchetti elencati sono spesso il -risultato di un'operazione di auto installazione (Auto Install). - - -I pacchetti da rimuovere -

- -The following packages will be REMOVED: - xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix - xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel - xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid - nas xpilot xfig - - -

-L'elenco dei pacchetti da rimuovere (Remove) indica tutti i pacchetti che -verranno rimossi dal sistema. Pu essere mostrato per una qualsiasi delle -operazioni, e deve sempre essere esaminato attentamente per assicurarsi -che non venga eliminato qualcosa di importante. Con l'opzione -f - particolarmente probabile che vengano eliminati dei pacchetti, ed in questo -caso va fatta estrema attenzione. La lista pu contenere dei pacchetti -che verranno rimossi perch sono gi rimossi parzialmente, forse a causa -di un'installazione non terminata correttamente. - - -L'elenco dei nuovi pacchetti installati -

- -The following NEW packages will installed: - zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base - - -

-L'elenco dei nuovi pacchetti installati (New) semplicemente un appunto -su quello che accadr. I pacchetti nell'elenco non sono al momento installati -nel sistema, ma lo saranno alla fine delle operazioni di APT. - - -L'elenco dei pacchetti trattenuti -

- -The following packages have been kept back - compface man-db tetex-base msql libpaper svgalib1 - gs snmp arena lynx xpat2 groff xscreensaver - - -

-In ogni caso in cui il sistema viene aggiornato nel suo insieme, c' la -possibilit che non possano venire installate nuove versioni di alcuni -pacchetti, dato che potrebbero richiedere l'installazione di pacchetti non -presenti nel sistema, o entrare in conflitto con altri gi presenti. -In questo caso, il pacchetto viene elencato nella lista di quelli -trattenuti (Kept Back). Il miglior modo per convincere i pacchetti -elencati in questa lista di installarli con apt-get install o -usare dselect per risolvere i problemi. - - -Messaggi di attenzione sui pacchetti trattenuti -

- -The following held packages will be changed: - cvs - - -

-A volte si pu richiedere ad APT di installare un pacchetto -che stato trattenuto; in questi casi viene stampato un messaggio di -attenzione, che avverte che il pacchetto verr modificato. Questo -dovrebbe accadere solo durante operazioni di dist-upgrade o di install. - - -Resoconto finale -

-Infine, APT stamper un riassunto di tutte le modifiche che accadranno. - -

- -206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded. -12 packages not fully installed or removed. -Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used. - - -

-La prima linea del riassunto semplicemente una versione ridotta di tutte -le liste, ed include il numero di aggiornamenti -- cio dei pacchetti -gi installati per cui sono disponibili nuove versioni. La seconda -linea indica il numero di pacchetti con problemi di configurazione, -probabilmente in conseguenza di un'installazione non andata a buon fine. -La linea finale indica i requisiti di spazio dell'installazione: i primi -due numeri indicano rispettivamente il numero di byte che devono -essere trasferiti da posizioni remote, ed il secondo la dimensione totale -di tutti gli archivi necessari per l'installazione. Il numero successivo -indica la differenza in dimensione tra i pacchetti gi installati -e quelli che lo saranno, ed approssimativamente equivalente allo spazio -richiesto in /usr dopo l'installazione. Se si stanno rimuovendo dei -pacchetti, il valore pu indicare lo spazio che verr liberato. - -

-Si possono generare altri resoconti usando l'opzione -u per mostrare -i pacchetti da aggiornare, ma sono simili all'esempio precedente. - - - -La visualizzazione dello stato -

-Durante il download degli archivi e dei file dei pacchetti, APT -stampa una serie di messaggi di stato. - -

- -# apt-get update -Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages -Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages -Hit http://llug.sep.bnl.gov/debian/ testing/main Packages -Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages -Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages -11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s - - -

-Le linee che cominciano con Get vengono stampate quando APT inizia -a scaricare un file, e l'ultima linea indica il progresso dell'operazione. -Il primo valore in percentuale indica la percentuale totale di tutti i file; -dato che la dimensione dei file Package non nota, purtroppo a volte -apt-get update fa una stima poco accurata. - -

-La sezione successiva della linea di stato viene ripetuta una volta per -ciascuna fase del download, ed indica l'operazione in corso, insieme -ad alcune informazioni utili su cosa stia accadendo. A volte questa -sezione contiene solamente Forking, che significa che il sistema -operativo sta caricando il modulo. La prima parola dopo la parentesi quadra -aperta il nome breve dell'oggetto che si sta scaricando, che per gli archivi - il nome del pacchetto. - -

-All'interno delle virgolette c' una stringa informativa, che indica il -progresso della fase di negoziazione del download. Tipicamente comincia con -Connecting, procede con Waiting for file e poi con -Downloading o Resuming. Il valore finale il numero di byte -che sono stati scaricati dal sito remoto: una volta cominciato il -download viene rappresentato come 102/10.2k, che indica che -sono stati scaricati 102 byte di 10.2 kilobyte. La dimensione totale -viene sempre espressa in notazione a quattro cifre, per risparmiare -spazio. Dopo la dimensione viene indicato un indicatore -progressivo della percentuale del file. Il penultimo elemento la velocit -istantanea media, che viene aggiornata ogni 5 secondi, e riflette la -velocit di trasferimento dei dati in quel periodo. Infine, viene -visualizzato il tempo stimato per il trasferimento, che viene aggiornato -periodicamente e riflette il tempo necessario per completare tutte le -operazioni alla velocit di trasferimento mostrata. - -

-La visualizzazione dello stato viene aggiornata ogni mezzo secondo per -fornire un feedback costante del processo di download, e le linee Get -scorrono indietro quando viene cominciato il download di un nuovo file. -Dato che la visualizzazione dello stato viene costantemente -aggiornata, non adatta per essere registrata in un file; per non -visualizzarla si pu usare l'opzione -q. - - - -Dpkg - -

-APT usa dpkg per installare gli archivi e passer all'interfaccia -dpkg una volta finito il download. -dpkg porr anche alcune domande durante la manipolazione dei -pacchetti, ed i pacchetti stessi -potranno farne altre. Prima di ciascuna domanda viene -proposta una descrizione di quello che sta per chiedere, e le domande -sono troppo diverse per poter essere discusse in maniera completa in questa -occasione. - - - - - - diff --git a/doc/it/guide.it.sgml b/doc/it/guide.it.sgml new file mode 100644 index 000000000..2dc46e263 --- /dev/null +++ b/doc/it/guide.it.sgml @@ -0,0 +1,585 @@ + + + +Guida dell'utente di APT + +Jason Gunthorpe jgg@debian.org +Traduzione di Eugenia Franzoni eugenia@linuxcare.com + +$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $ + + +Guida per l'uso del gestore di pacchetti APT. + + + +Copyright © Jason Gunthorpe, 1998. + +

Ed. italiana Copyright © Eugenia Franzoni, 2000. + +

+"APT" e questo documento sono software libero, e li si pu ridistribuire +e/o modificare secondo i termini della Licenza Pubblica Generica GNU +(GPL), pubblicata dalla Free Software Foundation, nella versione 2 o +(se preferite) qualsiasi versione successiva. + +

"APT" and this document are free software; you can redistribute them and/or +modify them 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. + +

+Per ulteriori dettagli sui sistemi GNU/Linux si veda il testo +completo della licenza nel file +/usr/share/common-licenses/GPL. + + + + + + +Descrizione generale + +

+Il pacchetto APT al momento contiene due sezioni, il metodo APT +dselect e l'interfaccia utente a linea di comando apt-get; +entrambi danno modo di installare e rimuovere pacchetti, e di scaricarne +altri da Internet. + +Anatomia del sistema di pacchettizzazione +

+Il sistema di pacchettizzazione di Debian contiene un gran numero di +informazioni associate a ciascun pacchetto, per assicurarsi che si +integri facilmente ed in maniera pulita nel sistema; la pi +importante di esse il sistema di dipendenze. + +

+Il sistema di dipendenze permette ai singoli programmi di fare uso +degli elementi condivisi del sistema, quali le librerie; per +ridurre il numero di elementi che l'utente medio debba installare, +le porzioni di programmi che non vengono usate spesso vengono poste +in pacchetti separati. Inoltre, possibile avere pi di una scelta per +cose quali i programmi di posta elettronica, i server X e cos via. + +

+Il primo passo per capire il sistema di dipendenze la +comprensione del concetto di dipendenza semplice: un pacchetto richiede +che un altro sia installato insieme ad esso per poter +funzionare. + + +

+Ad esempio, mail-crypt un'estensione di emacs che aiuta a criptare le +mail con PGP. Se PGP non installato, mail-crypt inutile, quindi +mail-crypt ha una dipendenza semplice da PGP. Inoltre, dato che si tratta +di un'estensione di emacs, mail-crypt dipende anche da emacs, senza il +quale totalmente inutile. + +

+L'altro tipo di dipendenza importante da capire la dipendenza di +conflitto; con questa, un pacchetto che venga installato insieme ad un +altro pacchetto non funziona, e si hanno seri problemi al sistema. +Come esempio, si consideri un programma di trasporto della posta, +quale sendmail, exim o qmail: non possibile averne due contemporaneamente, +perch entrambi hanno bisogno di restare in ascolto sulla stessa porta di rete +per ricevere la posta. Tentare di installarne due danneggerebbe seriamente il +sistema, quindi ciascun programma di trasporto della posta ha una +dipendenza di conflitto con tutti gli altri. + +

+Come ulteriore complicazione, c' la possibilit che un pacchetto +voglia prendere il posto di un altro; ad esempio, exim e sendmail per molte +cose sono identici, dato che entrambi gestiscono la posta e comprendono +un'interfaccia comune, quindi il sistema di pacchettizzazione deve dichiarare +che sono entrambi agenti di trasporto della posta, e che gli altri +pacchetti a cui serve uno dei due devono dipendere da un pacchetto +fittizio agente-di-trasporto-della-posta. Quando si modificano +a mano i pacchetti, questo pu portare a moltissima confusione. + +

+In ciascun momento una singola dipendenza pu essere soddisfatta o meno +dai pacchetti gi installati; APT cerca di risolvere i problemi +di dipendenze con un buon numero di algoritmi automatici, che aiutano +a selezionare i pacchetti da installare. + + + + + + +apt-get + +

+apt-get fornisce un modo semplice di installare i pacchetti dalla +linea di comando. Diversamente da dpkg, apt-get non +capisce i nomi dei file .deb, ma utilizza il vero nome dei pacchetti, +e pu installare archivi .deb solo da una fonte. + +

+La prima Se state usando un proxy server http, dovete prima ancora +impostare la variabile d'ambiente http_proxy; vedere +sources.list(5). +cosa da fare prima di usare apt-get impostare l'elenco dei +pacchetti dalle fonti in modo che il programma sappia quali pacchetti +sono disponibili. Lo si fa con apt-get update. Ad esempio, + +

+ +# apt-get update +Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages +Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages +Reading Package Lists... Done +Building Dependency Tree... Done + + +

+Dopo aver aggiornato l'elenco si possono usare molti comandi: + +upgrade +Upgrade tenter di fare un aggiornamento indolore del sistema completo, +senza installare nuovi pacchetti o rimuoverne di esistenti, e senza +aggiornare un pacchetto che possa rovinarne altri. Upgrade far un elenco +di tutti i pacchetti che non avr potuto aggiornare, cosa che in genere +significa che questi dipendono da nuovi pacchetti o vanno in conflitto +con altri. Per forzare la loro installazione si pu usare +dselect o apt-get install. + +install +Install viene usato per installare i singoli pacchetti dando il loro nome. +Il pacchetto viene automaticamente scaricato ed installato, cosa molto utile +se gi se ne conosce il nome e non si vuole entrare in grafica per +selezionarlo. Al comando si possono passare anche pi pacchetti, che saranno +tutti scaricati. L'installazione automatica cerca di risolvere i problemi +di dipendenze con gli altri pacchetti elencati, stampa un riassunto e +chiede conferma se si devono modificare altri pacchetti che non siano quelli +sulla linea di comando. + +dist-upgrade +Dist-upgrade fa un aggiornamento completo, progettato in modo da rendere +semplici gli aggiornamenti tra versioni di Debian. Usa un algoritmo +sofisticato per determinare il miglior insieme di pacchetti da installare, +aggiornare e rimuovere per arrivare alla versione pi aggiornata +del sistema possibile. In alcune situazioni pu essere vantaggioso usare +dist-upgrade invece che sprecare tempo a risolvere manualmente le +dipendenze con dselect. Una volta completato dist-upgrade, si pu +usare dselect per installare eventuali pacchetti che sono stati +tralasciati. + +

+ importante controllare attentamente cosa intende fare dist-upgrade, +dato che le sue decisioni a volte possono essere abbastanza sorprendenti. + + +

+apt-get ha diverse opzioni a linea di comando, che vengono +documentate dettagliatamente nella sua pagina man, +. L'opzione pi utile +-d, che non installa i file scaricati: se il sistema deve +scaricare un gran numero di pacchetti, non bene farglieli installare +subito, in caso dovesse andare male qualcosa. Dopo aver usato -d, +gli archivi scaricati possono essere installati semplicemente dando di +nuovo lo stesso comando senza l'opzione -d. + + + + + +DSelect +

+Il metodo APT di dselect fornisce tutte le funzionalit di APT +all'interno dell'interfaccia grafica di selezione dei pacchetti +dselect. dselect viene usato per selezionare i pacchetti +da installare o rimuovere, ed APT li installa. + +

+Per abilitare il metodo APT dovete selezionare [A]ccess in dselect +e scegliere il metodo APT; vi verr chiesto un insieme di fonti +(Sources), cio di posti da cui scaricare gli archivi. +Tali fonti possono essere siti Internet remoti, mirror locali di Debian +o CDROM; ciascuna di esse pu fornire una parte dell'archivio Debian, +ed APT le combiner insieme in un set completo di pacchetti. Se avete un +CDROM una buona idea indicare quello per primo, e poi i mirror, in modo +da avere accesso alle ultime versioni; APT user in questo modo automaticamente +i pacchetti sul CDROM prima di scaricarli da Internet. + +

+ + Set up a list of distribution source locations + + Please give the base URL of the debian distribution. + The access schemes I know about are: http file + + For example: + file:/mnt/debian, + ftp://ftp.debian.org/debian, + http://ftp.de.debian.org/debian, + + + URL [http://llug.sep.bnl.gov/debian]: + + +

+La configurazione delle fonti inizia chiedendo la base dell'archivio Debian, +propone come default un mirror HTTP, e poi chiede la distribuzione +da scaricare. + +

+ + Please give the distribution tag to get or a path to the + package file ending in a /. The distribution + tags are typically something like: stable unstable testing non-US + + Distribution [stable]: + + +

+La distribuzione (``distribution'') fa riferimento alla versione Debian +dell'archivio: stable l'ultima rilasciata, ed unstable + quella di sviluppo. non-US disponibile solo su alcuni mirror, +e contiene dei pacchetti in cui viene usata della tecnologia di criptazione +o altre cose che non possano essere esportate dagli Stati Uniti; importare +questi pacchetti negli US per legale. + +

+ + Please give the components to get + The components are typically something like: main contrib non-free + + Components [main contrib non-free]: + + +

+L'elenco dei componenti (``components'') si riferisce alla lista di +sotto-distribuzioni da scaricare. Ciascuna distribuzione viene divisa in +base al copyright del software: la main contiene pacchetti la cui licenza +soddisfa le DFSG, mentre contrib e non-free contengono software che ha +diverse restrizioni sull'uso e sulla distribuzione. + +

+Si possono inserire un qualsiasi numero di fonti, e lo script di +configurazione continuer a chiedere fino a che abbiate specificato tutti gli +elementi che volete. + +

+Prima di cominciare ad usare dselect necessario aggiornare +l'elenco dei pacchetti disponibili selezionando [U]pdate dal men: +si tratta di un sovrainsieme di ci che fa apt-get update, +che rende l'informazione scaricata disponibile a +dselect. [U]pdate deve essere fatto anche se prima stato dato +apt-get update. + +

+Si pu a questo punto continuare selezionando i pacchetti desiderati +usando [S]elect e poi installando con [I]nstall. Se si usa il metodo APT, +i comandi [C]onfig e [R]emove non hanno significato, dato che entrambe le +fasi sono contenute in [I]nstall. + +

+Per default APT rimuover automaticamente i pacchetti che sono stati installati +con successo. Per modificare questo comportamento, si inserisca +Dselect::clean "prompt"; in /etc/apt/apt.conf. + + + + + +L'interfaccia + +

+Entrambi i metodi, dselect APT ed apt-get, condividono la +stessa interfaccia; si tratta di un sistema semplice che indica in genere +cosa sta per fare, e poi lo fa. + +Il metodo dselect in realt un insieme di script di wrapper ad +apt-get. Il metodo fornisce delle funzionalit maggiori del +solo apt-get. + +Dopo la stampa di un riassunto delle operazioni che saranno fatte, +APT stampa dei messaggi informativi sullo stato del sistema, in modo che +possiate avere davanti agli occhi a quale punto dell'operazione si trova, +e quanto ancora si deve aspettare. + + +Avvio + +

+Prima di ciascuna operazione, eccetto l'aggiornamento della lista, APT +compie alcune operazioni per prepararsi, oltre a dei controlli dello +stato del sistema. In qualsiasi momento le stesse operazioni possono essere +fatte con apt-get check +

+ +# apt-get check +Reading Package Lists... Done +Building Dependancy Tree... Done + + +

+La prima cosa che fa leggere tutti i file dei pacchetti in memoria, +usando uno schema di caching in modo da rendere la stessa operazione pi +veloce la seconda volta che la si fa. Se alcuni dei file dei pacchetti +non vengono trovati, sono ignorati e viene stampato un avvertimento +all'uscita di apt-get. + +

+L'operazione finale consiste in un'analisi dettagliata delle +dipendenze del sistema: viene controllato che tutte le dipendenze dei +singoli pacchetti installati o non scompattati siano soddisfatte. +Se vengono individuati dei problemi, viene stampato un resoconto, +ed apt-get esce senza eseguire alcuna operazione. + +

+ +# apt-get check +Reading Package Lists... Done +Building Dependancy Tree... Done +You might want to run apt-get -f install' to correct these. +Sorry, but the following packages have unmet dependencies: + 9fonts: Depends: xlib6g but it is not installed + uucp: Depends: mailx but it is not installed + blast: Depends: xlib6g (>= 3.3-5) but it is not installed + adduser: Depends: perl-base but it is not installed + aumix: Depends: libgpmg1 but it is not installed + debiandoc-sgml: Depends: sgml-base but it is not installed + bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed + cthugha: Depends: svgalibg1 but it is not installed + Depends: xlib6g (>= 3.3-5) but it is not installed + libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1) + + +

+In questo esempio il sistema ha molti problemi, tra cui uno piuttosto serio +con la libreadlineg2. Per ciascun pacchetto che ha dipendenze non soddisfatte, +viene stampata una linea che indica il pacchetto che crea il problema e +quali problemi ci sono. Viene inclusa inoltre una breve spiegazione +del perch il pacchetto ha un problema di dipendenze. + +

+Ci sono due modi in cui un sistema possa arrivare in uno stato problematico +di questo genere: il primo causato dal fatto che dpkg possa +mancare alcune relazioni sottili tra pacchetti durante un aggiornamento +del sistemaAPT considera comunque tutte le dipendenze note, +e cerca di prevenire problemi ai pacchetti; il secondo possibile +se l'installazione di un pacchetto fallisce, ed in questo caso possibile +che un pacchetto venga scompattato senza che tutti quelli da cui dipende +siano stati installati. + +

+La seconda possibilit meno seria della prima, dato che APT gestisce +l'ordine di installazione dei pacchetti; in entrambi i casi l'opzione +-f di apt-get gli far trovare una soluzione e lo far +continuare. Il metodo APT di dselect comprende sempre l'opzione +-f per permettere di configurare facilmente anche i pacchetti con +script errati. + +

+Se viene usata per l'opzione -f per correggere un sistema in uno +stato molto problematico, possibile che anche con l'opzione il programma +fallisca, subito o durante la sequenza di installazione. In entrambi i casi + necessario usare dpkg a mano (probabilmente usando delle opzioni +di forzatura) per correggere quanto basta per poter fare continuare APT. + + + +Il resoconto sullo stato + +

+Prima di procedere, apt-get presenter un resoconto delle operazioni +che sta per fare. In genere tale resoconto varier con il tipo di operazioni +da fare, ma ci sono alcuni elementi comuni: in tutti i casi gli elenchi +dipendono dallo stato finale delle cose, e tengono conto dell'opzione +-f e di altre attivit rilevanti per il comando da eseguire. + +L'elenco dei pacchetti Extra +

+ +The following extra packages will be installed: + libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl + mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base + bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy + squake pgp-i python-base debmake ldso perl libreadlineg2 + ssh + + +

+L'elenco dei pacchetti Extra mostra tutti i pacchetti che verranno installati +o aggiornati oltre a quelli indicati sulla linea di comando. Viene generato +solo per il comando install. I pacchetti elencati sono spesso il +risultato di un'operazione di auto installazione (Auto Install). + + +I pacchetti da rimuovere +

+ +The following packages will be REMOVED: + xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix + xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel + xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid + nas xpilot xfig + + +

+L'elenco dei pacchetti da rimuovere (Remove) indica tutti i pacchetti che +verranno rimossi dal sistema. Pu essere mostrato per una qualsiasi delle +operazioni, e deve sempre essere esaminato attentamente per assicurarsi +che non venga eliminato qualcosa di importante. Con l'opzione -f + particolarmente probabile che vengano eliminati dei pacchetti, ed in questo +caso va fatta estrema attenzione. La lista pu contenere dei pacchetti +che verranno rimossi perch sono gi rimossi parzialmente, forse a causa +di un'installazione non terminata correttamente. + + +L'elenco dei nuovi pacchetti installati +

+ +The following NEW packages will installed: + zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base + + +

+L'elenco dei nuovi pacchetti installati (New) semplicemente un appunto +su quello che accadr. I pacchetti nell'elenco non sono al momento installati +nel sistema, ma lo saranno alla fine delle operazioni di APT. + + +L'elenco dei pacchetti trattenuti +

+ +The following packages have been kept back + compface man-db tetex-base msql libpaper svgalib1 + gs snmp arena lynx xpat2 groff xscreensaver + + +

+In ogni caso in cui il sistema viene aggiornato nel suo insieme, c' la +possibilit che non possano venire installate nuove versioni di alcuni +pacchetti, dato che potrebbero richiedere l'installazione di pacchetti non +presenti nel sistema, o entrare in conflitto con altri gi presenti. +In questo caso, il pacchetto viene elencato nella lista di quelli +trattenuti (Kept Back). Il miglior modo per convincere i pacchetti +elencati in questa lista di installarli con apt-get install o +usare dselect per risolvere i problemi. + + +Messaggi di attenzione sui pacchetti trattenuti +

+ +The following held packages will be changed: + cvs + + +

+A volte si pu richiedere ad APT di installare un pacchetto +che stato trattenuto; in questi casi viene stampato un messaggio di +attenzione, che avverte che il pacchetto verr modificato. Questo +dovrebbe accadere solo durante operazioni di dist-upgrade o di install. + + +Resoconto finale +

+Infine, APT stamper un riassunto di tutte le modifiche che accadranno. + +

+ +206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded. +12 packages not fully installed or removed. +Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used. + + +

+La prima linea del riassunto semplicemente una versione ridotta di tutte +le liste, ed include il numero di aggiornamenti -- cio dei pacchetti +gi installati per cui sono disponibili nuove versioni. La seconda +linea indica il numero di pacchetti con problemi di configurazione, +probabilmente in conseguenza di un'installazione non andata a buon fine. +La linea finale indica i requisiti di spazio dell'installazione: i primi +due numeri indicano rispettivamente il numero di byte che devono +essere trasferiti da posizioni remote, ed il secondo la dimensione totale +di tutti gli archivi necessari per l'installazione. Il numero successivo +indica la differenza in dimensione tra i pacchetti gi installati +e quelli che lo saranno, ed approssimativamente equivalente allo spazio +richiesto in /usr dopo l'installazione. Se si stanno rimuovendo dei +pacchetti, il valore pu indicare lo spazio che verr liberato. + +

+Si possono generare altri resoconti usando l'opzione -u per mostrare +i pacchetti da aggiornare, ma sono simili all'esempio precedente. + + + +La visualizzazione dello stato +

+Durante il download degli archivi e dei file dei pacchetti, APT +stampa una serie di messaggi di stato. + +

+ +# apt-get update +Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages +Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages +Hit http://llug.sep.bnl.gov/debian/ testing/main Packages +Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages +Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages +11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s + + +

+Le linee che cominciano con Get vengono stampate quando APT inizia +a scaricare un file, e l'ultima linea indica il progresso dell'operazione. +Il primo valore in percentuale indica la percentuale totale di tutti i file; +dato che la dimensione dei file Package non nota, purtroppo a volte +apt-get update fa una stima poco accurata. + +

+La sezione successiva della linea di stato viene ripetuta una volta per +ciascuna fase del download, ed indica l'operazione in corso, insieme +ad alcune informazioni utili su cosa stia accadendo. A volte questa +sezione contiene solamente Forking, che significa che il sistema +operativo sta caricando il modulo. La prima parola dopo la parentesi quadra +aperta il nome breve dell'oggetto che si sta scaricando, che per gli archivi + il nome del pacchetto. + +

+All'interno delle virgolette c' una stringa informativa, che indica il +progresso della fase di negoziazione del download. Tipicamente comincia con +Connecting, procede con Waiting for file e poi con +Downloading o Resuming. Il valore finale il numero di byte +che sono stati scaricati dal sito remoto: una volta cominciato il +download viene rappresentato come 102/10.2k, che indica che +sono stati scaricati 102 byte di 10.2 kilobyte. La dimensione totale +viene sempre espressa in notazione a quattro cifre, per risparmiare +spazio. Dopo la dimensione viene indicato un indicatore +progressivo della percentuale del file. Il penultimo elemento la velocit +istantanea media, che viene aggiornata ogni 5 secondi, e riflette la +velocit di trasferimento dei dati in quel periodo. Infine, viene +visualizzato il tempo stimato per il trasferimento, che viene aggiornato +periodicamente e riflette il tempo necessario per completare tutte le +operazioni alla velocit di trasferimento mostrata. + +

+La visualizzazione dello stato viene aggiornata ogni mezzo secondo per +fornire un feedback costante del processo di download, e le linee Get +scorrono indietro quando viene cominciato il download di un nuovo file. +Dato che la visualizzazione dello stato viene costantemente +aggiornata, non adatta per essere registrata in un file; per non +visualizzarla si pu usare l'opzione -q. + + + +Dpkg + +

+APT usa dpkg per installare gli archivi e passer all'interfaccia +dpkg una volta finito il download. +dpkg porr anche alcune domande durante la manipolazione dei +pacchetti, ed i pacchetti stessi +potranno farne altre. Prima di ciascuna domanda viene +proposta una descrizione di quello che sta per chiedere, e le domande +sono troppo diverse per poter essere discusse in maniera completa in questa +occasione. + + + + + + diff --git a/doc/it/makefile b/doc/it/makefile new file mode 100644 index 000000000..b7851768a --- /dev/null +++ b/doc/it/makefile @@ -0,0 +1,11 @@ +# -*- make -*- +BASE=../.. +SUBDIR=doc/it + +# Bring in the default rules +include ../../buildlib/defaults.mak + +# Debian Doc SGML Documents +SOURCE = guide.it.sgml +DEBIANDOC_HTML_OPTIONS=-l it +include $(DEBIANDOC_H) diff --git a/doc/makefile b/doc/makefile index 2a2663fb3..0f6d5afa3 100644 --- a/doc/makefile +++ b/doc/makefile @@ -7,7 +7,7 @@ SUBDIRS= $(dir $(wildcard */makefile)) include ../buildlib/defaults.mak # Debian Doc SGML Documents -SOURCE = dpkg-tech.sgml design.sgml files.sgml guide.sgml guide.it.sgml \ +SOURCE = dpkg-tech.sgml design.sgml files.sgml guide.sgml \ cache.sgml method.sgml offline.sgml include $(DEBIANDOC_H) -- cgit v1.2.3-70-g09d2 From 7652e03e9909ac65dab11a8cabb9ea5b77ef95ca Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Thu, 1 Oct 2009 18:33:22 +0200 Subject: add guide.sgml and offline.sgml to the "translatable with po4a"-group Fix also the buildsystem for building the coresponding docs from these two files if they are exist for this language so we don't need to change the makefiles for ja and fr - and can also use the same simple makefiles for it and pl which ship these files as not-yet-with-po4a-translated (and currently no man page translation.) --- buildlib/po4a_manpage.mak | 7 +- doc/it/makefile | 8 +- doc/makefile | 4 +- doc/pl/makefile | 8 +- doc/po/apt-doc.pot | 1084 +++++++++++++++++++++++++++++++++++- doc/po/fr.po | 1250 ++++++++++++++++++++++++++++++++++++++---- doc/po/ja.po | 1340 ++++++++++++++++++++++++++++++++++++++------- doc/po4a.conf | 9 +- 8 files changed, 3377 insertions(+), 333 deletions(-) (limited to 'doc/makefile') diff --git a/buildlib/po4a_manpage.mak b/buildlib/po4a_manpage.mak index 538859b6e..8bb7225b8 100644 --- a/buildlib/po4a_manpage.mak +++ b/buildlib/po4a_manpage.mak @@ -40,7 +40,7 @@ HAVE_PO4A=yes endif # take care of the rest -SOURCE := $(SOURCE) apt.$(LC).8 +SOURCE := $(SOURCE) $(wildcard apt.$(LC).8) INCLUDES := ifndef HAVE_PO4A @@ -52,3 +52,8 @@ endif ifneq ($(words $(SOURCE)),0) include $(MANPAGE_H) endif + +# Debian Doc SGML Documents +SOURCE := $(wildcard *.$(LC).sgml) +DEBIANDOC_HTML_OPTIONS=-l $(LC) +include $(DEBIANDOC_H) diff --git a/doc/it/makefile b/doc/it/makefile index b7851768a..2179ec15f 100644 --- a/doc/it/makefile +++ b/doc/it/makefile @@ -5,7 +5,7 @@ SUBDIR=doc/it # Bring in the default rules include ../../buildlib/defaults.mak -# Debian Doc SGML Documents -SOURCE = guide.it.sgml -DEBIANDOC_HTML_OPTIONS=-l it -include $(DEBIANDOC_H) +# Language Code of this translation +LC=it + +include $(PO4A_MANPAGE_H) diff --git a/doc/makefile b/doc/makefile index 0f6d5afa3..fe53aba48 100644 --- a/doc/makefile +++ b/doc/makefile @@ -7,8 +7,8 @@ SUBDIRS= $(dir $(wildcard */makefile)) include ../buildlib/defaults.mak # Debian Doc SGML Documents -SOURCE = dpkg-tech.sgml design.sgml files.sgml guide.sgml \ - cache.sgml method.sgml offline.sgml +SOURCE = $(wildcard *.sgml) +DEBIANDOC_HTML_OPTIONS=-l en include $(DEBIANDOC_H) # XML man pages diff --git a/doc/pl/makefile b/doc/pl/makefile index 94939e156..7e77b29b9 100644 --- a/doc/pl/makefile +++ b/doc/pl/makefile @@ -5,7 +5,7 @@ SUBDIR=doc/pl # Bring in the default rules include ../../buildlib/defaults.mak -# Debian Doc SGML Documents -SOURCE = offline.pl.sgml -DEBIANDOC_HTML_OPTIONS=-l pl -include $(DEBIANDOC_H) +# Language Code of this translation +LC=pl + +include $(PO4A_MANPAGE_H) diff --git a/doc/po/apt-doc.pot b/doc/po/apt-doc.pot index aeb624948..82a4afe67 100644 --- a/doc/po/apt-doc.pot +++ b/doc/po/apt-doc.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2009-09-26 11:35+0300\n" +"POT-Creation-Date: 2009-10-01 18:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1136,7 +1136,7 @@ msgstr "" #. type: Content of: #: apt-cache.8.xml:234 msgid "" -"Note that a package which APT knows of is not nessasarily available to " +"Note that a package which APT knows of is not necessarily available to " "download, installable or installed, e.g. virtual packages are also listed in " "the generated list." msgstr "" @@ -2716,8 +2716,8 @@ msgid "" "November 2008" msgstr "" -#. type: Content of: -#: apt-get.8.xml:22 apt-get.8.xml:29 +#. type: +#: apt-get.8.xml:22 apt-get.8.xml:29 guide.sgml:96 msgid "apt-get" msgstr "" @@ -2792,8 +2792,8 @@ msgid "" "advance." msgstr "" -#. type: Content of: -#: apt-get.8.xml:147 +#. type: +#: apt-get.8.xml:147 guide.sgml:121 msgid "upgrade" msgstr "" @@ -2829,8 +2829,8 @@ msgid "" "removal of old and the installation of new packages)." msgstr "" -#. type: Content of: -#: apt-get.8.xml:170 +#. type: +#: apt-get.8.xml:170 guide.sgml:140 msgid "dist-upgrade" msgstr "" @@ -2848,8 +2848,8 @@ msgid "" "for a mechanism for overriding the general settings for individual packages." msgstr "" -#. type: Content of: -#: apt-get.8.xml:183 +#. type: +#: apt-get.8.xml:183 guide.sgml:131 msgid "install" msgstr "" @@ -2960,8 +2960,7 @@ msgid "" "the newest available version of that source package while respect the " "default release, set with the option " "APT::Default-Release, the option or " -"per package with with the pkg/release syntax, if " -"possible." +"per package with the pkg/release syntax, if possible." msgstr "" #. type: Content of: @@ -6856,3 +6855,1064 @@ msgstr "" #: sources.list.5.xml:222 msgid "&apt-cache; &apt-conf;" msgstr "" + +#. type: +#: guide.sgml:4 +msgid "APT User's Guide" +msgstr "" + +#. type: +#: guide.sgml:6 offline.sgml:6 +msgid "Jason Gunthorpe jgg@debian.org" +msgstr "" + +#. type: +#: guide.sgml:7 +msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $" +msgstr "" + +#. type: +#: guide.sgml:11 +msgid "" +"This document provides an overview of how to use the the APT package " +"manager." +msgstr "" + +#. type: +#: guide.sgml:15 +msgid "Copyright © Jason Gunthorpe, 1998." +msgstr "" + +#. type:

+#: guide.sgml:21 offline.sgml:22 +msgid "" +"\"APT\" and this document are free software; you can redistribute them " +"and/or modify them 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." +msgstr "" + +#. type:

+#: guide.sgml:24 offline.sgml:25 +msgid "" +"For more details, on Debian GNU/Linux systems, see the file " +"/usr/share/common-licenses/GPL for the full license." +msgstr "" + +#. type: +#: guide.sgml:32 +msgid "General" +msgstr "" + +#. type:

+#: guide.sgml:38 +msgid "" +"The APT package currently contains two sections, the APT " +"dselect method and the apt-get command line user " +"interface. Both provide a way to install and remove packages as well as " +"download new packages from the Internet." +msgstr "" + +#. type: +#: guide.sgml:39 +msgid "Anatomy of the Package System" +msgstr "" + +#. type:

+#: guide.sgml:44 +msgid "" +"The Debian packaging system has a large amount of information associated " +"with each package to help assure that it integrates cleanly and easily into " +"the system. The most prominent of its features is the dependency system." +msgstr "" + +#. type:

+#: guide.sgml:52 +msgid "" +"The dependency system allows individual programs to make use of shared " +"elements in the system such as libraries. It simplifies placing infrequently " +"used portions of a program in separate packages to reduce the number of " +"things the average user is required to install. Also, it allows for choices " +"in mail transport agents, X servers and so on." +msgstr "" + +#. type:

+#: guide.sgml:57 +msgid "" +"The first step to understanding the dependency system is to grasp the " +"concept of a simple dependency. The meaning of a simple dependency is that a " +"package requires another package to be installed at the same time to work " +"properly." +msgstr "" + +#. type:

+#: guide.sgml:63 +msgid "" +"For instance, mailcrypt is an emacs extension that aids in encrypting email " +"with GPG. Without GPGP installed mail-crypt is useless, so mailcrypt has a " +"simple dependency on GPG. Also, because it is an emacs extension it has a " +"simple dependency on emacs, without emacs it is completely useless." +msgstr "" + +#. type:

+#: guide.sgml:73 +msgid "" +"The other important dependency to understand is a conflicting dependency. It " +"means that a package, when installed with another package, will not work and " +"may possibly be extremely harmful to the system. As an example consider a " +"mail transport agent such as sendmail, exim or qmail. It is not possible to " +"have two mail transport agents installed because both need to listen to the " +"network to receive mail. Attempting to install two will seriously damage the " +"system so all mail transport agents have a conflicting dependency with all " +"other mail transport agents." +msgstr "" + +#. type:

+#: guide.sgml:83 +msgid "" +"As an added complication there is the possibility for a package to pretend " +"to be another package. Consider that exim and sendmail for many intents are " +"identical, they both deliver mail and understand a common interface. Hence, " +"the package system has a way for them to declare that they are both " +"mail-transport-agents. So, exim and sendmail both declare that they provide " +"a mail-transport-agent and other packages that need a mail transport agent " +"depend on mail-transport-agent. This can add a great deal of confusion when " +"trying to manually fix packages." +msgstr "" + +#. type:

+#: guide.sgml:88 +msgid "" +"At any given time a single dependency may be met by packages that are " +"already installed or it may not be. APT attempts to help resolve dependency " +"issues by providing a number of automatic algorithms that help in selecting " +"packages for installation." +msgstr "" + +#. type:

+#: guide.sgml:102 +msgid "" +"apt-get provides a simple way to install packages from the " +"command line. Unlike dpkg, apt-get does not " +"understand .deb files, it works with the package's proper name and can only " +"install .deb archives from a Source." +msgstr "" + +#. type:

+#: guide.sgml:109 +msgid "" +"The first

If you are using an http proxy server you must set " +"the http_proxy environment variable first, see " +"sources.list(5)

 thing that should be done before using " +"apt-get is to fetch the package lists from the Sources " +"so that it knows what packages are available. This is done with apt-get " +"update. For instance," +msgstr "" + +#. type: +#: guide.sgml:116 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n" +"Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type:

+#: guide.sgml:120 +msgid "Once updated there are several commands that can be used:" +msgstr "" + +#. type:

+#: guide.sgml:131 +msgid "" +"Upgrade will attempt to gently upgrade the whole system. Upgrade will never " +"install a new package or remove an existing package, nor will it ever " +"upgrade a package that might cause some other package to break. This can be " +"used daily to relatively safely upgrade the system. Upgrade will list all of " +"the packages that it could not upgrade, this usually means that they depend " +"on new packages or conflict with some other package. dselect or " +"apt-get install can be used to force these packages to install." +msgstr "" + +#. type:

+#: guide.sgml:140 +msgid "" +"Install is used to install packages by name. The package is automatically " +"fetched and installed. This can be useful if you already know the name of " +"the package to install and do not want to go into a GUI to select it. Any " +"number of packages may be passed to install, they will all be " +"fetched. Install automatically attempts to resolve dependency problems with " +"the listed packages and will print a summary and ask for confirmation if " +"anything other than its arguments are changed." +msgstr "" + +#. type:

+#: guide.sgml:149 +msgid "" +"Dist-upgrade is a complete upgrader designed to simplify upgrading between " +"releases of Debian. It uses a sophisticated algorithm to determine the best " +"set of packages to install, upgrade and remove to get as much of the system " +"to the newest release. In some situations it may be desired to use " +"dist-upgrade rather than spend the time manually resolving dependencies in " +"dselect. Once dist-upgrade has completed then " +"dselect can be used to install any packages that may have been " +"left out." +msgstr "" + +#. type:

+#: guide.sgml:152 +msgid "" +"It is important to closely look at what dist-upgrade is going to do, its " +"decisions may sometimes be quite surprising." +msgstr "" + +#. type:

+#: guide.sgml:163 +msgid "" +"apt-get has several command line options that are detailed in " +"its man page, . The most useful " +"option is -d which does not install the fetched files. If the " +"system has to download a large number of package it would be undesired to " +"start installing them in case something goes wrong. When -d is used " +"the downloaded archives can be installed by simply running the command that " +"caused them to be downloaded again without -d." +msgstr "" + +#. type: +#: guide.sgml:168 +msgid "DSelect" +msgstr "" + +#. type:

+#: guide.sgml:173 +msgid "" +"The APT dselect method provides the complete APT system with " +"the dselect package selection GUI. dselect is used " +"to select the packages to be installed or removed and APT actually installs " +"them." +msgstr "" + +#. type:

+#: guide.sgml:184 +msgid "" +"To enable the APT method you need to to select [A]ccess in " +"dselect and then choose the APT method. You will be prompted " +"for a set of Sources which are places to fetch archives from. These " +"can be remote Internet sites, local Debian mirrors or CDROMs. Each source " +"can provide a fragment of the total Debian archive, APT will automatically " +"combine them to form a complete set of packages. If you have a CDROM then it " +"is a good idea to specify it first and then specify a mirror so that you " +"have access to the latest bug fixes. APT will automatically use packages on " +"your CDROM before downloading from the Internet." +msgstr "" + +#. type: +#: guide.sgml:198 +#, no-wrap +msgid "" +" Set up a list of distribution source locations\n" +"\t \n" +" Please give the base URL of the debian distribution.\n" +" The access schemes I know about are: http file\n" +"\t \n" +" For example:\n" +" file:/mnt/debian,\n" +" ftp://ftp.debian.org/debian,\n" +" http://ftp.de.debian.org/debian,\n" +" \n" +" \n" +" URL [http://llug.sep.bnl.gov/debian]:" +msgstr "" + +#. type:

+#: guide.sgml:205 +msgid "" +"The Sources setup starts by asking for the base of the Debian " +"archive, defaulting to a HTTP mirror. Next it asks for the distribution to " +"get." +msgstr "" + +#. type: +#: guide.sgml:212 +#, no-wrap +msgid "" +" Please give the distribution tag to get or a path to the\n" +" package file ending in a /. The distribution\n" +" tags are typically something like: stable unstable testing non-US\n" +" \n" +" Distribution [stable]:" +msgstr "" + +#. type:

+#: guide.sgml:222 +msgid "" +"The distribution refers to the Debian version in the archive, " +"stable refers to the latest released version and unstable " +"refers to the developmental version. non-US is only available on " +"some mirrors and refers to packages that contain encryption technology or " +"other things that cannot be exported from the United States. Importing these " +"packages into the US is legal however." +msgstr "" + +#. type: +#: guide.sgml:228 +#, no-wrap +msgid "" +" Please give the components to get\n" +" The components are typically something like: main contrib non-free\n" +" \n" +" Components [main contrib non-free]:" +msgstr "" + +#. type:

+#: guide.sgml:236 +msgid "" +"The components list refers to the list of sub distributions to fetch. The " +"distribution is split up based on software licenses, main being DFSG free " +"packages while contrib and non-free contain things that have various " +"restrictions placed on their use and distribution." +msgstr "" + +#. type:

+#: guide.sgml:240 +msgid "" +"Any number of sources can be added, the setup script will continue to prompt " +"until you have specified all that you want." +msgstr "" + +#. type:

+#: guide.sgml:247 +msgid "" +"Before starting to use dselect it is necessary to update the " +"available list by selecting [U]pdate from the menu. This is a super-set of " +"apt-get update that makes the fetched information available to " +"dselect. [U]pdate must be performed even if apt-get " +"update has been run before." +msgstr "" + +#. type:

+#: guide.sgml:253 +msgid "" +"You can then go on and make your selections using [S]elect and then perform " +"the installation using [I]nstall. When using the APT method the [C]onfig and " +"[R]emove commands have no meaning, the [I]nstall command performs both of " +"them together." +msgstr "" + +#. type:

+#: guide.sgml:258 +msgid "" +"By default APT will automatically remove the package (.deb) files once they " +"have been successfully installed. To change this behavior place " +"Dselect::clean \"prompt\"; in /etc/apt/apt.conf." +msgstr "" + +#. type: +#: guide.sgml:264 +msgid "The Interface" +msgstr "" + +#. type:

+#: guide.sgml:278 +msgid "" +"Both that APT dselect method and apt-get share the " +"same interface. It is a simple system that generally tells you what it will " +"do and then goes and does it.

The dselect method " +"actually is a set of wrapper scripts to apt-get. The method " +"actually provides more functionality than is present in apt-get " +"alone.

 After printing out a summary of what will happen APT " +"then will print out some informative status messages so that you can " +"estimate how far along it is and how much is left to do." +msgstr "" + +#. type: +#: guide.sgml:280 +msgid "Startup" +msgstr "" + +#. type:

+#: guide.sgml:284 +msgid "" +"Before all operations except update, APT performs a number of actions to " +"prepare its internal state. It also does some checks of the system's " +"state. At any time these operations can be performed by running apt-get " +"check." +msgstr "" + +#. type: +#: guide.sgml:289 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type:

+#: guide.sgml:297 +msgid "" +"The first thing it does is read all the package files into memory. APT uses " +"a caching scheme so this operation will be faster the second time it is " +"run. If some of the package files are not found then they will be ignored " +"and a warning will be printed when apt-get exits." +msgstr "" + +#. type:

+#: guide.sgml:303 +msgid "" +"The final operation performs a detailed analysis of the system's " +"dependencies. It checks every dependency of every installed or unpacked " +"package and considers if it is OK. Should this find a problem then a report " +"will be printed out and apt-get will refuse to run." +msgstr "" + +#. type: +#: guide.sgml:320 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done\n" +"You might want to run apt-get -f install' to correct these.\n" +"Sorry, but the following packages have unmet dependencies:\n" +" 9fonts: Depends: xlib6g but it is not installed\n" +" uucp: Depends: mailx but it is not installed\n" +" blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" adduser: Depends: perl-base but it is not installed\n" +" aumix: Depends: libgpmg1 but it is not installed\n" +" debiandoc-sgml: Depends: sgml-base but it is not installed\n" +" bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n" +" cthugha: Depends: svgalibg1 but it is not installed\n" +" Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)" +msgstr "" + +#. type:

+#: guide.sgml:329 +msgid "" +"In this example the system has many problems, including a serious problem " +"with libreadlineg2. For each package that has unmet dependencies a line is " +"printed out indicating the package with the problem and the dependencies " +"that are unmet. A short explanation of why the package has a dependency " +"problem is also included." +msgstr "" + +#. type:

+#: guide.sgml:337 +msgid "" +"There are two ways a system can get into a broken state like this. The first " +"is caused by dpkg missing some subtle relationships between " +"packages when performing upgrades.

APT however considers all " +"known dependencies and attempts to prevent broken " +"packages

. The second is if a package installation fails " +"during an operation. In this situation a package may have been unpacked " +"without its dependents being installed." +msgstr "" + +#. type:

+#: guide.sgml:345 +msgid "" +"The second situation is much less serious than the first because APT places " +"certain constraints on the order that packages are installed. In both cases " +"supplying the -f option to apt-get will cause APT to " +"deduce a possible solution to the problem and then continue on. The APT " +"dselect method always supplies the -f option to allow " +"for easy continuation of failed maintainer scripts." +msgstr "" + +#. type:

+#: guide.sgml:351 +msgid "" +"However, if the -f option is used to correct a seriously broken " +"system caused by the first case then it is possible that it will either fail " +"immediately or the installation sequence will fail. In either case it is " +"necessary to manually use dpkg (possibly with forcing options) to correct " +"the situation enough to allow APT to proceed." +msgstr "" + +#. type: +#: guide.sgml:356 +msgid "The Status Report" +msgstr "" + +#. type:

+#: guide.sgml:363 +msgid "" +"Before proceeding apt-get will present a report on what will " +"happen. Generally the report reflects the type of operation being performed " +"but there are several common elements. In all cases the lists reflect the " +"final state of things, taking into account the -f option and any " +"other relevant activities to the command being executed." +msgstr "" + +#. type: +#: guide.sgml:364 +msgid "The Extra Package list" +msgstr "" + +#. type: +#: guide.sgml:372 +#, no-wrap +msgid "" +"The following extra packages will be installed:\n" +" libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n" +" mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n" +" bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n" +" squake pgp-i python-base debmake ldso perl libreadlineg2\n" +" ssh" +msgstr "" + +#. type:

+#: guide.sgml:379 +msgid "" +"The Extra Package list shows all of the packages that will be installed or " +"upgraded in excess of the ones mentioned on the command line. It is only " +"generated for an install command. The listed packages are often the " +"result of an Auto Install." +msgstr "" + +#. type: +#: guide.sgml:382 +msgid "The Packages to Remove" +msgstr "" + +#. type: +#: guide.sgml:389 +#, no-wrap +msgid "" +"The following packages will be REMOVED:\n" +" xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n" +" xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n" +" xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n" +" nas xpilot xfig" +msgstr "" + +#. type:

+#: guide.sgml:399 +msgid "" +"The Packages to Remove list shows all of the packages that will be removed " +"from the system. It can be shown for any of the operations and should be " +"given a careful inspection to ensure nothing important is to be taken " +"off. The -f option is especially good at generating packages to " +"remove so extreme care should be used in that case. The list may contain " +"packages that are going to be removed because they are only partially " +"installed, possibly due to an aborted installation." +msgstr "" + +#. type: +#: guide.sgml:402 +msgid "The New Packages list" +msgstr "" + +#. type: +#: guide.sgml:406 +#, no-wrap +msgid "" +"The following NEW packages will installed:\n" +" zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base" +msgstr "" + +#. type:

+#: guide.sgml:411 +msgid "" +"The New Packages list is simply a reminder of what will happen. The packages " +"listed are not presently installed in the system but will be when APT is " +"done." +msgstr "" + +#. type: +#: guide.sgml:414 +msgid "The Kept Back list" +msgstr "" + +#. type: +#: guide.sgml:419 +#, no-wrap +msgid "" +"The following packages have been kept back\n" +" compface man-db tetex-base msql libpaper svgalib1\n" +" gs snmp arena lynx xpat2 groff xscreensaver" +msgstr "" + +#. type:

+#: guide.sgml:428 +msgid "" +"Whenever the whole system is being upgraded there is the possibility that " +"new versions of packages cannot be installed because they require new things " +"or conflict with already installed things. In this case the package will " +"appear in the Kept Back list. The best way to convince packages listed there " +"to install is with apt-get install or by using dselect " +"to resolve their problems." +msgstr "" + +#. type: +#: guide.sgml:431 +msgid "Held Packages warning" +msgstr "" + +#. type: +#: guide.sgml:435 +#, no-wrap +msgid "" +"The following held packages will be changed:\n" +" cvs" +msgstr "" + +#. type:

+#: guide.sgml:441 +msgid "" +"Sometimes you can ask APT to install a package that is on hold, in such a " +"case it prints out a warning that the held package is going to be " +"changed. This should only happen during dist-upgrade or install." +msgstr "" + +#. type: +#: guide.sgml:444 +msgid "Final summary" +msgstr "" + +#. type:

+#: guide.sgml:447 +msgid "Finally, APT will print out a summary of all the changes that will occur." +msgstr "" + +#. type: +#: guide.sgml:452 +#, no-wrap +msgid "" +"206 packages upgraded, 8 newly installed, 23 to remove and 51 not " +"upgraded.\n" +"12 packages not fully installed or removed.\n" +"Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used." +msgstr "" + +#. type:

+#: guide.sgml:470 +msgid "" +"The first line of the summary simply is a reduced version of all of the " +"lists and includes the number of upgrades - that is packages already " +"installed that have new versions available. The second line indicates the " +"number of poorly configured packages, possibly the result of an aborted " +"installation. The final line shows the space requirements that the " +"installation needs. The first pair of numbers refer to the size of the " +"archive files. The first number indicates the number of bytes that must be " +"fetched from remote locations and the second indicates the total size of all " +"the archives required. The next number indicates the size difference between " +"the presently installed packages and the newly installed packages. It is " +"roughly equivalent to the space required in /usr after everything is " +"done. If a large number of packages are being removed then the value may " +"indicate the amount of space that will be freed." +msgstr "" + +#. type:

+#: guide.sgml:473 +msgid "" +"Some other reports can be generated by using the -u option to show packages " +"to upgrade, they are similar to the previous examples." +msgstr "" + +#. type: +#: guide.sgml:477 +msgid "The Status Display" +msgstr "" + +#. type:

+#: guide.sgml:481 +msgid "" +"During the download of archives and package files APT prints out a series of " +"status messages." +msgstr "" + +#. type: +#: guide.sgml:490 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n" +"Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n" +"Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ " +"Packages\n" +"Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n" +"11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s" +msgstr "" + +#. type:

+#: guide.sgml:500 +msgid "" +"The lines starting with Get are printed out when APT begins to " +"fetch a file while the last line indicates the progress of the download. The " +"first percent value on the progress line indicates the total percent done of " +"all files. Unfortunately since the size of the Package files is unknown " +"apt-get update estimates the percent done which causes some " +"inaccuracies." +msgstr "" + +#. type:

+#: guide.sgml:509 +msgid "" +"The next section of the status line is repeated once for each download " +"thread and indicates the operation being performed and some useful " +"information about what is happening. Sometimes this section will simply read " +"Forking which means the OS is loading the download module. The " +"first word after the [ is the fetch number as shown on the history " +"lines. The next word is the short form name of the object being " +"downloaded. For archives it will contain the name of the package that is " +"being fetched." +msgstr "" + +#. type:

+#: guide.sgml:524 +msgid "" +"Inside of the single quote is an informative string indicating the progress " +"of the negotiation phase of the download. Typically it progresses from " +"Connecting to Waiting for file to Downloading or " +"Resuming. The final value is the number of bytes downloaded from " +"the remote site. Once the download begins this is represented as " +"102/10.2k indicating that 102 bytes have been fetched and 10.2 " +"kilobytes is expected. The total size is always shown in 4 figure notation " +"to preserve space. After the size display is a percent meter for the file " +"itself. The second last element is the instantaneous average speed. This " +"values is updated every 5 seconds and reflects the rate of data transfer for " +"that period. Finally is shown the estimated transfer time. This is updated " +"regularly and reflects the time to complete everything at the shown transfer " +"rate." +msgstr "" + +#. type:

+#: guide.sgml:530 +msgid "" +"The status display updates every half second to provide a constant feedback " +"on the download progress while the Get lines scroll back whenever a new file " +"is started. Since the status display is constantly updated it is unsuitable " +"for logging to a file, use the -q option to remove the status " +"display." +msgstr "" + +#. type: +#: guide.sgml:535 +msgid "Dpkg" +msgstr "" + +#. type:

+#: guide.sgml:542 +msgid "" +"APT uses dpkg for installing the archives and will switch over " +"to the dpkg interface once downloading is " +"completed. dpkg will also ask a number of questions as it " +"processes the packages and the packages themselves may also ask several " +"questions. Before each question there is usually a description of what it is " +"asking and the questions are too varied to discuss completely here." +msgstr "" + +#. type: +#: offline.sgml:4 +msgid "Using APT Offline" +msgstr "" + +#. type: +#: offline.sgml:7 +msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $" +msgstr "" + +#. type: +#: offline.sgml:12 +msgid "" +"This document describes how to use APT in a non-networked environment, " +"specifically a 'sneaker-net' approach for performing upgrades." +msgstr "" + +#. type: +#: offline.sgml:16 +msgid "Copyright © Jason Gunthorpe, 1999." +msgstr "" + +#. type: +#: offline.sgml:32 +msgid "Introduction" +msgstr "" + +#. type: +#: offline.sgml:34 offline.sgml:65 offline.sgml:180 +msgid "Overview" +msgstr "" + +#. type:

+#: offline.sgml:40 +msgid "" +"Normally APT requires direct access to a Debian archive, either from a local " +"media or through a network. Another common complaint is that a Debian " +"machine is on a slow link, such as a modem and another machine has a very " +"fast connection but they are physically distant." +msgstr "" + +#. type:

+#: offline.sgml:51 +msgid "" +"The solution to this is to use large removable media such as a Zip disc or a " +"SuperDisk disc. These discs are not large enough to store the entire Debian " +"archive but can easily fit a subset large enough for most users. The idea is " +"to use APT to generate a list of packages that are required and then fetch " +"them onto the disc using another machine with good connectivity. It is even " +"possible to use another Debian machine with APT or to use a completely " +"different OS and a download tool like wget. Let remote host mean " +"the machine downloading the packages, and target host the one with " +"bad or no connection." +msgstr "" + +#. type:

+#: offline.sgml:57 +msgid "" +"This is achieved by creatively manipulating the APT configuration file. The " +"essential premis to tell APT to look on a disc for it's archive files. Note " +"that the disc should be formated with a filesystem that can handle long file " +"names such as ext2, fat32 or vfat." +msgstr "" + +#. type: +#: offline.sgml:63 +msgid "Using APT on both machines" +msgstr "" + +#. type:

+#: offline.sgml:71 +msgid "" +"APT being available on both machines gives the simplest configuration. The " +"basic idea is to place a copy of the status file on the disc and use the " +"remote machine to fetch the latest package files and decide which packages " +"to download. The disk directory structure should look like:" +msgstr "" + +#. type: +#: offline.sgml:80 +#, no-wrap +msgid "" +" /disc/\n" +" archives/\n" +" partial/\n" +" lists/\n" +" partial/\n" +" status\n" +" sources.list\n" +" apt.conf" +msgstr "" + +#. type: +#: offline.sgml:88 +msgid "The configuration file" +msgstr "" + +#. type:

+#: offline.sgml:96 +msgid "" +"The configuration file should tell APT to store its files on the disc and to " +"use the configuration files on the disc as well. The sources.list should " +"contain the proper sites that you wish to use from the remote machine, and " +"the status file should be a copy of /var/lib/dpkg/status from the " +"target host. Please note, if you are using a local archive you must " +"use copy URIs, the syntax is identical to file URIs." +msgstr "" + +#. type:

+#: offline.sgml:100 +msgid "" +"apt.conf must contain the necessary information to make APT use the " +"disc:" +msgstr "" + +#. type: +#: offline.sgml:124 +#, no-wrap +msgid "" +" APT\n" +" {\n" +" /* This is not necessary if the two machines are the same arch, it " +"tells\n" +" the remote APT what architecture the target machine is */\n" +" Architecture \"i386\";\n" +" \n" +" Get::Download-Only \"true\";\n" +" };\n" +" \n" +" Dir\n" +" {\n" +" /* Use the disc for state information and redirect the status file from\n" +" the /var/lib/dpkg default */\n" +" State \"/disc/\";\n" +" State::status \"status\";\n" +"\n" +" // Binary caches will be stored locally\n" +" Cache::archives \"/disc/archives/\";\n" +" Cache \"/tmp/\";\n" +" \n" +" // Location of the source list.\n" +" Etc \"/disc/\";\n" +" };" +msgstr "" + +#. type:

+#: offline.sgml:129 +msgid "" +"More details can be seen by examining the apt.conf man page and the sample " +"configuration file in /usr/share/doc/apt/examples/apt.conf." +msgstr "" + +#. type:

+#: offline.sgml:136 +msgid "" +"On the target machine the first thing to do is mount the disc and copy " +"/var/lib/dpkg/status to it. You will also need to create the " +"directories outlined in the Overview, archives/partial/ and " +"lists/partial/ Then take the disc to the remote machine and " +"configure the sources.list. On the remote machine execute the following:" +msgstr "" + +#. type: +#: offline.sgml:142 +#, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get update\n" +" [ APT fetches the package files ]\n" +" # apt-get dist-upgrade\n" +" [ APT fetches all the packages needed to upgrade the target machine ]" +msgstr "" + +#. type:

+#: offline.sgml:149 +msgid "" +"The dist-upgrade command can be replaced with any-other standard APT " +"commands, particularly dselect-upgrade. You can even use an APT front end " +"such as dselect However this presents a problem in communicating " +"your selections back to the local computer." +msgstr "" + +#. type:

+#: offline.sgml:153 +msgid "" +"Now the disc contains all of the index files and archives needed to upgrade " +"the target machine. Take the disc back and run:" +msgstr "" + +#. type: +#: offline.sgml:159 +#, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get check\n" +" [ APT generates a local copy of the cache files ]\n" +" # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n" +" [ Or any other APT command ]" +msgstr "" + +#. type:

+#: offline.sgml:165 +msgid "" +"It is necessary for proper function to re-specify the status file to be the " +"local one. This is very important!" +msgstr "" + +#. type:

+#: offline.sgml:172 +msgid "" +"If you are using dselect you can do the very risky operation of copying " +"disc/status to /var/lib/dpkg/status so that any selections you made on the " +"remote machine are updated. I highly recommend that people only make " +"selections on the local machine - but this may not always be possible. DO " +"NOT copy the status file if dpkg or APT have been run in the mean time!!" +msgstr "" + +#. type: +#: offline.sgml:178 +msgid "Using APT and wget" +msgstr "" + +#. type:

+#: offline.sgml:185 +msgid "" +"wget is a popular and portable download tool that can run on nearly " +"any machine. Unlike the method above this requires that the Debian machine " +"already has a list of available packages." +msgstr "" + +#. type:

+#: offline.sgml:190 +msgid "" +"The basic idea is to create a disc that has only the archive files " +"downloaded from the remote site. This is done by using the --print-uris " +"option to apt-get and then preparing a wget script to actually fetch the " +"packages." +msgstr "" + +#. type: +#: offline.sgml:196 +msgid "Operation" +msgstr "" + +#. type:

+#: offline.sgml:200 +msgid "" +"Unlike the previous technique no special configuration files are " +"required. We merely use the standard APT commands to generate the file list." +msgstr "" + +#. type: +#: offline.sgml:205 +#, no-wrap +msgid "" +" # apt-get dist-upgrade \n" +" [ Press no when prompted, make sure you are happy with the actions ]\n" +" # apt-get -qq --print-uris dist-upgrade > uris\n" +" # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script" +msgstr "" + +#. type:

+#: offline.sgml:210 +msgid "" +"Any command other than dist-upgrade could be used here, including " +"dselect-upgrade." +msgstr "" + +#. type:

+#: offline.sgml:216 +msgid "" +"The /disc/wget-script file will now contain a list of wget commands to " +"execute in order to fetch the necessary archives. This script should be run " +"with the current directory as the disc's mount point so as to save the " +"output on the disc." +msgstr "" + +#. type:

+#: offline.sgml:219 +msgid "The remote machine would do something like" +msgstr "" + +#. type: +#: offline.sgml:223 +#, no-wrap +msgid "" +" # cd /disc\n" +" # sh -x ./wget-script\n" +" [ wait.. ]" +msgstr "" + +#. type: +#: offline.sgml:228 +msgid "" +"Once the archives are downloaded and the disc returned to the Debian machine " +"installation can proceed using," +msgstr "" + +#. type: +#: offline.sgml:230 +#, no-wrap +msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade" +msgstr "" + +#. type:

+#: offline.sgml:234 +msgid "Which will use the already fetched archives on the disc." +msgstr "" diff --git a/doc/po/fr.po b/doc/po/fr.po index b95576e34..738408312 100644 --- a/doc/po/fr.po +++ b/doc/po/fr.po @@ -9,7 +9,7 @@ msgid "" msgstr "" "Project-Id-Version: \n" -"POT-Creation-Date: 2009-09-26 11:35+0300\n" +"POT-Creation-Date: 2009-10-01 18:09+0300\n" "PO-Revision-Date: 2009-09-26 19:25+0200\n" "Last-Translator: Christian Perrier \n" "Language-Team: French \n" @@ -1023,8 +1023,8 @@ msgstr "" "\">\n" #. type: Plain text -#: apt.ent:350, no-wrap -#| msgid "Storage area for state information for each package resource specified in &sources-list; Configuration Item: Dir::State::Lists." +#: apt.ent:350 +#, no-wrap msgid "" "&statedir;/lists/\n" @@ -1040,8 +1040,8 @@ msgstr "" " \n" #. type: Plain text -#: apt.ent:355, no-wrap -#| msgid "Storage area for state information in transit. Configuration Item: Dir::State::Lists (implicit partial)." +#: apt.ent:355 +#, no-wrap msgid "" " &statedir;/lists/partial/\n" " Storage area for state information in transit.\n" @@ -1055,7 +1055,7 @@ msgstr "" " \n" "\">\n" -#. The last update date +#. The last update date #. type: Content of: #: apt-cache.8.xml:13 apt-config.8.xml:13 apt-extracttemplates.1.xml:13 #: apt-ftparchive.1.xml:13 apt-sortpkgs.1.xml:13 sources.list.5.xml:13 @@ -1538,12 +1538,6 @@ msgstr "pkgnames [ préfixe ]" #. type: Content of: #: apt-cache.8.xml:229 -#| msgid "" -#| "This command prints the name of each package in the system. The optional " -#| "argument is a prefix match to filter the name list. The output is " -#| "suitable for use in a shell tab complete function and the output is " -#| "generated extremely quickly. This command is best used with the option." msgid "" "This command prints the name of each package APT knows. The optional " "argument is a prefix match to filter the name list. The output is suitable " @@ -1551,19 +1545,27 @@ msgid "" "extremely quickly. This command is best used with the ." #. type: Content of: #: apt-cache.8.xml:234 +#, fuzzy +#| msgid "" +#| "Note that a package which APT knows of is not nessasarily available to " +#| "download, installable or installed, e.g. virtual packages are also listed " +#| "in the generated list." msgid "" -"Note that a package which APT knows of is not nessasarily available to " +"Note that a package which APT knows of is not necessarily available to " "download, installable or installed, e.g. virtual packages are also listed in " "the generated list." -msgstr "Veuillez noter qu'un paquet connu par APT n'est pas forcément disponible, installable ou installé. Par exemple, les paquets virtuels sont également affichés dans la liste." +msgstr "" +"Veuillez noter qu'un paquet connu par APT n'est pas forcément disponible, " +"installable ou installé. Par exemple, les paquets virtuels sont également " +"affichés dans la liste." #. type: Content of: #: apt-cache.8.xml:239 @@ -2446,25 +2448,6 @@ msgstr "Outil de création de fichiers d'index" #. type: Content of: #: apt-ftparchive.1.xml:36 -#| msgid "" -#| "apt-ftparchive " -#| " " -#| " " -#| " packagespathoverridepathprefix " -#| "sourcespathoverridepathprefix " -#| "contents path release path generate config-file section clean config-file " msgid "" "apt-ftparchive " " " @@ -2487,10 +2470,11 @@ msgstr "" "apt-ftparchive " " " " packagescheminoverride " +"packagescheminoverridepréfixe-de-chemin sourcescheminoverride #: apt-ftparchive.1.xml:82 apt-ftparchive.1.xml:106 -msgid "The option can be used to specify a binary caching DB." +msgid "" +"The option can be used to specify a binary caching DB." msgstr "" "On peut se servir de l'option pour demander un cache " "binaire." @@ -2721,8 +2706,10 @@ msgstr "" #. type: Content of: #: apt-ftparchive.1.xml:155 -msgid "The generate configuration has 4 separate sections, each described below." -msgstr "Ce fichier de configuration possède quatre sections, décrites ci-dessous." +msgid "" +"The generate configuration has 4 separate sections, each described below." +msgstr "" +"Ce fichier de configuration possède quatre sections, décrites ci-dessous." #. type: Content of: #: apt-ftparchive.1.xml:157 @@ -3565,7 +3552,7 @@ msgstr "" "<command>apt-ftparchive</command> retourne zéro si tout se passe bien, le " "nombre 100 en cas d'erreur." -#. The last update date +#. The last update date #. type: Content of: <refentry><refentryinfo> #: apt-get.8.xml:13 msgid "" @@ -3575,8 +3562,8 @@ msgstr "" "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 " "Novembre 2008</date>" -#. type: Content of: <refentry><refnamediv><refname> -#: apt-get.8.xml:22 apt-get.8.xml:29 +#. type: <heading></heading> +#: apt-get.8.xml:22 apt-get.8.xml:29 guide.sgml:96 msgid "apt-get" msgstr "apt-get" @@ -3589,37 +3576,6 @@ msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: apt-get.8.xml:36 -#| msgid "" -#| "<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> " -#| "<option>-o= <replaceable>config_string</replaceable> </option> </arg> " -#| "<arg> <option>-c= <replaceable>config_file</replaceable> </option> </arg> " -#| "<arg> <option>-t=</option> <group choice='req'> <arg choice='plain'> " -#| "<replaceable>target_release_name</replaceable> </arg> <arg " -#| "choice='plain'> <replaceable>target_release_number_expression</" -#| "replaceable> </arg> <arg choice='plain'> " -#| "<replaceable>target_release_codename</replaceable> </arg> </group> </arg> " -#| "<group choice=\"req\"> <arg choice='plain'>update</arg> <arg " -#| "choice='plain'>upgrade</arg> <arg choice='plain'>dselect-upgrade</arg> " -#| "<arg choice='plain'>dist-upgrade</arg> <arg choice='plain'>install <arg " -#| "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> " -#| "<group choice='req'> <arg choice='plain'> " -#| "=<replaceable>pkg_version_number</replaceable> </arg> <arg " -#| "choice='plain'> /<replaceable>target_release_name</replaceable> </arg> " -#| "<arg choice='plain'> /<replaceable>target_release_codename</replaceable> " -#| "</arg> </group> </arg> </arg> </arg> <arg choice='plain'>remove <arg " -#| "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></" -#| "arg> <arg choice='plain'>purge <arg choice=\"plain\" rep=\"repeat" -#| "\"><replaceable>pkg</replaceable></arg></arg> <arg choice='plain'>source " -#| "<arg choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> " -#| "=<replaceable>pkg_version_number</replaceable> </arg> </arg> </arg> <arg " -#| "choice='plain'>build-dep <arg choice=\"plain\" rep=\"repeat" -#| "\"><replaceable>pkg</replaceable></arg></arg> <arg choice='plain'>check</" -#| "arg> <arg choice='plain'>clean</arg> <arg choice='plain'>autoclean</arg> " -#| "<arg choice='plain'>autoremove</arg> <arg choice='plain'> <group " -#| "choice='req'> <arg choice='plain'>-v</arg> <arg choice='plain'>--version</" -#| "arg> </group> </arg> <arg choice='plain'> <group choice='req'> <arg " -#| "choice='plain'>-h</arg> <arg choice='plain'>--help</arg> </group> </arg> " -#| "</group>" msgid "" "<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> " "<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> " @@ -3726,8 +3682,8 @@ msgstr "" "progression d'ensemble peut être imprécis puisque la taille de ces fichiers " "ne peut être connue à l'avance." -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> -#: apt-get.8.xml:147 +#. type: <tag></tag> +#: apt-get.8.xml:147 guide.sgml:121 msgid "upgrade" msgstr "upgrade" @@ -3780,8 +3736,8 @@ msgstr "" "état (par exemple, suppression d'anciens paquets, installation de nouveaux " "paquets)." -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> -#: apt-get.8.xml:170 +#. type: <tag></tag> +#: apt-get.8.xml:170 guide.sgml:140 msgid "dist-upgrade" msgstr "dist-upgrade" @@ -3808,8 +3764,8 @@ msgstr "" "sources où récupérer les paquets désirés. Voyez aussi &apt-preferences; pour " "un mécanisme de remplacement des paramètres généraux pour certains paquets." -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> -#: apt-get.8.xml:183 +#. type: <tag></tag> +#: apt-get.8.xml:183 guide.sgml:131 msgid "install" msgstr "install" @@ -3962,32 +3918,31 @@ msgstr "source" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:251 +#, fuzzy #| msgid "" #| "<literal>source</literal> causes <command>apt-get</command> to fetch " #| "source packages. APT will examine the available packages to decide which " #| "source package to fetch. It will then find and download into the current " -#| "directory the newest available version of that source package. Source " -#| "packages are tracked separately from binary packages via <literal>deb-" -#| "src</literal> type lines in the &sources-list; file. This probably will " -#| "mean that you will not get the same source as the package you have " -#| "installed or as you could install. If the --compile options is specified " -#| "then the package will be compiled to a binary .deb using dpkg-" -#| "buildpackage, if --download-only is specified then the source package " -#| "will not be unpacked." +#| "directory the newest available version of that source package while " +#| "respect the default release, set with the option <literal>APT::Default-" +#| "Release</literal>, the <option>-t</option> option or per package with " +#| "with the <literal>pkg/release</literal> syntax, if possible." msgid "" "<literal>source</literal> causes <command>apt-get</command> to fetch source " "packages. APT will examine the available packages to decide which source " "package to fetch. It will then find and download into the current directory " "the newest available version of that source package while respect the " "default release, set with the option <literal>APT::Default-Release</" -"literal>, the <option>-t</option> option or per package with with the " +"literal>, the <option>-t</option> option or per package with the " "<literal>pkg/release</literal> syntax, if possible." msgstr "" "Avec la commande <literal>source</literal>, <command>apt-get</command> " "récupère des paquets sources. APT examine les paquets disponibles pour " "choisir le paquet source à récupérer. Il trouve ensuite et récupère dans le " -"répertoire courant leur version la plus récente par rapport à la version cible par défaut établie avec l'option <literal>APT::Default-Release</" -"literal>, l'option <option>-t</option> ou par paquet avec la syntaxe <literal>paquet/version</literal>, si possible." +"répertoire courant leur version la plus récente par rapport à la version " +"cible par défaut établie avec l'option <literal>APT::Default-Release</" +"literal>, l'option <option>-t</option> ou par paquet avec la syntaxe " +"<literal>paquet/version</literal>, si possible." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:259 @@ -4920,7 +4875,8 @@ msgstr "<filename>/etc/apt/trusted.gpg</filename>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-key.8.xml:141 msgid "Keyring of local trusted keys, new keys will be added here." -msgstr "Trousseau de clés locales fiables : les nouvelles clés y seront ajoutées." +msgstr "" +"Trousseau de clés locales fiables : les nouvelles clés y seront ajoutées." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: apt-key.8.xml:144 @@ -4944,8 +4900,10 @@ msgstr "Trousseau des clés fiables de l'archive Debian." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: apt-key.8.xml:152 -msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" -msgstr "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" +msgid "" +"<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" +msgstr "" +"<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-key.8.xml:153 @@ -4957,7 +4915,7 @@ msgstr "Trousseau des clés fiables supprimées de l'archive Debian." msgid "&apt-get;, &apt-secure;" msgstr "&apt-get;, &apt-secure;" -#. The last update date +#. The last update date #. type: Content of: <refentry><refentryinfo> #: apt-mark.8.xml:13 #, fuzzy @@ -5088,7 +5046,8 @@ msgstr "" #: apt-mark.8.xml:93 #, fuzzy #| msgid "<option>-f=<filename>FILENAME</filename></option>" -msgid "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>" +msgid "" +"<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>" msgstr "<option>-f=<filename>FICHIER</filename></option>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> @@ -5556,7 +5515,7 @@ msgstr "" "<command>apt-sortpkgs</command> retourne zéro si tout se passe bien ou 100 " "en cas d'erreur." -#. The last update date +#. The last update date #. type: Content of: <refentry><refentryinfo> #: apt.conf.5.xml:13 #, fuzzy @@ -6999,7 +6958,7 @@ msgstr "" #. TODO: provide a #. motivating example, except I haven't a clue why you'd want -#. to do this. +#. to do this. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> #: apt.conf.5.xml:626 msgid "" @@ -7021,7 +6980,8 @@ msgstr "<literal>Debug::Acquire::cdrom</literal>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.conf.5.xml:645 -msgid "Print information related to accessing <literal>cdrom://</literal> sources." +msgid "" +"Print information related to accessing <literal>cdrom://</literal> sources." msgstr "" "Affiche les informations concernant les sources de type <literal>cdrom://</" "literal>" @@ -7034,7 +6994,8 @@ msgstr "<literal>Debug::Acquire::ftp</literal>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.conf.5.xml:656 msgid "Print information related to downloading packages using FTP." -msgstr "Affiche les informations concernant le téléchargement de paquets par FTP." +msgstr "" +"Affiche les informations concernant le téléchargement de paquets par FTP." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: apt.conf.5.xml:663 @@ -7044,7 +7005,8 @@ msgstr "<literal>Debug::Acquire::http</literal>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.conf.5.xml:667 msgid "Print information related to downloading packages using HTTP." -msgstr "Affiche les informations concernant le téléchargement de paquets par HTTP." +msgstr "" +"Affiche les informations concernant le téléchargement de paquets par HTTP." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: apt.conf.5.xml:674 @@ -7205,7 +7167,8 @@ msgstr "<literal>Debug::pkgAcquire::Worker</literal>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.conf.5.xml:796 -msgid "Log all interactions with the sub-processes that actually perform downloads." +msgid "" +"Log all interactions with the sub-processes that actually perform downloads." msgstr "" "Affiche toutes les interactions avec les processus enfants qui se chargent " "effectivement des téléchargements." @@ -7346,7 +7309,8 @@ msgstr "<literal>Debug::pkgPackageManager</literal>" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.conf.5.xml:897 -msgid "Output status messages tracing the steps performed when invoking &dpkg;." +msgid "" +"Output status messages tracing the steps performed when invoking &dpkg;." msgstr "Affiche le détail des opérations liées à l'invocation de &dpkg;." #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> @@ -7419,13 +7383,13 @@ msgstr "" msgid "&file-aptconf;" msgstr "&apt-conf;" -#. ? reading apt.conf +#. ? reading apt.conf #. type: Content of: <refentry><refsect1><para> #: apt.conf.5.xml:975 msgid "&apt-cache;, &apt-config;, &apt-preferences;." msgstr "&apt-cache;, &apt-config;, &apt-preferences;." -#. The last update date +#. The last update date #. type: Content of: <refentry><refentryinfo> #: apt_preferences.5.xml:13 msgid "&apt-author.team; &apt-email; &apt-product; <date>04 May 2009</date>" @@ -7567,7 +7531,8 @@ msgstr "une priorité égale à 990" #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> #: apt_preferences.5.xml:94 -msgid "to the versions that are not installed and belong to the target release." +msgid "" +"to the versions that are not installed and belong to the target release." msgstr "" "est affectée aux versions qui ne sont pas installées et qui appartiennent à " "la distribution par défaut." @@ -8052,7 +8017,8 @@ msgstr "" #. type: Content of: <refentry><refsect1><refsect2><title> #: apt_preferences.5.xml:306 msgid "Determination of Package Version and Distribution Properties" -msgstr "Détermination de la version des paquets et des propriétés des distributions" +msgstr "" +"Détermination de la version des paquets et des propriétés des distributions" #. type: Content of: <refentry><refsect1><refsect2><para> #: apt_preferences.5.xml:308 @@ -9091,6 +9057,1072 @@ msgstr "" msgid "&apt-cache; &apt-conf;" msgstr "&apt-cache; &apt-conf;" +#. type: <title> +#: guide.sgml:4 +msgid "APT User's Guide" +msgstr "" + +#. type: +#: guide.sgml:6 offline.sgml:6 +msgid "Jason Gunthorpe jgg@debian.org" +msgstr "" + +#. type: +#: guide.sgml:7 +msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $" +msgstr "" + +#. type: +#: guide.sgml:11 +msgid "" +"This document provides an overview of how to use the the APT package manager." +msgstr "" + +#. type: +#: guide.sgml:15 +msgid "Copyright © Jason Gunthorpe, 1998." +msgstr "" + +#. type:

+#: guide.sgml:21 offline.sgml:22 +msgid "" +"\"APT\" and this document are free software; you can redistribute them and/" +"or modify them 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." +msgstr "" + +#. type:

+#: guide.sgml:24 offline.sgml:25 +msgid "" +"For more details, on Debian GNU/Linux systems, see the file /usr/share/" +"common-licenses/GPL for the full license." +msgstr "" + +#. type: +#: guide.sgml:32 +#, fuzzy +#| msgid "generate" +msgid "General" +msgstr "generate" + +#. type:

+#: guide.sgml:38 +msgid "" +"The APT package currently contains two sections, the APT dselect method and the apt-get command line user interface. Both " +"provide a way to install and remove packages as well as download new " +"packages from the Internet." +msgstr "" + +#. type: +#: guide.sgml:39 +msgid "Anatomy of the Package System" +msgstr "" + +#. type:

+#: guide.sgml:44 +msgid "" +"The Debian packaging system has a large amount of information associated " +"with each package to help assure that it integrates cleanly and easily into " +"the system. The most prominent of its features is the dependency system." +msgstr "" + +#. type:

+#: guide.sgml:52 +msgid "" +"The dependency system allows individual programs to make use of shared " +"elements in the system such as libraries. It simplifies placing infrequently " +"used portions of a program in separate packages to reduce the number of " +"things the average user is required to install. Also, it allows for choices " +"in mail transport agents, X servers and so on." +msgstr "" + +#. type:

+#: guide.sgml:57 +msgid "" +"The first step to understanding the dependency system is to grasp the " +"concept of a simple dependency. The meaning of a simple dependency is that a " +"package requires another package to be installed at the same time to work " +"properly." +msgstr "" + +#. type:

+#: guide.sgml:63 +msgid "" +"For instance, mailcrypt is an emacs extension that aids in encrypting email " +"with GPG. Without GPGP installed mail-crypt is useless, so mailcrypt has a " +"simple dependency on GPG. Also, because it is an emacs extension it has a " +"simple dependency on emacs, without emacs it is completely useless." +msgstr "" + +#. type:

+#: guide.sgml:73 +msgid "" +"The other important dependency to understand is a conflicting dependency. It " +"means that a package, when installed with another package, will not work and " +"may possibly be extremely harmful to the system. As an example consider a " +"mail transport agent such as sendmail, exim or qmail. It is not possible to " +"have two mail transport agents installed because both need to listen to the " +"network to receive mail. Attempting to install two will seriously damage the " +"system so all mail transport agents have a conflicting dependency with all " +"other mail transport agents." +msgstr "" + +#. type:

+#: guide.sgml:83 +msgid "" +"As an added complication there is the possibility for a package to pretend " +"to be another package. Consider that exim and sendmail for many intents are " +"identical, they both deliver mail and understand a common interface. Hence, " +"the package system has a way for them to declare that they are both mail-" +"transport-agents. So, exim and sendmail both declare that they provide a " +"mail-transport-agent and other packages that need a mail transport agent " +"depend on mail-transport-agent. This can add a great deal of confusion when " +"trying to manually fix packages." +msgstr "" + +#. type:

+#: guide.sgml:88 +msgid "" +"At any given time a single dependency may be met by packages that are " +"already installed or it may not be. APT attempts to help resolve dependency " +"issues by providing a number of automatic algorithms that help in selecting " +"packages for installation." +msgstr "" + +#. type:

+#: guide.sgml:102 +msgid "" +"apt-get provides a simple way to install packages from the " +"command line. Unlike dpkg, apt-get does not " +"understand .deb files, it works with the package's proper name and can only " +"install .deb archives from a Source." +msgstr "" + +#. type:

+#: guide.sgml:109 +msgid "" +"The first

If you are using an http proxy server you must set " +"the http_proxy environment variable first, see sources.list(5)

thing that should be done before using apt-get is to " +"fetch the package lists from the Sources so that it knows what " +"packages are available. This is done with apt-get update. For " +"instance," +msgstr "" + +#. type: +#: guide.sgml:116 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n" +"Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type:

+#: guide.sgml:120 +msgid "Once updated there are several commands that can be used:" +msgstr "" + +#. type:

+#: guide.sgml:131 +msgid "" +"Upgrade will attempt to gently upgrade the whole system. Upgrade will never " +"install a new package or remove an existing package, nor will it ever " +"upgrade a package that might cause some other package to break. This can be " +"used daily to relatively safely upgrade the system. Upgrade will list all of " +"the packages that it could not upgrade, this usually means that they depend " +"on new packages or conflict with some other package. dselect or " +"apt-get install can be used to force these packages to install." +msgstr "" + +#. type:

+#: guide.sgml:140 +msgid "" +"Install is used to install packages by name. The package is automatically " +"fetched and installed. This can be useful if you already know the name of " +"the package to install and do not want to go into a GUI to select it. Any " +"number of packages may be passed to install, they will all be fetched. " +"Install automatically attempts to resolve dependency problems with the " +"listed packages and will print a summary and ask for confirmation if " +"anything other than its arguments are changed." +msgstr "" + +#. type:

+#: guide.sgml:149 +msgid "" +"Dist-upgrade is a complete upgrader designed to simplify upgrading between " +"releases of Debian. It uses a sophisticated algorithm to determine the best " +"set of packages to install, upgrade and remove to get as much of the system " +"to the newest release. In some situations it may be desired to use dist-" +"upgrade rather than spend the time manually resolving dependencies in " +"dselect. Once dist-upgrade has completed then dselect can be used to install any packages that may have been left out." +msgstr "" + +#. type:

+#: guide.sgml:152 +msgid "" +"It is important to closely look at what dist-upgrade is going to do, its " +"decisions may sometimes be quite surprising." +msgstr "" + +#. type:

+#: guide.sgml:163 +msgid "" +"apt-get has several command line options that are detailed in " +"its man page, . The most useful " +"option is -d which does not install the fetched files. If the " +"system has to download a large number of package it would be undesired to " +"start installing them in case something goes wrong. When -d is used " +"the downloaded archives can be installed by simply running the command that " +"caused them to be downloaded again without -d." +msgstr "" + +#. type: +#: guide.sgml:168 +#, fuzzy +#| msgid "APT in DSelect" +msgid "DSelect" +msgstr "APT et DSelect" + +#. type:

+#: guide.sgml:173 +msgid "" +"The APT dselect method provides the complete APT system with " +"the dselect package selection GUI. dselect is used " +"to select the packages to be installed or removed and APT actually installs " +"them." +msgstr "" + +#. type:

+#: guide.sgml:184 +msgid "" +"To enable the APT method you need to to select [A]ccess in dselect and then choose the APT method. You will be prompted for a set of " +"Sources which are places to fetch archives from. These can be " +"remote Internet sites, local Debian mirrors or CDROMs. Each source can " +"provide a fragment of the total Debian archive, APT will automatically " +"combine them to form a complete set of packages. If you have a CDROM then it " +"is a good idea to specify it first and then specify a mirror so that you " +"have access to the latest bug fixes. APT will automatically use packages on " +"your CDROM before downloading from the Internet." +msgstr "" + +#. type: +#: guide.sgml:198 +#, no-wrap +msgid "" +" Set up a list of distribution source locations\n" +"\t \n" +" Please give the base URL of the debian distribution.\n" +" The access schemes I know about are: http file\n" +"\t \n" +" For example:\n" +" file:/mnt/debian,\n" +" ftp://ftp.debian.org/debian,\n" +" http://ftp.de.debian.org/debian,\n" +" \n" +" \n" +" URL [http://llug.sep.bnl.gov/debian]:" +msgstr "" + +#. type:

+#: guide.sgml:205 +msgid "" +"The Sources setup starts by asking for the base of the Debian " +"archive, defaulting to a HTTP mirror. Next it asks for the distribution to " +"get." +msgstr "" + +#. type: +#: guide.sgml:212 +#, no-wrap +msgid "" +" Please give the distribution tag to get or a path to the\n" +" package file ending in a /. The distribution\n" +" tags are typically something like: stable unstable testing non-US\n" +" \n" +" Distribution [stable]:" +msgstr "" + +#. type:

+#: guide.sgml:222 +msgid "" +"The distribution refers to the Debian version in the archive, stable refers to the latest released version and unstable refers to " +"the developmental version. non-US is only available on some mirrors " +"and refers to packages that contain encryption technology or other things " +"that cannot be exported from the United States. Importing these packages " +"into the US is legal however." +msgstr "" + +#. type: +#: guide.sgml:228 +#, no-wrap +msgid "" +" Please give the components to get\n" +" The components are typically something like: main contrib non-free\n" +" \n" +" Components [main contrib non-free]:" +msgstr "" + +#. type:

+#: guide.sgml:236 +msgid "" +"The components list refers to the list of sub distributions to fetch. The " +"distribution is split up based on software licenses, main being DFSG free " +"packages while contrib and non-free contain things that have various " +"restrictions placed on their use and distribution." +msgstr "" + +#. type:

+#: guide.sgml:240 +msgid "" +"Any number of sources can be added, the setup script will continue to prompt " +"until you have specified all that you want." +msgstr "" + +#. type:

+#: guide.sgml:247 +msgid "" +"Before starting to use dselect it is necessary to update the " +"available list by selecting [U]pdate from the menu. This is a super-set of " +"apt-get update that makes the fetched information available to " +"dselect. [U]pdate must be performed even if apt-get update has been run before." +msgstr "" + +#. type:

+#: guide.sgml:253 +msgid "" +"You can then go on and make your selections using [S]elect and then perform " +"the installation using [I]nstall. When using the APT method the [C]onfig and " +"[R]emove commands have no meaning, the [I]nstall command performs both of " +"them together." +msgstr "" + +#. type:

+#: guide.sgml:258 +msgid "" +"By default APT will automatically remove the package (.deb) files once they " +"have been successfully installed. To change this behavior place Dselect::" +"clean \"prompt\"; in /etc/apt/apt.conf." +msgstr "" + +#. type: +#: guide.sgml:264 +msgid "The Interface" +msgstr "" + +#. type:

+#: guide.sgml:278 +msgid "" +"Both that APT dselect method and apt-get share the " +"same interface. It is a simple system that generally tells you what it will " +"do and then goes and does it.

The dselect method " +"actually is a set of wrapper scripts to apt-get. The method " +"actually provides more functionality than is present in apt-get " +"alone.

 After printing out a summary of what will happen APT " +"then will print out some informative status messages so that you can " +"estimate how far along it is and how much is left to do." +msgstr "" + +#. type: +#: guide.sgml:280 +msgid "Startup" +msgstr "" + +#. type:

+#: guide.sgml:284 +msgid "" +"Before all operations except update, APT performs a number of actions to " +"prepare its internal state. It also does some checks of the system's state. " +"At any time these operations can be performed by running apt-get check." +msgstr "" + +#. type: +#: guide.sgml:289 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type:

+#: guide.sgml:297 +msgid "" +"The first thing it does is read all the package files into memory. APT uses " +"a caching scheme so this operation will be faster the second time it is run. " +"If some of the package files are not found then they will be ignored and a " +"warning will be printed when apt-get exits." +msgstr "" + +#. type:

+#: guide.sgml:303 +msgid "" +"The final operation performs a detailed analysis of the system's " +"dependencies. It checks every dependency of every installed or unpacked " +"package and considers if it is OK. Should this find a problem then a report " +"will be printed out and apt-get will refuse to run." +msgstr "" + +#. type: +#: guide.sgml:320 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done\n" +"You might want to run apt-get -f install' to correct these.\n" +"Sorry, but the following packages have unmet dependencies:\n" +" 9fonts: Depends: xlib6g but it is not installed\n" +" uucp: Depends: mailx but it is not installed\n" +" blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" adduser: Depends: perl-base but it is not installed\n" +" aumix: Depends: libgpmg1 but it is not installed\n" +" debiandoc-sgml: Depends: sgml-base but it is not installed\n" +" bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n" +" cthugha: Depends: svgalibg1 but it is not installed\n" +" Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)" +msgstr "" + +#. type:

+#: guide.sgml:329 +msgid "" +"In this example the system has many problems, including a serious problem " +"with libreadlineg2. For each package that has unmet dependencies a line is " +"printed out indicating the package with the problem and the dependencies " +"that are unmet. A short explanation of why the package has a dependency " +"problem is also included." +msgstr "" + +#. type:

+#: guide.sgml:337 +msgid "" +"There are two ways a system can get into a broken state like this. The first " +"is caused by dpkg missing some subtle relationships between " +"packages when performing upgrades.

APT however considers all " +"known dependencies and attempts to prevent broken packages

. " +"The second is if a package installation fails during an operation. In this " +"situation a package may have been unpacked without its dependents being " +"installed." +msgstr "" + +#. type:

+#: guide.sgml:345 +msgid "" +"The second situation is much less serious than the first because APT places " +"certain constraints on the order that packages are installed. In both cases " +"supplying the -f option to apt-get will cause APT to " +"deduce a possible solution to the problem and then continue on. The APT " +"dselect method always supplies the -f option to allow " +"for easy continuation of failed maintainer scripts." +msgstr "" + +#. type:

+#: guide.sgml:351 +msgid "" +"However, if the -f option is used to correct a seriously broken " +"system caused by the first case then it is possible that it will either fail " +"immediately or the installation sequence will fail. In either case it is " +"necessary to manually use dpkg (possibly with forcing options) to correct " +"the situation enough to allow APT to proceed." +msgstr "" + +#. type: +#: guide.sgml:356 +msgid "The Status Report" +msgstr "" + +#. type:

+#: guide.sgml:363 +msgid "" +"Before proceeding apt-get will present a report on what will " +"happen. Generally the report reflects the type of operation being performed " +"but there are several common elements. In all cases the lists reflect the " +"final state of things, taking into account the -f option and any " +"other relevant activities to the command being executed." +msgstr "" + +#. type: +#: guide.sgml:364 +msgid "The Extra Package list" +msgstr "" + +#. type: +#: guide.sgml:372 +#, no-wrap +msgid "" +"The following extra packages will be installed:\n" +" libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n" +" mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n" +" bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n" +" squake pgp-i python-base debmake ldso perl libreadlineg2\n" +" ssh" +msgstr "" + +#. type:

+#: guide.sgml:379 +msgid "" +"The Extra Package list shows all of the packages that will be installed or " +"upgraded in excess of the ones mentioned on the command line. It is only " +"generated for an install command. The listed packages are often the " +"result of an Auto Install." +msgstr "" + +#. type: +#: guide.sgml:382 +msgid "The Packages to Remove" +msgstr "" + +#. type: +#: guide.sgml:389 +#, no-wrap +msgid "" +"The following packages will be REMOVED:\n" +" xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n" +" xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n" +" xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n" +" nas xpilot xfig" +msgstr "" + +#. type:

+#: guide.sgml:399 +msgid "" +"The Packages to Remove list shows all of the packages that will be removed " +"from the system. It can be shown for any of the operations and should be " +"given a careful inspection to ensure nothing important is to be taken off. " +"The -f option is especially good at generating packages to remove " +"so extreme care should be used in that case. The list may contain packages " +"that are going to be removed because they are only partially installed, " +"possibly due to an aborted installation." +msgstr "" + +#. type: +#: guide.sgml:402 +msgid "The New Packages list" +msgstr "" + +#. type: +#: guide.sgml:406 +#, no-wrap +msgid "" +"The following NEW packages will installed:\n" +" zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base" +msgstr "" + +#. type:

+#: guide.sgml:411 +msgid "" +"The New Packages list is simply a reminder of what will happen. The packages " +"listed are not presently installed in the system but will be when APT is " +"done." +msgstr "" + +#. type: +#: guide.sgml:414 +msgid "The Kept Back list" +msgstr "" + +#. type: +#: guide.sgml:419 +#, no-wrap +msgid "" +"The following packages have been kept back\n" +" compface man-db tetex-base msql libpaper svgalib1\n" +" gs snmp arena lynx xpat2 groff xscreensaver" +msgstr "" + +#. type:

+#: guide.sgml:428 +msgid "" +"Whenever the whole system is being upgraded there is the possibility that " +"new versions of packages cannot be installed because they require new things " +"or conflict with already installed things. In this case the package will " +"appear in the Kept Back list. The best way to convince packages listed there " +"to install is with apt-get install or by using dselect " +"to resolve their problems." +msgstr "" + +#. type: +#: guide.sgml:431 +msgid "Held Packages warning" +msgstr "" + +#. type: +#: guide.sgml:435 +#, no-wrap +msgid "" +"The following held packages will be changed:\n" +" cvs" +msgstr "" + +#. type:

+#: guide.sgml:441 +msgid "" +"Sometimes you can ask APT to install a package that is on hold, in such a " +"case it prints out a warning that the held package is going to be changed. " +"This should only happen during dist-upgrade or install." +msgstr "" + +#. type: +#: guide.sgml:444 +msgid "Final summary" +msgstr "" + +#. type:

+#: guide.sgml:447 +msgid "" +"Finally, APT will print out a summary of all the changes that will occur." +msgstr "" + +#. type: +#: guide.sgml:452 +#, no-wrap +msgid "" +"206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n" +"12 packages not fully installed or removed.\n" +"Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used." +msgstr "" + +#. type:

+#: guide.sgml:470 +msgid "" +"The first line of the summary simply is a reduced version of all of the " +"lists and includes the number of upgrades - that is packages already " +"installed that have new versions available. The second line indicates the " +"number of poorly configured packages, possibly the result of an aborted " +"installation. The final line shows the space requirements that the " +"installation needs. The first pair of numbers refer to the size of the " +"archive files. The first number indicates the number of bytes that must be " +"fetched from remote locations and the second indicates the total size of all " +"the archives required. The next number indicates the size difference between " +"the presently installed packages and the newly installed packages. It is " +"roughly equivalent to the space required in /usr after everything is done. " +"If a large number of packages are being removed then the value may indicate " +"the amount of space that will be freed." +msgstr "" + +#. type:

+#: guide.sgml:473 +msgid "" +"Some other reports can be generated by using the -u option to show packages " +"to upgrade, they are similar to the previous examples." +msgstr "" + +#. type: +#: guide.sgml:477 +msgid "The Status Display" +msgstr "" + +#. type:

+#: guide.sgml:481 +msgid "" +"During the download of archives and package files APT prints out a series of " +"status messages." +msgstr "" + +#. type: +#: guide.sgml:490 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n" +"Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n" +"Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n" +"Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n" +"11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s" +msgstr "" + +#. type:

+#: guide.sgml:500 +msgid "" +"The lines starting with Get are printed out when APT begins to " +"fetch a file while the last line indicates the progress of the download. The " +"first percent value on the progress line indicates the total percent done of " +"all files. Unfortunately since the size of the Package files is unknown " +"apt-get update estimates the percent done which causes some " +"inaccuracies." +msgstr "" + +#. type:

+#: guide.sgml:509 +msgid "" +"The next section of the status line is repeated once for each download " +"thread and indicates the operation being performed and some useful " +"information about what is happening. Sometimes this section will simply read " +"Forking which means the OS is loading the download module. The " +"first word after the [ is the fetch number as shown on the history lines. " +"The next word is the short form name of the object being downloaded. For " +"archives it will contain the name of the package that is being fetched." +msgstr "" + +#. type:

+#: guide.sgml:524 +msgid "" +"Inside of the single quote is an informative string indicating the progress " +"of the negotiation phase of the download. Typically it progresses from " +"Connecting to Waiting for file to Downloading or " +"Resuming. The final value is the number of bytes downloaded from " +"the remote site. Once the download begins this is represented as " +"102/10.2k indicating that 102 bytes have been fetched and 10.2 " +"kilobytes is expected. The total size is always shown in 4 figure notation " +"to preserve space. After the size display is a percent meter for the file " +"itself. The second last element is the instantaneous average speed. This " +"values is updated every 5 seconds and reflects the rate of data transfer for " +"that period. Finally is shown the estimated transfer time. This is updated " +"regularly and reflects the time to complete everything at the shown transfer " +"rate." +msgstr "" + +#. type:

+#: guide.sgml:530 +msgid "" +"The status display updates every half second to provide a constant feedback " +"on the download progress while the Get lines scroll back whenever a new file " +"is started. Since the status display is constantly updated it is unsuitable " +"for logging to a file, use the -q option to remove the status " +"display." +msgstr "" + +#. type: +#: guide.sgml:535 +msgid "Dpkg" +msgstr "" + +#. type:

+#: guide.sgml:542 +msgid "" +"APT uses dpkg for installing the archives and will switch over " +"to the dpkg interface once downloading is completed. " +"dpkg will also ask a number of questions as it processes the " +"packages and the packages themselves may also ask several questions. Before " +"each question there is usually a description of what it is asking and the " +"questions are too varied to discuss completely here." +msgstr "" + +#. type: +#: offline.sgml:4 +msgid "Using APT Offline" +msgstr "" + +#. type: +#: offline.sgml:7 +msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $" +msgstr "" + +#. type: +#: offline.sgml:12 +msgid "" +"This document describes how to use APT in a non-networked environment, " +"specifically a 'sneaker-net' approach for performing upgrades." +msgstr "" + +#. type: +#: offline.sgml:16 +msgid "Copyright © Jason Gunthorpe, 1999." +msgstr "" + +#. type: +#: offline.sgml:32 +msgid "Introduction" +msgstr "" + +#. type: +#: offline.sgml:34 offline.sgml:65 offline.sgml:180 +#, fuzzy +#| msgid "OverrideDir" +msgid "Overview" +msgstr "OverrideDir" + +#. type:

+#: offline.sgml:40 +msgid "" +"Normally APT requires direct access to a Debian archive, either from a local " +"media or through a network. Another common complaint is that a Debian " +"machine is on a slow link, such as a modem and another machine has a very " +"fast connection but they are physically distant." +msgstr "" + +#. type:

+#: offline.sgml:51 +msgid "" +"The solution to this is to use large removable media such as a Zip disc or a " +"SuperDisk disc. These discs are not large enough to store the entire Debian " +"archive but can easily fit a subset large enough for most users. The idea is " +"to use APT to generate a list of packages that are required and then fetch " +"them onto the disc using another machine with good connectivity. It is even " +"possible to use another Debian machine with APT or to use a completely " +"different OS and a download tool like wget. Let remote host mean " +"the machine downloading the packages, and target host the one with " +"bad or no connection." +msgstr "" + +#. type:

+#: offline.sgml:57 +msgid "" +"This is achieved by creatively manipulating the APT configuration file. The " +"essential premis to tell APT to look on a disc for it's archive files. Note " +"that the disc should be formated with a filesystem that can handle long file " +"names such as ext2, fat32 or vfat." +msgstr "" + +#. type: +#: offline.sgml:63 +msgid "Using APT on both machines" +msgstr "" + +#. type:

+#: offline.sgml:71 +msgid "" +"APT being available on both machines gives the simplest configuration. The " +"basic idea is to place a copy of the status file on the disc and use the " +"remote machine to fetch the latest package files and decide which packages " +"to download. The disk directory structure should look like:" +msgstr "" + +#. type: +#: offline.sgml:80 +#, no-wrap +msgid "" +" /disc/\n" +" archives/\n" +" partial/\n" +" lists/\n" +" partial/\n" +" status\n" +" sources.list\n" +" apt.conf" +msgstr "" + +#. type: +#: offline.sgml:88 +#, fuzzy +#| msgid "User configuration" +msgid "The configuration file" +msgstr "Configuration utilisateur" + +#. type:

+#: offline.sgml:96 +msgid "" +"The configuration file should tell APT to store its files on the disc and to " +"use the configuration files on the disc as well. The sources.list should " +"contain the proper sites that you wish to use from the remote machine, and " +"the status file should be a copy of /var/lib/dpkg/status from the " +"target host. Please note, if you are using a local archive you must " +"use copy URIs, the syntax is identical to file URIs." +msgstr "" + +#. type:

+#: offline.sgml:100 +msgid "" +"apt.conf must contain the necessary information to make APT use the " +"disc:" +msgstr "" + +#. type: +#: offline.sgml:124 +#, no-wrap +msgid "" +" APT\n" +" {\n" +" /* This is not necessary if the two machines are the same arch, it tells\n" +" the remote APT what architecture the target machine is */\n" +" Architecture \"i386\";\n" +" \n" +" Get::Download-Only \"true\";\n" +" };\n" +" \n" +" Dir\n" +" {\n" +" /* Use the disc for state information and redirect the status file from\n" +" the /var/lib/dpkg default */\n" +" State \"/disc/\";\n" +" State::status \"status\";\n" +"\n" +" // Binary caches will be stored locally\n" +" Cache::archives \"/disc/archives/\";\n" +" Cache \"/tmp/\";\n" +" \n" +" // Location of the source list.\n" +" Etc \"/disc/\";\n" +" };" +msgstr "" + +#. type:

+#: offline.sgml:129 +msgid "" +"More details can be seen by examining the apt.conf man page and the sample " +"configuration file in /usr/share/doc/apt/examples/apt.conf." +msgstr "" + +#. type:

+#: offline.sgml:136 +msgid "" +"On the target machine the first thing to do is mount the disc and copy /" +"var/lib/dpkg/status to it. You will also need to create the directories " +"outlined in the Overview, archives/partial/ and lists/partial/ Then take the disc to the remote machine and configure the sources.list. " +"On the remote machine execute the following:" +msgstr "" + +#. type: +#: offline.sgml:142 +#, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get update\n" +" [ APT fetches the package files ]\n" +" # apt-get dist-upgrade\n" +" [ APT fetches all the packages needed to upgrade the target machine ]" +msgstr "" + +#. type:

+#: offline.sgml:149 +msgid "" +"The dist-upgrade command can be replaced with any-other standard APT " +"commands, particularly dselect-upgrade. You can even use an APT front end " +"such as dselect However this presents a problem in communicating " +"your selections back to the local computer." +msgstr "" + +#. type:

+#: offline.sgml:153 +msgid "" +"Now the disc contains all of the index files and archives needed to upgrade " +"the target machine. Take the disc back and run:" +msgstr "" + +#. type: +#: offline.sgml:159 +#, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get check\n" +" [ APT generates a local copy of the cache files ]\n" +" # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n" +" [ Or any other APT command ]" +msgstr "" + +#. type:

+#: offline.sgml:165 +msgid "" +"It is necessary for proper function to re-specify the status file to be the " +"local one. This is very important!" +msgstr "" + +#. type:

+#: offline.sgml:172 +msgid "" +"If you are using dselect you can do the very risky operation of copying disc/" +"status to /var/lib/dpkg/status so that any selections you made on the remote " +"machine are updated. I highly recommend that people only make selections on " +"the local machine - but this may not always be possible. DO NOT copy the " +"status file if dpkg or APT have been run in the mean time!!" +msgstr "" + +#. type: +#: offline.sgml:178 +msgid "Using APT and wget" +msgstr "" + +#. type:

+#: offline.sgml:185 +msgid "" +"wget is a popular and portable download tool that can run on nearly " +"any machine. Unlike the method above this requires that the Debian machine " +"already has a list of available packages." +msgstr "" + +#. type:

+#: offline.sgml:190 +msgid "" +"The basic idea is to create a disc that has only the archive files " +"downloaded from the remote site. This is done by using the --print-uris " +"option to apt-get and then preparing a wget script to actually fetch the " +"packages." +msgstr "" + +#. type: +#: offline.sgml:196 +#, fuzzy +#| msgid "Options" +msgid "Operation" +msgstr "Options" + +#. type:

+#: offline.sgml:200 +msgid "" +"Unlike the previous technique no special configuration files are required. " +"We merely use the standard APT commands to generate the file list." +msgstr "" + +#. type: +#: offline.sgml:205 +#, no-wrap +msgid "" +" # apt-get dist-upgrade \n" +" [ Press no when prompted, make sure you are happy with the actions ]\n" +" # apt-get -qq --print-uris dist-upgrade > uris\n" +" # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script" +msgstr "" + +#. type:

+#: offline.sgml:210 +msgid "" +"Any command other than dist-upgrade could be used here, including dselect-" +"upgrade." +msgstr "" + +#. type:

+#: offline.sgml:216 +msgid "" +"The /disc/wget-script file will now contain a list of wget commands to " +"execute in order to fetch the necessary archives. This script should be run " +"with the current directory as the disc's mount point so as to save the " +"output on the disc." +msgstr "" + +#. type:

+#: offline.sgml:219 +msgid "The remote machine would do something like" +msgstr "" + +#. type: +#: offline.sgml:223 +#, no-wrap +msgid "" +" # cd /disc\n" +" # sh -x ./wget-script\n" +" [ wait.. ]" +msgstr "" + +#. type: +#: offline.sgml:228 +msgid "" +"Once the archives are downloaded and the disc returned to the Debian machine " +"installation can proceed using," +msgstr "" + +#. type: +#: offline.sgml:230 +#, no-wrap +msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade" +msgstr "" + +#. type:

+#: offline.sgml:234 +msgid "Which will use the already fetched archives on the disc." +msgstr "" + #~ msgid "/etc/apt/sources.list" #~ msgstr "/etc/apt/sources.list" diff --git a/doc/po/ja.po b/doc/po/ja.po index ca5ccef2b..0cceb0909 100644 --- a/doc/po/ja.po +++ b/doc/po/ja.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2009-09-26 11:35+0300\n" +"POT-Creation-Date: 2009-10-01 18:09+0300\n" "PO-Revision-Date: 2009-07-30 22:55+0900\n" "Last-Translator: KURASAWA Nozomu \n" "Language-Team: LANGUAGE \n" @@ -1579,7 +1579,7 @@ msgstr "" #. type: Content of: #: apt-cache.8.xml:234 msgid "" -"Note that a package which APT knows of is not nessasarily available to " +"Note that a package which APT knows of is not necessarily available to " "download, installable or installed, e.g. virtual packages are also listed in " "the generated list." msgstr "" @@ -3708,8 +3708,8 @@ msgstr "" "November 2008" # type: Content of: -#. type: Content of: -#: apt-get.8.xml:22 apt-get.8.xml:29 +#. type: +#: apt-get.8.xml:22 apt-get.8.xml:29 guide.sgml:96 msgid "apt-get" msgstr "apt-get" @@ -3858,8 +3858,8 @@ msgstr "" "のサイズを知ることができないため、全体の進捗メータは正しく表示されません。" # type: -#. type: Content of: -#: apt-get.8.xml:147 +#. type: +#: apt-get.8.xml:147 guide.sgml:121 msgid "upgrade" msgstr "upgrade" @@ -3912,8 +3912,8 @@ msgstr "" "ど)" # type: -#. type: Content of: -#: apt-get.8.xml:170 +#. type: +#: apt-get.8.xml:170 guide.sgml:140 msgid "dist-upgrade" msgstr "dist-upgrade" @@ -3942,8 +3942,8 @@ msgstr "" "さい。" # type: -#. type: Content of: -#: apt-get.8.xml:183 +#. type: +#: apt-get.8.xml:183 guide.sgml:131 msgid "install" msgstr "install" @@ -4107,7 +4107,7 @@ msgid "" "package to fetch. It will then find and download into the current directory " "the newest available version of that source package while respect the " "default release, set with the option APT::Default-Release, the option or per package with with the " +"literal>, the option or per package with the " "pkg/release syntax, if possible." msgstr "" "source は、ソースパッケージを取得するのに apt-" @@ -9292,6 +9292,1138 @@ msgstr "" msgid "&apt-cache; &apt-conf;" msgstr "&apt-cache; &apt-conf;" +#. type: +#: guide.sgml:4 +msgid "APT User's Guide" +msgstr "" + +# type: +#. type: +#: guide.sgml:6 offline.sgml:6 +msgid "Jason Gunthorpe jgg@debian.org" +msgstr "Jason Gunthorpe jgg@debian.org" + +#. type: +#: guide.sgml:7 +msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $" +msgstr "" + +#. type: +#: guide.sgml:11 +msgid "" +"This document provides an overview of how to use the the APT package manager." +msgstr "" + +# type: +#. type: +#: guide.sgml:15 +#, fuzzy +msgid "Copyright © Jason Gunthorpe, 1998." +msgstr "Copyright © Jason Gunthorpe, 1999." + +#. type:

+#: guide.sgml:21 offline.sgml:22 +msgid "" +"\"APT\" and this document are free software; you can redistribute them and/" +"or modify them 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." +msgstr "" + +#. type:

+#: guide.sgml:24 offline.sgml:25 +msgid "" +"For more details, on Debian GNU/Linux systems, see the file /usr/share/" +"common-licenses/GPL for the full license." +msgstr "" + +#. type: +#: guide.sgml:32 +#, fuzzy +msgid "General" +msgstr "generate" + +#. type:

+#: guide.sgml:38 +msgid "" +"The APT package currently contains two sections, the APT dselect method and the apt-get command line user interface. Both " +"provide a way to install and remove packages as well as download new " +"packages from the Internet." +msgstr "" + +# type: Content of: +#. type: +#: guide.sgml:39 +#, fuzzy +msgid "Anatomy of the Package System" +msgstr "パッケージ名" + +#. type:

+#: guide.sgml:44 +msgid "" +"The Debian packaging system has a large amount of information associated " +"with each package to help assure that it integrates cleanly and easily into " +"the system. The most prominent of its features is the dependency system." +msgstr "" + +#. type:

+#: guide.sgml:52 +msgid "" +"The dependency system allows individual programs to make use of shared " +"elements in the system such as libraries. It simplifies placing infrequently " +"used portions of a program in separate packages to reduce the number of " +"things the average user is required to install. Also, it allows for choices " +"in mail transport agents, X servers and so on." +msgstr "" + +#. type:

+#: guide.sgml:57 +msgid "" +"The first step to understanding the dependency system is to grasp the " +"concept of a simple dependency. The meaning of a simple dependency is that a " +"package requires another package to be installed at the same time to work " +"properly." +msgstr "" + +#. type:

+#: guide.sgml:63 +msgid "" +"For instance, mailcrypt is an emacs extension that aids in encrypting email " +"with GPG. Without GPGP installed mail-crypt is useless, so mailcrypt has a " +"simple dependency on GPG. Also, because it is an emacs extension it has a " +"simple dependency on emacs, without emacs it is completely useless." +msgstr "" + +#. type:

+#: guide.sgml:73 +msgid "" +"The other important dependency to understand is a conflicting dependency. It " +"means that a package, when installed with another package, will not work and " +"may possibly be extremely harmful to the system. As an example consider a " +"mail transport agent such as sendmail, exim or qmail. It is not possible to " +"have two mail transport agents installed because both need to listen to the " +"network to receive mail. Attempting to install two will seriously damage the " +"system so all mail transport agents have a conflicting dependency with all " +"other mail transport agents." +msgstr "" + +#. type:

+#: guide.sgml:83 +msgid "" +"As an added complication there is the possibility for a package to pretend " +"to be another package. Consider that exim and sendmail for many intents are " +"identical, they both deliver mail and understand a common interface. Hence, " +"the package system has a way for them to declare that they are both mail-" +"transport-agents. So, exim and sendmail both declare that they provide a " +"mail-transport-agent and other packages that need a mail transport agent " +"depend on mail-transport-agent. This can add a great deal of confusion when " +"trying to manually fix packages." +msgstr "" + +#. type:

+#: guide.sgml:88 +msgid "" +"At any given time a single dependency may be met by packages that are " +"already installed or it may not be. APT attempts to help resolve dependency " +"issues by providing a number of automatic algorithms that help in selecting " +"packages for installation." +msgstr "" + +#. type:

+#: guide.sgml:102 +msgid "" +"apt-get provides a simple way to install packages from the " +"command line. Unlike dpkg, apt-get does not " +"understand .deb files, it works with the package's proper name and can only " +"install .deb archives from a Source." +msgstr "" + +#. type:

+#: guide.sgml:109 +msgid "" +"The first

If you are using an http proxy server you must set " +"the http_proxy environment variable first, see sources.list(5)

thing that should be done before using apt-get is to " +"fetch the package lists from the Sources so that it knows what " +"packages are available. This is done with apt-get update. For " +"instance," +msgstr "" + +#. type: +#: guide.sgml:116 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n" +"Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type:

+#: guide.sgml:120 +msgid "Once updated there are several commands that can be used:" +msgstr "" + +#. type:

+#: guide.sgml:131 +msgid "" +"Upgrade will attempt to gently upgrade the whole system. Upgrade will never " +"install a new package or remove an existing package, nor will it ever " +"upgrade a package that might cause some other package to break. This can be " +"used daily to relatively safely upgrade the system. Upgrade will list all of " +"the packages that it could not upgrade, this usually means that they depend " +"on new packages or conflict with some other package. dselect or " +"apt-get install can be used to force these packages to install." +msgstr "" + +#. type:

+#: guide.sgml:140 +msgid "" +"Install is used to install packages by name. The package is automatically " +"fetched and installed. This can be useful if you already know the name of " +"the package to install and do not want to go into a GUI to select it. Any " +"number of packages may be passed to install, they will all be fetched. " +"Install automatically attempts to resolve dependency problems with the " +"listed packages and will print a summary and ask for confirmation if " +"anything other than its arguments are changed." +msgstr "" + +#. type:

+#: guide.sgml:149 +msgid "" +"Dist-upgrade is a complete upgrader designed to simplify upgrading between " +"releases of Debian. It uses a sophisticated algorithm to determine the best " +"set of packages to install, upgrade and remove to get as much of the system " +"to the newest release. In some situations it may be desired to use dist-" +"upgrade rather than spend the time manually resolving dependencies in " +"dselect. Once dist-upgrade has completed then dselect can be used to install any packages that may have been left out." +msgstr "" + +#. type:

+#: guide.sgml:152 +msgid "" +"It is important to closely look at what dist-upgrade is going to do, its " +"decisions may sometimes be quite surprising." +msgstr "" + +#. type:

+#: guide.sgml:163 +msgid "" +"apt-get has several command line options that are detailed in " +"its man page, . The most useful " +"option is -d which does not install the fetched files. If the " +"system has to download a large number of package it would be undesired to " +"start installing them in case something goes wrong. When -d is used " +"the downloaded archives can be installed by simply running the command that " +"caused them to be downloaded again without -d." +msgstr "" + +# type: Content of: +#. type: <heading></heading> +#: guide.sgml:168 +msgid "DSelect" +msgstr "DSelect" + +#. type: <p></p> +#: guide.sgml:173 +msgid "" +"The APT <prgn>dselect</prgn> method provides the complete APT system with " +"the <prgn>dselect</prgn> package selection GUI. <prgn>dselect</prgn> is used " +"to select the packages to be installed or removed and APT actually installs " +"them." +msgstr "" + +#. type: <p></p> +#: guide.sgml:184 +msgid "" +"To enable the APT method you need to to select [A]ccess in <prgn>dselect</" +"prgn> and then choose the APT method. You will be prompted for a set of " +"<em>Sources</em> which are places to fetch archives from. These can be " +"remote Internet sites, local Debian mirrors or CDROMs. Each source can " +"provide a fragment of the total Debian archive, APT will automatically " +"combine them to form a complete set of packages. If you have a CDROM then it " +"is a good idea to specify it first and then specify a mirror so that you " +"have access to the latest bug fixes. APT will automatically use packages on " +"your CDROM before downloading from the Internet." +msgstr "" + +#. type: <example></example> +#: guide.sgml:198 +#, no-wrap +msgid "" +" Set up a list of distribution source locations\n" +"\t \n" +" Please give the base URL of the debian distribution.\n" +" The access schemes I know about are: http file\n" +"\t \n" +" For example:\n" +" file:/mnt/debian,\n" +" ftp://ftp.debian.org/debian,\n" +" http://ftp.de.debian.org/debian,\n" +" \n" +" \n" +" URL [http://llug.sep.bnl.gov/debian]:" +msgstr "" + +#. type: <p></p> +#: guide.sgml:205 +msgid "" +"The <em>Sources</em> setup starts by asking for the base of the Debian " +"archive, defaulting to a HTTP mirror. Next it asks for the distribution to " +"get." +msgstr "" + +#. type: <example></example> +#: guide.sgml:212 +#, no-wrap +msgid "" +" Please give the distribution tag to get or a path to the\n" +" package file ending in a /. The distribution\n" +" tags are typically something like: stable unstable testing non-US\n" +" \n" +" Distribution [stable]:" +msgstr "" + +#. type: <p></p> +#: guide.sgml:222 +msgid "" +"The distribution refers to the Debian version in the archive, <em>stable</" +"em> refers to the latest released version and <em>unstable</em> refers to " +"the developmental version. <em>non-US</em> is only available on some mirrors " +"and refers to packages that contain encryption technology or other things " +"that cannot be exported from the United States. Importing these packages " +"into the US is legal however." +msgstr "" + +#. type: <example></example> +#: guide.sgml:228 +#, no-wrap +msgid "" +" Please give the components to get\n" +" The components are typically something like: main contrib non-free\n" +" \n" +" Components [main contrib non-free]:" +msgstr "" + +#. type: <p></p> +#: guide.sgml:236 +msgid "" +"The components list refers to the list of sub distributions to fetch. The " +"distribution is split up based on software licenses, main being DFSG free " +"packages while contrib and non-free contain things that have various " +"restrictions placed on their use and distribution." +msgstr "" + +#. type: <p></p> +#: guide.sgml:240 +msgid "" +"Any number of sources can be added, the setup script will continue to prompt " +"until you have specified all that you want." +msgstr "" + +#. type: <p></p> +#: guide.sgml:247 +msgid "" +"Before starting to use <prgn>dselect</prgn> it is necessary to update the " +"available list by selecting [U]pdate from the menu. This is a super-set of " +"<tt>apt-get update</tt> that makes the fetched information available to " +"<prgn>dselect</prgn>. [U]pdate must be performed even if <tt>apt-get update</" +"tt> has been run before." +msgstr "" + +#. type: <p></p> +#: guide.sgml:253 +msgid "" +"You can then go on and make your selections using [S]elect and then perform " +"the installation using [I]nstall. When using the APT method the [C]onfig and " +"[R]emove commands have no meaning, the [I]nstall command performs both of " +"them together." +msgstr "" + +#. type: <p></p> +#: guide.sgml:258 +msgid "" +"By default APT will automatically remove the package (.deb) files once they " +"have been successfully installed. To change this behavior place <tt>Dselect::" +"clean \"prompt\";</tt> in /etc/apt/apt.conf." +msgstr "" + +# type: <tag></tag> +#. type: <heading></heading> +#: guide.sgml:264 +#, fuzzy +msgid "The Interface" +msgstr "メソッドインスタンス" + +#. type: <p></p> +#: guide.sgml:278 +msgid "" +"Both that APT <prgn>dselect</prgn> method and <prgn>apt-get</prgn> share the " +"same interface. It is a simple system that generally tells you what it will " +"do and then goes and does it. <footnote><p>The <prgn>dselect</prgn> method " +"actually is a set of wrapper scripts to <prgn>apt-get</prgn>. The method " +"actually provides more functionality than is present in <prgn>apt-get</prgn> " +"alone.</p></footnote> After printing out a summary of what will happen APT " +"then will print out some informative status messages so that you can " +"estimate how far along it is and how much is left to do." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:280 +msgid "Startup" +msgstr "" + +#. type: <p></p> +#: guide.sgml:284 +msgid "" +"Before all operations except update, APT performs a number of actions to " +"prepare its internal state. It also does some checks of the system's state. " +"At any time these operations can be performed by running <tt>apt-get check</" +"tt>." +msgstr "" + +#. type: <example></example> +#: guide.sgml:289 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done" +msgstr "" + +#. type: <p></p> +#: guide.sgml:297 +msgid "" +"The first thing it does is read all the package files into memory. APT uses " +"a caching scheme so this operation will be faster the second time it is run. " +"If some of the package files are not found then they will be ignored and a " +"warning will be printed when apt-get exits." +msgstr "" + +#. type: <p></p> +#: guide.sgml:303 +msgid "" +"The final operation performs a detailed analysis of the system's " +"dependencies. It checks every dependency of every installed or unpacked " +"package and considers if it is OK. Should this find a problem then a report " +"will be printed out and <prgn>apt-get</prgn> will refuse to run." +msgstr "" + +#. type: <example></example> +#: guide.sgml:320 +#, no-wrap +msgid "" +"# apt-get check\n" +"Reading Package Lists... Done\n" +"Building Dependency Tree... Done\n" +"You might want to run apt-get -f install' to correct these.\n" +"Sorry, but the following packages have unmet dependencies:\n" +" 9fonts: Depends: xlib6g but it is not installed\n" +" uucp: Depends: mailx but it is not installed\n" +" blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" adduser: Depends: perl-base but it is not installed\n" +" aumix: Depends: libgpmg1 but it is not installed\n" +" debiandoc-sgml: Depends: sgml-base but it is not installed\n" +" bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n" +" cthugha: Depends: svgalibg1 but it is not installed\n" +" Depends: xlib6g (>= 3.3-5) but it is not installed\n" +" libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)" +msgstr "" + +#. type: <p></p> +#: guide.sgml:329 +msgid "" +"In this example the system has many problems, including a serious problem " +"with libreadlineg2. For each package that has unmet dependencies a line is " +"printed out indicating the package with the problem and the dependencies " +"that are unmet. A short explanation of why the package has a dependency " +"problem is also included." +msgstr "" + +#. type: <p></p> +#: guide.sgml:337 +msgid "" +"There are two ways a system can get into a broken state like this. The first " +"is caused by <prgn>dpkg</prgn> missing some subtle relationships between " +"packages when performing upgrades. <footnote><p>APT however considers all " +"known dependencies and attempts to prevent broken packages</p></footnote>. " +"The second is if a package installation fails during an operation. In this " +"situation a package may have been unpacked without its dependents being " +"installed." +msgstr "" + +#. type: <p></p> +#: guide.sgml:345 +msgid "" +"The second situation is much less serious than the first because APT places " +"certain constraints on the order that packages are installed. In both cases " +"supplying the <tt>-f</tt> option to <prgn>apt-get</prgn> will cause APT to " +"deduce a possible solution to the problem and then continue on. The APT " +"<prgn>dselect</prgn> method always supplies the <tt>-f</tt> option to allow " +"for easy continuation of failed maintainer scripts." +msgstr "" + +#. type: <p></p> +#: guide.sgml:351 +msgid "" +"However, if the <tt>-f</tt> option is used to correct a seriously broken " +"system caused by the first case then it is possible that it will either fail " +"immediately or the installation sequence will fail. In either case it is " +"necessary to manually use dpkg (possibly with forcing options) to correct " +"the situation enough to allow APT to proceed." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:356 +msgid "The Status Report" +msgstr "" + +#. type: <p></p> +#: guide.sgml:363 +msgid "" +"Before proceeding <prgn>apt-get</prgn> will present a report on what will " +"happen. Generally the report reflects the type of operation being performed " +"but there are several common elements. In all cases the lists reflect the " +"final state of things, taking into account the <tt>-f</tt> option and any " +"other relevant activities to the command being executed." +msgstr "" + +# type: <tag></tag> +#. type: <heading></heading> +#: guide.sgml:364 +#, fuzzy +msgid "The Extra Package list" +msgstr "NextPackage" + +#. type: <example></example> +#: guide.sgml:372 +#, no-wrap +msgid "" +"The following extra packages will be installed:\n" +" libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n" +" mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n" +" bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n" +" squake pgp-i python-base debmake ldso perl libreadlineg2\n" +" ssh" +msgstr "" + +#. type: <p></p> +#: guide.sgml:379 +msgid "" +"The Extra Package list shows all of the packages that will be installed or " +"upgraded in excess of the ones mentioned on the command line. It is only " +"generated for an <tt>install</tt> command. The listed packages are often the " +"result of an Auto Install." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:382 +msgid "The Packages to Remove" +msgstr "" + +#. type: <example></example> +#: guide.sgml:389 +#, no-wrap +msgid "" +"The following packages will be REMOVED:\n" +" xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n" +" xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n" +" xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n" +" nas xpilot xfig" +msgstr "" + +#. type: <p></p> +#: guide.sgml:399 +msgid "" +"The Packages to Remove list shows all of the packages that will be removed " +"from the system. It can be shown for any of the operations and should be " +"given a careful inspection to ensure nothing important is to be taken off. " +"The <tt>-f</tt> option is especially good at generating packages to remove " +"so extreme care should be used in that case. The list may contain packages " +"that are going to be removed because they are only partially installed, " +"possibly due to an aborted installation." +msgstr "" + +# type: <tag></tag> +#. type: <heading></heading> +#: guide.sgml:402 +#, fuzzy +msgid "The New Packages list" +msgstr "NextPackage" + +#. type: <example></example> +#: guide.sgml:406 +#, no-wrap +msgid "" +"The following NEW packages will installed:\n" +" zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base" +msgstr "" + +#. type: <p></p> +#: guide.sgml:411 +msgid "" +"The New Packages list is simply a reminder of what will happen. The packages " +"listed are not presently installed in the system but will be when APT is " +"done." +msgstr "" + +# type: <tag></tag> +#. type: <heading></heading> +#: guide.sgml:414 +#, fuzzy +msgid "The Kept Back list" +msgstr "NextPackage" + +#. type: <example></example> +#: guide.sgml:419 +#, no-wrap +msgid "" +"The following packages have been kept back\n" +" compface man-db tetex-base msql libpaper svgalib1\n" +" gs snmp arena lynx xpat2 groff xscreensaver" +msgstr "" + +#. type: <p></p> +#: guide.sgml:428 +msgid "" +"Whenever the whole system is being upgraded there is the possibility that " +"new versions of packages cannot be installed because they require new things " +"or conflict with already installed things. In this case the package will " +"appear in the Kept Back list. The best way to convince packages listed there " +"to install is with <tt>apt-get install</tt> or by using <prgn>dselect</prgn> " +"to resolve their problems." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:431 +msgid "Held Packages warning" +msgstr "" + +#. type: <example></example> +#: guide.sgml:435 +#, no-wrap +msgid "" +"The following held packages will be changed:\n" +" cvs" +msgstr "" + +#. type: <p></p> +#: guide.sgml:441 +msgid "" +"Sometimes you can ask APT to install a package that is on hold, in such a " +"case it prints out a warning that the held package is going to be changed. " +"This should only happen during dist-upgrade or install." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:444 +msgid "Final summary" +msgstr "" + +#. type: <p></p> +#: guide.sgml:447 +msgid "" +"Finally, APT will print out a summary of all the changes that will occur." +msgstr "" + +#. type: <example></example> +#: guide.sgml:452 +#, no-wrap +msgid "" +"206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n" +"12 packages not fully installed or removed.\n" +"Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used." +msgstr "" + +#. type: <p></p> +#: guide.sgml:470 +msgid "" +"The first line of the summary simply is a reduced version of all of the " +"lists and includes the number of upgrades - that is packages already " +"installed that have new versions available. The second line indicates the " +"number of poorly configured packages, possibly the result of an aborted " +"installation. The final line shows the space requirements that the " +"installation needs. The first pair of numbers refer to the size of the " +"archive files. The first number indicates the number of bytes that must be " +"fetched from remote locations and the second indicates the total size of all " +"the archives required. The next number indicates the size difference between " +"the presently installed packages and the newly installed packages. It is " +"roughly equivalent to the space required in /usr after everything is done. " +"If a large number of packages are being removed then the value may indicate " +"the amount of space that will be freed." +msgstr "" + +#. type: <p></p> +#: guide.sgml:473 +msgid "" +"Some other reports can be generated by using the -u option to show packages " +"to upgrade, they are similar to the previous examples." +msgstr "" + +#. type: <heading></heading> +#: guide.sgml:477 +msgid "The Status Display" +msgstr "" + +#. type: <p></p> +#: guide.sgml:481 +msgid "" +"During the download of archives and package files APT prints out a series of " +"status messages." +msgstr "" + +#. type: <example></example> +#: guide.sgml:490 +#, no-wrap +msgid "" +"# apt-get update\n" +"Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n" +"Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n" +"Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n" +"Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n" +"Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n" +"11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s" +msgstr "" + +#. type: <p></p> +#: guide.sgml:500 +msgid "" +"The lines starting with <em>Get</em> are printed out when APT begins to " +"fetch a file while the last line indicates the progress of the download. The " +"first percent value on the progress line indicates the total percent done of " +"all files. Unfortunately since the size of the Package files is unknown " +"<tt>apt-get update</tt> estimates the percent done which causes some " +"inaccuracies." +msgstr "" + +#. type: <p></p> +#: guide.sgml:509 +msgid "" +"The next section of the status line is repeated once for each download " +"thread and indicates the operation being performed and some useful " +"information about what is happening. Sometimes this section will simply read " +"<em>Forking</em> which means the OS is loading the download module. The " +"first word after the [ is the fetch number as shown on the history lines. " +"The next word is the short form name of the object being downloaded. For " +"archives it will contain the name of the package that is being fetched." +msgstr "" + +#. type: <p></p> +#: guide.sgml:524 +msgid "" +"Inside of the single quote is an informative string indicating the progress " +"of the negotiation phase of the download. Typically it progresses from " +"<em>Connecting</em> to <em>Waiting for file</em> to <em>Downloading</em> or " +"<em>Resuming</em>. The final value is the number of bytes downloaded from " +"the remote site. Once the download begins this is represented as " +"<tt>102/10.2k</tt> indicating that 102 bytes have been fetched and 10.2 " +"kilobytes is expected. The total size is always shown in 4 figure notation " +"to preserve space. After the size display is a percent meter for the file " +"itself. The second last element is the instantaneous average speed. This " +"values is updated every 5 seconds and reflects the rate of data transfer for " +"that period. Finally is shown the estimated transfer time. This is updated " +"regularly and reflects the time to complete everything at the shown transfer " +"rate." +msgstr "" + +#. type: <p></p> +#: guide.sgml:530 +msgid "" +"The status display updates every half second to provide a constant feedback " +"on the download progress while the Get lines scroll back whenever a new file " +"is started. Since the status display is constantly updated it is unsuitable " +"for logging to a file, use the <tt>-q</tt> option to remove the status " +"display." +msgstr "" + +# type: <heading></heading> +#. type: <heading></heading> +#: guide.sgml:535 +msgid "Dpkg" +msgstr "Dpkg" + +#. type: <p></p> +#: guide.sgml:542 +msgid "" +"APT uses <prgn>dpkg</prgn> for installing the archives and will switch over " +"to the <prgn>dpkg</prgn> interface once downloading is completed. " +"<prgn>dpkg</prgn> will also ask a number of questions as it processes the " +"packages and the packages themselves may also ask several questions. Before " +"each question there is usually a description of what it is asking and the " +"questions are too varied to discuss completely here." +msgstr "" + +# type: <title> +#. type: +#: offline.sgml:4 +msgid "Using APT Offline" +msgstr "オフラインでの APT の使用法" + +#. type: +#: offline.sgml:7 +msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $" +msgstr "" + +# type: +#. type: +#: offline.sgml:12 +msgid "" +"This document describes how to use APT in a non-networked environment, " +"specifically a 'sneaker-net' approach for performing upgrades." +msgstr "" +"このドキュメントはネットワークがない環境での APT の使用方法を説明しています。" +"具体的には、アップグレード時に「スニーカーネット」アプローチです。" + +# type: +#. type: +#: offline.sgml:16 +msgid "Copyright © Jason Gunthorpe, 1999." +msgstr "Copyright © Jason Gunthorpe, 1999." + +# type: Content of: +#. type: <heading></heading> +#: offline.sgml:32 +msgid "Introduction" +msgstr "はじめに" + +#. type: <heading></heading> +#: offline.sgml:34 offline.sgml:65 offline.sgml:180 +#, fuzzy +msgid "Overview" +msgstr "OverrideDir" + +#. type: <p></p> +#: offline.sgml:40 +msgid "" +"Normally APT requires direct access to a Debian archive, either from a local " +"media or through a network. Another common complaint is that a Debian " +"machine is on a slow link, such as a modem and another machine has a very " +"fast connection but they are physically distant." +msgstr "" + +#. type: <p></p> +#: offline.sgml:51 +msgid "" +"The solution to this is to use large removable media such as a Zip disc or a " +"SuperDisk disc. These discs are not large enough to store the entire Debian " +"archive but can easily fit a subset large enough for most users. The idea is " +"to use APT to generate a list of packages that are required and then fetch " +"them onto the disc using another machine with good connectivity. It is even " +"possible to use another Debian machine with APT or to use a completely " +"different OS and a download tool like wget. Let <em>remote host</em> mean " +"the machine downloading the packages, and <em>target host</em> the one with " +"bad or no connection." +msgstr "" + +#. type: <p></p> +#: offline.sgml:57 +msgid "" +"This is achieved by creatively manipulating the APT configuration file. The " +"essential premis to tell APT to look on a disc for it's archive files. Note " +"that the disc should be formated with a filesystem that can handle long file " +"names such as ext2, fat32 or vfat." +msgstr "" + +# type: <title> +#. type: +#: offline.sgml:63 +#, fuzzy +msgid "Using APT on both machines" +msgstr "オフラインでの APT の使用法" + +#. type:

+#: offline.sgml:71 +msgid "" +"APT being available on both machines gives the simplest configuration. The " +"basic idea is to place a copy of the status file on the disc and use the " +"remote machine to fetch the latest package files and decide which packages " +"to download. The disk directory structure should look like:" +msgstr "" + +# type: +#. type: +#: offline.sgml:80 +#, no-wrap +msgid "" +" /disc/\n" +" archives/\n" +" partial/\n" +" lists/\n" +" partial/\n" +" status\n" +" sources.list\n" +" apt.conf" +msgstr "" +" /disc/\n" +" archives/\n" +" partial/\n" +" lists/\n" +" partial/\n" +" status\n" +" sources.list\n" +" apt.conf" + +# type: Content of: +#. type: <heading></heading> +#: offline.sgml:88 +#, fuzzy +msgid "The configuration file" +msgstr "ユーザの設定" + +#. type: <p></p> +#: offline.sgml:96 +msgid "" +"The configuration file should tell APT to store its files on the disc and to " +"use the configuration files on the disc as well. The sources.list should " +"contain the proper sites that you wish to use from the remote machine, and " +"the status file should be a copy of <em>/var/lib/dpkg/status</em> from the " +"<em>target host</em>. Please note, if you are using a local archive you must " +"use copy URIs, the syntax is identical to file URIs." +msgstr "" + +#. type: <p><example> +#: offline.sgml:100 +msgid "" +"<em>apt.conf</em> must contain the necessary information to make APT use the " +"disc:" +msgstr "" + +# type: <example></example> +#. type: <example></example> +#: offline.sgml:124 +#, fuzzy, no-wrap +msgid "" +" APT\n" +" {\n" +" /* This is not necessary if the two machines are the same arch, it tells\n" +" the remote APT what architecture the target machine is */\n" +" Architecture \"i386\";\n" +" \n" +" Get::Download-Only \"true\";\n" +" };\n" +" \n" +" Dir\n" +" {\n" +" /* Use the disc for state information and redirect the status file from\n" +" the /var/lib/dpkg default */\n" +" State \"/disc/\";\n" +" State::status \"status\";\n" +"\n" +" // Binary caches will be stored locally\n" +" Cache::archives \"/disc/archives/\";\n" +" Cache \"/tmp/\";\n" +" \n" +" // Location of the source list.\n" +" Etc \"/disc/\";\n" +" };" +msgstr "" +" APT\n" +" {\n" +" /* This is not necessary if the two machines are the same arch, it tells\n" +" the remote APT what architecture the Debian machine is */\n" +" Architecture \"i386\";\n" +" \n" +" Get::Download-Only \"true\";\n" +" };\n" +" \n" +" Dir\n" +" {\n" +" /* Use the disc for state information and redirect the status file from\n" +" the /var/lib/dpkg default */\n" +" State \"/disc/\";\n" +" State::status \"status\";\n" +"\n" +" // Binary caches will be stored locally\n" +" Cache::archives \"/disc/archives/\";\n" +" Cache \"/tmp/\";\n" +" \n" +" // Location of the source list.\n" +" Etc \"/disc/\";\n" +" };" + +#. type: </example></p> +#: offline.sgml:129 +msgid "" +"More details can be seen by examining the apt.conf man page and the sample " +"configuration file in <em>/usr/share/doc/apt/examples/apt.conf</em>." +msgstr "" + +#. type: <p><example> +#: offline.sgml:136 +msgid "" +"On the target machine the first thing to do is mount the disc and copy <em>/" +"var/lib/dpkg/status</em> to it. You will also need to create the directories " +"outlined in the Overview, <em>archives/partial/</em> and <em>lists/partial/</" +"em> Then take the disc to the remote machine and configure the sources.list. " +"On the remote machine execute the following:" +msgstr "" + +# type: <example></example> +#. type: <example></example> +#: offline.sgml:142 +#, fuzzy, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get update\n" +" [ APT fetches the package files ]\n" +" # apt-get dist-upgrade\n" +" [ APT fetches all the packages needed to upgrade the target machine ]" +msgstr "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get update\n" +" [ パッケージファイルを取得します ]\n" +" # apt-get dist-upgrade\n" +" [ アップグレードが必要な全パッケージを取得します ]" + +#. type: </example></p> +#: offline.sgml:149 +msgid "" +"The dist-upgrade command can be replaced with any-other standard APT " +"commands, particularly dselect-upgrade. You can even use an APT front end " +"such as <em>dselect</em> However this presents a problem in communicating " +"your selections back to the local computer." +msgstr "" + +#. type: <p><example> +#: offline.sgml:153 +msgid "" +"Now the disc contains all of the index files and archives needed to upgrade " +"the target machine. Take the disc back and run:" +msgstr "" + +# type: <example></example> +#. type: <example></example> +#: offline.sgml:159 +#, fuzzy, no-wrap +msgid "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get check\n" +" [ APT generates a local copy of the cache files ]\n" +" # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n" +" [ Or any other APT command ]" +msgstr "" +" # export APT_CONFIG=\"/disc/apt.conf\"\n" +" # apt-get update\n" +" [ パッケージファイルを取得します ]\n" +" # apt-get dist-upgrade\n" +" [ アップグレードが必要な全パッケージを取得します ]" + +#. type: <p></p> +#: offline.sgml:165 +msgid "" +"It is necessary for proper function to re-specify the status file to be the " +"local one. This is very important!" +msgstr "" + +#. type: <p></p> +#: offline.sgml:172 +msgid "" +"If you are using dselect you can do the very risky operation of copying disc/" +"status to /var/lib/dpkg/status so that any selections you made on the remote " +"machine are updated. I highly recommend that people only make selections on " +"the local machine - but this may not always be possible. DO NOT copy the " +"status file if dpkg or APT have been run in the mean time!!" +msgstr "" + +# type: <title> +#. type: +#: offline.sgml:178 +#, fuzzy +msgid "Using APT and wget" +msgstr "オフラインでの APT の使用法" + +#. type:

+#: offline.sgml:185 +msgid "" +"wget is a popular and portable download tool that can run on nearly " +"any machine. Unlike the method above this requires that the Debian machine " +"already has a list of available packages." +msgstr "" + +#. type:

+#: offline.sgml:190 +msgid "" +"The basic idea is to create a disc that has only the archive files " +"downloaded from the remote site. This is done by using the --print-uris " +"option to apt-get and then preparing a wget script to actually fetch the " +"packages." +msgstr "" + +# type: Content of: +#. type: <heading></heading> +#: offline.sgml:196 +#, fuzzy +msgid "Operation" +msgstr "オプション" + +#. type: <p><example> +#: offline.sgml:200 +msgid "" +"Unlike the previous technique no special configuration files are required. " +"We merely use the standard APT commands to generate the file list." +msgstr "" + +#. type: <example></example> +#: offline.sgml:205 +#, no-wrap +msgid "" +" # apt-get dist-upgrade \n" +" [ Press no when prompted, make sure you are happy with the actions ]\n" +" # apt-get -qq --print-uris dist-upgrade > uris\n" +" # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script" +msgstr "" + +#. type: </example></p> +#: offline.sgml:210 +msgid "" +"Any command other than dist-upgrade could be used here, including dselect-" +"upgrade." +msgstr "" + +#. type: <p></p> +#: offline.sgml:216 +msgid "" +"The /disc/wget-script file will now contain a list of wget commands to " +"execute in order to fetch the necessary archives. This script should be run " +"with the current directory as the disc's mount point so as to save the " +"output on the disc." +msgstr "" + +#. type: <p><example> +#: offline.sgml:219 +msgid "The remote machine would do something like" +msgstr "" + +#. type: <example></example> +#: offline.sgml:223 +#, no-wrap +msgid "" +" # cd /disc\n" +" # sh -x ./wget-script\n" +" [ wait.. ]" +msgstr "" + +#. type: </example><example> +#: offline.sgml:228 +msgid "" +"Once the archives are downloaded and the disc returned to the Debian machine " +"installation can proceed using," +msgstr "" + +#. type: <example></example> +#: offline.sgml:230 +#, no-wrap +msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade" +msgstr "" + +#. type: </example></p> +#: offline.sgml:234 +msgid "Which will use the already fetched archives on the disc." +msgstr "" + # type: Content of: <refentry><refnamediv><refname> #, fuzzy #~ msgid "NoConfigure" @@ -9353,18 +10485,10 @@ msgstr "&apt-cache; &apt-conf;" #~ msgid "<filename>&cachedir;/archives/partial/</filename>" #~ msgstr "<filename>&cachedir;/archives/partial/</filename>" -# type: <author></author> -#~ msgid "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>" -#~ msgstr "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>" - # type: <copyrightsummary></copyrightsummary> #~ msgid "Copyright © Jason Gunthorpe, 1997-1998." #~ msgstr "Copyright © Jason Gunthorpe, 1997-1998." -# type: Content of: <refentry><refsect1><title> -#~ msgid "Introduction" -#~ msgstr "はじめに" - # type: Content of: <refentry><refnamediv><refpurpose> #, fuzzy #~ msgid "Note on Pointer access" @@ -9949,10 +11073,6 @@ msgstr "&apt-cache; &apt-conf;" #~ msgid "Copyright © Jason Gunthorpe, 1998-1999." #~ msgstr "Copyright © Jason Gunthorpe, 1997-1998." -#, fuzzy -#~ msgid "General" -#~ msgstr "generate" - #, fuzzy #~ msgid "" #~ "deb <var>uri</var> <var>distribution</var> <var>component</var> " @@ -10036,34 +11156,6 @@ msgstr "&apt-cache; &apt-conf;" #~ msgid "The Release File" #~ msgstr "ソースオーバーライドファイル" -# type: <copyrightsummary></copyrightsummary> -#, fuzzy -#~ msgid "Copyright © Jason Gunthorpe, 1998." -#~ msgstr "Copyright © Jason Gunthorpe, 1999." - -# type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara> -#, fuzzy -#~ msgid "Anatomy of the Package System" -#~ msgstr "パッケージ名" - -# type: Content of: <refentry><refsect1><title> -#~ msgid "DSelect" -#~ msgstr "DSelect" - -# type: <tag></tag> -#, fuzzy -#~ msgid "The Extra Package list" -#~ msgstr "NextPackage" - -# type: <heading></heading> -#~ msgid "Dpkg" -#~ msgstr "Dpkg" - -# type: <tag></tag> -#, fuzzy -#~ msgid "APT Method Interface" -#~ msgstr "メソッドインスタンス" - # type: Content of: <refentry><refsect1><title> #~ msgid "Global configuration" #~ msgstr "共通設定" @@ -10094,10 +11186,6 @@ msgstr "&apt-cache; &apt-conf;" #~ msgid "Specification" #~ msgstr "仕様" -#, fuzzy -#~ msgid "Overview" -#~ msgstr "OverrideDir" - # type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #, fuzzy #~ msgid "601 Configuration - Sends the configuration space" @@ -10160,147 +11248,5 @@ msgstr "&apt-cache; &apt-conf;" #~ msgid "Notes" #~ msgstr "contents" -# type: <title> -#~ msgid "Using APT Offline" -#~ msgstr "オフラインでの APT の使用法" - -# type: -#~ msgid "" -#~ "This document describes how to use APT in a non-networked environment, " -#~ "specifically a 'sneaker-net' approach for performing upgrades." -#~ msgstr "" -#~ "このドキュメントはネットワークがない環境での APT の使用方法を説明していま" -#~ "す。具体的には、アップグレード時に「スニーカーネット」アプローチです。" - -# type: -#~ msgid "Copyright © Jason Gunthorpe, 1999." -#~ msgstr "Copyright © Jason Gunthorpe, 1999." - -# type: -#, fuzzy -#~ msgid "Using APT on both machines" -#~ msgstr "オフラインでの APT の使用法" - -# type: -#~ msgid "" -#~ " /disc/\n" -#~ " archives/\n" -#~ " partial/\n" -#~ " lists/\n" -#~ " partial/\n" -#~ " status\n" -#~ " sources.list\n" -#~ " apt.conf" -#~ msgstr "" -#~ " /disc/\n" -#~ " archives/\n" -#~ " partial/\n" -#~ " lists/\n" -#~ " partial/\n" -#~ " status\n" -#~ " sources.list\n" -#~ " apt.conf" - -# type: Content of: -#, fuzzy -#~ msgid "The configuration file" -#~ msgstr "ユーザの設定" - -# type: <example></example> -#, fuzzy -#~ msgid "" -#~ " APT\n" -#~ " {\n" -#~ " /* This is not necessary if the two machines are the same arch, it " -#~ "tells\n" -#~ " the remote APT what architecture the target machine is */\n" -#~ " Architecture \"i386\";\n" -#~ " \n" -#~ " Get::Download-Only \"true\";\n" -#~ " };\n" -#~ " \n" -#~ " Dir\n" -#~ " {\n" -#~ " /* Use the disc for state information and redirect the status file " -#~ "from\n" -#~ " the /var/lib/dpkg default */\n" -#~ " State \"/disc/\";\n" -#~ " State::status \"status\";\n" -#~ "\n" -#~ " // Binary caches will be stored locally\n" -#~ " Cache::archives \"/disc/archives/\";\n" -#~ " Cache \"/tmp/\";\n" -#~ " \n" -#~ " // Location of the source list.\n" -#~ " Etc \"/disc/\";\n" -#~ " };" -#~ msgstr "" -#~ " APT\n" -#~ " {\n" -#~ " /* This is not necessary if the two machines are the same arch, it " -#~ "tells\n" -#~ " the remote APT what architecture the Debian machine is */\n" -#~ " Architecture \"i386\";\n" -#~ " \n" -#~ " Get::Download-Only \"true\";\n" -#~ " };\n" -#~ " \n" -#~ " Dir\n" -#~ " {\n" -#~ " /* Use the disc for state information and redirect the status file " -#~ "from\n" -#~ " the /var/lib/dpkg default */\n" -#~ " State \"/disc/\";\n" -#~ " State::status \"status\";\n" -#~ "\n" -#~ " // Binary caches will be stored locally\n" -#~ " Cache::archives \"/disc/archives/\";\n" -#~ " Cache \"/tmp/\";\n" -#~ " \n" -#~ " // Location of the source list.\n" -#~ " Etc \"/disc/\";\n" -#~ " };" - -# type: <example></example> -#, fuzzy -#~ msgid "" -#~ " # export APT_CONFIG=\"/disc/apt.conf\"\n" -#~ " # apt-get update\n" -#~ " [ APT fetches the package files ]\n" -#~ " # apt-get dist-upgrade\n" -#~ " [ APT fetches all the packages needed to upgrade the target machine ]" -#~ msgstr "" -#~ " # export APT_CONFIG=\"/disc/apt.conf\"\n" -#~ " # apt-get update\n" -#~ " [ パッケージファイルを取得します ]\n" -#~ " # apt-get dist-upgrade\n" -#~ " [ アップグレードが必要な全パッケージを取得します ]" - -# type: <example></example> -#, fuzzy -#~ msgid "" -#~ " # export APT_CONFIG=\"/disc/apt.conf\"\n" -#~ " # apt-get check\n" -#~ " [ APT generates a local copy of the cache files ]\n" -#~ " # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-" -#~ "upgrade\n" -#~ " [ Or any other APT command ]" -#~ msgstr "" -#~ " # export APT_CONFIG=\"/disc/apt.conf\"\n" -#~ " # apt-get update\n" -#~ " [ パッケージファイルを取得します ]\n" -#~ " # apt-get dist-upgrade\n" -#~ " [ アップグレードが必要な全パッケージを取得します ]" - -# type: <title> -#, fuzzy -#~ msgid "Using APT and wget" -#~ msgstr "オフラインでの APT の使用法" - -# type: Content of: -#, fuzzy -#~ msgid "Operation" -#~ msgstr "オプション" - #~ msgid "<literal>Debug::Vendor</literal>" #~ msgstr "<literal>Debug::Vendor</literal>" diff --git a/doc/po4a.conf b/doc/po4a.conf index edf8d0357..12f2465bc 100644 --- a/doc/po4a.conf +++ b/doc/po4a.conf @@ -33,6 +33,11 @@ add_$lang:$lang/addendum/xml_$lang.add [type: docbook] sources.list.5.xml $lang:$lang/sources.list.$lang.5.xml \ add_$lang:$lang/addendum/xml_$lang.add + +[type: sgml] guide.sgml $lang:$lang/guide.$lang.sgml \ + add_$lang::$lang/addendum/debiandoc_$lang.add +[type: sgml] offline.sgml $lang:$lang/offline.$lang.sgml \ + add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] cache.sgml $lang:$lang/cache.$lang.sgml \ # add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] design.sgml $lang:$lang/design.$lang.sgml\ @@ -41,10 +46,6 @@ # add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] files.sgml $lang:$lang/files.$lang.sgml\ # add_$lang::$lang/addendum/debiandoc_$lang.add -#[type: sgml] guide.sgml $lang:$lang/guide.$lang.sgml\ -# add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] method.sgml $lang:$lang/method.$lang.sgml\ # add_$lang::$lang/addendum/debiandoc_$lang.add -#[type: sgml] offline.sgml $lang:$lang/offline.$lang.sgml\ -# add_$lang::$lang/addendum/debiandoc_$lang.add -- cgit v1.2.3-70-g09d2 From 944b2fffc4a54fbf9329faa579592cc758915a99 Mon Sep 17 00:00:00 2001 From: David Kalnischkies <kalnischkies@gmail.com> Date: Thu, 29 Oct 2009 21:34:31 +0100 Subject: remove generated sgml files (if we really had build them) --- doc/makefile | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'doc/makefile') diff --git a/doc/makefile b/doc/makefile index fe53aba48..26ca52a9e 100644 --- a/doc/makefile +++ b/doc/makefile @@ -43,6 +43,14 @@ veryclean-subdirs: for dir in $(SUBDIRS); do\ $(MAKE) -C $$dir veryclean; \ done + # FIXME remove created sgml files, but preserve all + # which are "left over" from older systems. + # After completing the transition this should be handled + # in the po4a-manpage makefile for all translations + for dir in $(subst /addendum/,, $(dir $(wildcard */addendum/debiandoc*))); do\ + rm -f $$dir/offline.$$dir.sgml; \ + rm -f $$dir/guide.$$dir.sgml; \ + done ifdef PO4A doc: po4a -- cgit v1.2.3-70-g09d2 From 41f28cb341b1757162826ba2f8fc1ce75ecb25b7 Mon Sep 17 00:00:00 2001 From: David Kalnischkies <kalnischkies@gmail.com> Date: Sun, 1 Nov 2009 23:36:09 +0100 Subject: disable addendum for sgml-files as we have no valid file until now Will be reenabled after Translators provide such a file. --- doc/de/addendum/debiandoc_de.add | 6 ------ doc/fr/addendum/debiandoc_fr.add | 7 ------- doc/ja/addendum/debiandoc_ja.add | 7 ------- doc/makefile | 2 +- doc/po4a.conf | 8 ++++---- 5 files changed, 5 insertions(+), 25 deletions(-) delete mode 100644 doc/de/addendum/debiandoc_de.add delete mode 100644 doc/fr/addendum/debiandoc_fr.add delete mode 100644 doc/ja/addendum/debiandoc_ja.add (limited to 'doc/makefile') diff --git a/doc/de/addendum/debiandoc_de.add b/doc/de/addendum/debiandoc_de.add deleted file mode 100644 index 2332878a6..000000000 --- a/doc/de/addendum/debiandoc_de.add +++ /dev/null @@ -1,6 +0,0 @@ -PO4A-HEADER:mode=after;position=manbugs;beginboundary=^</refentry> - <refsect1><title>Übersetzung - Die deutsche Übersetzung wurde 2009 von Chris Leick c.leick@vollbio.de angefertigt - in Zusammenarbeit mit dem Debian German-l10n-Team debian-l10n-german@lists.debian.org. - - diff --git a/doc/fr/addendum/debiandoc_fr.add b/doc/fr/addendum/debiandoc_fr.add deleted file mode 100644 index 987b5b1f5..000000000 --- a/doc/fr/addendum/debiandoc_fr.add +++ /dev/null @@ -1,7 +0,0 @@ -PO4A-HEADER:mode=after;position=manbugs;beginboundary=^ - Traducteurs - Jérôme Marant, Philippe Batailler, Christian Perrier bubulle@debian.org (2000, 2005, 2009), - Équipe de traduction francophone de Debian debian-l10n-french@lists.debian.org - - - diff --git a/doc/ja/addendum/debiandoc_ja.add b/doc/ja/addendum/debiandoc_ja.add deleted file mode 100644 index 05d4cff3f..000000000 --- a/doc/ja/addendum/debiandoc_ja.add +++ /dev/null @@ -1,7 +0,0 @@ -PO4A-HEADER:mode=after;position=manbugs;beginboundary=^ - 訳者 - 倉澤 望 nabetaro@debian.or.jp (2003-2006,2009), - Debian JP Documentation ML debian-doc@debian.or.jp - - - diff --git a/doc/makefile b/doc/makefile index 26ca52a9e..0cb135c7b 100644 --- a/doc/makefile +++ b/doc/makefile @@ -47,7 +47,7 @@ veryclean-subdirs: # which are "left over" from older systems. # After completing the transition this should be handled # in the po4a-manpage makefile for all translations - for dir in $(subst /addendum/,, $(dir $(wildcard */addendum/debiandoc*))); do\ + for dir in $(subst /addendum/,, $(dir $(wildcard */addendum/*))); do\ rm -f $$dir/offline.$$dir.sgml; \ rm -f $$dir/guide.$$dir.sgml; \ done diff --git a/doc/po4a.conf b/doc/po4a.conf index 12f2465bc..fae80d690 100644 --- a/doc/po4a.conf +++ b/doc/po4a.conf @@ -34,10 +34,10 @@ [type: docbook] sources.list.5.xml $lang:$lang/sources.list.$lang.5.xml \ add_$lang:$lang/addendum/xml_$lang.add -[type: sgml] guide.sgml $lang:$lang/guide.$lang.sgml \ - add_$lang::$lang/addendum/debiandoc_$lang.add -[type: sgml] offline.sgml $lang:$lang/offline.$lang.sgml \ - add_$lang::$lang/addendum/debiandoc_$lang.add +[type: sgml] guide.sgml $lang:$lang/guide.$lang.sgml +# add_$lang::$lang/addendum/debiandoc_$lang.add +[type: sgml] offline.sgml $lang:$lang/offline.$lang.sgml +# add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] cache.sgml $lang:$lang/cache.$lang.sgml \ # add_$lang::$lang/addendum/debiandoc_$lang.add #[type: sgml] design.sgml $lang:$lang/design.$lang.sgml\ -- cgit v1.2.3-70-g09d2 From 93517da394859666e4af08f518dfb95c4ac271dd Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 2 Nov 2009 10:26:52 +0100 Subject: fix/simplify buildsystem for the (now) po4a-only manpages --- .bzrignore | 14 +++----------- buildlib/po4a_manpage.mak | 3 ++- buildlib/sgml_manpage.mak | 45 --------------------------------------------- doc/es/makefile | 9 ++++----- doc/makefile | 8 -------- doc/pt_BR/makefile | 7 ++++--- 6 files changed, 13 insertions(+), 73 deletions(-) delete mode 100644 buildlib/sgml_manpage.mak (limited to 'doc/makefile') diff --git a/.bzrignore b/.bzrignore index 660c3e027..45db3c607 100644 --- a/.bzrignore +++ b/.bzrignore @@ -9,7 +9,8 @@ autom4te.cache/ build/ configure -# generated apt man pages +# generated files in the progress to build all +# apt man pages and other documentation doc/*.1 doc/*.5 doc/*.8 @@ -17,14 +18,5 @@ doc/*/*.1 doc/*/*.5 doc/*/*.8 doc/*/apt.ent - -# ignore xml man page files generated by po4a -# older translation methods translate in this files -# so we can not ignore it for all translations now doc/*/*.xml - -# FIXME: files generated by deprecated sgml man pages -doc/es/manpage.links -doc/es/manpage.refs -doc/pt_BR/manpage.links -doc/pt_BR/manpage.refs +doc/*/*.sgml diff --git a/buildlib/po4a_manpage.mak b/buildlib/po4a_manpage.mak index 3d90c6ba4..dfa215d29 100644 --- a/buildlib/po4a_manpage.mak +++ b/buildlib/po4a_manpage.mak @@ -35,7 +35,8 @@ $($(LOCAL)-LIST) :: % : %.xml $(INCLUDES) .PHONY: veryclean/$(LOCAL) veryclean/$(LOCAL): -rm -rf $($(@F)-LIST) apt.ent apt.$(LC).8 \ - $(addsuffix .xml,$($(@F)-LIST)) + $(addsuffix .xml,$($(@F)-LIST)) \ + offline.$(LC).sgml guide.$(LC).sgml HAVE_PO4A=yes endif diff --git a/buildlib/sgml_manpage.mak b/buildlib/sgml_manpage.mak deleted file mode 100644 index 5fcb75c46..000000000 --- a/buildlib/sgml_manpage.mak +++ /dev/null @@ -1,45 +0,0 @@ -# -*- make -*- - -# This handles man pages in DocBook SGMLL format. We convert to the respective -# output in the source directory then copy over to the final dest. This -# means yodl is only needed if compiling from CVS - -# Input -# $(SOURCE) - The documents to use, in the form foo.sect, ie apt-cache.8 -# the sgml files are called apt-cache.8.sgml - -# See defaults.mak for information about LOCAL - -# Some local definitions -ifdef DOCBOOK2MAN - -LOCAL := sgml-manpage-$(firstword $(SOURCE)) -$(LOCAL)-LIST := $(SOURCE) - -# Install generation hooks -doc: $($(LOCAL)-LIST) -veryclean: veryclean/$(LOCAL) - -$($(LOCAL)-LIST) :: % : %.sgml $(INCLUDES) - echo Creating man page $@ - $(DOCBOOK2MAN) $< - -# Clean rule -.PHONY: veryclean/$(LOCAL) -veryclean/$(LOCAL): - -rm -rf $($(@F)-LIST) - -HAVE_SGML=yes -endif - -INCLUDES := - -ifndef HAVE_SGML -# Strip from the source list any man pages we dont have compiled already -SOURCE := $(wildcard $(SOURCE)) -endif - -# Chain to the manpage rule -ifneq ($(words $(SOURCE)),0) -include $(MANPAGE_H) -endif diff --git a/doc/es/makefile b/doc/es/makefile index 81a410c5c..0b5b52222 100644 --- a/doc/es/makefile +++ b/doc/es/makefile @@ -5,8 +5,7 @@ SUBDIR=doc/es # Bring in the default rules include ../../buildlib/defaults.mak -# Man pages -SOURCE = apt-cache.es.8 apt-get.es.8 apt-cdrom.es.8 apt.conf.es.5 \ - sources.list.es.5 apt-config.es.8 apt_preferences.es.5 -INCLUDES = apt.ent.es -include $(SGML_MANPAGE_H) +# Language Code of this translation +LC=es + +include $(PO4A_MANPAGE_H) diff --git a/doc/makefile b/doc/makefile index 0cb135c7b..fe53aba48 100644 --- a/doc/makefile +++ b/doc/makefile @@ -43,14 +43,6 @@ veryclean-subdirs: for dir in $(SUBDIRS); do\ $(MAKE) -C $$dir veryclean; \ done - # FIXME remove created sgml files, but preserve all - # which are "left over" from older systems. - # After completing the transition this should be handled - # in the po4a-manpage makefile for all translations - for dir in $(subst /addendum/,, $(dir $(wildcard */addendum/*))); do\ - rm -f $$dir/offline.$$dir.sgml; \ - rm -f $$dir/guide.$$dir.sgml; \ - done ifdef PO4A doc: po4a diff --git a/doc/pt_BR/makefile b/doc/pt_BR/makefile index 4c9ea6293..6e485bbf6 100644 --- a/doc/pt_BR/makefile +++ b/doc/pt_BR/makefile @@ -5,6 +5,7 @@ SUBDIR=doc/pt_BR # Bring in the default rules include ../../buildlib/defaults.mak -SOURCE = apt_preferences.pt_BR.5 -INCLUDES = apt.ent.pt_BR -include $(SGML_MANPAGE_H) +# Language Code of this translation +LC=pt_BR + +include $(PO4A_MANPAGE_H) -- cgit v1.2.3-70-g09d2 From e46a23a59689c917ad3e589a84add9fdfa498159 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Mon, 2 Nov 2009 17:54:22 +0100 Subject: remove traces of old manpage-buildsystems --- buildlib/defaults.mak | 3 --- buildlib/environment.mak.in | 8 +------- buildlib/xml_manpage.mak | 45 --------------------------------------------- buildlib/yodl_manpage.mak | 42 ------------------------------------------ configure.in | 9 --------- debian/changelog | 7 +++++++ debian/control | 2 +- doc/makefile | 36 ++++++++++++++++++++++++++++-------- 8 files changed, 37 insertions(+), 115 deletions(-) delete mode 100644 buildlib/xml_manpage.mak delete mode 100644 buildlib/yodl_manpage.mak (limited to 'doc/makefile') diff --git a/buildlib/defaults.mak b/buildlib/defaults.mak index 5373ee5cf..bf93bd2ee 100644 --- a/buildlib/defaults.mak +++ b/buildlib/defaults.mak @@ -81,10 +81,7 @@ MANPAGE_H = $(BASE)/buildlib/manpage.mak PROGRAM_H = $(BASE)/buildlib/program.mak PYTHON_H = $(BASE)/buildlib/python.mak COPY_H = $(BASE)/buildlib/copy.mak -YODL_MANPAGE_H = $(BASE)/buildlib/yodl_manpage.mak -SGML_MANPAGE_H = $(BASE)/buildlib/sgml_manpage.mak PO4A_MANPAGE_H = $(BASE)/buildlib/po4a_manpage.mak -XML_MANPAGE_H = $(BASE)/buildlib/xml_manpage.mak FAIL_H = $(BASE)/buildlib/fail.mak PODOMAIN_H = $(BASE)/buildlib/podomain.mak diff --git a/buildlib/environment.mak.in b/buildlib/environment.mak.in index b3afca0ad..5fca48d5a 100644 --- a/buildlib/environment.mak.in +++ b/buildlib/environment.mak.in @@ -30,13 +30,7 @@ DEBIANDOC_TEXT = @DEBIANDOC_TEXT@ DOXYGEN = @DOXYGEN@ -# SGML for the man pages -DOCBOOK2MAN := @DOCBOOK2MAN@ - -# XML for the man pages -XMLTO := @XMLTO@ - -# po4a for the man pages +# xsltproc for the man pages XSLTPROC := @XSLTPROC@ # po4a for the man pages diff --git a/buildlib/xml_manpage.mak b/buildlib/xml_manpage.mak deleted file mode 100644 index c8b155d09..000000000 --- a/buildlib/xml_manpage.mak +++ /dev/null @@ -1,45 +0,0 @@ -# -*- make -*- - -# This handles man pages in DocBook XML format. We convert to the respective -# output in the source directory then copy over to the final dest. This -# means xmlto is only needed if compiling from Arch - -# Input -# $(SOURCE) - The documents to use, in the form foo.sect, ie apt-cache.8 -# the XML files are called apt-cache.8.xml - -# See defaults.mak for information about LOCAL - -# Some local definitions -ifdef XMLTO - -LOCAL := xml-manpage-$(firstword $(SOURCE)) -$(LOCAL)-LIST := $(SOURCE) - -# Install generation hooks -doc: $($(LOCAL)-LIST) -veryclean: veryclean/$(LOCAL) - -$($(LOCAL)-LIST) :: % : %.xml $(INCLUDES) - echo Creating man page $@ - $(XMLTO) man $< - -# Clean rule -.PHONY: veryclean/$(LOCAL) -veryclean/$(LOCAL): - -rm -rf $($(@F)-LIST) - -HAVE_XMLTO=yes -endif - -INCLUDES := - -ifndef HAVE_XMLTO -# Strip from the source list any man pages we dont have compiled already -SOURCE := $(wildcard $(SOURCE)) -endif - -# Chain to the manpage rule -ifneq ($(words $(SOURCE)),0) -include $(MANPAGE_H) -endif diff --git a/buildlib/yodl_manpage.mak b/buildlib/yodl_manpage.mak deleted file mode 100644 index a5f436f60..000000000 --- a/buildlib/yodl_manpage.mak +++ /dev/null @@ -1,42 +0,0 @@ -# -*- make -*- - -# This handles man pages in YODL format. We convert to the respective -# output in the source directory then copy over to the final dest. This -# means yodl is only needed if compiling from CVS - -# Input -# $(SOURCE) - The documents to use, in the form foo.sect, ie apt-cache.8 -# the yodl files are called apt-cache.8.yo - -# See defaults.mak for information about LOCAL - -# Some local definitions -ifdef YODL_MAN - -LOCAL := yodl-manpage-$(firstword $(SOURCE)) -$(LOCAL)-LIST := $(SOURCE) - -# Install generation hooks -doc: $($(LOCAL)-LIST) -veryclean: veryclean/$(LOCAL) - -$($(LOCAL)-LIST) :: % : %.yo - echo Creating man page $@ - yodl2man -o $@ $< - -# Clean rule -.PHONY: veryclean/$(LOCAL) -veryclean/$(LOCAL): - -rm -rf $($(@F)-LIST) - -else - -# Strip from the source list any man pages we dont have compiled already -SOURCE := $(wildcard $(SOURCE)) - -endif - -# Chain to the manpage rule -ifneq ($(words $(SOURCE)),0) -include $(MANPAGE_H) -endif diff --git a/configure.in b/configure.in index 9d6589e55..9bcb94068 100644 --- a/configure.in +++ b/configure.in @@ -184,12 +184,6 @@ AC_PATH_PROG(DEBIANDOC_TEXT,debiandoc2text) dnl Check for doxygen AC_PATH_PROG(DOXYGEN, doxygen) -dnl Check for the SGML tools needed to build man pages -AC_PATH_PROG(DOCBOOK2MAN,docbook2man) - -dnl Check for the XML tools needed to build man pages -AC_PATH_PROG(XMLTO,xmlto) - dnl Check for the XSLTProc tool needed to build man pages together with po4a AC_PATH_PROG(XSLTPROC,xsltproc) @@ -202,9 +196,6 @@ AC_PATH_PROG([DOT], [dot], []) DOTDIR=$(dirname $DOT) AC_SUBST(DOTDIR) -dnl Check for YODL -dnl AC_CHECK_PROG(YODL_MAN,yodl2man,"yes","") - ah_NUM_PROCS rc_GLIBC_VER rc_LIBSTDCPP_VER diff --git a/debian/changelog b/debian/changelog index 9c4d46e09..8db5fa3d6 100644 --- a/debian/changelog +++ b/debian/changelog @@ -38,6 +38,13 @@ apt (0.7.25) UNRELEASED; urgency=low * buildlib/configure.mak, buildlib/config.{sub,guess}: - remove (outdated) config.{sub,guess} and use the ones provided by the new added build-dependency autotools-dev instead + * configure.in, buildlib/{xml,yodl,sgml}_manpage.mak: + - remove the now obsolete manpage buildsystems + * doc/{pl,pt_BR,es,it}/*.{sgml,xml}: + - convert all remaining translation to the po4a system + * debian/control: + - drop build-dependency on docbook-utils and xmlto + - add build-dependency on autotools-dev [ Chris Leick ] * doc/ various manpages: diff --git a/debian/control b/debian/control index 5db294f2e..18bcff3d4 100644 --- a/debian/control +++ b/debian/control @@ -6,7 +6,7 @@ Uploaders: Michael Vogt , Otavio Salvador , Christian Perrier , Daniel Burrows , Luca Bruno , Julian Andres Klode Standards-Version: 3.8.2.0 -Build-Depends: debhelper (>= 5.0), libdb-dev, gettext (>= 0.12), libcurl4-gnutls-dev | libcurl3-gnutls-dev (>= 7.15.5), debiandoc-sgml, docbook-utils (>= 0.6.12), xsltproc, docbook-xsl, xmlto, po4a (>= 0.34-2), autotools-dev +Build-Depends: debhelper (>= 5.0), libdb-dev, gettext (>= 0.12), libcurl4-gnutls-dev | libcurl3-gnutls-dev (>= 7.15.5), debiandoc-sgml, xsltproc, docbook-xsl, po4a (>= 0.34-2), autotools-dev Vcs-Bzr: http://bzr.debian.org/apt/debian-sid/ Package: apt diff --git a/doc/makefile b/doc/makefile index fe53aba48..6fb604e4e 100644 --- a/doc/makefile +++ b/doc/makefile @@ -11,13 +11,34 @@ SOURCE = $(wildcard *.sgml) DEBIANDOC_HTML_OPTIONS=-l en include $(DEBIANDOC_H) -# XML man pages -SOURCE = apt-cache.8 apt-get.8 apt-cdrom.8 apt.conf.5 sources.list.5 \ - apt-config.8 apt_preferences.5 \ - apt-sortpkgs.1 apt-ftparchive.1 apt-extracttemplates.1 \ - apt-key.8 apt-secure.8 apt-mark.8 -INCLUDES = apt.ent -include $(XML_MANPAGE_H) +# Do not use XMLTO, build the manpages directly with XSLTPROC +ifdef XSLTPROC +# generate a list of accepted man page translations +SOURCE = $(patsubst %.xml,%,$(wildcard *.?.xml)) +INCLUDES = apt.ent +STYLESHEET=manpage-style.xsl + +LOCAL := manpage-$(firstword $(SOURCE)) +$(LOCAL)-LIST := $(SOURCE) + +# Install generation hooks +doc: $($(LOCAL)-LIST) +veryclean: veryclean/$(LOCAL) + +$($(LOCAL)-LIST) :: % : %.xml $(INCLUDES) + echo Creating man page $@ + $(XSLTPROC) -o $@ $(STYLESHEET) $< + +# Clean rule +.PHONY: veryclean/$(LOCAL) +veryclean/$(LOCAL): + -rm -rf $($(@F)-LIST) + +endif + +# Chain to the manpage rule +SOURCE = apt.8 +include $(MANPAGE_H) # Examples SOURCE = examples/apt.conf examples/sources.list examples/configure-index examples/apt-https-method-example.conf @@ -78,5 +99,4 @@ $(BUILD)/doc/doxygen-stamp: $(DOXYGEN_SOURCES) $(BUILD)/doc/Doxyfile touch $(BUILD)/doc/doxygen-stamp doc: $(BUILD)/doc/doxygen-stamp - endif -- cgit v1.2.3-70-g09d2