[cairo-commit] cairo README,1.11,1.12 ChangeLog,1.977,1.978

Carl Worth commit at pdx.freedesktop.org
Tue Aug 23 19:31:12 PDT 2005


Committed by: cworth

Update of /cvs/cairo/cairo
In directory gabe:/tmp/cvs-serv18640

Modified Files:
	README ChangeLog 
Log Message:

2005-08-23  Carl Worth  <cworth at cworth.org>

        * README: Big update in preparation for 1.0.


Index: README
===================================================================
RCS file: /cvs/cairo/cairo/README,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- README	23 Jul 2005 17:05:54 -0000	1.11
+++ README	24 Aug 2005 02:31:10 -0000	1.12
@@ -1,60 +1,123 @@
 Cairo - Multi-platform 2D graphics library
 http://cairographics.org
 
-Compiling
----------
-See the INSTALL document for build instructions.
+What is cairo
+=============
+Cairo is a 2D graphics library with support for multiple output
+devices. Currently supported output targets include the X Window
+System, OpenGL, and win32 as well as image buffers and PostScript and
+PDF files.
 
-Description
------------
-Cairo is a vector graphics library with cross-device output
-support. Currently supported output targets include the X Window
-System and in-memory image buffers. PostScript and PDF file output is
-planned. Cairo is designed to produce identical output on all output
-media while taking advantage of display hardware acceleration when
-available (eg. through the X Render Extension).
+Cairo is designed to produce consistent output on all output media
+while taking advantage of display hardware acceleration when available
+(eg. through the X Render Extension).
 
-Cairo provides a stateful user-level API with capabilities similar to
-the PDF 1.4 imaging model. Cairo provides operations including
-stroking and filling Bezier cubic splines, transforming and
-compositing translucent images, and antialiased text rendering.
+The cairo API provides operations similar to the drawing operators of
+PostScript and PDF. Operations in cairo including stroking and filling
+cubic Bézier splines, transforming and compositing translucent images,
+and antialiased text rendering. All drawing operations can be scaled,
+rotated, or transformed through any other affine transformation.
 
-Cairo was once named Xr, (or Xr/Xc), so if you came looking for that
-software, you've found it.
+Cairo has been designed to let you draw anything you might want to
+have in a modern 2D graphical user interface. At the same time, the
+cairo API has been designed to be as easy to learn and fun to use as
+possible. If you're not having fun while programming with cairo, then
+we have failed somewhere---let us know and we'll try to fix it next
+time around.
+
+Cairo is free software and is available to be redistributed and/or
+modified under the terms of either the GNU Lesser General Public
+License (LGPL) version 2.1 or the Mozilla Public License (MPL) version
+1.1.
+
+Where to get more information about cairo
+=========================================
+The primary source of information about cairo is:
+
+	http://cairographics.org
+
+The latest releases of cairo can be found at:
+
+	http://cairographics.org/releases
+
+Snapshots of in-developmenent versions of cairo:
+
+	http://cairographics.org/snapshots
+
+The programming manual for using cairo:
+
+	http://cairographics.org/manual
+
+Mailing lists for contacting cairo users and developers:
+
+	http://cairographics.org/lists
+
+Answers to some frequently asked questions about cairo:
+
+	http://cairographics.org/FAQ
 
 Dependencies
-------------
-Cairo currently requires the following supporting libraries:
+============
+The set of libraries needed to compile cairo depends on which backends
+are enabled when cairo is configured. Here are the dependencies for
+each backend:
 
-	libpixman
-	Xft2
-	fontconfig
-	freetype2
+Surface backends:
 
-Documentation
--------------
-There's not much documentation yet apart from the cairo.h header
-file. We'll be correcting that shortly.
+	image backend
+	-------------
+	no dependencies
 
-In the meantime, the cairo-demo module in CVS provides a few example
-programs using cairo. These may be helpful to a programmer just
-beginning with cairo. Also, familiarity with the PostScript imaging
-model will help in understanding cairo.
+	glitz backend
+	-------------
+	glitz >= 0.4.4 		http://freedesktop.org/Software/glitz)
+
+	pdf backend
+	-----------
+	freetype >= 2.1.4	http://freetype.org
+
+	postscript backend
+	------------------
+	zlib			http://www.gzip.org/zlib
+
+	quartz backend
+	--------------
+
+
+	win32 backend
+	-------------
+
+	xcb backend
+	-----------
+	XCB			http://xcb.freedesktop.org
+
+	xlib backend
+	------------
+	Xrender >= 0.6		http://freedesktop.org/Software/xlibs
+
+Font backends:
+
+	freetype font backend
+	---------------------
+	freetype >= 2.1.4	http://freetype.org
+	fontconfig		http://fontconfig.org
+
+	win32 font backend
+	------------------
+
+	atsui font backend
+	------------------
+
+Compiling
+=========
+See the INSTALL document for build instructions.
 
 History
--------
+=======
 Cairo was originally developed by Carl Worth <cworth at cworth.org> and
 Keith Packard <keithp at keithp.com>. Many thanks are due to Lyle Ramshaw
 without whose patient help our ignorance would be much more apparent.
 
-Mailing List
-------------
-If you have trouble with cairo or you have some ideas for how it could be
-improved, please feel free to send a message to cairo at cairographics.org
-
-Cairo is still under active development and all discussion happens on
-that list. So if you want to lurk or, (even better), take part in the
-development, take a look. Subscription information and archives are
-available:
-
-	http://cairographics.org/cgi-bin/mailman/listinfo/cairo
+Since the original development, many more people have contributed to
+cairo. See the AUTHORS files for as complete a list as we've been able
+to compile so far.

Index: ChangeLog
===================================================================
RCS file: /cvs/cairo/cairo/ChangeLog,v
retrieving revision 1.977
retrieving revision 1.978
diff -u -d -r1.977 -r1.978
--- ChangeLog	24 Aug 2005 00:36:20 -0000	1.977
+++ ChangeLog	24 Aug 2005 02:31:10 -0000	1.978
@@ -1,5 +1,9 @@
 2005-08-23  Carl Worth  <cworth at cworth.org>
 
+	* README: Big update in preparation for 1.0.
+
+2005-08-23  Carl Worth  <cworth at cworth.org>
+	
 	* AUTHORS: Added several names to the AUTHORS file (since
 	2005-01-24):
 



More information about the cairo-commit mailing list