added a glossary to the docs

ddale · ddale · commit 5dba25129e91 · 2008-06-14T13:21:19.000Z
svn path=/trunk/matplotlib/; revision=5536
diff --git a/doc/glossary/index.rst b/doc/glossary/index.rst
@@ -0,0 +1,20 @@
+########
+Glossary
+########
+
+.. glossary::
+
+  raster graphics
+      Raster graphics, or bitmaps, represent an image as an array of pixels
+      which is resolution dependent. Raster graphics are generally most
+      practical for photo-realistic images, but do not easily without loss of
+      quality.
+
+  vector graphics
+      The use of geometrical primitives based upon mathematical equations to
+      represent images in computer graphics. Primitives can include points,
+      lines, curves, and shapes or polygons. Vector graphics are scalable,
+      which means that they can be resized without suffering from issues
+      related to inherent resolution like are seen in raster graphics. Vector
+      graphics are generally most practical for typesetting and graphic design
+      applications.
diff --git a/doc/index.rst b/doc/index.rst
@@ -1,6 +1,4 @@
-.. matplotlib documentation master file, created by sphinx-quickstart on Sat May 24 15:37:00 2008.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+
 
 Welcome to matplotlib's documentation!
 ======================================
@@ -19,16 +17,10 @@ Welcome to matplotlib's documentation!
    faq/index.rst
    devel/index.rst
    api/index.rst
+   glossary/index.rst
 
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
+.. htmlonly::
 
-.. _ipython: http://ipython.scipy.org
-.. _numpy: http://numpy.scipy.org
-.. _scipy: http://scipy.org
-.. _vtk: http://www.vtk.org
+  * :ref:`genindex`
+  * :ref:`modindex`
+  * :ref:`search`
