Added upgrading notes

docs/contents.rst.inc

@@ -44,6 +44,6 @@ Design notes, legal information and changelog are here for the interested.
    security
    unicode
    extensiondev
-   license
    upgrading
    changelog
+   license

docs/license.rst

@@ -1,21 +1,48 @@
 License
 =======
 
-Flask is licensed under a three clause `BSD License`_.  It basically
-means: do whatever you want with it as long as the copyright in Flask
-sticks around, the conditions are not modified and the disclaimer is
-present.  Furthermore you must not use the names of the authors to promote
-derivates of the software without written consent.
+Flask is licensed under a three clause BSD License.  It basically means:
+do whatever you want with it as long as the copyright in Flask sticks
+around, the conditions are not modified and the disclaimer is present.
+Furthermore you must not use the names of the authors to promote derivates
+of the software without written consent.
 
-.. _BSD License:
-   http://en.wikipedia.org/wiki/BSD_licenses#3-clause_license_.28.22New_BSD_License.22.29
+The full license text can be found below (:ref:`flask-license`).  For the
+documentation and artwork different licenses apply.
+
+.. _authors:
 
 Authors
 -------
 
 .. include:: ../AUTHORS
 
-License Text
-------------
+General License Definitions
+---------------------------
+
+The following section contains the full license texts for Flask and the
+documentation.
+
+-   "AUTHORS" hereby refers to all the authors listed in the
+    :ref:`authors` section.
+
+-   The ":ref:`flask-license`" applies to all the sourcecode shipped as
+    part of Flask (Flask itself as well as the examples and the unittests)
+    as well as documentation.
+
+-   The ":ref:`artwork-license`" applies to the project's Horn-Logo.
+
+.. _flask-license:
+
+Flask License
+-------------
 
 .. include:: ../LICENSE
+
+
+.. _artwork-license:
+
+Flask Artwork License
+---------------------
+
+.. include:: ../artwork/LICENSE

docs/upgrading.rst

@@ -14,6 +14,19 @@ This section of the documentation enumerates all the changes in Flask from
 release to release and how you can change your code to have a painless
 updating experience.
 
+If you want to use the `easy_install` command to upgrade your Flask
+installation, make sure to pass it the ``-U`` parameter::
+
+    $ easy_install -U Flask
+
+Version 0.4
+-----------
+
+For application developers there are no changes that require changes in
+your code.  In case you are developing on a Flask extension however, and
+that extension has a unittest-mode you might want to link the activation
+of that mode to the new ``TESTING`` flag.
+
 Version 0.3
 -----------