* merged with apt@packages.debian.org/apt--main--0

[apt.git] / doc / examples / configure-index

diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index 58492cd57ee0317404886170ac505ab8d2fcbe6b..dee0c06ffeee1ed3b1003bb5daa7a358dbd89b44 100644 (file)
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -1,9 +1,9 @@
-// $Id: configure-index,v 1.1 1999/12/06 02:19:39 jgg 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,14 +17,18 @@
    if an option is specified on the command line with -o.
 */
 
+quiet "0";
+
 // Options for APT in general
 APT 
 {
   Architecture "i386";
+  Build-Essential "build-essential";
   
   // Options for apt-get
   Get 
   {
+     Arch-Only "false";
      Download-Only "false";
      Simulate "false";
      Assume-Yes "false";
@@ -32,21 +36,32 @@ APT
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
-     No-Upgrade "false";
+     Show-Versions "false";
+     Upgrade "true";
      Print-URIs "false";
      Compile "false";
-     No-Download "false";
+     Download "true";
      Purge "false";
      List-Cleanup "true";
      ReInstall "false";
      Trivial-Only "false";
-     No-Remove "false";
+     Remove "true";
+     Only-Source "";
+     Diff-Only "false";
+     Tar-Only "false";
   };
 
   Cache 
   {
      Important "false";
      AllVersions "false";
+     GivenOnly "false";
+     RecurseDepends "false";
+     ShowFull "false";
+     Generate "true";
+     NamesOnly "false";
+     AllNames "false";
+     Installed "false";
   };
 
   CDROM 
@@ -57,12 +72,25 @@ APT
      NoAct "false";
   };
 
+  GPGV
+  {
+     TrustedKeyring "/etc/apt/trusted.gpg";
+  };
+
   // 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";
+  Default-Release "";
+
+
+  // Write progress messages on this fd (for stuff like base-config)
+  Status-Fd "-1";
+  // Keep the list of FDs open (normally apt closes all fds when it
+  // does a ExecFork)
+  Keep-Fds {};
 };
 
 // Options for the downloading routines
@@ -112,7 +140,7 @@ Acquire
   
   cdrom
   {
-    Mount "/cdrom";
+    mount "/cdrom";
 
     // You need the trailing slash!
     "/cdrom/"
@@ -121,15 +149,20 @@ Acquire
        UMount "sleep 500";
     }
   };
+
+  gpgv
+  {
+   Options {"--ignore-time-conflict";} // not very usefull on a normal system
+  };
 };
 
 // Directory layout
-Dir 
+Dir "/"
 {
   // Location of the state dir
-  State "/var/state/apt/" 
+  State "var/lib/apt/" 
   {
-     lists "lists/";
+     Lists "lists/";
      xstatus "xstatus";
      userstatus "status.user";
      status "/var/lib/dpkg/status";
@@ -137,25 +170,28 @@ Dir
   };
   
   // Location of the cache dir
-  Cache "/var/cache/apt/" {
-     archives "archives/";
+  Cache "var/cache/apt/" {
+     Archives "archives/";
      srcpkgcache "srcpkgcache.bin";
      pkgcache "pkgcache.bin";     
   };
   
   // Config files
-  Etc "/etc/apt/" {
-     sourcelist "sources.list";
-     main "apt.conf";
+  Etc "etc/apt/" {
+     SourceList "sources.list";
+     Main "apt.conf";
+     Preferences "preferences";     
+     Parts "apt.conf.d/";
   };
   
   // Locations of binaries
   Bin {
      methods "/usr/lib/apt/methods/";
      gzip "/bin/gzip";
+     gpg  "/usr/bin/gpgv";
      dpkg "/usr/bin/dpkg";
      dpkg-source "/usr/bin/dpkg-source";
-     dpkg-buildpackage "/usr/bin/dpkg-buildpackage"
+     dpkg-buildpackage "/usr/bin/dpkg-buildpackage";
      apt-get "/usr/bin/apt-get";
      apt-cache "/usr/bin/apt-cache";
   };
@@ -168,6 +204,7 @@ DSelect
    Options "-f";
    UpdateOptions "";
    PromptAfterUpdate "no";
+   CheckDir "no";
 }
 
 DPkg 
@@ -186,10 +223,17 @@ DPkg
    Build-Options "-b -uc";
 
    // Pre-configure all packages before they are installed using debconf.
-   Pre-Install-Pkgs {"dpkg-preconfig --apt --priority=low --frontend=dialog";};
+   Pre-Install-Pkgs {"dpkg-preconfigure --apt --priority=low --frontend=dialog";};
+
+   // Flush the contents of stdin before forking dpkg.
+   FlushSTDIN "true";
+
+   // Control the size of the command line passed to dpkg.
+   MaxBytes 1024;
+   MaxArgs 350;
 }
 
-/* Options you can set to see some debugging text They corrispond to names
+/* Options you can set to see some debugging text They correspond to names
    of classes in the source code */
 Debug 
 {
@@ -197,12 +241,17 @@ Debug
   pkgAcquire "false";
   pkgAcquire::Worker "false";
   pkgDPkgPM "false";
+  pkgDPkgProgressReporting "false";
+  pkgOrderList "false";
   
   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
+  Acquire::gpgv "false";   // Show the gpgv traffic
   aptcdrom "false";        // Show found package files
+  IdentCdrom "false";
+  
 }
 
 /* Whatever you do, do not use this configuration file!! Take out ONLY