Fixed up share/doc stuff

[apt.git] / doc / examples / apt.conf

diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index affe5d8be2d4e7f97e852db9a8730c33c61fe6a7..6bd04c5e55b4e224117be662ffd279e0aee029aa 100644 (file)
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,7 +1,9 @@
-// $Id: apt.conf,v 1.33 1999/05/24 03:39:37 jgg Exp $
+// $Id: apt.conf,v 1.42 1999/10/31 06:32:28 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.
+   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
@@ -34,11 +36,17 @@ APT
      Print-URIs "false";
      Compile "false";
      No-Download "false";
+     Purge "false";
+     List-Cleanup "true";
+     ReInstall "false";
+     Trivial-Only "false";
+     No-Remove "false";
   };
 
   Cache 
   {
      Important "false";
+     AllVersions "false";
   };
 
   CDROM 
@@ -51,7 +59,10 @@ APT
 
   // Some general options
   Ignore-Hold "false";
+  Clean-Installed "true";
   Immediate-Configure "true";      // DO NOT turn this off, see the man page
+  Force-LoopBreak "false";         // DO NOT turn this on, see the man page
+  Cache-Limit "4194304";
 };
 
 // Options for the downloading routines
@@ -59,6 +70,7 @@ Acquire
 {
   Queue-Mode "host";       // host|access
   Retries "0";
+  Source-Symlinks "true";
   
   // HTTP method configuration
   http 
@@ -66,6 +78,7 @@ Acquire
     Proxy "http://127.0.0.1:3128";
     Proxy::http.us.debian.org "DIRECT";  // Specific per-host setting
     Timeout "120";
+    Pipeline-Depth "5";
     
     // Cache Control. Note these do not work with Squid 2.0.2
     No-Cache "false";
@@ -159,8 +172,8 @@ DSelect
 
 DPkg 
 {
-   // Probably don't want to set this one..
-   Options {"--force-downgrade";}
+   // Probably don't want to use force-downgrade..
+   Options {"--force-overwrite";"--force-downgrade";}
    
    // Auto re-mounting of a readonly /usr
    Pre-Invoke {"mount -o remount,rw /usr";};
@@ -171,6 +184,9 @@ DPkg
    
    // Build options for apt-get source --compile
    Build-Options "-b -uc";
+
+   // Pre-configure all packages before they are installed using debconf.
+   Pre-Install-Pkgs {"dpkg-preconfig --apt --priority=low --frontend=dialog";};
 }
 
 /* Options you can set to see some debugging text They corrispond to names
@@ -185,5 +201,10 @@ Debug
   pkgInitialize "false";   // This one will dump the configuration space
   NoLocking "false";
   Acquire::Ftp "false";    // Show ftp command traffic
+  Acquire::Http "false";   // Show http command traffic
   aptcdrom "false";        // Show found package files
 }
+
+/* Whatever you do, do not use this configuration file!! Take out ONLY
+   the portions you need */
+This Is Not A Valid Config File