Final draft

Author: jgg
Date: 1998-12-06 04:36:25 GMT
Final draft

1 files changed, 153 insertions, 0 deletions

diff --git a/doc/apt.conf.5.yo b/doc/apt.conf.5.yo
new file mode 100644
index 000000000..5c4a9d429
--- /dev/null
+++ b/doc/apt.conf.5.yo
@@ -0,0 +1,153 @@
+mailto(apt@packages.debian.org)
+manpage(apt.conf)(5)(5 Dec 1998)(apt)()
+manpagename(apt.conf)(configuration file for APT)
+
+manpagedescription()
+bf(apt.conf) is the main configuration file for the APT suite of
+tools, all tools make use of the configuration file and a common command line
+parser to provide a uniform environment. When an APT tool starts up it will
+read bf(/etc/apt/apt.conf), then read the configuration specified by the
+bf($APT_CONFIG) environment variable and then finally apply the command line
+options to override the configuration directives, possibly loading more 
+config files.
+
+The configuration file is organized in a tree with options organized into
+functional groups. Option specification is given with a double colon
+notation, for instance em(APT::Get::Assume-Yes) is an option within the
+APT tool group, for the Get tool. Options do not inherit from their parent
+groups.
+
+Syntacticly the configuration language is modeled after what the ISC tools
+such as bind and dhcp use. Each line is of the form
+quote(APT::Get::Assume-Yes "true";) The trailing semicolon is required and
+the quotes are optional. A new em(scope) can be opened with curly braces,
+like: 
+verb(APT {
+  Get {
+    Assume-Yes "true";
+    Fix-Broken "true";
+  };
+};
+)
+with newlines placed to make
+it more readable. In general the sample configuration file in
+em(/usr/doc/apt/examples/apt.conf) is a good guide for how it should look.
+
+manpagesection(The APT Group)
+This group of options controls general APT behavoir as well as holding the
+options for all of the tools.
+
+startdit()
+dit(bf(Architecture))
+System Architecture; sets the architecture to use when fetching files and
+parsing package lists. The internal default is the architecture apt was 
+compiled for.
+
+dit(bf(Ignore-Hold))
+Ignore Held packages; This global options causes the problem resolver to
+ignore held packages in its decision making. 
+
+dit(bf(Get))
+The Get subsection controls the bf(apt-get(8)) tool, please see its
+documentation for more information about the options here.
+
+dit(bf(Cache))
+The Cache subsection controls the bf(apt-cache(8)) tool, please see it
+sdocumentation for more information about the options here.
+
+dit(bf(CDROM))
+The CDROM subsection controls the bf(apt-cdrom(8)) tool, please see it
+sdocumentation for more information about the options here.
+
+enddit()
+
+manpagesection(The Acquire Group)
+The bf(Acquire) group of options controls the download of packages and the 
+URI handlers. 
+
+startdit()
+dit(bf(Queue-Mode))
+Queuing mode; bf(Queue-Mode) can be one of bf(host) or bf(access) which 
+determins how APT parallelizesoutgoing connections. bf(host) means that
+one connection per target host will be opened, bf(access) means that one
+connection per URI type will be opened.
+
+dit(bf(http))
+HTTP URIs; http::Proxy is the default http proxy to use. It is in the standard
+form of em(http://[[user][:pass]@]host[:port]/). Per host proxies can also
+be specified by using the form http::Proxy::<host> with the special keyword
+em(DIRECT) meaning to use no proxies. The em($http_proxy) environment variable
+will override all settings.
+
+dit(bf(cdrom))
+CDROM URIs; the only setting for CDROM URIs is the mount point, cdrom::Mount
+which must be the mount point for the CDROM drive as specified in /etc/fstab.
+
+enddit()
+
+manpagesection(Directories)
+The bf(Dir::State) section has directories that pertain to local state
+information. bf(lists) is the directory to place downloaded package lists
+in and bf(status) is the name of the dpkg status file. bf(Dir::State)
+contains the default directory to prefix on all sub items if they do not
+start with em(/) or em(./). bf(xstatus) and bf(userstatus) are for future
+use.
+
+bf(Dir::Cache) contains locations pertaining to local cache information, such
+as the two package caches bf(srcpkgcache) and bf(pkgcache) as well as the
+location to place downloaded archives, bf(Dir::Cache::archives). Like 
+bf(Dir::State) the default directory is contained in bf(Dir::Cache)
+
+bf(Dir::Etc) contains the location of configuration files, bd(sourcelist)
+gives the location of the sourcelist and bf(main) is the default configuration
+file (setting has no effect)
+
+Binary programs are pointed to by bf(Dir::Bin). bf(methods) specifies the
+location of the method handlers and bf(gzip), bf(dpkg), bf(apt-get), and
+bf(apt-cache) specify the location of the respective programs.
+
+manpagesection(APT in DSelect)
+When APT is used as a bf(dselect(8)) method several configuration directives
+control the default behavoir. These are in the bf(DSelect) section.
+
+startdit()
+dit(bf(Clean))
+Cache Clean mode; this value may be one of always, auto, prompt and never.
+Currently always and auto are identical but their meanings may diverge in
+future to have auto only clean useless archives and always clean all archives.
+
+dit(bf(Options))
+The contents of this variable is passed to bf(apt-get(8)) as command line
+options when it is run for the install phase.
+
+dit(bf(UpdateOptions))
+The contents of this variable is passed to bf(apt-get(8)) as command line
+options when it is run for the update phase.
+
+dit(bf(PromptAfterUpdate))
+If true the [U]pdate operation in dselect will always prompt to continue. 
+The default is to prompt only on error.
+enddit()
+
+manpagesection(Debug Options)
+Most of the options in the bf(debug) section are not interesting to the
+normal user, however bf(Debug::pkgProblemResolver) shows interesting
+output about the decisions dist-upgrade makes. bf(Debug::NoLocking)
+disables file locking so apt can do some operations as non-root and
+bf(Debug::pkgDPkgPM) will print out the command line for each dpkg invokation.
+
+manpagesection(EXAMPLES)
+bf(/usr/doc/apt/examples/apt.conf) contains a sample configuration file
+showing the default values for all possible options.
+
+manpageseealso()
+apt-cache (8),
+apt.conf (5)
+
+manpagebugs()
+See http://www.debian.org/Bugs/db/pa/lapt.html.  If you wish to report a
+bug in bf(apt-get), please see bf(/usr/doc/debian/bug-reporting.txt)
+or the bf(bug(1)) command.
+
+manpageauthor()
+apt-get was written by the APT team <apt@packages.debian.org>.