* add --dsc-only option, thanks to K. Richard Pixley

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

diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index 2f9d0987366ea9b0abb540dff3eb02f7091c2a97..73e20aa435c7be50c4871cd7b7bf154e05c9640b 100644 (file)
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -1,9 +1,9 @@
-// $Id: configure-index,v 1.9 2004/04/29 17:30:22 mdz 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
 /* 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
    
    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,6 +17,8 @@
    if an option is specified on the command line with -o.
 */
 
    if an option is specified on the command line with -o.
 */
 

+quiet "0";
+

 // Options for APT in general
 APT 
 {
 // Options for APT in general
 APT 
 {


@@ -34,6 +36,7 @@ APT
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";
      Fix-Broken "false";  
      Fix-Missing "false";     
      Show-Upgraded "false";

+     Show-Versions "false";

      Upgrade "true";
      Print-URIs "false";
      Compile "false";
      Upgrade "true";
      Print-URIs "false";
      Compile "false";


@@ -43,6 +46,9 @@ APT
      ReInstall "false";
      Trivial-Only "false";
      Remove "true";
      ReInstall "false";
      Trivial-Only "false";
      Remove "true";

+     Only-Source "";
+     Diff-Only "false";
+     Tar-Only "false";

   };
 
   Cache 
   };
 
   Cache 


@@ -51,6 +57,11 @@ APT
      AllVersions "false";
      GivenOnly "false";
      RecurseDepends "false";
      AllVersions "false";
      GivenOnly "false";
      RecurseDepends "false";

+     ShowFull "false";
+     Generate "true";
+     NamesOnly "false";
+     AllNames "false";
+     Installed "false";

   };
 
   CDROM 
   };
 
   CDROM 


@@ -61,6 +72,16 @@ APT
      NoAct "false";
   };
 
      NoAct "false";
   };
 

+  Authentication
+  {
+     TrustCDROM "false";            // consider the CDROM always trusted
+  };
+
+  GPGV
+  {
+     TrustedKeyring "/etc/apt/trusted.gpg";
+  };
+

   // Some general options
   Ignore-Hold "false";
   Clean-Installed "true";
   // Some general options
   Ignore-Hold "false";
   Clean-Installed "true";


@@ -68,6 +89,13 @@ APT
   Force-LoopBreak "false";         // DO NOT turn this on, see the man page
   Cache-Limit "4194304";
   Default-Release "";
   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
 };
 
 // Options for the downloading routines


@@ -89,6 +117,7 @@ Acquire
     No-Cache "false";
     Max-Age "86400";     // 1 Day age on index files
     No-Store "false";    // Prevent the cache from storing archives    
     No-Cache "false";
     Max-Age "86400";     // 1 Day age on index files
     No-Store "false";    // Prevent the cache from storing archives    

+    Dl-Limit "7";        // 7Kb/sec maximum download rate

   };
 
   ftp
   };
 
   ftp


@@ -117,7 +146,7 @@ Acquire
   
   cdrom
   {
   
   cdrom
   {

-    Mount "/cdrom";
+    mount "/cdrom";

 
     // You need the trailing slash!
     "/cdrom/"
 
     // You need the trailing slash!
     "/cdrom/"


@@ -126,6 +155,11 @@ Acquire
        UMount "sleep 500";
     }
   };
        UMount "sleep 500";
     }
   };

+
+  gpgv
+  {
+   Options {"--ignore-time-conflict";} // not very usefull on a normal system
+  };

 };
 
 // Directory layout
 };
 
 // Directory layout


@@ -134,7 +168,7 @@ Dir "/"
   // Location of the state dir
   State "var/lib/apt/" 
   {
   // Location of the state dir
   State "var/lib/apt/" 
   {

-     lists "lists/";
+     Lists "lists/";

      xstatus "xstatus";
      userstatus "status.user";
      status "/var/lib/dpkg/status";
      xstatus "xstatus";
      userstatus "status.user";
      status "/var/lib/dpkg/status";


@@ -143,25 +177,27 @@ Dir "/"
   
   // Location of the cache dir
   Cache "var/cache/apt/" {
   
   // Location of the cache dir
   Cache "var/cache/apt/" {

-     archives "archives/";
+     Archives "archives/";

      srcpkgcache "srcpkgcache.bin";
      pkgcache "pkgcache.bin";     
   };
   
   // Config files
   Etc "etc/apt/" {
      srcpkgcache "srcpkgcache.bin";
      pkgcache "pkgcache.bin";     
   };
   
   // Config files
   Etc "etc/apt/" {

-     sourcelist "sources.list";
-     main "apt.conf";
-     preferences "preferences";     
+     SourceList "sources.list";
+     Main "apt.conf";
+     Preferences "preferences";     
+     Parts "apt.conf.d/";

   };
   
   // Locations of binaries
   Bin {
      methods "/usr/lib/apt/methods/";
      gzip "/bin/gzip";
   };
   
   // 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 "/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";
   };
      apt-get "/usr/bin/apt-get";
      apt-cache "/usr/bin/apt-cache";
   };


@@ -201,6 +237,10 @@ DPkg
    // Control the size of the command line passed to dpkg.
    MaxBytes 1024;
    MaxArgs 350;
    // Control the size of the command line passed to dpkg.
    MaxBytes 1024;
    MaxArgs 350;

+
+   // controls if apt will apport on the first dpkg error or if it 
+   // tries to install as many packages as possible
+   StopOnError "true";

 }
 
 /* Options you can set to see some debugging text They correspond to names
 }
 
 /* Options you can set to see some debugging text They correspond to names


@@ -208,16 +248,23 @@ DPkg
 Debug 
 {
   pkgProblemResolver "false";
 Debug 
 {
   pkgProblemResolver "false";

+  pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies

   pkgAcquire "false";
   pkgAcquire::Worker "false";
   pkgAcquire "false";
   pkgAcquire::Worker "false";

+  pkgAcquire::Auth "false";

   pkgDPkgPM "false";
   pkgDPkgPM "false";

+  pkgDPkgProgressReporting "false";

   pkgOrderList "false";
   pkgOrderList "false";

+  BuildDeps "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
   
   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
   aptcdrom "false";        // Show found package files

+  IdentCdrom "false";
+  

 }
 
 /* Whatever you do, do not use this configuration file!! Take out ONLY
 }
 
 /* Whatever you do, do not use this configuration file!! Take out ONLY