From affd42dc50a0cb02b3e91aa406626982ce5303d8 Mon Sep 17 00:00:00 2001
From: "Andrew M. Kuchling" <amk@amk.ca>
Date: Thu, 22 Dec 2005 20:12:39 +0000
Subject: Add some chapter introductions (not linked into the LibRef yet)

---
 Doc/lib/archiving.tex   |  8 ++++++++
 Doc/lib/datatypes.tex   | 10 ++++++++++
 Doc/lib/fileformats.tex |  7 +++++++
 Doc/lib/filesys.tex     | 18 ++++++++++++++++++
 Doc/lib/i18n.tex        | 11 +++++++++++
 Doc/lib/ipc.tex         | 14 ++++++++++++++
 Doc/lib/numeric.tex     | 13 +++++++++++++
 Doc/lib/persistence.tex | 15 +++++++++++++++
 8 files changed, 96 insertions(+)
 create mode 100644 Doc/lib/archiving.tex
 create mode 100644 Doc/lib/datatypes.tex
 create mode 100644 Doc/lib/fileformats.tex
 create mode 100644 Doc/lib/filesys.tex
 create mode 100644 Doc/lib/i18n.tex
 create mode 100644 Doc/lib/ipc.tex
 create mode 100644 Doc/lib/numeric.tex
 create mode 100644 Doc/lib/persistence.tex

diff --git a/Doc/lib/archiving.tex b/Doc/lib/archiving.tex
new file mode 100644
index 0000000..93f5bf7
--- /dev/null
+++ b/Doc/lib/archiving.tex
@@ -0,0 +1,8 @@
+\chapter{Data Compression and Archiving}
+\label{archiving}
+
+The modules described in this chapter support data compression
+with the zlib, gzip, and bzip2 algorithms, and 
+the creation of ZIP- and tar-format archives.
+
+\localmoduletable
diff --git a/Doc/lib/datatypes.tex b/Doc/lib/datatypes.tex
new file mode 100644
index 0000000..0fe03c7
--- /dev/null
+++ b/Doc/lib/datatypes.tex
@@ -0,0 +1,10 @@
+\chapter{Data Types}
+\label{datatypes}
+
+The modules described in this chapter provide a variety of specialized
+data types such as dates and times, fixed-type arrays, heap queues,
+synchronized queues, and sets.
+
+The following modules are documented in this chapter:
+
+\localmoduletable
diff --git a/Doc/lib/fileformats.tex b/Doc/lib/fileformats.tex
new file mode 100644
index 0000000..9f9c116
--- /dev/null
+++ b/Doc/lib/fileformats.tex
@@ -0,0 +1,7 @@
+\chapter{File Formats}
+\label{fileformats}
+
+The modules described in this chapter parse various miscellaneous file
+formats that aren't markup languages or are related to e-mail.
+
+\localmoduletable
diff --git a/Doc/lib/filesys.tex b/Doc/lib/filesys.tex
new file mode 100644
index 0000000..0c682c8
--- /dev/null
+++ b/Doc/lib/filesys.tex
@@ -0,0 +1,18 @@
+\chapter{File and Directory Access}
+\label{filesys}
+
+The modules described in this chapter deal with disk files and
+directories.  For example, there are modules for reading the
+properties of files, manipulating paths in a portable way, and
+creating temporary files.  The full list of modules in this chapter is:
+
+\localmoduletable
+
+% XXX can this be included in the seealso environment? --amk
+Also see section \ref{bltin-file-objects} for a description 
+of Python's built-in file objects.
+
+\begin{seealso}
+    \seemodule{os}{Operating system interfaces, including functions to
+    work with files at a lower level than the built-in file object.} 
+\end{seealso}
diff --git a/Doc/lib/i18n.tex b/Doc/lib/i18n.tex
new file mode 100644
index 0000000..699a60c
--- /dev/null
+++ b/Doc/lib/i18n.tex
@@ -0,0 +1,11 @@
+\chapter{Internationalization}
+\label{i18n}
+
+The modules described in this chapter help you write
+software that is independent of language and locale
+by providing mechanisms for selecting a language to be used in 
+program messages or by tailoring output to match local conventions.
+
+The list of modules described in this chapter is:
+
+\localmoduletable
diff --git a/Doc/lib/ipc.tex b/Doc/lib/ipc.tex
new file mode 100644
index 0000000..cd95056
--- /dev/null
+++ b/Doc/lib/ipc.tex
@@ -0,0 +1,14 @@
+\chapter{Interprocess Communication and Networking}
+\label{ipc}
+
+The modules described in this chapter provide mechanisms for different
+processes to communicate.
+
+Some modules only work for two processes that are on the same machine,
+e.g.  \module{signal} and \module{subprocess}.  Other modules support
+networking protocols that two or more processes can used to
+communicate across machines.
+
+The list of modules described in this chapter is:
+
+\localmoduletable
diff --git a/Doc/lib/numeric.tex b/Doc/lib/numeric.tex
new file mode 100644
index 0000000..a9a9e18
--- /dev/null
+++ b/Doc/lib/numeric.tex
@@ -0,0 +1,13 @@
+\chapter{Numeric and Mathematical Modules}
+\label{numeric}
+
+The modules described in this chapter provide
+numeric and math-related functions and data types.
+The \module{math} and \module{cmath} contain 
+various mathematical functions for floating-point and complex numbers.
+For users more interested in decimal accuracy than in speed, the 
+\module{decimal} module supports exact representations of  decimal numbers.
+
+The following modules are documented in this chapter:
+
+\localmoduletable
diff --git a/Doc/lib/persistence.tex b/Doc/lib/persistence.tex
new file mode 100644
index 0000000..0bcdad2
--- /dev/null
+++ b/Doc/lib/persistence.tex
@@ -0,0 +1,15 @@
+\chapter{Data Persistence}
+\label{persistence}
+
+The modules described in this chapter support storing Python data in a
+persistent form on disk.  The \module{pickle} and \module{marshal}
+modules can turn many Python data types into a stream of bytes and
+then recreate the objects from the bytes.  The various DBM-related
+modules support a family of hash-based file formats that store a
+mapping of strings to other strings.  The \module{bsddb} module also
+provides such disk-based string-to-string mappings based on hashing,
+and also supports B-Tree and record-based formats.
+
+The list of modules described in this chapter is:
+
+\localmoduletable
-- 
cgit v0.12

