Regex, --all-versions and more OR stuff

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

diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index 061b082dd1a74d69532708e8fdd7ab25c2b7d51c..2249cadba202dde7ab2b15d6aa176335cdf6b737 100644 (file)
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,9 +1,11 @@
-// $Id: apt.conf,v 1.18 1998/12/06 22:51:14 jgg Exp $
+// $Id: apt.conf,v 1.39 1999/10/22 04:05:48 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 involing filenames it is possible to set the default
+   In some instances involving 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.
    
@@ -16,26 +18,36 @@
 */
 
 // Options for APT in general
-APT {
+APT 
+{
   Architecture "i386";
   
   // Options for apt-get
-  Get {
+  Get 
+  {
      Download-Only "false";
      Simulate "false";
      Assume-Yes "false";
-     Force-Yes "false";  // I would never set this.
+     Force-Yes "false";             // I would never set this.
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
      No-Upgrade "false";
+     Print-URIs "false";
+     Compile "false";
+     No-Download "false";
+     Purge "false";
+     List-Cleanup "true";
   };
 
-  Cache {
+  Cache 
+  {
      Important "false";
+     AllVersions "false";
   };
-  
-  CDROM {
+
+  CDROM 
+  {
      Rename "false";
      NoMount "false";
      Fast "false";
@@ -43,29 +55,66 @@ APT {
   };
 
   // Some general options
-  Ingore-Hold "false";
+  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
 };
 
 // Options for the downloading routines
 Acquire
 {
   Queue-Mode "host";       // host|access
+  Retries "0";
+  Source-Symlinks "true";
   
   // HTTP method configuration
   http 
   {
     Proxy "http://127.0.0.1:3128";
     Proxy::http.us.debian.org "DIRECT";  // Specific per-host setting
+    Timeout "120";
     
     // Cache Control. Note these do not work with Squid 2.0.2
     No-Cache "false";
     Max-Age "86400";     // 1 Day age on index files
     No-Store "false";    // Prevent the cache from storing archives    
   };
+
+  ftp
+  {
+    Proxy "ftp://127.0.0.1/";
+    Proxy::http.us.debian.org "DIRECT"; // Specific per-host setting
+
+    /* Required script to perform proxy login. This example should work
+       for tisfwtk */
+    ProxyLogin
+    {
+       "USER $(PROXY_USER)";
+       "PASS $(PROXY_PASS)";
+       "USER $(SITE_USER)@$(SITE):$(SITE_PORT)";
+       "PASS $(SITE_PASS)";
+    };
+    
+    Timeout "120";
+    
+    /* Passive mode control, proxy, non-proxy and per-host. Pasv mode
+       is prefered if possible */
+    Passive "true";
+    Proxy::Passive "true";
+    Passive::http.us.debian.org "true"; // Specific per-host setting
+  };
   
   cdrom
   {
-    Mount "/cdrom";    
+    Mount "/cdrom";
+
+    // You need the trailing slash!
+    "/cdrom/"
+    {
+       Mount "sleep 1000";
+       UMount "sleep 500";
+    }
   };
 };
 
@@ -78,7 +127,8 @@ Dir
      lists "lists/";
      xstatus "xstatus";
      userstatus "status.user";
-     status "/var/lib/dpkg/status";     
+     status "/var/lib/dpkg/status";
+     cdroms "cdroms.list";
   };
   
   // Location of the cache dir
@@ -99,27 +149,57 @@ Dir
      methods "/usr/lib/apt/methods/";
      gzip "/bin/gzip";
      dpkg "/usr/bin/dpkg";
+     dpkg-source "/usr/bin/dpkg-source";
+     dpkg-buildpackage "/usr/bin/dpkg-buildpackage"
      apt-get "/usr/bin/apt-get";
-     apt-cache "/usr/bin/apt-get";
+     apt-cache "/usr/bin/apt-cache";
   };
 };
 
 // Things that effect the APT dselect method
-DSelect {
+DSelect 
+{
    Clean "auto";   // always|auto|prompt|never
    Options "-f";
    UpdateOptions "";
    PromptAfterUpdate "no";
 }
 
+DPkg 
+{
+   // 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";};
+   Post-Invoke {"mount -o remount,ro /usr";};
+   
+   // Prevents daemons from getting cwd as something mountable (default)
+   Run-Directory "/";
+   
+   // 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
    of classes in the source code */
-Debug {
+Debug 
+{
   pkgProblemResolver "false";
   pkgAcquire "false";
   pkgAcquire::Worker "false";
   pkgDPkgPM "false";
   
   pkgInitialize "false";   // This one will dump the configuration space
-  NoLocking "false";   
+  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