~ubuntu-branches/ubuntu/wily/python-imaging/wily

« back to all changes in this revision

Viewing changes to README.rst

  • Committer: Package Import Robot
  • Author(s): Matthias Klose
  • Date: 2013-01-31 20:49:20 UTC
  • mfrom: (27.1.1 raring-proposed)
  • Revision ID: package-import@ubuntu.com-20130131204920-b5zshy6vgfvdionl
Tags: 1.1.7+1.7.8-1ubuntu1
Rewrite build dependencies to allow cross builds.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. contents::
 
2
 
 
3
Pillow
 
4
======
 
5
 
 
6
Pillow is the "friendly" PIL fork. PIL is the Python Imaging Library. Pillow was
 
7
started for and is currently maintained by the Plone community. But it is used by
 
8
many other folks in the Python web community, and probably elsewhere too.
 
9
 
 
10
Introduction
 
11
------------
 
12
 
 
13
The fork author's goal is to foster packaging improvements via:
 
14
 
 
15
- Publicized development and solicitation of community support.
 
16
- Exploration of packaging problems within the fork, most noticably
 
17
  via adding setuptools support but also via clean up & refactoring
 
18
  of packaging code.
 
19
 
 
20
Why a fork?
 
21
-----------
 
22
 
 
23
PIL is currently not setuptools compatible. Please see
 
24
http://mail.python.org/pipermail/image-sig/2010-August/006480.html for a
 
25
more detailed explanation. Also, PIL's current release/maintenance schedule
 
26
is not compatible with the various & frequent packaging issues that have
 
27
occured.
 
28
 
 
29
What about image code bugs?
 
30
---------------------------
 
31
 
 
32
Please report any non-packaging related issues here first:
 
33
 
 
34
- https://bitbucket.org/effbot/pil-2009-raclette/issues 
 
35
 
 
36
Then open a ticket here:
 
37
 
 
38
- https://github.com/python-imaging/Pillow/issues
 
39
 
 
40
and provide a link to the first ticket so we can track the issue(s) upstream.
 
41
This project does not aim to fix image code bugs, but if we can track them
 
42
properly we may consider it. (And the image code could potentially be wholesale
 
43
replaced when the next PIL release comes out.)
 
44
 
 
45
Documentation
 
46
-------------
 
47
 
 
48
The API documentation included with PIL has been converted (from HTML) to
 
49
reStructured text (via pandoc) and is now `hosted by readthedocs.org`_.
 
50
 
 
51
.. _`hosted by readthedocs.org`: http://pillow.readthedocs.org
 
52
 
 
53
What follows is the original PIL README.
 
54
 
 
55
Python Imaging Library
 
56
======================
 
57
 
 
58
Introduction
 
59
------------
 
60
 
 
61
The Python Imaging Library (PIL) adds image processing capabilities
 
62
to your Python environment.  This library provides extensive file
 
63
format support, an efficient internal representation, and powerful
 
64
image processing capabilities.
 
65
 
 
66
This source kit has been built and tested with Python 2.0 and newer,
 
67
on Windows, Mac OS X, and major Unix platforms.  Large parts of the
 
68
library also work on 1.5.2 and 1.6.
 
69
 
 
70
The main distribution site for this software is:
 
71
 
 
72
        http://www.pythonware.com/products/pil/
 
73
 
 
74
That site also contains information about free and commercial support
 
75
options, PIL add-ons, answers to frequently asked questions, and more.
 
76
 
 
77
Development versions (alphas, betas) are available here:
 
78
 
 
79
        http://effbot.org/downloads/
 
80
 
 
81
The PIL handbook is not included in this distribution; to get the
 
82
latest version, check:
 
83
 
 
84
        http://www.pythonware.com/library/
 
85
 
 
86
For installation and licensing details, see below.
 
87
 
 
88
--------------------------------------------------------------------
 
89
Support Options
 
90
--------------------------------------------------------------------
 
91
 
 
92
Commercial Support
 
93
~~~~~~~~~~~~~~~~~~
 
94
 
 
95
Secret Labs (PythonWare) offers support contracts for companies using
 
96
the Python Imaging Library in commercial applications, and in mission-
 
97
critical environments.  The support contract includes technical support,
 
98
bug fixes, extensions to the PIL library, sample applications, and more.
 
99
 
 
100
For the full story, check:
 
101
 
 
102
        http://www.pythonware.com/products/pil/support.htm
 
103
 
 
104
 
 
105
Free Support
 
106
~~~~~~~~~~~~
 
107
 
 
108
For support and general questions on the Python Imaging Library, send
 
109
e-mail to the Image SIG mailing list:
 
110
 
 
111
        image-sig@python.org
 
112
 
 
113
You can join the Image SIG by sending a mail to:
 
114
 
 
115
        image-sig-request@python.org
 
116
 
 
117
Put "subscribe" in the message body to automatically subscribe to the
 
118
list, or "help" to get additional information.  Alternatively, you can
 
119
send your questions to the Python mailing list, python-list@python.org,
 
120
or post them to the newsgroup comp.lang.python.  DO NOT SEND SUPPORT
 
121
QUESTIONS TO PYTHONWARE ADDRESSES.
 
122
 
 
123
 
 
124
--------------------------------------------------------------------
 
125
Software License
 
126
--------------------------------------------------------------------
 
127
 
 
128
The Python Imaging Library is
 
129
 
 
130
Copyright (c) 1997-2009 by Secret Labs AB
 
131
Copyright (c) 1995-2009 by Fredrik Lundh
 
132
 
 
133
By obtaining, using, and/or copying this software and/or its
 
134
associated documentation, you agree that you have read, understood,
 
135
and will comply with the following terms and conditions:
 
136
 
 
137
Permission to use, copy, modify, and distribute this software and its
 
138
associated documentation for any purpose and without fee is hereby
 
139
granted, provided that the above copyright notice appears in all
 
140
copies, and that both that copyright notice and this permission notice
 
141
appear in supporting documentation, and that the name of Secret Labs
 
142
AB or the author not be used in advertising or publicity pertaining to
 
143
distribution of the software without specific, written prior
 
144
permission.
 
145
 
 
146
SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO
 
147
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
 
148
FITNESS.  IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR
 
149
ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 
150
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 
151
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 
152
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.