* apt-pkg/deb/dpkgpm.cc:

[apt.git] / doc / offline.sgml

diff --git a/doc/offline.sgml b/doc/offline.sgml
index 9a664ac3d7604c4ae3dc9d3d4173e81feb60875c..ecbd85cf7da0a67d53c932686496dbb8588c556c 100644 (file)
--- a/doc/offline.sgml
+++ b/doc/offline.sgml
@@ -1,10 +1,10 @@
-<!doctype debiandoc system>
 <!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype debiandoc  PUBLIC  "-//DebianDoc//DTD DebianDoc//EN">
 <book>
 <title>Using APT Offline</title>
 
 <author>Jason Gunthorpe <email>jgg@debian.org</email></author>
-<version>$Id: offline.sgml,v 1.2 2000/02/13 07:20:47 jgg Exp $</version>
+<version>$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $</version>
 
 <abstract>
 This document describes how to use APT in a non-networked environment, 
@@ -21,7 +21,7 @@ option) any later version.
 
 <p>
 For more details, on Debian GNU/Linux systems, see the file
-/usr/doc/copyright/GPL for the full license.
+/usr/share/common-licenses/GPL for the full license.
 </copyright>
 
 <toc sect>
@@ -43,7 +43,7 @@ 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 
+even possible to use another Debian machine with APT or to use a completely 
 different OS and a download tool like wget.
 
 <p>
@@ -114,17 +114,18 @@ disc:
 
    // Binary caches will be stored locally
    Cache::archives "/disc/archives/";
- 
+   Cache "/tmp/";
+   
    // Location of the source list.
    Etc "/disc/";
  }; 
 </example>
 
 More details can be seen by examining the apt.conf man page and the sample
-configuration file in <em>/usr/doc/apt/examples/apt.conf</em>.
+configuration file in <em>/usr/share/doc/apt/examples/apt.conf</em>.
 
 <p>
-On the Debian machine the first thing to do is mount the disc and copy 
+On the remote Debian 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. 
@@ -139,8 +140,9 @@ On the remote machine execute the following:
 </example>
 
 The dist-upgrade command can be replaced with any-other standard APT commands,
-you can even use an APT front end such as <em>gnome-apt</em> [still in 
-development].
+particularly dselect-upgrad. 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.
 
 <p>
 Now the disc contains all of the index files and archives needed to upgrade
@@ -150,7 +152,7 @@ the Debian machine. Take the disc back and run:
   # export APT_CONFIG="/disc/apt.conf"
   # apt-get check
   [ APT generates a local copy of the cache files ]
-  # apt-get --no-d -o dir::etc::status=/var/lib/dpkg/status dist-upgrade
+  # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade
   [ Or any other APT command ]
 </example>
 
@@ -158,6 +160,13 @@ the Debian machine. Take the disc back and run:
 It is necessary for proper function to re-specify the status file to be the 
 local one. This is very important!
 
+<p>
+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!!
+
 </sect>
                                                                   <!-- }}} -->
 
@@ -193,6 +202,10 @@ merely use the standard APT commands to generate the file list.
  # awk '{print "wget -O " $2 " " $1}' < uris > /disc/wget-script
 </example>
 
+Any command other than dist-upgrade could be used here, including 
+dselect-upgrade.
+
+<p>
 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