<?xml version="1.0" encoding="iso-8859-1"?>

<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->

<page>
    <content>
        <p class="note">
            All documents and files included in this tour are
            Copyright (C) 1999-2004 by the Apache Software Foundation.
        </p>
        <p class="note">
            You can generate a printable single-page version of this tour
            <a href="../../print/supersonic-tour.html">here</a> (requires
            an Internet connection for some example pages).
        </p>
        <h2>Overview</h2>
        <p>
            This <em>supersonic tour of Apache Cocoon</em> will give
            you a quick overview of what Cocoon is and does.
        </p>
        <p>
            We won't go deep into any part of Cocoon, but will rather
            get an overall feel of what's in Cocoon.
        </p>
        <p>
            The only parts that we will study in some detail are the
            following Cocoon components, which are becoming the
            mainstream way of using Cocoon:
            <ul>
                <li>
                    The <em>pipelines</em>, used to transform
                    XML data obtained from various sources into
                    many differents output formats like HTML, PDF,
                    SVG, XML, bitmapped pictures, etc.
                </li>

                <li>
                    The <em>Flow subsystem</em>, a powerful yet simple
                    to use mechanism to handle the interaction between
                    multiple web pages and forms in a Web application.
                </li>

                <li>
                    The <em>Cocoon Forms</em> subsystem, which uses
                    simple and modular definitions of Web-based forms
                    to allow java beans, XML documents or other objects
                    to be edited via the Web.
                </li>
            </ul>
        </p>

        <h2>Running this application</h2>
        <p>
            If you're reading this documentation on paper and would like
            to study the application directly in Cocoon, you will find it under
            <em>blocks with samples</em> on the Cocoon samples page.

        </p>

        <h2>Studying this application</h2>
        <p>
            The complete source code of this tour is found under
            <em>src/blocks/tour</em> in the Cocoon source code tree.
            There is one directory with its own sitemap for each part of
            the tutorial, so that you can easily dig deeper in your areas
            of interest.
        </p>

        <h2>Code excerpts</h2>
        <p>
            Note that (according to the <em>lazyness is a virtue</em> rule),
            most of the sitemap, flowscripts, XSLT transforms and
            other code excerpts are dynamically inserted into this documentation
            from the corresponding source files. This avoids having to
            copy and paste code and ensures that the code you see stays up to date.
        </p>

        <h2>Contents</h2>
        <insert-toc/>
    </content>
</page>
