Merge from CVS

Patches applied: * apt@arch.ubuntu.com/apt--MAIN--0--patch-1304 Basque correction. * apt@arch.ubuntu.com/apt--MAIN--0--patch-1305 Updated Brazilian Portuguese and Greek (256396 and 2567... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1306 New Korean translation from Changwoo Ryu <cwryu@debian.... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1307 German translation now available in two flavours: with ... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1308 Finalize 0.5.26 * apt@arch.ubuntu.com/apt--MAIN--0--patch-1309 Remove duplicate entry * apt@arch.ubuntu.com/apt--MAIN--0--patch-1310 Note about archtable when architecture test fails * apt@arch.ubuntu.com/apt--MAIN--0--patch-1311 0.5.26 (really) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1312 German translation now available in two flavours: with ... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1313 New Finnish translation from Tapio Lehtonen <tale@debia... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1314 New Bosnian translation from Safir ��e��erovi�� <sapphi... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1315 Fix Italian incontrario * apt@arch.ubuntu.com/apt--MAIN--0--patch-1316 * Bring configure-index up to date with documented opti... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1317 configure-index contains example values, not strictly d... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1318 Updated Spanish from Ruben Porras (Closes:#260483) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1319 Updated Danish from Claus Hindsgaul (Closes: #260569) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1320 Updated Slovak from Peter Mann (Closes: #260627) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1321 Updated Portuguese from Miguel Figueiredo (Closes: #261423) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1322 * Add Polish translation of offline.sgml (Closes: #259229) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1323 urgency=high * apt@arch.ubuntu.com/apt--MAIN--0--patch-1324 Sync with new POT. * apt@arch.ubuntu.com/apt--MAIN--0--patch-1325 Updated Hungarian from Kelemen G��bor <kelemeng@gnome.hu>. * apt@arch.ubuntu.com/apt--MAIN--0--patch-1326 Updated Greek from George Papamichelakis (Closes: #265004) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1327 Updated Simplified Chinese from Tchaikov (Closes: #265190) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1328 Updated French by Christian Perrier (Closes: #265816) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1329 Updated Japanese by Kenshi Muto (Closes: #265630) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1330 Updated French by Christian Perrier (Closes: #265816) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1331 - Updated Catalan from Jordi Mallach * apt@arch.ubuntu.com/apt--MAIN--0--patch-1332 Updated Dutch from Bart Cornelis (Closes: #268258) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1333 Updated Portuguese from Miguel Figueiredo (Closes: #268265) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1334 Updated Dutch from Bart Cornelis (Closes: #268258) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1335 APT::Get::APT::Get::No-List-Cleanup -> APT::Get::List-C... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1336 Updated Polish from Robert Luberda <robert@debian.org> ... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1337 Updated Danish from Claus Hindsgaul (Closes: #269417) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1338 Updated Norwegian Nynorsk from H��vard Korsvoll <korsvo... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1339 Updated Russian from Yuri Kozlov <yuray@id.ru> (Closes:... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1340 Updated Italian from Samuele Giovanni Tonon (Closes: #2... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1341 Updated Dutch from Bart Cornelis (Closes: #278697) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1342 Updated Slovak from Peter Mann (Closes: #279481)
author: Matt Zimmerman <matt.zimmerman@canonical.com> 2004-11-13 18:27:46 +0000
committer: Matt Zimmerman <matt.zimmerman@canonical.com> 2004-11-13 18:27:46 +0000
commit: 640c5d948afa27a8e71eb6c03f1e0d55f81773c5 (patch)
tree: 02bffabc3d80410d347322a83a6adc86c8544208 /doc
parent: e91cfaca9f2a4ba23f89f91ad21e63095b50bdb3 (diff)
5 files changed, 291 insertions, 15 deletions
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index eed5b8d52..b5d223372 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -377,8 +377,8 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
  </refsect1>
  
  <refsect1><title>Examples</title>
-   <para>&configureindex; contains a 
-   sample configuration file showing the default values for all possible 
+   <para>&configureindex; is a 
+   configuration file showing example values for all possible 
    options.</para>
  </refsect1>
  
diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index 2f9d09873..7cb29f082 100644
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -1,9 +1,9 @@
-// $Id: configure-index,v 1.9 2004/04/29 17:30:22 mdz Exp $
+// $Id: configure-index,v 1.10 2004/07/17 19:37:16 mdz Exp $
 /* This file is an index of all APT configuration directives. It should
-   NOT actually be used as a real config file, though it is a completely
-   valid file. Most of the options have sane default values, unless
-   you have specific needs you should NOT include arbitary items in a custom
-   configuration.
+   NOT actually be used as a real config file, though it is (except for the
+   last line) a completely valid file. Most of the options have sane default
+   values, unless you have specific needs you should NOT include arbitary
+   items in a custom configuration.
    
    In some instances involving filenames it is possible to set the default
    directory when the path is evaluated. This means you can use relative
@@ -17,6 +17,8 @@
    if an option is specified on the command line with -o.
 */
 
+quiet "0";
+
 // Options for APT in general
 APT 
 {
@@ -34,6 +36,7 @@ APT
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
+     Show-Versions "false";
      Upgrade "true";
      Print-URIs "false";
      Compile "false";
@@ -43,6 +46,9 @@ APT
      ReInstall "false";
      Trivial-Only "false";
      Remove "true";
+     Only-Source "";
+     Diff-Only "false";
+     Tar-Only "false";
   };
 
   Cache 
@@ -51,6 +57,11 @@ APT
      AllVersions "false";
      GivenOnly "false";
      RecurseDepends "false";
+     ShowFull "false";
+     Generate "true";
+     NamesOnly "false";
+     AllNames "false";
+     Installed "false";
   };
 
   CDROM 
@@ -117,7 +128,7 @@ Acquire
   
   cdrom
   {
-    Mount "/cdrom";
+    mount "/cdrom";
 
     // You need the trailing slash!
     "/cdrom/"
@@ -134,7 +145,7 @@ Dir "/"
   // Location of the state dir
   State "var/lib/apt/" 
   {
-     lists "lists/";
+     Lists "lists/";
      xstatus "xstatus";
      userstatus "status.user";
      status "/var/lib/dpkg/status";
@@ -143,16 +154,17 @@ Dir "/"
   
   // Location of the cache dir
   Cache "var/cache/apt/" {
-     archives "archives/";
+     Archives "archives/";
      srcpkgcache "srcpkgcache.bin";
      pkgcache "pkgcache.bin";     
   };
   
   // Config files
   Etc "etc/apt/" {
-     sourcelist "sources.list";
-     main "apt.conf";
-     preferences "preferences";     
+     SourceList "sources.list";
+     Main "apt.conf";
+     Preferences "preferences";     
+     Parts "apt.conf.d/";
   };
   
   // Locations of binaries
@@ -218,6 +230,7 @@ Debug
   Acquire::Ftp "false";    // Show ftp command traffic
   Acquire::Http "false";   // Show http command traffic
   aptcdrom "false";        // Show found package files
+  IdentCdrom "false";
 }
 
 /* Whatever you do, do not use this configuration file!! Take out ONLY
diff --git a/doc/makefile b/doc/makefile
index 1287cfc5f..ace9010df 100644
--- a/doc/makefile
+++ b/doc/makefile
@@ -1,7 +1,7 @@
 # -*- make -*-
 BASE=..
 SUBDIR=doc
-SUBDIRS= fr ja pt_BR es
+SUBDIRS= fr ja pl pt_BR es
 
 # Bring in the default rules
 include ../buildlib/defaults.mak
@@ -25,7 +25,7 @@ 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.pt_BR doc.es
+doc: doc.fr doc.ja doc.pl doc.pt_BR doc.es
 
 doc.fr: %.fr:
 	$(MAKE) -C fr $*
@@ -38,3 +38,6 @@ doc.es: %.es:
 
 doc.ja: %.ja:
 	$(MAKE) -C ja $*
+
+doc.pl: %.pl:
+	$(MAKE) -C pl $*
diff --git a/doc/pl/makefile b/doc/pl/makefile
new file mode 100644
index 000000000..72a505422
--- /dev/null
+++ b/doc/pl/makefile
@@ -0,0 +1,10 @@
+# -*- make -*-
+BASE=../..
+SUBDIR=doc/pl
+
+# Bring in the default rules
+include ../../buildlib/defaults.mak
+
+# Debian Doc SGML Documents
+SOURCE = offline.pl.sgml
+include $(DEBIANDOC_H)
diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml
new file mode 100644
index 000000000..48f84e3b1
--- /dev/null
+++ b/doc/pl/offline.pl.sgml
@@ -0,0 +1,250 @@
+<!doctype debiandoc system>
+<!-- -*- mode: sgml; mode: fold -*- -->
+<book>
+<title>U�ywanie APT w trybie offline</title>
+
+<author>Jason Gunthorpe <email>jgg@debian.org</email></author>
+<author>Polskie t�umaczenie Krzysztof Fiertek <email>akfedux@megapolis.pl</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 &copy; Jason Gunthorpe, 1999.
+<p>
+Copyright &copy; 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>
author	Matt Zimmerman <matt.zimmerman@canonical.com>	2004-11-13 18:27:46 +0000
committer	Matt Zimmerman <matt.zimmerman@canonical.com>	2004-11-13 18:27:46 +0000
commit	640c5d948afa27a8e71eb6c03f1e0d55f81773c5 (patch)
tree	02bffabc3d80410d347322a83a6adc86c8544208 /doc
parent	e91cfaca9f2a4ba23f89f91ad21e63095b50bdb3 (diff)