1 files changed, 29 insertions, 8 deletions

diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index dc2f9cc3a..bbc3c7ea4 100644
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,12 +1,25 @@
-// $Id: apt.conf,v 1.6 1998/10/26 07:11:51 jgg Exp $
+// $Id: apt.conf,v 1.7 1998/10/30 07:53:50 jgg 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.
+   
+   In some instances involing filenames it is possible to set the default
+   directory when the path is evaluated. This means you can use relative
+   paths within the sub scope.
+   
+   The configuration directives are specified in a tree with {} designating
+   a subscope relative to the tag before the {}. You can further specify
+   a subscope using scope notation eg,
+     APT::Architecture "i386";
+   This is prefixed with the current scope. Scope notation must be used
+   if an option is specified on the command line with -o.
 */
 
+// Options for APT in general
 APT {
   Architecture "i386";
   
+  // Options for apt-get
   Get {
      Download-Only "false";
      Simulate "false";
@@ -15,17 +28,20 @@ APT {
      Show-Upgraded "false";
   };
   
+  // Some general options
   Ingore-Hold "false";
 };
 
+// Options for the downloading routines
 Acquire
 {
   Queue-Mode "access";       // host|access
 };
 
+// Directory layout
 Dir 
 {
-  
+  // Location of the state dir
   State "/var/state/apt/" 
   {
      lists "lists/";
@@ -34,20 +50,23 @@ Dir
      status "/var/lib/dpkg/status";     
   };
   
+  // Location of the cache dir
   Cache "/var/cache/apt/" {
      archives "archives/";
      srcpkgcache "srcpkgcache.bin";
      pkgcache "pkgcache.bin";     
   };
   
+  // Config files
   Etc "/etc/apt/" {
-     sourcelist "sources.list.test";
+     sourcelist "sources.list";
      main "apt.conf";
   };
   
+  // Locations of binaries
   Bin {
      methods "/home/jgg/work/apt/build/bin/methods/";
-     gzip "gzip";
+     gzip "/bin/gzip";
   };
 };
 
@@ -55,10 +74,12 @@ DSelect {
 
 }
 
+/* Options you can set to see some debugging text They corrispond to names
+   of classes in the source code */
 Debug {
-  pkgProblemResolver "true";
+  pkgProblemResolver "false";
   pkgAcquire "false";
-  pkgAcquire::Worker "true";
+  pkgAcquire::Worker "false";
+  
+  pkgInitialize "false";   // This one will dump the configuration space
 }
-
-dir::state::lists "/tmp/lists/";