summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMatt Zimmerman <matt.zimmerman@canonical.com>2004-11-13 18:27:46 +0000
committerMatt Zimmerman <matt.zimmerman@canonical.com>2004-11-13 18:27:46 +0000
commit640c5d948afa27a8e71eb6c03f1e0d55f81773c5 (patch)
tree02bffabc3d80410d347322a83a6adc86c8544208 /doc
parente91cfaca9f2a4ba23f89f91ad21e63095b50bdb3 (diff)
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)
Diffstat (limited to 'doc')
-rw-r--r--doc/apt.conf.5.xml4
-rw-r--r--doc/examples/configure-index35
-rw-r--r--doc/makefile7
-rw-r--r--doc/pl/makefile10
-rw-r--r--doc/pl/offline.pl.sgml250
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>