From 429465b26c77b3b6d37adc45e576e9cdf7e80f91 Mon Sep 17 00:00:00 2001 From: Matt Zimmerman Date: Fri, 4 Feb 2005 21:58:18 +0000 Subject: [PATCH] Fix build/install of Polish offline documentation * Fix build/install of Polish offline documentation, based on patch from Christian Perrier (Closes: #270404) --- debian/changelog | 4 +- debian/rules | 2 +- doc/pl/offline.pl.sgml | 180 ++++++++++++++++++++--------------------- 3 files changed, 94 insertions(+), 92 deletions(-) diff --git a/debian/changelog b/debian/changelog index bf71480cc..0ca0b5223 100644 --- a/debian/changelog +++ b/debian/changelog @@ -4,8 +4,10 @@ apt (0.6.31) hoary; urgency=low * Apply patch from Anthony Towns to allow SHA1Summation to process a file descriptor until EOF, rather than requiring that the length of input be specified (Closes: #291338) + * Fix build/install of Polish offline documentation, based on patch from + Christian Perrier (Closes: #270404) - -- + -- Matt Zimmerman Fri, 4 Feb 2005 10:23:01 -0800 apt (0.6.30) unstable; urgency=low diff --git a/debian/rules b/debian/rules index b756b3b32..e3254c2d2 100755 --- a/debian/rules +++ b/debian/rules @@ -171,7 +171,7 @@ apt-doc: build-doc # # Copy the guides dh_installdocs -p$@ $(BLD)/docs/guide*.text $(BLD)/docs/guide*.html \ - $(BLD)/docs/offline.text $(BLD)/docs/offline.html + $(BLD)/docs/offline*.text $(BLD)/docs/offline*.html dh_installchangelogs -p$@ dh_compress -p$@ dh_fixperms -p$@ diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml index 48f84e3b1..2adb2554d 100644 --- a/doc/pl/offline.pl.sgml +++ b/doc/pl/offline.pl.sgml @@ -1,80 +1,80 @@ -U¿ywanie APT w trybie offline +U�ywanie APT w trybie offline Jason Gunthorpe jgg@debian.org -Polskie t³umaczenie Krzysztof Fiertek akfedux@megapolis.pl +Polskie t�umaczenie Krzysztof Fiertek akfedux@megapolis.pl $Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $ -Dokument ten opisuje jak u¿ywaæ programu APT w ¶rodowiskach niesieciowych, -a w szczególno¶ci metodê pozwalaj±c± na robienie aktualizacji systemu. +Dokument ten opisuje jak u�ywa� programu APT w �rodowiskach niesieciowych, +a w szczeg�lno�ci metod� pozwalaj�c� na robienie aktualizacji systemu. Copyright © Jason Gunthorpe, 1999.

-Copyright © polskiego t³umaczenia Krzysztof Fiertek, 2004. +Copyright © polskiego t�umaczenia Krzysztof Fiertek, 2004.

-"APT" i ten dokument s± oprogramowaniem wolnodostêpnym; mo¿esz -rozpowszechniaæ je i/lub zmieniaæ w zgodzie z postanowieniami -"Ogólnej Licencji Publicznej GNU" (GNU General Public License) -takiej, jak zosta³a opublikowana przez "Fundacje Wolnego -Oprogramowania (Free Software Foundation); albo w wersji 2 tej¿e -licencji, albo (twój wybór) w dowolnej pó¼niejszej. +"APT" i ten dokument s� oprogramowaniem wolnodost�pnym; mo�esz +rozpowszechnia� je i/lub zmienia� w zgodzie z postanowieniami +"Og�lnej Licencji Publicznej GNU" (GNU General Public License) +takiej, jak zosta�a opublikowana przez "Fundacje Wolnego +Oprogramowania (Free Software Foundation); albo w wersji 2 tej�e +licencji, albo (tw�j wyb�r) w dowolnej p��niejszej.

-Wiêcej szczegó³ów mo¿esz uzyskaæ przegl±daj±c plik zawieraj±cy pe³ny tekst +Wi�cej szczeg���w mo�esz uzyska� przegl�daj�c plik zawieraj�cy pe�ny tekst licencji (w systemach Debian jest to plik /usr/doc/copyright/GPL). -Wstêp +Wst�p Wprowadzenie

-Normalnie APT wymaga bezpo¶redniego dostêpu do archiwów Debiana poprzez -sieæ lokaln± albo przez sieæ internetow±. Kolejn± niedogodno¶ci± mo¿e byæ -fakt, ¿e nasz komputer, który pracuje na wolnym ³±czu takim jak modem, -jest znacznie oddalony od innnego komputera z szybkim ³±czem. +Normalnie APT wymaga bezpo�redniego dost�pu do archiw�w Debiana poprzez +sie� lokaln� albo przez sie� internetow�. Kolejn� niedogodno�ci� mo�e by� +fakt, �e nasz komputer, kt�ry pracuje na wolnym ��czu takim jak modem, +jest znacznie oddalony od innnego komputera z szybkim ��czem.

-Rozwi±zaniem tego problemu jest u¿ycie pojemnych przeno¶nych no¶ników -takich jak dyskietka Zip lub dysk SuperDisk. No¶niki te nie s± -wystarczaj±co pojemne, by zgromadziæ kompletne archiwum Debiana, ale mo¿na -¶mia³o dopasowaæ podzbiór du¿ego archiwum wystarczaj±cy dla wiêkszo¶ci -u¿ytkowników. Pomys³ polega na tym, by u¿yæ programu APT do wygenerowania -listy pakietów, które s± wymagane, nastêpnie pobraniu ich na dysk u¿ywaj±c -innego komputera z w³a¶ciw± zwarto¶ci±. Jest nawet mo¿liwe, by u¿yæ innego -komputera z Debianem z zainstalowanym programem APT lub zupe³nie innym -systemem operacyjnym i programem narzêdziowym do pobierania plików takim +Rozwi�zaniem tego problemu jest u�ycie pojemnych przeno�nych no�nik�w +takich jak dyskietka Zip lub dysk SuperDisk. No�niki te nie s� +wystarczaj�co pojemne, by zgromadzi� kompletne archiwum Debiana, ale mo�na +�mia�o dopasowa� podzbi�r du�ego archiwum wystarczaj�cy dla wi�kszo�ci +u�ytkownik�w. Pomys� polega na tym, by u�y� programu APT do wygenerowania +listy pakiet�w, kt�re s� wymagane, nast�pnie pobraniu ich na dysk u�ywaj�c +innego komputera z w�a�ciw� zwarto�ci�. Jest nawet mo�liwe, by u�y� innego +komputera z Debianem z zainstalowanym programem APT lub zupe�nie innym +systemem operacyjnym i programem narz�dziowym do pobierania plik�w takim jak wget.

-Osi±gniête jest to przez twórcze manipulowanie plikiem konfiguracyjnym -programu APT. Rzecz± niezbêdn± jest poinformowanie programu APT, aby wskazywa³ -na dysk z plikami archiwum. Nale¿y zauwa¿yæ, ¿e dysk powinien byæ -sformatowany do obs³ugi systemu plików takiego jak ext2, fat32 albo vfat -pozwalaj±cych pos³ugiwaæ siê d³ugimi nazwami pliku. +Osi�gni�te jest to przez tw�rcze manipulowanie plikiem konfiguracyjnym +programu APT. Rzecz� niezb�dn� jest poinformowanie programu APT, aby wskazywa� +na dysk z plikami archiwum. Nale�y zauwa�y�, �e dysk powinien by� +sformatowany do obs�ugi systemu plik�w takiego jak ext2, fat32 albo vfat +pozwalaj�cych pos�ugiwa� si� d�ugimi nazwami pliku. -U¿ywanie programu APT na obu komputerach +U�ywanie programu APT na obu komputerach Wprowadzenie

-APT bêd±cy do dyspozycji na obu komputerach daje najprostsz± kombinacjê. -Zasadniczym pomys³em tej metody jest umie¶ciæ kopie pliku status na dysku -i u¿yæ odleg³ego komputera, aby uzyskaæ najnowsze pliki pakietów -i zdecydowaæ, które pakiety chcemy pobraæ. Struktura katalogów na dysku -powinna wygl±daæ nastêpuj±co: +APT b�d�cy do dyspozycji na obu komputerach daje najprostsz� kombinacj�. +Zasadniczym pomys�em tej metody jest umie�ci� kopie pliku status na dysku +i u�y� odleg�ego komputera, aby uzyska� najnowsze pliki pakiet�w +i zdecydowa�, kt�re pakiety chcemy pobra�. Struktura katalog�w na dysku +powinna wygl�da� nast�puj�co: /disc/ @@ -94,21 +94,21 @@ powinna wygl Plik konfiguracyjny

-Plik konfiguracyjny powinien informowaæ program APT, aby przechowywaæ jego -pliki na dysku, a tak¿e u¿ywaæ plików konfiguracyjnych z dysku. Plik -sources.list powinien zawieraæ prawid³owe odno¶niki, których oczekujesz -u¿yæ od zdalnego komputera, a plik status powinien byæ kopi± -/var/lib/dpkg/status. Zauwa¿, ¿e je¶li u¿ywasz lokalnego archiwum -musisz u¿yæ tych samych odno¶ników o identycznej sk³adni. +Plik konfiguracyjny powinien informowa� program APT, aby przechowywa� jego +pliki na dysku, a tak�e u�ywa� plik�w konfiguracyjnych z dysku. Plik +sources.list powinien zawiera� prawid�owe odno�niki, kt�rych oczekujesz +u�y� od zdalnego komputera, a plik status powinien by� kopi� +/var/lib/dpkg/status. Zauwa�, �e je�li u�ywasz lokalnego archiwum +musisz u�y� tych samych odno�nik�w o identycznej sk�adni.

-apt.conf musi zawieraæ niezbêdne wpisy, by APT korzysta³ z dysku: +apt.conf musi zawiera� niezb�dne wpisy, by APT korzysta� z dysku: APT { - /* Ten wpis nie jest wymagany je¶li oba komputery s± tej samej - architektury, mówi on APTowi na komputerze pobieraj±cym pakiety + /* Ten wpis nie jest wymagany je�li oba komputery s� tej samej + architektury, m�wi on APTowi na komputerze pobieraj�cym pakiety jakiej architektury jest nasz komputer */ Architecture "i386"; @@ -117,12 +117,12 @@ musisz u Dir { - /* U¿yj katalogu disc na informacje stanu i skieruj plik status + /* U�yj katalogu disc na informacje stanu i skieruj plik status z /var/lib/dpkg default */ State "/disc/"; State::status "status"; - // Katalog lokalnie przechowywanych pakietów binarnych + // Katalog lokalnie przechowywanych pakiet�w binarnych Cache::archives "/disc/archives/"; Cache "/tmp/"; @@ -131,15 +131,15 @@ musisz u }; -Wiêcej szczegó³ów mo¿na zobaczyæ w manualu apt.conf i w przyk³adowym pliku +Wi�cej szczeg���w mo�na zobaczy� w manualu apt.conf i w przyk�adowym pliku konfiguracyjnym /usr/doc/apt/examples/apt.conf.

-Pierwsz± rzecz± jaka nale¿y zrobiæ na oddalonym komputerze z Debianem to -zamontowaæ dysk i przekopiowaæ na niego plik /var/lib/dpkg/status. -Potrzeba tak¿e utworzyæ stukturê katalogów przedstawion± we Wprowadzeniu, -archives/partial/ i lists/partial/. Nastêpnie niesiemy -dysk do oddalonego komputera z szybkim ³±czem i konfigurujemy plik +Pierwsz� rzecz� jaka nale�y zrobi� na oddalonym komputerze z Debianem to +zamontowa� dysk i przekopiowa� na niego plik /var/lib/dpkg/status. +Potrzeba tak�e utworzy� stuktur� katalog�w przedstawion� we Wprowadzeniu, +archives/partial/ i lists/partial/. Nast�pnie niesiemy +dysk do oddalonego komputera z szybkim ��czem i konfigurujemy plik sources.list. Na oddalonym komputerze wykonujemy kolejno: @@ -151,54 +151,54 @@ sources.list. Na oddalonym komputerze wykonujemy kolejno: -Polecenie dist-upgrade mo¿na zast±piæ ka¿dym innym podstawowym poleceniem -APT, w szczególno¶ci dselect-upgrade. Mo¿esz nawet u¿yæ APT jako metodê -dostêpu dla dselect. Jednak stworzy to problem w przeniesieniu -twoich operacji wyborów z powrotem na lokalny komputer. +Polecenie dist-upgrade mo�na zast�pi� ka�dym innym podstawowym poleceniem +APT, w szczeg�lno�ci dselect-upgrade. Mo�esz nawet u�y� APT jako metod� +dost�pu dla dselect. Jednak stworzy to problem w przeniesieniu +twoich operacji wybor�w z powrotem na lokalny komputer.

W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa -niezbêdne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do +niezb�dne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do siebie i wpisujemy: # export APT_CONFIG="/disc/apt.conf" # apt-get check - [ APT tworzy lokaln± kopiê plików cache ] + [ APT tworzy lokaln� kopi� plik�w cache ] # apt-get --no-d -o dir::etc::status=/var/lib/dpkg/status dist-upgrade - [ Mo¿e te¿ byæ inne polecenie programu APT ] + [ Mo�e te� by� inne polecenie programu APT ]

-Koniecznym jest do prawid³owego dzia³ania podmieniæ plik status na lokalnej -maszynie. To jest bardzo wa¿ne! +Koniecznym jest do prawid�owego dzia�ania podmieni� plik status na lokalnej +maszynie. To jest bardzo wa�ne!

-Je¶li u¿ywasz dselect mo¿esz wykonaæ bardzo ryzykown± operacjê skopiowania -disc/status do /var/lib/dpkg/status tak, ¿e wszystkie zmiany które -dokona³e¶ na odleg³ym komputerze s± uaktualnione. Mocno zalecam aby -dokonywaæ doboru pakietów tylko na lokalnym komputerze, ale nie zawsze -jest to mo¿liwe. NIE podmieniaj pliku status je¶li dpkg lub APT by³y -uruchamiane w miêdzyczasie!! +Je�li u�ywasz dselect mo�esz wykona� bardzo ryzykown� operacj� skopiowania +disc/status do /var/lib/dpkg/status tak, �e wszystkie zmiany kt�re +dokona�e� na odleg�ym komputerze s� uaktualnione. Mocno zalecam aby +dokonywa� doboru pakiet�w tylko na lokalnym komputerze, ale nie zawsze +jest to mo�liwe. NIE podmieniaj pliku status je�li dpkg lub APT by�y +uruchamiane w mi�dzyczasie!! -U¿ywanie programów APT i wget +U�ywanie program�w APT i wget Wprowadzenie

-wget jest popularnym i przeno¶nym programem narzêdziowym -pobierania plików, który dzia³a na prawie ka¿dym komputerze. -W przeciwieñstwie do metody opisanej powy¿ej ta wymaga komputera z Debianem, -który ju¿ posiada listê dostêpnych pakietów. +wget jest popularnym i przeno�nym programem narz�dziowym +pobierania plik�w, kt�ry dzia�a na prawie ka�dym komputerze. +W przeciwie�stwie do metody opisanej powy�ej ta wymaga komputera z Debianem, +kt�ry ju� posiada list� dost�pnych pakiet�w.

-Nale¿y stworzyæ katalog disc tylko na pakiety do pobrania z innego -komputera. U¿yta zostanie do tego opcja --print-uris programu apt-get, -a nastêpnie przygotujemy skrypt dla programu wget, który pobierze w³a¶ciwe +Nale�y stworzy� katalog disc tylko na pakiety do pobrania z innego +komputera. U�yta zostanie do tego opcja --print-uris programu apt-get, +a nast�pnie przygotujemy skrypt dla programu wget, kt�ry pobierze w�a�ciwe pakiety. @@ -208,28 +208,28 @@ pakiety. Kolejne kroki

-W odró¿nieniu od poprzedniej metody dzia³ania ta nie wymaga specjalnych -plików konfiguracyjnych. U¿ywamy jedynie podstawowych poleceñ APT, by -wygenerowaæ listê plików. +W odr��nieniu od poprzedniej metody dzia�ania ta nie wymaga specjalnych +plik�w konfiguracyjnych. U�ywamy jedynie podstawowych polece� APT, by +wygenerowa� list� plik�w. # apt-get dist-upgrade - [ Wybierz no po znaku zachêty, upewnij siê czy to w³a¶ciwy wybór ] + [ Wybierz no po znaku zach�ty, upewnij si� czy to w�a?ciwy wyb�r ] # apt-get -qq --print-uris dist-upgrade > uris # awk '{print "wget -O " $2 " " $1}' < uris > /disc/wget-script -Tak¿e inne opcje ni¿ dist-upgrade mog± tu byæ u¿yte, w³±czaj±c +Tak�e inne opcje ni� dist-upgrade mog� tu by� u�yte, w��czaj�c dselect-upgrade.

-Plik skryptu /disc/wget-script bêdzie teraz zawieraæ listê poleceñ dla -programu wget, który uruchomi w porz±dku pobieranie potrzebnych archiwów. -Skrypt ten nale¿y uruchomiæ w bie¿±cym katalogu o punkcie montowania disc -tak aby tu zapisywa³ dane na dysku. +Plik skryptu /disc/wget-script b�dzie teraz zawiera� list� polece� dla +programu wget, kt�ry uruchomi w porz�dku pobieranie potrzebnych archiw�w. +Skrypt ten nale�y uruchomi� w bie��cym katalogu o punkcie montowania disc +tak aby tu zapisywa� dane na dysku.

-Na oddalonym komputerze nale¿y wykonaæ co¶ takiego +Na oddalonym komputerze nale�y wykona� co� takiego # cd /disc @@ -237,14 +237,14 @@ Na oddalonym komputerze nale [ czekaj.. ] -Gdy archiwa zosta³y pobrane i dysk wróci³ do komputera z Debianem, -instalowanie mo¿na prowadziæ dalej poleceniem, +Gdy archiwa zosta�y pobrane i dysk wr�ci� do komputera z Debianem, +instalowanie mo�na prowadzi� dalej poleceniem, # apt-get -o dir::cache::archives="/disc/" dist-upgrade -Które u¿yje pobrane uprzednio archiwa z dysku. +Kt�re u�yje pobrane uprzednio archiwa z dysku. -- 2.45.2