You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by mg...@apache.org on 2013/01/25 16:23:33 UTC
git commit: Add more docu for stateless
Updated Branches:
refs/heads/reference-guide 2d779606f -> 4dae90dc9
Add more docu for stateless
Project: http://git-wip-us.apache.org/repos/asf/wicket/repo
Commit: http://git-wip-us.apache.org/repos/asf/wicket/commit/4dae90dc
Tree: http://git-wip-us.apache.org/repos/asf/wicket/tree/4dae90dc
Diff: http://git-wip-us.apache.org/repos/asf/wicket/diff/4dae90dc
Branch: refs/heads/reference-guide
Commit: 4dae90dc955039a9cdb6b6c58f9f2303161f55c1
Parents: 2d77960
Author: Martin Tzvetanov Grigorov <mg...@apache.org>
Authored: Fri Jan 25 17:23:07 2013 +0200
Committer: Martin Tzvetanov Grigorov <mg...@apache.org>
Committed: Fri Jan 25 17:23:07 2013 +0200
----------------------------------------------------------------------
documentation/.gitignore | 1 -
documentation/Makefile | 153 ---------
documentation/make.bat | 190 -----------
documentation/source/ajax.rst | 2 -
documentation/source/application.rst | 2 -
documentation/source/behaviors.rst | 2 -
documentation/source/components.rst | 2 -
documentation/source/conf.py | 246 ---------------
documentation/source/exts/apilinks.py | 37 ---
documentation/source/exts/includecode.py | 139 --------
documentation/source/exts/includecode.pyc | Bin 5484 -> 0 bytes
documentation/source/helloworld.rst | 68 ----
documentation/source/index.rst | 32 --
documentation/source/ioc.rst | 2 -
documentation/source/models.rst | 2 -
documentation/source/stateless.rst | 31 --
documentation/source/velocity.rst | 98 ------
documentation/source/websockets.rst | 2 -
wicket-reference-guide/helloworld/pom.xml | 36 +++
.../wicket/reference/helloworld/HelloWorld.html | 9 +
.../wicket/reference/helloworld/HelloWorld.java | 29 ++
.../helloworld/HelloWorldApplication.java | 33 ++
.../helloworld/src/main/webapp/WEB-INF/web.xml | 46 +++
wicket-reference-guide/pom.xml | 54 ++++
.../src/documentation/source/helloworld.rst | 4 +-
.../src/documentation/source/stateless.rst | 43 +++-
wicket-reference-guide/stateless/pom.xml | 40 +++
.../wicket/reference/stateless/CheckedPage.html | 9 +
.../wicket/reference/stateless/CheckedPage.java | 10 +
.../wicket/reference/stateless/StatefulPage.html | 9 +
.../wicket/reference/stateless/StatefulPage.java | 43 +++
.../reference/stateless/StatelessApplication.java | 42 +++
.../wicket/reference/stateless/StatelessPage.html | 9 +
.../wicket/reference/stateless/StatelessPage.java | 43 +++
.../stateless/src/main/webapp/WEB-INF/web.xml | 44 +++
35 files changed, 500 insertions(+), 1012 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/.gitignore
----------------------------------------------------------------------
diff --git a/documentation/.gitignore b/documentation/.gitignore
deleted file mode 100644
index 378eac2..0000000
--- a/documentation/.gitignore
+++ /dev/null
@@ -1 +0,0 @@
-build
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/Makefile
----------------------------------------------------------------------
diff --git a/documentation/Makefile b/documentation/Makefile
deleted file mode 100644
index 5e7d4ff..0000000
--- a/documentation/Makefile
+++ /dev/null
@@ -1,153 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS =
-SPHINXBUILD = sphinx-build
-PAPER =
-BUILDDIR = build
-
-# Internal variables.
-PAPEROPT_a4 = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
-
-help:
- @echo "Please use \`make <target>' where <target> is one of"
- @echo " html to make standalone HTML files"
- @echo " dirhtml to make HTML files named index.html in directories"
- @echo " singlehtml to make a single large HTML file"
- @echo " pickle to make pickle files"
- @echo " json to make JSON files"
- @echo " htmlhelp to make HTML files and a HTML help project"
- @echo " qthelp to make HTML files and a qthelp project"
- @echo " devhelp to make HTML files and a Devhelp project"
- @echo " epub to make an epub"
- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
- @echo " latexpdf to make LaTeX files and run them through pdflatex"
- @echo " text to make text files"
- @echo " man to make manual pages"
- @echo " texinfo to make Texinfo files"
- @echo " info to make Texinfo files and run them through makeinfo"
- @echo " gettext to make PO message catalogs"
- @echo " changes to make an overview of all changed/added/deprecated items"
- @echo " linkcheck to check all external links for integrity"
- @echo " doctest to run all doctests embedded in the documentation (if enabled)"
-
-clean:
- -rm -rf $(BUILDDIR)/*
-
-html:
- $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
- @echo
- @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
- $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
- @echo
- @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
- $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
- @echo
- @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
- $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
- @echo
- @echo "Build finished; now you can process the pickle files."
-
-json:
- $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
- @echo
- @echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
- $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
- @echo
- @echo "Build finished; now you can run HTML Help Workshop with the" \
- ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
- $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
- @echo
- @echo "Build finished; now you can run "qcollectiongenerator" with the" \
- ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
- @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/ApacheWicket.qhcp"
- @echo "To view the help file:"
- @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/ApacheWicket.qhc"
-
-devhelp:
- $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
- @echo
- @echo "Build finished."
- @echo "To view the help file:"
- @echo "# mkdir -p $$HOME/.local/share/devhelp/ApacheWicket"
- @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/ApacheWicket"
- @echo "# devhelp"
-
-epub:
- $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
- @echo
- @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
- @echo
- @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
- @echo "Run \`make' in that directory to run these through (pdf)latex" \
- "(use \`make latexpdf' here to do that automatically)."
-
-latexpdf:
- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
- @echo "Running LaTeX files through pdflatex..."
- $(MAKE) -C $(BUILDDIR)/latex all-pdf
- @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
- $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
- @echo
- @echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
- $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
- @echo
- @echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
- @echo
- @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
- @echo "Run \`make' in that directory to run these through makeinfo" \
- "(use \`make info' here to do that automatically)."
-
-info:
- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
- @echo "Running Texinfo files through makeinfo..."
- make -C $(BUILDDIR)/texinfo info
- @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
- $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
- @echo
- @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
- $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
- @echo
- @echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
- $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
- @echo
- @echo "Link check complete; look for any errors in the above output " \
- "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
- $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
- @echo "Testing of doctests in the sources finished, look at the " \
- "results in $(BUILDDIR)/doctest/output.txt."
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/make.bat
----------------------------------------------------------------------
diff --git a/documentation/make.bat b/documentation/make.bat
deleted file mode 100644
index f438e04..0000000
--- a/documentation/make.bat
+++ /dev/null
@@ -1,190 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
- set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=build
-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% source
-set I18NSPHINXOPTS=%SPHINXOPTS% source
-if NOT "%PAPER%" == "" (
- set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
- set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
- :help
- echo.Please use `make ^<target^>` where ^<target^> is one of
- echo. html to make standalone HTML files
- echo. dirhtml to make HTML files named index.html in directories
- echo. singlehtml to make a single large HTML file
- echo. pickle to make pickle files
- echo. json to make JSON files
- echo. htmlhelp to make HTML files and a HTML help project
- echo. qthelp to make HTML files and a qthelp project
- echo. devhelp to make HTML files and a Devhelp project
- echo. epub to make an epub
- echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
- echo. text to make text files
- echo. man to make manual pages
- echo. texinfo to make Texinfo files
- echo. gettext to make PO message catalogs
- echo. changes to make an overview over all changed/added/deprecated items
- echo. linkcheck to check all external links for integrity
- echo. doctest to run all doctests embedded in the documentation if enabled
- goto end
-)
-
-if "%1" == "clean" (
- for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
- del /q /s %BUILDDIR%\*
- goto end
-)
-
-if "%1" == "html" (
- %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The HTML pages are in %BUILDDIR%/html.
- goto end
-)
-
-if "%1" == "dirhtml" (
- %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
- goto end
-)
-
-if "%1" == "singlehtml" (
- %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
- goto end
-)
-
-if "%1" == "pickle" (
- %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished; now you can process the pickle files.
- goto end
-)
-
-if "%1" == "json" (
- %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished; now you can process the JSON files.
- goto end
-)
-
-if "%1" == "htmlhelp" (
- %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
- goto end
-)
-
-if "%1" == "qthelp" (
- %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
- echo.^> qcollectiongenerator %BUILDDIR%\qthelp\ApacheWicket.qhcp
- echo.To view the help file:
- echo.^> assistant -collectionFile %BUILDDIR%\qthelp\ApacheWicket.ghc
- goto end
-)
-
-if "%1" == "devhelp" (
- %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished.
- goto end
-)
-
-if "%1" == "epub" (
- %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The epub file is in %BUILDDIR%/epub.
- goto end
-)
-
-if "%1" == "latex" (
- %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
- goto end
-)
-
-if "%1" == "text" (
- %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The text files are in %BUILDDIR%/text.
- goto end
-)
-
-if "%1" == "man" (
- %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The manual pages are in %BUILDDIR%/man.
- goto end
-)
-
-if "%1" == "texinfo" (
- %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
- goto end
-)
-
-if "%1" == "gettext" (
- %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
- if errorlevel 1 exit /b 1
- echo.
- echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
- goto end
-)
-
-if "%1" == "changes" (
- %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
- if errorlevel 1 exit /b 1
- echo.
- echo.The overview file is in %BUILDDIR%/changes.
- goto end
-)
-
-if "%1" == "linkcheck" (
- %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
- if errorlevel 1 exit /b 1
- echo.
- echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
- goto end
-)
-
-if "%1" == "doctest" (
- %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
- if errorlevel 1 exit /b 1
- echo.
- echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
- goto end
-)
-
-:end
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/ajax.rst
----------------------------------------------------------------------
diff --git a/documentation/source/ajax.rst b/documentation/source/ajax.rst
deleted file mode 100644
index 569793d..0000000
--- a/documentation/source/ajax.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Ajax
-====
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/application.rst
----------------------------------------------------------------------
diff --git a/documentation/source/application.rst b/documentation/source/application.rst
deleted file mode 100644
index e238c37..0000000
--- a/documentation/source/application.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-The application class
-=====================
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/behaviors.rst
----------------------------------------------------------------------
diff --git a/documentation/source/behaviors.rst b/documentation/source/behaviors.rst
deleted file mode 100644
index ea5f028..0000000
--- a/documentation/source/behaviors.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Behavior
-========
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/components.rst
----------------------------------------------------------------------
diff --git a/documentation/source/components.rst b/documentation/source/components.rst
deleted file mode 100644
index 81ca5b0..0000000
--- a/documentation/source/components.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Component
-=========
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/conf.py
----------------------------------------------------------------------
diff --git a/documentation/source/conf.py b/documentation/source/conf.py
deleted file mode 100644
index 7859b072..0000000
--- a/documentation/source/conf.py
+++ /dev/null
@@ -1,246 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Apache Wicket documentation build configuration file, created by
-# sphinx-quickstart on Tue Jan 22 14:43:46 2013.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys, os
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#sys.path.insert(0, os.path.abspath('.'))
-
-sys.path.append(os.path.abspath('exts'))
-
-# -- General configuration -----------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
-
-# Add any Sphinx extension module names here, as strings. They can be extensions
-# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['includecode', 'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo', 'sphinx.ext.ifconfig', 'sphinx.ext.viewcode']
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'Apache Wicket'
-copyright = u'2013, ASF'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = '6'
-# The full version, including alpha/beta/rc tags.
-release = '6'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = []
-
-# The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-
-# -- Options for HTML output ---------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages. See the documentation for
-# a list of builtin themes.
-html_theme = 'pyramid'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further. For a list of options available for each theme, see the
-# documentation.
-#html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents. If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar. Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#html_logo = None
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it. The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'ApacheWicketdoc'
-
-
-# -- Options for LaTeX output --------------------------------------------------
-
-latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
- ('index', 'ApacheWicket.tex', u'Apache Wicket Documentation',
- u'The Wicket team', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# If true, show page references after internal links.
-#latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output --------------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
- ('index', 'apachewicket', u'Apache Wicket Documentation',
- [u'The Wicket team'], 1)
-]
-
-# If true, show URL addresses after external links.
-#man_show_urls = False
-
-
-# -- Options for Texinfo output ------------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-# dir menu entry, description, category)
-texinfo_documents = [
- ('index', 'ApacheWicket', u'Apache Wicket Documentation',
- u'The Wicket team', 'ApacheWicket', 'One line description of project.',
- 'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
-
-# If false, no module index is generated.
-#texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
-
-highlight_language = 'java'
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/exts/apilinks.py
----------------------------------------------------------------------
diff --git a/documentation/source/exts/apilinks.py b/documentation/source/exts/apilinks.py
deleted file mode 100644
index 4de5822..0000000
--- a/documentation/source/exts/apilinks.py
+++ /dev/null
@@ -1,37 +0,0 @@
-"""
- Based on sphinx.ext.extlinks,
- :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS.
- :license: BSD, see LICENSE for details.
-"""
-
-from docutils import nodes, utils
-
-from sphinx.util.nodes import split_explicit_title
-
-
-def make_link_role(base_url):
- def role(typ, rawtext, text, lineno, inliner, options={}, content=[]):
- text = utils.unescape(text)
- has_explicit_title, title, part = split_explicit_title(text)
- try:
- full_url = base_url % part
- except (TypeError, ValueError):
- inliner.reporter.warning(
- 'unable to expand %s apilink with base URL %r, please make '
- 'sure the base contains \'%%s\' exactly once'
- % (typ, base_url), line=lineno)
- full_url = base_url + part
- if not has_explicit_title:
- idents = part.split(".")
- title = idents[len(idents)-1]
- pnode = nodes.reference(title, title, internal=False, refuri=full_url)
- return [pnode], []
- return role
-
-def setup_link_roles(app):
- for name, base_url in app.config.apilinks.iteritems():
- app.add_role(name, make_link_role(base_url))
-
-def setup(app):
- app.add_config_value('apilinks', {}, 'env')
- app.connect('builder-inited', setup_link_roles)
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/exts/includecode.py
----------------------------------------------------------------------
diff --git a/documentation/source/exts/includecode.py b/documentation/source/exts/includecode.py
deleted file mode 100644
index 7a98848..0000000
--- a/documentation/source/exts/includecode.py
+++ /dev/null
@@ -1,139 +0,0 @@
-import os
-import codecs
-from os import path
-
-from docutils import nodes
-from docutils.parsers.rst import Directive, directives
-
-class IncludeCode(Directive):
- """
- Include a code example from a file with sections delimited with special comments.
- """
-
- has_content = False
- required_arguments = 1
- optional_arguments = 0
- final_argument_whitespace = False
- option_spec = {
- 'section': directives.unchanged_required,
- 'comment': directives.unchanged_required,
- 'marker': directives.unchanged_required,
- 'include': directives.unchanged_required,
- 'exclude': directives.unchanged_required,
- 'hideexcludes': directives.flag,
- 'linenos': directives.flag,
- 'language': directives.unchanged_required,
- 'encoding': directives.encoding,
- 'prepend': directives.unchanged_required,
- 'append': directives.unchanged_required,
- }
-
- def run(self):
- document = self.state.document
- arg0 = self.arguments[0]
- (filename, sep, section) = arg0.partition('#')
-
- if not document.settings.file_insertion_enabled:
- return [document.reporter.warning('File insertion disabled',
- line=self.lineno)]
- env = document.settings.env
- if filename.startswith('/') or filename.startswith(os.sep):
- rel_fn = filename[1:]
- else:
- docdir = path.dirname(env.doc2path(env.docname, base=None))
- rel_fn = path.join(docdir, filename)
- try:
- fn = path.join(env.srcdir, rel_fn)
- except UnicodeDecodeError:
- # the source directory is a bytestring with non-ASCII characters;
- # let's try to encode the rel_fn in the file system encoding
- rel_fn = rel_fn.encode(sys.getfilesystemencoding())
- fn = path.join(env.srcdir, rel_fn)
-
- encoding = self.options.get('encoding', env.config.source_encoding)
- codec_info = codecs.lookup(encoding)
- try:
- f = codecs.StreamReaderWriter(open(fn, 'U'),
- codec_info[2], codec_info[3], 'strict')
- lines = f.readlines()
- f.close()
- except (IOError, OSError):
- return [document.reporter.warning(
- 'Include file %r not found or reading it failed' % filename,
- line=self.lineno)]
- except UnicodeError:
- return [document.reporter.warning(
- 'Encoding %r used for reading included file %r seems to '
- 'be wrong, try giving an :encoding: option' %
- (encoding, filename))]
-
- comment = self.options.get('comment', '//')
- marker = self.options.get('marker', comment + '#')
- lenm = len(marker)
- if not section:
- section = self.options.get('section')
- include_sections = self.options.get('include', '')
- exclude_sections = self.options.get('exclude', '')
- include = set(include_sections.split(',')) if include_sections else set()
- exclude = set(exclude_sections.split(',')) if exclude_sections else set()
- hideexcludes = 'hideexcludes' in self.options
- if section:
- include |= set([section])
- within = set()
- res = []
- excluding = False
- for line in lines:
- index = line.find(marker)
- if index >= 0:
- section_name = line[index+lenm:].strip()
- if section_name in within:
- within ^= set([section_name])
- if excluding and not (exclude & within):
- excluding = False
- else:
- within |= set([section_name])
- if not excluding and (exclude & within):
- excluding = True
- if not hideexcludes:
- res.append(' ' * index + comment + ' ' + section_name.replace('-', ' ') + ' ...\n')
- elif not (exclude & within) and (not include or (include & within)):
- res.append(line)
- lines = res
-
- def countwhile(predicate, iterable):
- count = 0
- for x in iterable:
- if predicate(x):
- count += 1
- else:
- return count
-
- nonempty = filter(lambda l: l.strip(), lines)
- tabcounts = map(lambda l: countwhile(lambda c: c == ' ', l), nonempty)
- tabshift = min(tabcounts) if tabcounts else 0
-
- if tabshift > 0:
- lines = map(lambda l: l[tabshift:] if len(l) > tabshift else l, lines)
-
- prepend = self.options.get('prepend')
- append = self.options.get('append')
- if prepend:
- lines.insert(0, prepend + '\n')
- if append:
- lines.append(append + '\n')
-
- text = ''.join(lines)
- retnode = nodes.literal_block(text, text, source=fn)
- retnode.line = 1
- retnode.attributes['line_number'] = self.lineno
- language = self.options.get('language')
- if language:
- retnode['language'] = language
- if 'linenos' in self.options:
- retnode['linenos'] = True
- document.settings.env.note_dependency(rel_fn)
- return [retnode]
-
-def setup(app):
- app.require_sphinx('1.0')
- app.add_directive('includecode', IncludeCode)
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/exts/includecode.pyc
----------------------------------------------------------------------
diff --git a/documentation/source/exts/includecode.pyc b/documentation/source/exts/includecode.pyc
deleted file mode 100644
index 2e21e0d..0000000
Binary files a/documentation/source/exts/includecode.pyc and /dev/null differ
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/helloworld.rst
----------------------------------------------------------------------
diff --git a/documentation/source/helloworld.rst b/documentation/source/helloworld.rst
deleted file mode 100644
index ad06171..0000000
--- a/documentation/source/helloworld.rst
+++ /dev/null
@@ -1,68 +0,0 @@
-Hello World
-=========================================
-.. toctree::
- :maxdepth: 3
-
-
-This HelloWorld application demonstrates the basic structure of a web application in Apache Wicket. A ``Label`` [#]_ component is used to display a message on the home page for the application.
-
-In all the Wicket examples, you have to put all files in the same package directory. This means putting the markup files and the java files next to one another. It is possible to alter this behavior, but that is beyond the scope of this example. The only exception is the obligatory web.xml file which should reside in the WEB-INF/ directory of your web application root folder.
-
-If you wish to start building this example, you may want to take a look at the `Wicket Quickstart project <http://wicket.apache.org/start/quickstart.html>`_, which provides a quick way of getting up and running without having to figure things out yourself. The Quickstart project contains the necessary build files for `Apache Maven <http://maven.apache.org>`_, libraries, minimal set of Java and markup files and an embedded Jetty server to run your application without having to go through the whole build-deploy cycle.
-
-HelloWorldApplication.java
---------------------------
-
-Each Wicket application is defined by an Application [#]_ object. This object defines what the home page is, and allows for some configuration.
-
-.. includecode:: ../../wicket-examples/src/main/java/org/apache/wicket/examples/helloworld/HelloWorldApplication.java
-
-Here you can see that we define org.apache.wicket.examples.helloworld.HelloWorld to be our home page. When the base URL (the context root) of our application is requested, the markup rendered by the HelloWorld page is returned.
-
-HelloWorld.java
----------------
-
-.. includecode:: ../../wicket-examples/src/main/java/org/apache/wicket/examples/helloworld/HelloWorld.java
-
-The Label is constructed using two parameters:
-
-#. “message”
-
-#. “Hello World!”
-
-The first parameter is the component identifier, which Wicket uses to identify the Label component in your HTML markup. The second parameter is the message which the Label should render.
-
-HelloWorld.html
----------------
-
-The HTML file that defines our Hello World functionality is as follows:
-
-.. includecode:: ../../wicket-examples/src/main/java/org/apache/wicket/examples/helloworld/HelloWorld.html
-
-In this file, you see two elements that need some attention:
-
-#. the component declaration *<span wicket:id="message">*
-
-#. the text *The real message goes here*
-
-The component declaration consists of the Wicket identifier wicket:id. The component identifier should be the same as the name of the component you defined in your WebPage. The text between the <span> tags is removed when the component renders its message. The final content of the component is determined by your Java code.
-
-web.xml
--------
-
-In order to deploy our HelloWorld application, we need to make our application known to the application server by means of the web.xml file.
-
-.. includecode:: ../../wicket-examples/src/main/webapp/WEB-INF/web.xml
-
-In this definition you see the Wicket filter defined, which handles all requests. In order to let Wicket know which application is available, only the applicationClassName filter parameter is needed.
-
-Also, notice the url-mapping to /*. The Wicket filter will only process requests that are Wicket requests. If a request is not Wicket related, the filter will pass the request on to the chain. This ensures that (static) resources outside the realm of the Wicket application, such as style sheets, JavaScript files, images and so forth will be served by the container.
-
-Ready to deploy
-
-That’s it. No more configuration necessary! All you need to do now is to deploy the web application into your favorite application server. Point your browser to the url: http://<servername>/<warfilename>/, substituting servername and warfilename to the appropriate values, such as http://localhost:8080/helloworld/.
-
-As you can see: no superfluous XML configuration files are needed to enable a Wicket application. Only the markup (HTML) files, the Java class files and the required web.xml were needed to create this application.
-
-.. [#] org.apache.wicket.markup.html.Label
-.. [#] org.apache.wicket.protocol.http.WebApplication
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/index.rst
----------------------------------------------------------------------
diff --git a/documentation/source/index.rst b/documentation/source/index.rst
deleted file mode 100644
index 3fb1824..0000000
--- a/documentation/source/index.rst
+++ /dev/null
@@ -1,32 +0,0 @@
-.. Apache Wicket documentation master file, created by
- sphinx-quickstart on Tue Jan 22 14:43:46 2013.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
-Welcome to Apache Wicket's documentation!
-=========================================
-
-Contents:
-
-.. toctree::
- :maxdepth: 1
-
- helloworld
- application
- components
- models
- behaviors
- ajax
- stateless
- ioc
- websockets
- velocity
-
-
-.. Indices and tables
-.. ==================
-
-.. * :ref:`genindex`
-.. * :ref:`modindex`
-.. * :ref:`search`
-
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/ioc.rst
----------------------------------------------------------------------
diff --git a/documentation/source/ioc.rst b/documentation/source/ioc.rst
deleted file mode 100644
index 9536cf2..0000000
--- a/documentation/source/ioc.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Dependency injection
-====================
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/models.rst
----------------------------------------------------------------------
diff --git a/documentation/source/models.rst b/documentation/source/models.rst
deleted file mode 100644
index 75338c8..0000000
--- a/documentation/source/models.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Model
-=====
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/stateless.rst
----------------------------------------------------------------------
diff --git a/documentation/source/stateless.rst b/documentation/source/stateless.rst
deleted file mode 100644
index f488117..0000000
--- a/documentation/source/stateless.rst
+++ /dev/null
@@ -1,31 +0,0 @@
-Stateless pages
-===============
-
-
-Being stateful
---------------
-
-By nature a page is stateless, i.e. a new instance is created for each request and discarded at the end. A page becomes stateful as soon as a stateful behavior or component is added in the tree. Stateful pages are stored in a storage for later use, i.e. in following requests the same page instance is reused instead of creating a new instance. Technically, the page may be deserialized so it is not always the same JVM instance but the important thing is that any state/data in the page will be preserved.
-
-A `Component <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/Component.html>`_ declares that it needs to be stateful by returning *false* in #getStatelessHint() method::
-
- protected boolean getStatelessHint()
- {
- return false;
- }
-
-and `Behavior <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/Behavior.html>`_ by overriding::
-
- public boolean getStatelessHint(Component component)
- {
- return false;
- }
-
-
-Example
--------
-
-
-
-
-For example, click on an `Link <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/markup/html/link/Link.html>`_ will lead to a request that will try to find the Page object that contains this link, then find the link itself in that page and finally execute its `#onClick()` method.
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/velocity.rst
----------------------------------------------------------------------
diff --git a/documentation/source/velocity.rst b/documentation/source/velocity.rst
deleted file mode 100644
index d3d0f0c..0000000
--- a/documentation/source/velocity.rst
+++ /dev/null
@@ -1,98 +0,0 @@
-Apache Velocity
-===============
-
-wicket-velocity integration module provides a specialized panel and some related utilities that enable users to use `Apache Velocity <http://velocity.apache.org/>`_ in `Apache Wicket <http://wicket.apache.org/>`_ applications. Particularly useful for simple CMS like applications.
-
-Contents
-
-#. Introduction_
-#. Example_
-#. Installing_
-
-.. _Introduction:
-
-Introduction
-------------
-
-Velocity brings a templating language to your users. You can let them create conditional markup, use loops and do all other things made possible by Velocity.
-
-Velocity templates look like the following::
-
- #set ($foo = "deoxyribonucleic acid")
- #set ($bar = "ribonucleic acid")
-
- #if ($foo == $bar)
- In this case it's clear they aren't equivalent. So...
- #else
- They are not equivalent and this will be the output.
- #end
-
-Read `more <http://velocity.apache.org/engine/releases/velocity-1.4/user-guide.html>`_ about the Velocity template language.
-
-This project allows you to use Velocity templates as a component within your Wicket pages, and let them live next to Wicket components. A typical usecase would be to enable your users to embed Velocity templates in your application and using that as a type of portlet.
-
-The main component for the Veloticy/Wicket integration is the VelocityPanel.
-
-.. _Exammple:
-
-Example
---------
-
-Showing Hello, World using Velocity in a Wicket application, embedded in a Wicket page.::
-
- <h2>This is a Velocity template</h2>
-
- <p>The secret message is: $message</p>
-
-In this template we want to replace the string $message with the text “Hello, World!”. $message is Velocity markup denoting a variable that is taken from the context that is provided to the Velocity rendering engine.
-
-To use Velocity in your Wicket pages we provide a VelocityPanel which enables you to generate parts of your page using Velocity markup. Adding the panel to your Wicket page is shown in the following example:::
-
- public VelocityPage() {
- HashMap<String, String> values = new HashMap<String, String>();
- values.put("message", "Hello, World!");
- Model<HashMap<String, String>> context = Model.of(values);
-
- UrlResourceStream template = new UrlResourceStream(getClass().getResource("test.html"));
- add(VelocityPanel.forTemplateResource("velocityPanel", context, template));
- }
-
-VelocityPanel.forTemplateResource creates a VelocityPanel and sets up the engine such that the context is merged with the template with each render.
-
-The markup of the page is quite simple: adding a VelocityPanel is as simple as using a div and attaching a wicket:identifier to it. The following example shows this.
-::
-
- <!DOCTYPE html>
- <h1>This is a test page for Velocity</h1>
- <div wicket:id="velocityPanel"></div>
-
-.. _Installing:
-
-Installing
-----------
-
-Installing Wicket Velocity can be done through adding a dependency in your project’s Maven pom, or by putting the wicket-velocity.jar and the required dependencies in your projects classpath.
-
-Using Maven
-
-Add the following dependency to your pom:::
-
- <dependency>
- <groupId>org.apache.wicket</groupId>
- <artifactId>wicket-velocity</artifactId>
- <version>${wicket.version}</version>
- </dependency>
-
-Required dependencies
-
-If you use dependency management tool like Apache Maven, Apache Ivy, Gradle then just adding the dependency above will download all transitive dependencies. Otherwise you will need at least:
-
-- wicket-util.jar
-- wicket-request.jar
-- wicket-core.jar
-- wicket-velocity.jar
-- velocity.jar
-
-Check the Apache Velocity project to find out which other dependencies you may need additionally.
-
-Also see `Wicket Mustache <https://github.com/l0rdn1kk0n/wicket-mustache>`_ - a third party module that provides similar integration with `Mustache <https://github.com/mustache>`_ templating language.
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/documentation/source/websockets.rst
----------------------------------------------------------------------
diff --git a/documentation/source/websockets.rst b/documentation/source/websockets.rst
deleted file mode 100644
index 407d3d0..0000000
--- a/documentation/source/websockets.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-Native WebSocket
-=================
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/helloworld/pom.xml
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/helloworld/pom.xml b/wicket-reference-guide/helloworld/pom.xml
new file mode 100644
index 0000000..a7acbf7
--- /dev/null
+++ b/wicket-reference-guide/helloworld/pom.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-reference-guide</artifactId>
+ <version>6.6.0-SNAPSHOT</version>
+ <relativePath>../pom.xml</relativePath>
+ </parent>
+ <artifactId>wicket-reference-guide-helloworld</artifactId>
+ <packaging>jar</packaging>
+ <name>Wicket Reference guide - Hello World</name>
+ <description>Hello world application for Wicket Reference guide.</description>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-core</artifactId>
+ </dependency>
+ </dependencies>
+</project>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.html
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.html b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.html
new file mode 100644
index 0000000..4398450
--- /dev/null
+++ b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:wicket="http://wicket.apache.org">
+<head>
+ <title>Hello World</title>
+</head>
+<body>
+ <span wicket:id="message">The real message goes here</span>
+</body>
+</html>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java
new file mode 100644
index 0000000..c82efec
--- /dev/null
+++ b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java
@@ -0,0 +1,29 @@
+/*
+ * 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.
+ */
+package org.apache.wicket.reference.helloworld;
+//#docu
+import org.apache.wicket.markup.html.WebPage;
+import org.apache.wicket.markup.html.basic.Label;
+
+public class HelloWorld extends WebPage
+{
+ public HelloWorld()
+ {
+ add(new Label("message", "Hello World!"));
+ }
+}
+//#docu
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java
new file mode 100644
index 0000000..6065486
--- /dev/null
+++ b/wicket-reference-guide/helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java
@@ -0,0 +1,33 @@
+/*
+ * 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.
+ */
+package org.apache.wicket.reference.helloworld;
+//#docu
+import org.apache.wicket.Page;
+import org.apache.wicket.protocol.http.WebApplication;
+
+public class HelloWorldApplication extends WebApplication
+{
+ /**
+ * @see org.apache.wicket.Application#getHomePage()
+ */
+ @Override
+ public Class<? extends Page> getHomePage()
+ {
+ return HelloWorld.class;
+ }
+}
+//#docu
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/helloworld/src/main/webapp/WEB-INF/web.xml
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/helloworld/src/main/webapp/WEB-INF/web.xml b/wicket-reference-guide/helloworld/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 0000000..7732dc4
--- /dev/null
+++ b/wicket-reference-guide/helloworld/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.
+-->
+<!--//#docu -->
+<web-app xmlns="http://java.sun.com/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
+ version="2.5">
+
+ <filter>
+ <filter-name>HelloWorldApplication</filter-name>
+ <filter-class>org.apache.wicket.protocol.http.WicketFilter</filter-class>
+ <init-param>
+ <param-name>applicationClassName</param-name>
+ <param-value>org.apache.wicket.reference.helloworld.HelloWorldApplication</param-value>
+ </init-param>
+ </filter>
+
+ <filter-mapping>
+ <filter-name>HelloWorldApplication</filter-name>
+ <url-pattern>/helloworld/*</url-pattern>
+ <dispatcher>REQUEST</dispatcher>
+ <dispatcher>INCLUDE</dispatcher>
+ <dispatcher>ERROR</dispatcher>
+ </filter-mapping>
+
+ <session-config>
+ <session-timeout>5</session-timeout>
+ </session-config>
+
+</web-app>
+<!--//#docu -->
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/pom.xml
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/pom.xml b/wicket-reference-guide/pom.xml
new file mode 100644
index 0000000..8e6784a
--- /dev/null
+++ b/wicket-reference-guide/pom.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-parent</artifactId>
+ <version>6.6.0-SNAPSHOT</version>
+ <relativePath>../pom.xml</relativePath>
+ </parent>
+ <artifactId>wicket-reference-guide</artifactId>
+ <packaging>pom</packaging>
+ <name>Wicket Reference guide</name>
+ <description>Wicket Reference guide contains the official documentation for Apache Wicket with code samples.</description>
+
+ <modules>
+ <module>helloworld</module>
+ <module>stateless</module>
+ </modules>
+
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-core</artifactId>
+ </dependency>
+ </dependencies>
+
+ <build>
+ <plugins>
+ <plugin>
+ <artifactId>maven-deploy-plugin</artifactId>
+ <configuration>
+ <!-- Do not deploy the mini applications for the reference guide to Maven repos -->
+ <skip>true</skip>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+</project>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/src/documentation/source/helloworld.rst
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/src/documentation/source/helloworld.rst b/wicket-reference-guide/src/documentation/source/helloworld.rst
index c02e3e8..06917b6 100644
--- a/wicket-reference-guide/src/documentation/source/helloworld.rst
+++ b/wicket-reference-guide/src/documentation/source/helloworld.rst
@@ -15,14 +15,14 @@ HelloWorldApplication.java
Each Wicket application is defined by an `Application <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/Application.html>`_ object. This object defines what the home page is, and allows for some configuration.
-.. includecode:: ../../../helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java
+.. includecode:: ../../../helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorldApplication.java#docu
Here you can see that we define org.apache.wicket.examples.helloworld.HelloWorld to be our home page. When the base URL (the context root) of our application is requested, the markup rendered by the HelloWorld page is returned.
HelloWorld.java
---------------
-.. includecode:: ../../../helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java
+.. includecode:: ../../../helloworld/src/main/java/org/apache/wicket/reference/helloworld/HelloWorld.java#docu
The Label is constructed using two parameters:
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/src/documentation/source/stateless.rst
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/src/documentation/source/stateless.rst b/wicket-reference-guide/src/documentation/source/stateless.rst
index f488117..8f71dac 100644
--- a/wicket-reference-guide/src/documentation/source/stateless.rst
+++ b/wicket-reference-guide/src/documentation/source/stateless.rst
@@ -25,7 +25,48 @@ and `Behavior <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wic
Example
-------
+.. includecode:: ../../../stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.java#docu
+
+
+Click on an `Link <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/markup/html/link/Link.html>`_ will lead to a request that will try to find the Page object that contains this link, then find the link itself in that page and finally execute its `#onClick()` method. The value of *counter* field will increment for each click on the link.
+
+If `StatelessLink <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/markup/html/link/StatelessLink.html>`_ is used instead:
+
+.. includecode:: ../../../stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.java#docu
+
+then the value of *counter* field will always be *0* because a new instance of StatelessPage is created for each click on the link.
+
+Keeping it stateless
+--------------------
+
+To make sure that a page is stateless and there is no stateful component/behavior added to it by accident `StatelessChecker <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/devutils/stateless/StatelessChecker.html>`_ can be used. If there is a stateful component or behavior then this checker will throw an exception which message explains where is the problem.
+
+1. Add dependency to `wicket-devutils`
+
+::
+
+ <dependency>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-devutils</artifactId>
+ <version>${wicket.version}<version>
+ </dependency>
+
+2. Register StatelessChecker
+
+Register StatelessChecker as a listener that is invoked before rendering the page:
+
+**MyApplication.java**
+
+.. includecode:: ../../../stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessApplication.java#check-stateless
+
+3. Annotate the pages
+
+Use `StatelessComponent <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/devutils/stateless/StatelessComponent.html>`_ annotation to require the page to be stateless.
+
+.. includecode:: ../../../stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.java#check-stateless
+
+
+
-For example, click on an `Link <http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/markup/html/link/Link.html>`_ will lead to a request that will try to find the Page object that contains this link, then find the link itself in that page and finally execute its `#onClick()` method.
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/pom.xml
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/pom.xml b/wicket-reference-guide/stateless/pom.xml
new file mode 100644
index 0000000..0702870
--- /dev/null
+++ b/wicket-reference-guide/stateless/pom.xml
@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-reference-guide</artifactId>
+ <version>6.6.0-SNAPSHOT</version>
+ <relativePath>../pom.xml</relativePath>
+ </parent>
+ <artifactId>wicket-reference-guide-stateless</artifactId>
+ <packaging>jar</packaging>
+ <name>Wicket Reference guide - Stateless</name>
+ <description>Demo application for Stateless reference.</description>
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-core</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.wicket</groupId>
+ <artifactId>wicket-devutils</artifactId>
+ </dependency>
+ </dependencies>
+</project>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.html
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.html b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.html
new file mode 100644
index 0000000..c98ab68
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:wicket="http://wicket.apache.org">
+<head>
+ <title>Checked page</title>
+</head>
+<body>
+
+</body>
+</html>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.java b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.java
new file mode 100644
index 0000000..7d5ade4
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/CheckedPage.java
@@ -0,0 +1,10 @@
+package org.apache.wicket.reference.stateless;
+
+import org.apache.wicket.markup.html.WebPage;
+
+//#check-stateless
+@org.apache.wicket.devutils.stateless.StatelessComponent
+public class CheckedPage extends WebPage
+{
+}
+//#check-stateless
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.html
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.html b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.html
new file mode 100644
index 0000000..0927611
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:wicket="http://wicket.apache.org">
+<head>
+ <title>Stateless page</title>
+</head>
+<body>
+<a wicket:id="link">Link</a>
+</body>
+</html>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.java b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.java
new file mode 100644
index 0000000..145fad4
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatefulPage.java
@@ -0,0 +1,43 @@
+/*
+ * 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.
+ */
+//#docu
+package org.apache.wicket.reference.stateless;
+
+import org.apache.wicket.markup.html.WebPage;
+import org.apache.wicket.markup.html.link.Link;
+
+public class StatefulPage extends WebPage
+{
+ private int counter = 0;
+
+ public StatefulPage()
+ {
+ add(new Link<Void>("link") {
+
+ @Override
+ public void onClick()
+ {
+ counter++;
+ }
+ });
+ }
+
+ public int getCounter() {
+ return counter;
+ }
+}
+//#docu
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessApplication.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessApplication.java b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessApplication.java
new file mode 100644
index 0000000..ecd4ac9
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessApplication.java
@@ -0,0 +1,42 @@
+/*
+ * 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.
+ */
+package org.apache.wicket.reference.stateless;
+
+import org.apache.wicket.Page;
+import org.apache.wicket.protocol.http.WebApplication;
+
+public class StatelessApplication extends WebApplication
+{
+ /**
+ * @see org.apache.wicket.Application#getHomePage()
+ */
+ @Override
+ public Class<? extends Page> getHomePage()
+ {
+ return StatefulPage.class;
+ }
+
+ //#check-stateless
+ @Override
+ protected void init()
+ {
+ super.init();
+
+ getComponentPreOnBeforeRenderListeners().add(new org.apache.wicket.devutils.stateless.StatelessChecker());
+ }
+ //#check-stateless
+}
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.html
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.html b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.html
new file mode 100644
index 0000000..0184338
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.html
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:wicket="http://wicket.apache.org">
+<head>
+ <title>Stateless page</title>
+</head>
+<body>
+ <a wicket:id="link">Link</a>
+</body>
+</html>
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.java
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.java b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.java
new file mode 100644
index 0000000..9a7e416
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/java/org/apache/wicket/reference/stateless/StatelessPage.java
@@ -0,0 +1,43 @@
+/*
+ * 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.
+ */
+//#docu
+package org.apache.wicket.reference.stateless;
+
+import org.apache.wicket.markup.html.WebPage;
+import org.apache.wicket.markup.html.link.StatelessLink;
+
+public class StatelessPage extends WebPage
+{
+ private int counter = 0;
+
+ public StatelessPage()
+ {
+ add(new StatelessLink<Void>("link") {
+
+ @Override
+ public void onClick()
+ {
+ counter++;
+ }
+ });
+ }
+
+ public int getCounter() {
+ return counter;
+ }
+}
+//#docu
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/wicket/blob/4dae90dc/wicket-reference-guide/stateless/src/main/webapp/WEB-INF/web.xml
----------------------------------------------------------------------
diff --git a/wicket-reference-guide/stateless/src/main/webapp/WEB-INF/web.xml b/wicket-reference-guide/stateless/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 0000000..c2371fe
--- /dev/null
+++ b/wicket-reference-guide/stateless/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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.
+-->
+<web-app xmlns="http://java.sun.com/xml/ns/javaee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
+ version="2.5">
+
+ <filter>
+ <filter-name>HelloWorldApplication</filter-name>
+ <filter-class>org.apache.wicket.protocol.http.WicketFilter</filter-class>
+ <init-param>
+ <param-name>applicationClassName</param-name>
+ <param-value>org.apache.wicket.reference.stateless.StatelessApplication</param-value>
+ </init-param>
+ </filter>
+
+ <filter-mapping>
+ <filter-name>HelloWorldApplication</filter-name>
+ <url-pattern>/helloworld/*</url-pattern>
+ <dispatcher>REQUEST</dispatcher>
+ <dispatcher>INCLUDE</dispatcher>
+ <dispatcher>ERROR</dispatcher>
+ </filter-mapping>
+
+ <session-config>
+ <session-timeout>5</session-timeout>
+ </session-config>
+
+</web-app>