You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by ba...@apache.org on 2006/01/01 22:43:46 UTC
svn commit: r360559 - in /myfaces/sandbox/trunk/src/site: ./ apt/ fml/
resources/ resources/css/ resources/images/ xdoc/
Author: baranda
Date: Sun Jan 1 13:43:19 2006
New Revision: 360559
URL: http://svn.apache.org/viewcvs?rev=360559&view=rev
Log:
Added documentation sites for the new maven structure for the build (main), tomahawk and sandbox subprojects. Also, modified pom to add some dependencies needed to execute the tests that were missing
Added:
myfaces/sandbox/trunk/src/site/
myfaces/sandbox/trunk/src/site/apt/
myfaces/sandbox/trunk/src/site/apt/format.apt
myfaces/sandbox/trunk/src/site/fml/
myfaces/sandbox/trunk/src/site/fml/faq_maven.fml
myfaces/sandbox/trunk/src/site/resources/
myfaces/sandbox/trunk/src/site/resources/css/
myfaces/sandbox/trunk/src/site/resources/css/site.css (with props)
myfaces/sandbox/trunk/src/site/resources/images/
myfaces/sandbox/trunk/src/site/resources/images/autoUpdateDataTable.jpg (with props)
myfaces/sandbox/trunk/src/site/resources/images/banner-back.jpg (with props)
myfaces/sandbox/trunk/src/site/resources/images/banner-faces.png (with props)
myfaces/sandbox/trunk/src/site/resources/images/banner-logo.png (with props)
myfaces/sandbox/trunk/src/site/resources/images/inputSuggest.png (with props)
myfaces/sandbox/trunk/src/site/resources/images/inputsuggestajax.jpg (with props)
myfaces/sandbox/trunk/src/site/resources/images/schedule.jpg (with props)
myfaces/sandbox/trunk/src/site/resources/images/schedule.png (with props)
myfaces/sandbox/trunk/src/site/resources/images/selectManyPicklist.jpg (with props)
myfaces/sandbox/trunk/src/site/site.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/
myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/component-template.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/focus.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/form.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/index.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/schedule.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml (with props)
myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml (with props)
Added: myfaces/sandbox/trunk/src/site/apt/format.apt
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/apt/format.apt?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/apt/format.apt (added)
+++ myfaces/sandbox/trunk/src/site/apt/format.apt Sun Jan 1 13:43:19 2006
@@ -0,0 +1,596 @@
+
+The APT format
+~~~~~~~~~~~~~~
+
+ In the following section, boxes containing text in typewriter-like font are
+ examples of APT source.
+
+* Document structure
+~~~~~~~~~~~~~~~~~~~~
+
+ A short APT document is contained in a single text file. A longer document
+ may be contained in a ordered list of text files. For instance, first text
+ file contains section 1, second text file contains section 2, and so on.
+
+ [Note:] Splitting the APT document in several text files on a section
+ boundary is not mandatory. The split may occur anywhere.
+ However doing so is recommended because a text file containing a
+ section is by itself a valid APT document.
+
+ A file contains a sequence of paragraphs and ``displays'' (non paragraphs
+ such as tables) separated by open lines.
+
+ A paragraph is simply a sequence of consecutive text lines.
+
++------------------------------------------------------------------------+
+ First line of first paragraph.
+ Second line of first paragraph.
+ Third line of first paragraph.
+
+ Line 1 of paragraph 2 (separated from first paragraph by an open line).
+ Line 2 of paragraph 2.
++------------------------------------------------------------------------+
+
+ The indentation of the first line of a paragraph is the main method used by
+ an APT processor to recognize the type of the paragraph. For example, a
+ section title must not be indented at all.
+
+ A ``plain'' paragraph must be indented by a certain amount of space. For
+ example, a plain paragraph which is not contained in a list may be indented
+ by two spaces.
+
++-------------------------------------------------+
+My section title (not indented).
+
+ My paragraph first line (indented by 2 spaces).
++-------------------------------------------------+
+
+ Indentation is not rigid. Any amount of space will do. You don't even need
+ to use a consistent indentation all over your document. What really matters
+ for an APT processor is whether the paragraph is not indented at all or,
+ when inside a list, whether a paragraph is more or less indented than the
+ first item of the list (more about this later).
+
++-------------------------------------------------------+
+ First paragraph has its first line indented by four
+spaces. Then the author did even bother to indent the
+other lines of the paragraph.
+
+ Second paragraph contains several lines which are all
+ indented by two spaces. This style is much nicer than
+ the one used for the previous paragraph.
++-------------------------------------------------------+
+
+ Note that tabs are expanded with a tab width set to 8.
+
+* Document elements
+~~~~~~~~~~~~~~~~~~~
+
+** Block level elements
+~~~~~~~~~~~~~~~~~~~~~~~
+
+*** Title
+~~~~~~~~~~
+
+ A title is optional. If used, it must appear as the first block of the
+ document.
+
++----------------------------------------------------------------------------+
+ ------
+ Title
+ ------
+ Author
+ ------
+ Date
++----------------------------------------------------------------------------+
+
+ A title block is indented (centering it is nicer). It begins with a line
+ containing at least 3 dashes (<<<--->>>).
+
+ After the first <<<--->>> line, one or several consecutive lines of text
+ (implicit line break after each line) specify the title of the document.
+
+ This text may immediately be followed by another <<<--->>> line and one or
+ several consecutive lines of text which specifies the author of the
+ document.
+
+ The author sub-block may optionaly be followed by a date sub-block using the
+ same syntax.
+
+ The following example is used for a document with an title and a date but
+ with no declared author.
+
++----------------------------------------------------------------------------+
+ ------
+ Title
+ ------
+ ------
+ Date
+ ------
++----------------------------------------------------------------------------+
+
+ The last line is ignored. It is just there to make the block nicer.
+
+*** Paragraph
+~~~~~~~~~~~~~
+
+ Paragraphs other than the title block may appear before the first section.
+
++----------------------+
+ Paragraph 1, line 1.
+ Paragraph 1, line 2.
+
+ Paragraph 2, line 1.
+ Paragraph 2, line 2.
++----------------------+
+
+ Paragraphs are indented. They have already been described in the {{document
+ structure}} section.
+
+*** Section
+~~~~~~~~~~~
+
+ Sections are created by inserting section titles into the document. Simple
+ documents need not contain sections.
+
++-----------------------------------+
+Section title
+
+* Sub-section title
+
+** Sub-sub-section title
+
+*** Sub-sub-sub-section title
+
+**** Sub-sub-sub-sub-section title
++-----------------------------------+
+
+ Section titles are not indented. A sub-section title begins with one
+ asterisk (<<<*>>>), a sub-sub-section title begins with two asterisks
+ (<<<**>>>), and so forth up to four sub-section levels.
+
+*** List
+~~~~~~~~
+
++---------------------------------------+
+ * List item 1.
+
+ * List item 2.
+
+ Paragraph contained in list item 2.
+
+ * Sub-list item 1.
+
+ * Sub-list item 2.
+
+ * List item 3.
++---------------------------------------+
+
+ List items are indented and begin with a asterisk (<<<*>>>).
+
+ Plain paragraphs more indented than the first list item are nested in that
+ list. Displays such as tables (not indented) are always nested in the
+ current list.
+
+ To nest a list inside a list, indent its first item more than its parent
+ list. To end a list, add a paragraph or list item less indented than the
+ current list.
+
+ Section titles always end a list. Displays cannot end a list but the
+ <<<[]>>> pseudo-element may be used to force the end of a list.
+
++------------------------------------+
+ * List item 3.
+ Force end of list:
+
+ []
+
+--------------------------------------------
+Verbatim text not contained in list item 3
+--------------------------------------------
++------------------------------------+
+
+ In the previous example, without the <<<[]>>>, the verbatim text (not
+ indented as all displays) would have been contained in list item 3.
+
+ A single <<<[]>>> may be used to end several nested lists at the same
+ time. The indentation of <<<[]>>> may be used to specify exactly which
+ lists should be ended. Example:
+
++------------------------------------+
+ * List item 1.
+
+ * List item 2.
+
+ * Sub-list item 1.
+
+ * Sub-list item 2.
+
+ []
+
+-------------------------------------------------------------------
+Verbatim text contained in list item 2, but not in sub-list item 2
+-------------------------------------------------------------------
++------------------------------------+
+
+ There are three kind of lists, the bulleted lists we have already described,
+ the numbered lists and the definition lists.
+
++-----------------------------------------+
+ [[1]] Numbered item 1.
+
+ [[A]] Numbered item A.
+
+ [[B]] Numbered item B.
+
+ [[2]] Numbered item 2.
++-----------------------------------------+
+
+ A numbered list item begins with a label beetween two square brackets. The
+ label of the first item establishes the numbering scheme for the whole list:
+
+ [<<<[[1\]\]>>>] Decimal numbering: 1, 2, 3, 4, etc.
+
+ [<<<[[a\]\]>>>] Lower-alpha numbering: a, b, c, d, etc.
+
+ [<<<[[A\]\]>>>] Upper-alpha numbering: A, B, C, D, etc.
+
+ [<<<[[i\]\]>>>] Lower-roman numbering: i, ii, iii, iv, etc.
+
+ [<<<[[I\]\]>>>] Upper-roman numbering: I, II, III, IV, etc.
+
+ The labels of the items other than the first one are ignored. It is
+ recommended to take the time to type the correct label for each item in
+ order to keep the APT source document readable.
+
++-------------------------------------------+
+ [Defined term 1] of definition list 2.
+
+ [Defined term 2] of definition list 2.
++-------------------------------------------+
+
+ A definition list item begins with a defined term: text between square
+ brackets.
+
+*** Verbatim text
+~~~~~~~~~~~~~~~~~
+
++----------------------------------------+
+----------------------------------------
+Verbatim
+ text,
+ preformatted,
+ escaped.
+----------------------------------------
++----------------------------------------+
+
+ A verbatim block is not indented. It begins with a non indented line
+ containing at least 3 dashes (<<<--->>>). It ends with a similar line.
+
+ <<<+-->>> instead of <<<--->>> draws a box around verbatim text.
+
+ Like in HTML, verbatim text is preformatted. Unlike HTML, verbatim text is
+ escaped: inside a verbatim display, markup is not interpreted by the APT
+ processor.
+
+*** Figure
+~~~~~~~~~~
+
++---------------------------+
+[Figure name] Figure caption
++---------------------------+
+
+ A figure block is not indented. It begins with the figure name between
+ square brackets. The figure name is optionally followed by some text: the
+ figure caption.
+
+ The figure name is the pathname of the file containing the figure but
+ without an extension. Example: if your figure is contained in
+ <<</home/joe/docs/mylogo.jpeg>>>, the figure name is
+ <<</home/joe/docs/mylogo>>>.
+
+ If the figure name comes from a relative pathname (recommended practice)
+ rather than from an absolute pathname, this relative pathname is taken to be
+ relative to the directory of the current APT document (a la HTML)
+ rather than relative to the current working directory.
+
+ Why not leave the file extension in the figure name? This is better
+ explained by an example. You need to convert an APT document to PostScript
+ and your figure name is <<</home/joe/docs/mylogo>>>. A APT processor will
+ first try to load <<</home/joe/docs/mylogo.eps>>>. When the desired format
+ is not found, a APT processor tries to convert one of the existing
+ formats. In our example, the APT processor tries to convert
+ <<</home/joe/docs/mylogo.jpeg>>> to encapsulated PostScript.
+
+*** Table
+~~~~~~~~~
+
+ A table block is not indented. It begins with a non indented line containing
+ an asterisk and at least 2 dashes (<<<*-->>>). It ends with a
+ similar line.
+
+ The first line is not only used to recognize a table but also to specify
+ column justification. In the following example,
+
+ * the second asterisk (<<<*>>>) is used to specify that column 1 is
+ centered,
+
+ * the plus sign (<<<+>>>) specifies that column 2 is left aligned,
+
+ * the colon (<<<:>>>) specifies that column 3 is right aligned.
+
+ []
+
++---------------------------------------------+
+*----------*--------------+----------------:
+| Centered | Left-aligned | Right-aligned |
+| cell 1,1 | cell 1,2 | cell 1,3 |
+*----------*--------------+----------------:
+| cell 2,1 | cell 2,2 | cell 2,3 |
+*----------*--------------+----------------:
+Table caption
++---------------------------------------------+
+
+ Rows are separated by a non indented line beginning with <<<*-->>>.
+
+ An optional table caption (non indented text) may immediately follow the
+ table.
+
+ Rows may contain single line or multiple line cells. Each line of cell text
+ is separated from the adjacent cell by the pipe character (<<<|>>>).
+ (<<<|>>> may be used in the cell text if quoted: <<<\\|>>>.)
+
+ The last <<<|>>> is only used to make the table nicer. The first <<<|>>> is
+ not only used to make the table nicer, but also to specify that a grid is to
+ be drawn around table cells.
+
+ The following example shows a simple table with no grid and no caption.
+
++---------------+
+*-----*------*
+ cell | cell
+*-----*------*
+ cell | cell
+*-----*------*
++---------------+
+
+*** Horizontal rule
+~~~~~~~~~~~~~~~~~~~
+
++---------------------+
+=====================
++---------------------+
+
+ A non indented line containing at least 3 equal signs (<<<===>>>).
+
+*** Page break
+~~~~~~~~~~~~~~
+
++---+
+^L
++---+
+
+ A non indented line containing a single form feed character (Control-L).
+
+** Text level elements
+~~~~~~~~~~~~~~~~~~~~~~
+
+*** Font
+~~~~~~~~
+
++-----------------------------------------------------+
+ <Italic> font. <<Bold>> font. <<<Monospaced>>> font.
++-----------------------------------------------------+
+
+ Text between \< and > must be rendered in italic. Text between \<\< and >>
+ must be rendered in bold. Text between \<\<\< and >>> must be rendered using
+ a monospaced, typewriter-like font.
+
+ Font elements may appear anywhere except inside other font elements.
+
+ It is not recommended to use font elements inside titles, section titles,
+ links and defined terms because a APT processor automatically applies
+ appropriate font styles to these elements.
+
+*** Anchor and link
+~~~~~~~~~~~~~~~~~~~
+
++-----------------------------------------------------------------+
+ {Anchor}. Link to {{anchor}}. Link to {{http://www.pixware.fr}}.
+ Link to {{{anchor}showing alternate text}}.
+ Link to {{{http://www.pixware.fr}Pixware home page}}.
++-----------------------------------------------------------------+
+
+ Text between curly braces (<<<\{}>>>) specifies an anchor. Text between
+ double curly braces (<<<\{\{}}>>>) specifies a link.
+
+ It is an error to create a link element that does not refer to an anchor of
+ the same name. The name of an anchor/link is its text with all non
+ alphanumeric characters stripped.
+
+ This rule does not apply to links to <external> anchors. Text beginning
+ with <<<http:/>>>, <<<https:/>>>, <<<ftp:/>>>, <<<file:/>>>, <<<mailto:>>>,
+ <<<../>>>, <<<./>>> (<<<..\\>>> and <<<.\\>>> on Windows) is recognized as
+ an external anchor name.
+
+ When the construct <<\{\{\{>><name><<}>><text><<}}>> is used, the link text
+ <text> may differ from the link name <name>.
+
+ Anchor/link elements may appear anywhere except inside other anchor/link
+ elements.
+
+ Section titles are implicitly defined anchors.
+
+*** Line break
+~~~~~~~~~~~~~~
+
++-------------+
+ Force line\
+ break.
++-------------+
+
+ A backslash character (<<<\\>>>) followed by a newline character.
+
+ Line breaks must not be used inside titles and tables (which are line
+ oriented blocks with implicit line breaks).
+
+*** Non breaking space
+~~~~~~~~~~~~~~~~~~~~~~
+
++----------------------+
+ Non\ breaking\ space.
++----------------------+
+
+ A backslash character (<<<\\>>>) followed by a space character.
+
+*** Special character
+~~~~~~~~~~~~~~~~~~~~~
+
++---------------------------------------------------------------------------+
+ Escaped special characters: \~, \=, \-, \+, \*, \[, \], \<, \>, \{, \}, \\.
++---------------------------------------------------------------------------+
+
+ In certain contexts, these characters have a special meaning and therefore
+ must be escaped if needed as is. They are escaped by adding a backslash in
+ front of them. The backslash may itself be escaped by adding another
+ backslash in front of it.
+
+ Note that an asterisk, for example, needs to be escaped only if its begins a
+ paragraph. (<<<*>>> has no special meaning in the middle of a paragraph.)
+
++--------------------------------------+
+ Copyright symbol: \251, \xA9, \u00a9.
++--------------------------------------+
+
+ Latin-1 characters (whatever is the encoding of the APT document) may be
+ specified by their codes using a backslash followed by one to three octal
+ digits or by using the <<<\x>>><NN> notation, where <NN> are two hexadecimal
+ digits.
+
+ Unicode characters may be specified by their codes using the <<<\u>>><NNNN>
+ notation, where <NNNN> are four hexadecimal digits.
+
+*** Comment
+~~~~~~~~~~~
+
++---------------+
+~~Commented out.
++---------------+
+
+ Text found after two tildes (<<<\~~>>>) is ignored up to the end of line.
+
+ A line of <<<~>>> is often used to ``underline'' section titles in order to
+ make them stand out of other paragraphs.
+
+
+* The APT format at a glance
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+------------------------------------------------------------------------------
+ ------
+ Title
+ ------
+ Author
+ ------
+ Date
+
+ Paragraph 1, line 1.
+ Paragraph 1, line 2.
+
+ Paragraph 2, line 1.
+ Paragraph 2, line 2.
+
+Section title
+
+* Sub-section title
+
+** Sub-sub-section title
+
+*** Sub-sub-sub-section title
+
+**** Sub-sub-sub-sub-section title
+
+ * List item 1.
+
+ * List item 2.
+
+ Paragraph contained in list item 2.
+
+ * Sub-list item 1.
+
+ * Sub-list item 2.
+
+ * List item 3.
+ Force end of list:
+
+ []
+
++------------------------------------------+
+Verbatim text not contained in list item 3
++------------------------------------------+
+
+ [[1]] Numbered item 1.
+
+ [[A]] Numbered item A.
+
+ [[B]] Numbered item B.
+
+ [[2]] Numbered item 2.
+
+ List numbering schemes: [[1]], [[a]], [[A]], [[i]], [[I]].
+
+ [Defined term 1] of definition list.
+
+ [Defined term 2] of definition list.
+
++-------------------------------+
+Verbatim text
+ in a box
++-------------------------------+
+
+ --- instead of +-- suppresses the box around verbatim text.
+
+[Figure name] Figure caption
+
+*----------*--------------+----------------:
+| Centered | Left-aligned | Right-aligned |
+| cell 1,1 | cell 1,2 | cell 1,3 |
+*----------*--------------+----------------:
+| cell 2,1 | cell 2,2 | cell 2,3 |
+*----------*--------------+----------------:
+Table caption
+
+ No grid, no caption:
+
+*-----*------*
+ cell | cell
+*-----*------*
+ cell | cell
+*-----*------*
+
+ Horizontal line:
+
+=======================================================================
+
+^L
+ New page.
+
+ <Italic> font. <<Bold>> font. <<<Monospaced>>> font.
+
+ {Anchor}. Link to {{anchor}}. Link to {{http://www.pixware.fr}}.
+ Link to {{{anchor}showing alternate text}}.
+ Link to {{{http://www.pixware.fr}Pixware home page}}.
+
+ Force line\
+ break.
+
+ Non\ breaking\ space.
+
+ Escaped special characters: \~, \=, \-, \+, \*, \[, \], \<, \>, \{, \}, \\.
+
+ Copyright symbol: \251, \xA9, \u00a9.
+
+~~Commented out.
+
+------------------------------------------------------------------------------
+
Added: myfaces/sandbox/trunk/src/site/fml/faq_maven.fml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/fml/faq_maven.fml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/fml/faq_maven.fml (added)
+++ myfaces/sandbox/trunk/src/site/fml/faq_maven.fml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,25 @@
+<?xml version="1.0"?>
+<faqs id="General FAQ">
+ <part id="General">
+ <faq id="where">
+ <question>Where did Maven come from?</question>
+ <answer>
+ <p>
+ Maven was created by a group of software developers who were tired
+ of wasting their time fiddling around with builds and wanted to get
+ down to brass tacks and actually develop software!
+ </p>
+ </answer>
+ </faq>
+ <faq id="why">
+ <question>Why is maven so wildly popular?</question>
+ <answer>
+ <p>
+ Maven saves you so much time in your software development efforts that
+ you will have time to learn a second language, relax ten hours a
+ day, and train for that marathon you've always wanted to run!
+ </p>
+ </answer>
+ </faq>
+ </part>
+</faqs>
Added: myfaces/sandbox/trunk/src/site/resources/css/site.css
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/css/site.css?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/resources/css/site.css (added)
+++ myfaces/sandbox/trunk/src/site/resources/css/site.css Sun Jan 1 13:43:19 2006
@@ -0,0 +1,197 @@
+body {
+ background-color: #fff;
+ font-family: Verdana, Helvetica, Arial, sans-serif;
+ margin-left: auto;
+ margin-right: auto;
+ background-repeat: repeat-y;
+ font-size: 13px;
+ padding: 0px;
+}
+td, select, input, li{
+ font-family: Verdana, Helvetica, Arial, sans-serif;
+ font-size: 12px;
+ color:#333333;
+}
+code{
+ font-size: 12px;
+}
+a {
+ text-decoration: none;
+}
+a:link {
+ color:#47a;
+}
+a:visited {
+ color:#666666;
+}
+a:active, a:hover {
+ color:#990000;
+}
+#legend li.externalLink {
+ background: url(../images/external.png) left top no-repeat;
+ padding-left: 18px;
+}
+a.externalLink, a.externalLink:link, a.externalLink:visited, a.externalLink:active, a.externalLink:hover {
+ background: url(../images/external.png) right center no-repeat;
+ padding-right: 18px;
+}
+#legend li.newWindow {
+ background: url(../images/newwindow.png) left top no-repeat;
+ padding-left: 18px;
+}
+a.newWindow, a.newWindow:link, a.newWindow:visited, a.newWindow:active, a.newWindow:hover {
+ background: url(../images/newwindow.png) right center no-repeat;
+ padding-right: 18px;
+}
+h2 {
+ font-size: 17px;
+ color: #333333;
+}
+h3 {
+ padding: 4px 4px 4px 24px;
+ color: #666;
+ background-color: #ccc;
+ font-weight: bold;
+ font-size: 14px;
+ background-image: url(../images/h3.jpg);
+ background-repeat: no-repeat;
+ background-position: left bottom;
+}
+p {
+ line-height: 1.3em;
+ font-size: 12px;
+ color: #000;
+}
+#breadcrumbs {
+ height: 13px;
+ background-image: url(../images/breadcrumbs.jpg);
+ padding: 5px 10px 14px 20px;
+}
+* html #breadcrumbs {
+ padding-bottom: 8px;
+}
+#leftColumn {
+ margin: 10px 0 10px 0;
+ border-top-color: #ccc;
+ border-top-style: solid;
+ border-top-width: 1px;
+ border-right-color: #ccc;
+ border-right-style: solid;
+ border-right-width: 1px;
+ border-bottom-color: #ccc;
+ border-bottom-style: solid;
+ border-bottom-width: 1px;
+ padding-right: 5px;
+ padding-left: 5px;
+}
+#navcolumn h5 {
+ font-size: smaller;
+ border-bottom: 1px solid #aaaaaa;
+ padding-top: 2px;
+ padding-left: 9px;
+ color: #49635a;
+ background-image: url(../images/h5.gif);
+ background-repeat: no-repeat;
+ background-position: left bottom;
+}
+
+table.bodyTable th {
+ color: white;
+ background-color: #fec;
+ text-align: left;
+ font-weight: bold;
+}
+
+table.bodyTable th, table.bodyTable td {
+ font-size: 11px;
+}
+
+table.bodyTable tr.a {
+ background-color: #ddd;
+}
+
+table.bodyTable tr.b {
+ background-color: #eee;
+}
+
+.source {
+ border: 1px solid #999;
+ overflow:auto
+}
+dt {
+ padding: 4px 4px 4px 24px;
+ color: #333333;
+ background-color: #ccc;
+ font-weight: bold;
+ font-size: 14px;
+ background-image: url(../images/h3.jpg);
+ background-repeat: no-repeat;
+ background-position: left bottom;
+}
+.subsectionTitle {
+ font-size: 13px;
+ font-weight: bold;
+ color: #666;
+
+}
+
+table {
+ font-size: 10px;
+}
+.xright a:link, .xright a:visited, .xright a:active {
+ color: #666;
+}
+.xright a:hover {
+ color: #003300;
+}
+#banner {
+ height: 95px;
+ background: url(../images/banner-back.jpg);
+}
+#navcolumn ul {
+ margin: 5px 0 15px -0em;
+}
+#navcolumn ul a {
+ color: #333333;
+}
+#navcolumn ul a:hover {
+ color: red;
+}
+#intro {
+ border: solid #ccc 1px;
+ margin: 6px 0px 0px 0px;
+ padding: 10px 40px 10px 40px;
+}
+.subsection {
+ margin-left: 3px;
+ color: #333333;
+}
+
+.subsection p {
+ font-size: 12px;
+}
+#footer {
+ padding: 10px;
+ margin: 20px 0px 20px 0px;
+ border-top: solid #ccc 1px;
+ color: #333333;
+}
+
+div#leftColumn {
+ background: #eff;
+ border-color: #999 #EEE #EEE #999;
+ border-width: 1px;
+ border-style: solid;
+}
+
+.section h2 {
+ background: #fff;
+ border-top: none;
+ border-left: none;
+ border-right: none;
+ padding-left: 0px;
+}
+
+#breadcrumbs{
+ background: #fec;
+}
\ No newline at end of file
Propchange: myfaces/sandbox/trunk/src/site/resources/css/site.css
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/resources/css/site.css
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/resources/images/autoUpdateDataTable.jpg
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/autoUpdateDataTable.jpg?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/autoUpdateDataTable.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/banner-back.jpg
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/banner-back.jpg?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/banner-back.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/banner-faces.png
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/banner-faces.png?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/banner-faces.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/banner-logo.png
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/banner-logo.png?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/banner-logo.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/inputSuggest.png
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/inputSuggest.png?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/inputSuggest.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/inputsuggestajax.jpg
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/inputsuggestajax.jpg?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/inputsuggestajax.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/schedule.jpg
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/schedule.jpg?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/schedule.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/schedule.png
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/schedule.png?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/schedule.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/resources/images/selectManyPicklist.jpg
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/resources/images/selectManyPicklist.jpg?rev=360559&view=auto
==============================================================================
Binary file - no diff available.
Propchange: myfaces/sandbox/trunk/src/site/resources/images/selectManyPicklist.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: myfaces/sandbox/trunk/src/site/site.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/site.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/site.xml (added)
+++ myfaces/sandbox/trunk/src/site/site.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<project name="MyFaces Sandbox">
+ <bannerLeft>
+ <name>MyFaces Sandbox</name>
+ <src>images/banner-logo.png</src>
+ <href>http://myfaces.apache.org/</href>
+ </bannerLeft>
+ <bannerRight>
+ <src>images/banner-faces.png</src>
+ </bannerRight>
+ <body>
+ <links>
+ <item name="Apache" href="http://www.apache.org/" />
+ </links>
+
+ <menu name="Sandbox">
+ <item name="Overview" href="index.html"/>
+ </menu>
+
+ <menu name="Components">
+ <item name="Input Suggest Ajax Menu" href="inputSuggestAjax.html"/>
+ <item name="Auto Update DataTable" href="autoUpdateDataTable.html"/>
+ <item name="Input Suggest" href="inputSuggest.html"/>
+ <item name="Schedule" href="schedule.html"/>
+ <item name="Focus" href="focus.html"/>
+ <item name="Form" href="form.html"/>
+ <item name="Picklist" href="selectManyPicklist.html"/>
+ <item name="Dynamic Image" href="graphicImageDynamic.html"/>
+ </menu>
+
+ <menu name="Validators">
+ <item name="validateCompareTo" href="validateCompareTo.html"/>
+ </menu>
+
+ ${reports}
+
+ </body>
+</project>
Propchange: myfaces/sandbox/trunk/src/site/site.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/site.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ A tag that defines an automatically update DataTable Ajax binding.<br/>
+ This allows you to do frequency controlled update via asynchronous
+ server requests - Ajax. <br/><br/>
+ <code>
+ Note, this control is experimental and it is currently
+ located in the MyFaces sandbox and can be subject to
+ alteration in the immediate future.
+ Therefore use it with care.
+ </code>
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <div><img src="images/autoUpdateDataTable.jpg" alt="autoUpdateDataTable"/></div>
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Data</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.AutoUpdateDataTable</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTable</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTableRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTableTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">
+ <s:autoUpdateDataTable [ all standard dataTable attributes allowed ]
+ [ preserveDataModel="{true|false}" ]
+ [ forceIdIndexFormula="value-binding" ]
+ [ sortColumn="value-binding" ]
+ [ sortAscending="value-binding" ]
+ [ preserveSort="{true|false}" ]
+ [ frequency="value-binding" ]>
+ standard dataTable body (<h:column> tags and optional "header" and "footer" facets)
+ </t:command_sortheader>
+ <s:autoUpdateDataTable>
+ </source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><x:autoUpdateDataTable></h3>
+ <code>all standard dataTable attributes allowed</code><br/>
+ <code>preserveDataModel="{true|false}"</code><br/>
+ <code>forceIdIndexFormula="value-binding"</code><br/>
+ <code>sortColumn="value-binding"</code><br/>
+ <code>sortAscending="value-binding"</code><br/>
+ <code>preserveSort="{true|false}"</code><br/>
+ <code>frequency="value-binding"</code><br/>
+ </blockquote>
+ </section>
+
+ <section name="Instructions">
+
+ <p>
+ <code>
+ frequency - defines the time in seconds between the Ajax-Requests
+ </code>
+ </p>
+ <p>
+ Note - This component is different to others, it uses Ajax mechanisms
+ to fetch data from the server, thus the backend binding can
+ and will be used outside of the standard JSF lifecycle to deliver the data.
+ </p>
+ <p>Use the autoUpdateDataTable tag always within a form tag.</p>
+ <p>
+ It is also not very advisable, to put some input fields
+ (or checkboxes, radio buttons, etc.) into the dataTable, since after every submit
+ (which happens periodically) all the form data is cleared.
+ </p>
+ <p>see examples/ajaxDataTableSingle.jsp for an example.</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/autoUpdateDataTable.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/component-template.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/component-template.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/component-template.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/component-template.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ [TO DO]
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <p>[TO DO]</p> <!-- replace with either a figure or Not Available -->
+ <!--
+ <figure src="jscookmenu.png" alt="jscookmenu"/>
+ -->
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">[TODO]</source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <!-- ex. <s:jsCookMenu> -->
+ <blockquote><h3><s:[TODO]/></h3>
+ <!-- ex. for="reference to UIData" -->
+ <code>[TODO] - [TODO]</code><br/>
+ </blockquote>
+ </section>
+
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>see [TO DO] for an example!</p>
+ </section>
+
+ <!-- Additional Information -->
+ <section name="Additional Information">
+
+ <p>[TODO]</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/component-template.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/component-template.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/focus.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/focus.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/focus.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/focus.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ This component provides a way to control which component receives focus when the page loads.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <p>Not Available</p> <!-- replace with either a figure or Not Available -->
+ <!--
+ <figure src="jscookmenu.png" alt="jscookmenu"/>
+ -->
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Output</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.Focus</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.focus.HtmlFocus</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.focus.HtmlFocusRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.focus.HtmlFocusTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve"><h:inputText id="textfield" value="#{bean.value}" />
+<s:focus id="focus" for="textfield" /></source>
+ <source xml:space="preserve"><s:focus id="focus" for="#{bean.focusedComponentId}" /></source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><s:focus></h3>
+ <code>for="reference to UIComponent"</code><br/>
+ </blockquote>
+ </section>
+
+ <!-- Additional Information -->
+ <section name="Additional Information">
+
+ <p>This component must be placed on the page in such a way that it is rendered
+ after all components to which it might contain a reference. Generally,
+ the best place for this component is right before the closing form tag.</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/focus.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/focus.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/form.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/form.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/form.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/form.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>The tag allows control for the action attribute of the form.</p>
+ <p>
+ Every JSF request goes to the same url which renders the response.
+ The x:form component allows to use a different scheme, servername or
+ port when a form is submitted. This is normally needed to change
+ from http to https to submit security related data.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <p>Not Available</p> <!-- replace with either a figure or Not Available -->
+ <!--
+ <figure src="jscookmenu.png" alt="jscookmenu"/>
+ -->
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Form</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.Form</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.form.HtmlForm</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.form.HtmlFormRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.form.HtmlFormTag</td>
+ </tr>
+ </table>
+ </section>
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">
+<s:form scheme="https" servername="www.domain.org" port="1234">
+</s:form>
+ </source>
+ </section>
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><x:form/></h3>
+ <code>scheme - either "http" or "https" (optional)</code><br/>
+ <code>servername - the server name or an ip address (optional)</code><br/>
+ <code>port - a int value which defines the port (optional)</code>
+ </blockquote>
+ </section>
+ </body>
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/form.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/form.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,98 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ This tag renders a html img tag and can be used to render dynamic images.
+ </p>
+ <p>
+ Embedding images into html pages requires a second request to get the binary data
+ stream of the image. The result is that the state of the view including the state of request
+ scoped beans will not be available when the image is requested.
+ </p>
+ <p>
+ The image data is written by an image renderer which can be defined by the
+ imageRendererClass attribute.
+ </p>
+ <p>
+ This component is able to use nested f:param elements to pass parameters to the image renderer.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <p>Not Available</p> <!-- replace with either a figure or Not Available -->
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Graphic</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.GraphicImageDynamicRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.graphicimagedynamic.GraphicImageDynamic</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.graphicimagedynamic.GraphicImageDynamicRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.graphicimagedynamic.GraphicImageDynamicTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">
+<s:graphicImageDynamic imageRendererClass="ImageRendererClass" >
+ <f:param name="param" value="value" />
+</s:graphicImageDynamic>
+ </source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><s:graphicImageDynamic/></h3>
+ imageRendererClass="class reference"<br/>
+ <code>imageRendererClass - contains a class reference or a fully qualified class name
+ which implements org.apache.myfaces.custom.graphicimagedynamic.ImageRenderer</code><br/>
+ + any attribute of t:graphicImage from tomahawk but without url and value attribute
+ </blockquote>
+ </section>
+
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>see sandbox examples graphicImageDynamic.jsf and graphicImageDynamicText.jsf</p>
+ </section>
+
+ <!-- Additional Information -->
+ <section name="Additional Information">
+
+ <p>[TODO]</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/graphicImageDynamic.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/index.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/index.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/index.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <document>
+
+<body>
+
+ <section name="Summary">
+
+
+ <p>
+ See also the component section of our <a href="http://wiki.apache.org/myfaces/MyFacesComponents">WIKI</a>
+ (might be more complete than the information here).
+ </p>
+ <p>
+ The sandbox is a MyFaces subproject that is a testing ground for potential new additions to the Tomahawk project. It
+ primarily consists of components, but like the Tomahawk project, it can also contain validators and other useful JSF
+ "goodies."
+ </p>
+ <warning label="Warning">
+ These components are a work in progress. In many cases they are checked in without being 100% feature complete. Testing
+ is generally minimal and there is no guarantee that something you use in sandbox will ever be promoted to an official
+ release in Tomahawk.
+ </warning>
+
+ </section>
+
+</body>
+
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/index.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ [TO DO]
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <div><img src="images/inputSuggest.png" alt="inputSuggest"/></div>
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">[TODO]</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">[TODO]</source>
+ </section>
+
+ <!-- Additional Information -->
+ <section name="Additional Information">
+
+ <p>[TODO]</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/inputSuggest.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ A tag that defines an autosuggest control complete with Ajax binding.<br/>
+ This allows you to do real time autocompletion via asynchronous
+ server requests. Note, this control is experimental and it is currently
+ located in the MyFaces sandbox and can be subject to
+ alteration in the immediate future. So use it with care.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <div><img src="images/inputsuggestajax.jpg" alt="InputSuggestAjax"/></div>
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Input</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.InputSuggestAjax</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.inputsuggestAjax.InputSuggestAjax</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.inputsuggestAjax.InputSuggestAjaxRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.inputsuggestAjax.InputSuggestAjaxTag</td>
+ </tr>
+ </table>
+ </section>
+ <section name="Syntax">
+
+ <source xml:space="preserve"><s:Ajaxsuggest id="id" binding="control binding"
+ suggestedItemsMethod="backend bean callback method" value="Bean"/>
+ </source>
+ </section>
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>
+ <code>
+ id - defines the id of the control
+ </code>
+ <br/>
+ <code>
+ suggestedItemsMethod - defines the method call for the backend bean which delivers the preview data
+ </code>
+ <br/>
+ <code>
+ maxSuggestedItems - defines the number of maximal suggested entries (optional)
+ </code>
+ <br/>
+ <code>
+ value - standard bean value for the result
+ </code>
+ <br/>
+ <code>
+ binding - the binding into a control object, this binding is needed because the control object does all the
+ needed data transformation between the Ajax control and the backend/frontend
+ </code>
+ </p>
+ <p>
+ Note - This component is different to others, it uses Ajax mechanisms
+ to fetch preview data from the server, thus the backend binding can
+ and will be used outside of the standard JSF lifecycle to deliver the data.
+
+ <br/><br/>
+ Description of the call order:<br/>
+ <code>
+ control -> Ajax request -> suggestionMethod in backend bean -> values pushed into the control binding -> result sent back to the client -> control shows suggestion drop down
+ </code>
+ <br/><br/>
+ On the backend side, a callback method - the suggestion method, has to be implemented,
+ which is called by the Ajax request and
+ fetches the data from a data source. The data then is pushed into the control binding similarly
+ to drop down menus and other controls which use the SelectItem object as data holder.
+ The rest is done automatically.
+ </p>
+ </section>
+ </body>
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/inputSuggestAjax.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/schedule.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/schedule.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/schedule.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/schedule.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ Renders a schedule component, showing appointments and events
+ in a day, workweek, week or month view, similar to the schedule
+ part of MS Outlook or Evolution.
+ </p>
+ <p>
+ The component is backed by an implementation of the
+ ScheduleModel interface. Creating a custom model can be easily
+ achieved by implementing this interface, or by overriding
+ the AbstractScheduleModel class.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <div><img src="images/schedule.png" alt="schedule"/></div>
+ <div><img src="images/schedule.jpg" alt="schedule"/></div>
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">author</td>
+ <td colspan="1" rowspan="1">Jurgen Lust</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.Panel</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.Schedule</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.schedule.HtmlSchedule</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.schedule.renderer.ScheduleDelegatingRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.schedule.ScheduleTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">
+<s:schedule [ UI component attributes ]
+ [ UI command attributes ]
+ [value="#{backingBean.scheduleModel}"]
+ [visibleStartHour="7"]
+ [visibleEndHour="21"]
+ [workingStartHour="9"]
+ [workingEndHour="17"]
+ [readonly={true|false}]
+ [tooltip={true|false}]
+ [theme={default|outlookxp|evolution}]
+ [headerDateFormat="dd-MM-yyyy"]
+ [compactWeekRowHeight="200"]
+ [compactMonthRowHeight="100"]>
+</s:schedule>
+ </source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><x:schedule/></h3>
+ <code>
+ value - This must be a value binding expression that points to an instance of ScheduleModel.
+ </code>
+ <br/>
+ <code>
+ visibleStartHour - Integer value indicating the first hour of the day that should be visible in the schedule
+ </code>
+ <br/>
+ <code>
+ visibleEndHour - Integer value indicating the last hour of the day that should be visible in the schedule
+ </code>
+ <br/>
+ <code>
+ workingStartHour - Integer value indicating the start of the working day. Everything before this hour will be grayed out
+ </code>
+ <br/>
+ <code>
+ workingEndHour - Integer value indicating the end of the working day. Everything after this hour will be grayed out
+ </code>
+ <br/>
+ <code>
+ readonly - When a schedule is read-only, no entries can be selected
+ </code>
+ <br/>
+ <code>
+ tooltip - Determines whether or not tooltips will be displayed for schedule entries
+ </code>
+ <br/>
+ <code>
+ theme - The name of the theme that should be used when rendering the schedule. Available themes are 'default', 'outlookxp' and 'evolution'
+ </code>
+ <br/>
+ <code>
+ headerDateFormat - If you want to override the Locale dateFormat for displaying the date in the header, you can specify the custom format here
+ </code>
+ <br/>
+ <code>
+ compactWeekRowHeight - The height in pixels of a row in the week view (defaults to 200)
+ </code>
+ <br/>
+ <code>
+ compactMonthRowHeight - The height in pixels of a row in the month view (defaults to 100)
+ </code>
+ <br/>
+ </blockquote>
+ </section>
+
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>see examples/schedule.jsp for an example.</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/schedule.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/schedule.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ A picklist component is a selection component where a set of items
+ can be selected from a list that contains all the available items to a list
+ that contains the selected items.
+ </p>
+ <p>
+ The component is based on the t:selectManyListbox component, so it contains
+ the same attributes. Soon, more specific attributes will be added.
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <div><img src="images/selectManyPicklist.jpg" alt="picklist"/></div>
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">author</td>
+ <td colspan="1" rowspan="1">Bruno Aranda</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-family</td>
+ <td colspan="1" rowspan="1">javax.faces.SelectMany</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-type</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.PicklistRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">component-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.picklist.HtmlSelectManyPicklist</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">renderer-class</td>
+ <td colspan="1" rowspan="1">rg.apache.myfaces.custom.picklist.HtmlPicklistRenderer</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.picklist.HtmlSelectManyPicklistTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve">
+<s:selectManyPicklist [ Standard selectManyListbox attributes ] />
+ </source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><s:selectManyPicklist/></h3>
+ <code>
+ In the current state, this component uses the same attributes than the h:selectManyListBox component. Specific attributes will be added soon.
+ </code>
+ <br/>
+ </blockquote>
+ </section>
+
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>see sandbox/picklist.jsf for an example.</p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/selectManyPicklist.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL
Added: myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml
URL: http://svn.apache.org/viewcvs/myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml?rev=360559&view=auto
==============================================================================
--- myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml (added)
+++ myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml Sun Jan 1 13:43:19 2006
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+ <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN" "http://maven.apache.org/dtd/maven-xdoc.dtd">
+
+ <!--
+This is a standard template meant to be used for the documentation of all custom
+components.
+--><document>
+
+ <body>
+ <!-- Description -->
+ <section name="Description">
+
+ <p>
+ Validate by comparing this component value to another component value
+ </p>
+ </section>
+ <!-- screen shot -->
+ <section name="Screen Shot">
+
+ <p>Not Available</p> <!-- replace with either a figure or Not Available -->
+ </section>
+ <!-- API -->
+ <section name="API">
+
+ <table>
+ <tr>
+ <td colspan="1" rowspan="1">validatorId</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.validator.CompareTo</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">validator-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.comparetovalidator.CompareToValidator</td>
+ </tr>
+ <tr>
+ <td colspan="1" rowspan="1">tag-class</td>
+ <td colspan="1" rowspan="1">org.apache.myfaces.custom.comparetovalidator.ValidateCompareToTag</td>
+ </tr>
+ </table>
+ </section>
+
+ <!-- Usage -->
+ <section name="Usage">
+
+ <source xml:space="preserve"><t:inputCalendar id="startDate"/>
+<t:inputCalendar id="endDate">
+ <s:compareToValidator operator="gt" for="startDate" />
+ <s:compareToValidator operator="gt" for="startDate" message="Start date must be before end date." />
+ <s:compareToValidator operator="gt" for="startDate" message="{0} must be {2} {3}" />
+ <s:compareToValidator operator="gt" for="startDate" alternateOperatorName="after" />
+ <s:compareToValidator operator="gt" for="startDate" message="{0} must be {2} {3}" alternateOperatorName="after" />
+ <s:compareToValidator operator="gt" for="startDate" comparator="#{dateComparator}" />
+<t:inputCalendar></source>
+ </section>
+
+ <!-- Syntax -->
+ <section name="Syntax">
+
+ <blockquote><h3><s:compareToValidator/></h3>
+ <code>for - Required reference to another component.</code><br/>
+ <code>operator - Required operator for comparison: </code><br/>
+ <code>....equals: eq, ==, =,</code><br/>
+ <code>....not equals: ne, !=,</code><br/>
+ <code>....greater than: gt, >,</code><br/>
+ <code>....less than: lt, <,</code><br/>
+ <code>....greater than or equals: ge, >=,</code><br/>
+ <code>....less than or equals: le, <=</code><br/>
+ <code>comparator - Optional value binding for an alternate java.util.Comparator object if component values don't implement Comparable</code><br/>
+ <code>message - Optional alternate validation error message format string where</code><br/>
+ <code>....{0} is the parent component id,</code><br/>
+ <code>....{1} is the parent component value,</code><br/>
+ <code>....{2} is the operator name,</code><br/>
+ <code>....{3} is the foreign component id, and</code><br/>
+ <code>....{4} is the foreign component value.</code><br/>
+ <code>alternateOperatorName = Optional custom operator name in error message (ie "after" instead of "greater than" for dates)</code><br/>
+ </blockquote>
+ </section>
+
+ <!-- Instructions -->
+ <section name="Instructions">
+
+ <p>
+ If the comparator attribute is specified, the component values are compared
+ using the specified java.util.Comparator object. If no comparator is specified, the
+ component values must implement Comparable and are compared using compareTo().
+ If either value or foreign value does not implement Comparable and no Comparator
+ is specified, validation always succeeds.
+ </p>
+ <p>
+ Put this validator on the bottom-most component to insure that
+ the foreign component's value has been converted and validated first.
+ However, this validator will attempt to convert and validate the foreign
+ component's value if this has not already occurred. This process may not
+ be identical to the standard JSF conversion and validation process.
+ </p>
+ <p>See "examples/sandbox/validateUrl.jsp" for an example!</p>
+ </section>
+
+ <!-- Additional Information -->
+ <section name="Known issues">
+
+ <p>
+ The validation error message key is currently hardcoded as
+ "{0} value <{1}> must be {2} {3} value <{4}>"
+ and should be localized.
+ </p>
+ <p>
+ Operator names should be localized.
+ </p>
+ <p>
+ Perhaps an exception should be thrown if the two values are not
+ Comparable and no Comparator is specified.
+ </p>
+ </section>
+
+ </body>
+
+
+</document>
Propchange: myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: myfaces/sandbox/trunk/src/site/xdoc/validateCompareTo.xml
------------------------------------------------------------------------------
svn:keywords = Date Author Id Revision HeadURL