tags 270404 patch
thanks
Attached is a patch for supposedly fix this bug and include
offline.pl.* files in apt-doc.
As it indeed moves offline.pl.sgml out of doc/pl (otherwise, the file
is not built) and as I'm not deeply familiar with apt build system, I
prefer just sending a patch rather than commiting it in my archive.
--
diff -Nru apt-sarge/debian/rules apt-sarge.new/debian/rules
--- apt-sarge/debian/rules 2005-01-11 19:24:14.000000000 +0100
+++ apt-sarge.new/debian/rules 2005-01-13 18:42:59.000000000 +0100
@@ -169,7 +169,7 @@
#
# 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 -Nru apt-sarge/doc/makefile apt-sarge.new/doc/makefile
--- apt-sarge/doc/makefile 2005-01-11 19:24:12.000000000 +0100
+++ apt-sarge.new/doc/makefile 2005-01-13 18:42:31.000000000 +0100
@@ -8,7 +8,7 @@
# Debian Doc SGML Documents
SOURCE = dpkg-tech.sgml design.sgml files.sgml guide.sgml guide.it.sgml \
- cache.sgml method.sgml offline.sgml
+ cache.sgml method.sgml offline.sgml offline.pl.sgml
include $(DEBIANDOC_H)
# XML man pages
diff -Nru apt-sarge/doc/offline.pl.sgml apt-sarge.new/doc/offline.pl.sgml
--- apt-sarge/doc/offline.pl.sgml 1970-01-01 01:00:00.000000000 +0100
+++ apt-sarge.new/doc/offline.pl.sgml 2005-01-13 18:41:27.000000000 +0100
@@ -0,0 +1,250 @@
+<!doctype debiandoc system>
+<!-- -*- mode: sgml; mode: fold -*- -->
+<book>
+<title>Uïywanie APT w trybie offline</title>
+
+<author>Jason Gunthorpe <email>[EMAIL PROTECTED]</email></author>
+<author>Polskie tïumaczenie Krzysztof Fiertek <email>[EMAIL
PROTECTED]</email></author>
+<version>$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $</version>
+
+<abstract>
+Dokument ten opisuje jak uïywaï programu APT w ïrodowiskach
niesieciowych,
+a w szczegïlnoïci metodï pozwalajïcï na robienie aktualizacji
systemu.
+</abstract>
+
+<copyright>
+Copyright © Jason Gunthorpe, 1999.
+<p>
+Copyright © polskiego tïumaczenia Krzysztof Fiertek, 2004.
+<p>
+"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.
+
+<p>
+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).
+</copyright
+
+<toc sect>
+
+<chapt>Wstïp
+<!-- Overview {{{ -->
+<!-- ===================================================================== -->
+<sect>Wprowadzenie
+
+<p>
+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.
+
+<p>
+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.
+
+<p>
+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.
+
+</sect>
+ <!-- }}} -->
+
+<chapt>Uïywanie programu APT na obu komputerach
+<!-- Overview {{{ -->
+<!-- ===================================================================== -->
+<sect>Wprowadzenie
+
+<p>
+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:
+
+<example>
+ /disc/
+ archives/
+ partial/
+ lists/
+ partial/
+ status
+ sources.list
+ apt.conf
+</example>
+
+</sect>
+ <!-- }}} -->
+<!-- The configuartion file {{{ -->
+<!-- ===================================================================== -->
+<sect>Plik konfiguracyjny
+
+<p>
+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ï
+<em>/var/lib/dpkg/status</em>. Zauwaï, ïe jeïli uïywasz lokalnego
archiwum
+musisz uïyï tych samych odnoïnikïw o identycznej skïadni.
+
+<p>
+<em>apt.conf</em> musi zawieraï niezbïdne wpisy, by APT korzystaï z
dysku:
+
+<example>
+ APT
+ {
+ /* 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";
+
+ Get::Download-Only "true";
+ };
+
+ Dir
+ {
+ /* 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
+ Cache::archives "/disc/archives/";
+ Cache "/tmp/";
+
+ // Lokalizacja pliku sources.list.
+ Etc "/disc
+ };
+</example>
+
+Wiïcej szczegïïïw moïna zobaczyï w manualu apt.conf i w
przykïadowym pliku
+konfiguracyjnym <em>/usr/doc/apt/examples/apt.conf</em>.
+
+<p>
+Pierwszï rzeczï jaka naleïy zrobiï na oddalonym komputerze z Debianem
to
+zamontowaï dysk i przekopiowaï na niego plik <em>/var/lib/dpkg/status</em>.
+Potrzeba takïe utworzyï stukturï katalogïw przedstawionï we
Wprowadzeniu,
+<em>archives/partial/</em> i <em>lists/partial/</em>. Nastïpnie niesiemy
+dysk do oddalonego komputera z szybkim ïïczem i konfigurujemy plik
+sources.list. Na oddalonym komputerze wykonujemy kolejno:
+
+<example>
+ # export APT_CONFIG="/disc/apt.conf"
+ # apt-get update
+ [ APT aktualizuje ustawienia ]
+ # apt-get dist-upgrade
+ [ APT pobiera wszystkie potrzebne pakiety do aktualizacji twojego systemu ]
+
+</example>
+
+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 <em>dselect</em>. Jednak stworzy to problem w przeniesieniu
+twoich operacji wyborïw z powrotem na lokalny komputer.
+
+<p>
+W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa
+niezbïdne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do
+siebie i wpisujemy:
+
+<example>
+ # export APT_CONFIG="/disc/apt.conf"
+ # apt-get check
+ [ 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 ]
+</example>
+
+<p>
+Koniecznym jest do prawidïowego dziaïania podmieniï plik status na
lokalnej
+maszynie. To jest bardzo waïne!
+
+<p>
+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!!
+
+</sect>
+ <!-- }}} -->
+
+<chapt>Uïywanie programïw APT i wget
+<!-- Overview {{{ -->
+<!-- ===================================================================== -->
+<sect>Wprowadzenie
+
+<p>
+<em>wget</em> 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.
+
+<p>
+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.
+
+</sect>
+ <!-- }}} -->
+<!-- Operation {{{ -->
+<!-- ===================================================================== -->
+<sect>Kolejne kroki
+
+<p>
+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.
+
+<example>
+ # apt-get dist-upgrade
+ [ 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
+</example>
+
+Takïe inne opcje niï dist-upgrade mogï tu byï uïyte, wïïczajïc
+dselect-upgrade.
+
+<p>
+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.
+
+<p>
+Na oddalonym komputerze naleïy wykonaï coï takiego
+
+<example>
+ # cd /disc
+ # sh -x ./wget-script
+ [ czekaj.. ]
+</example>
+
+Gdy archiwa zostaïy pobrane i dysk wrïciï do komputera z Debianem,
+instalowanie moïna prowadziï dalej poleceniem,
+
+<example>
+ # apt-get -o dir::cache::archives="/disc/" dist-upgrade
+</example>
+
+Ktïre uïyje pobrane uprzednio archiwa z dysku.
+</sect>
+ <!-- }}} -->
+</book>
diff -Nru apt-sarge/doc/pl/offline.pl.sgml apt-sarge.new/doc/pl/offline.pl.sgml
--- apt-sarge/doc/pl/offline.pl.sgml 2005-01-11 19:24:13.000000000 +0100
+++ apt-sarge.new/doc/pl/offline.pl.sgml 1970-01-01 01:00:00.000000000
+0100
@@ -1,250 +0,0 @@
-<!doctype debiandoc system>
-<!-- -*- mode: sgml; mode: fold -*- -->
-<book>
-<title>Uïywanie APT w trybie offline</title>
-
-<author>Jason Gunthorpe <email>[EMAIL PROTECTED]</email></author>
-<author>Polskie tïumaczenie Krzysztof Fiertek <email>[EMAIL
PROTECTED]</email></author>
-<version>$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $</version>
-
-<abstract>
-Dokument ten opisuje jak uïywaï programu APT w ïrodowiskach
niesieciowych,
-a w szczegïlnoïci metodï pozwalajïcï na robienie aktualizacji
systemu.
-</abstract>
-
-<copyright>
-Copyright © Jason Gunthorpe, 1999.
-<p>
-Copyright © polskiego tïumaczenia Krzysztof Fiertek, 2004.
-<p>
-"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.
-
-<p>
-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).
-</copyright
-
-<toc sect>
-
-<chapt>Wstïp
-<!-- Overview {{{ -->
-<!-- ===================================================================== -->
-<sect>Wprowadzenie
-
-<p>
-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.
-
-<p>
-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.
-
-<p>
-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.
-
-</sect>
- <!-- }}} -->
-
-<chapt>Uïywanie programu APT na obu komputerach
-<!-- Overview {{{ -->
-<!-- ===================================================================== -->
-<sect>Wprowadzenie
-
-<p>
-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:
-
-<example>
- /disc/
- archives/
- partial/
- lists/
- partial/
- status
- sources.list
- apt.conf
-</example>
-
-</sect>
- <!-- }}} -->
-<!-- The configuartion file {{{ -->
-<!-- ===================================================================== -->
-<sect>Plik konfiguracyjny
-
-<p>
-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ï
-<em>/var/lib/dpkg/status</em>. Zauwaï, ïe jeïli uïywasz lokalnego
archiwum
-musisz uïyï tych samych odnoïnikïw o identycznej skïadni.
-
-<p>
-<em>apt.conf</em> musi zawieraï niezbïdne wpisy, by APT korzystaï z
dysku:
-
-<example>
- APT
- {
- /* 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";
-
- Get::Download-Only "true";
- };
-
- Dir
- {
- /* 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
- Cache::archives "/disc/archives/";
- Cache "/tmp/";
-
- // Lokalizacja pliku sources.list.
- Etc "/disc
- };
-</example>
-
-Wiïcej szczegïïïw moïna zobaczyï w manualu apt.conf i w
przykïadowym pliku
-konfiguracyjnym <em>/usr/doc/apt/examples/apt.conf</em>.
-
-<p>
-Pierwszï rzeczï jaka naleïy zrobiï na oddalonym komputerze z Debianem
to
-zamontowaï dysk i przekopiowaï na niego plik <em>/var/lib/dpkg/status</em>.
-Potrzeba takïe utworzyï stukturï katalogïw przedstawionï we
Wprowadzeniu,
-<em>archives/partial/</em> i <em>lists/partial/</em>. Nastïpnie niesiemy
-dysk do oddalonego komputera z szybkim ïïczem i konfigurujemy plik
-sources.list. Na oddalonym komputerze wykonujemy kolejno:
-
-<example>
- # export APT_CONFIG="/disc/apt.conf"
- # apt-get update
- [ APT aktualizuje ustawienia ]
- # apt-get dist-upgrade
- [ APT pobiera wszystkie potrzebne pakiety do aktualizacji twojego systemu ]
-
-</example>
-
-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 <em>dselect</em>. Jednak stworzy to problem w przeniesieniu
-twoich operacji wyborïw z powrotem na lokalny komputer.
-
-<p>
-W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa
-niezbïdne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do
-siebie i wpisujemy:
-
-<example>
- # export APT_CONFIG="/disc/apt.conf"
- # apt-get check
- [ 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 ]
-</example>
-
-<p>
-Koniecznym jest do prawidïowego dziaïania podmieniï plik status na
lokalnej
-maszynie. To jest bardzo waïne!
-
-<p>
-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!!
-
-</sect>
- <!-- }}} -->
-
-<chapt>Uïywanie programïw APT i wget
-<!-- Overview {{{ -->
-<!-- ===================================================================== -->
-<sect>Wprowadzenie
-
-<p>
-<em>wget</em> 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.
-
-<p>
-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.
-
-</sect>
- <!-- }}} -->
-<!-- Operation {{{ -->
-<!-- ===================================================================== -->
-<sect>Kolejne kroki
-
-<p>
-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.
-
-<example>
- # apt-get dist-upgrade
- [ 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
-</example>
-
-Takïe inne opcje niï dist-upgrade mogï tu byï uïyte, wïïczajïc
-dselect-upgrade.
-
-<p>
-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.
-
-<p>
-Na oddalonym komputerze naleïy wykonaï coï takiego
-
-<example>
- # cd /disc
- # sh -x ./wget-script
- [ czekaj.. ]
-</example>
-
-Gdy archiwa zostaïy pobrane i dysk wrïciï do komputera z Debianem,
-instalowanie moïna prowadziï dalej poleceniem,
-
-<example>
- # apt-get -o dir::cache::archives="/disc/" dist-upgrade
-</example>
-
-Ktïre uïyje pobrane uprzednio archiwa z dysku.
-</sect>
- <!-- }}} -->
-</book>
