[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Gavin King
gavin.king at jboss.com
Fri Jun 15 03:36:21 EDT 2007
User: gavin
Date: 07/06/15 03:36:21
Modified: doc/reference/en/modules annotations.xml
cache.xml components.xml concepts.xml
configuration.xml controls.xml conversations.xml
drools.xml events.xml framework.xml itext.xml
jbpm.xml mail.xml persistence.xml tutorial.xml
validation.xml xml.xml
Log:
get rid of mdash
Revision Changes Path
1.63 +49 -49 jboss-seam/doc/reference/en/modules/annotations.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: annotations.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/annotations.xml,v
retrieving revision 1.62
retrieving revision 1.63
diff -u -b -r1.62 -r1.63
--- annotations.xml 4 Jun 2007 00:27:19 -0000 1.62
+++ annotations.xml 15 Jun 2007 07:36:20 -0000 1.63
@@ -51,11 +51,11 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — the context variable name. </para>
+ <literal>name</literal> — the context variable name. </para>
</listitem>
<listitem>
<para>
- <literal>scope</literal> — the context variable scope. When no scope is
+ <literal>scope</literal> — the context variable scope. When no scope is
explicitly specified, the default depends upon the component type, as above. </para>
</listitem>
</itemizedlist>
@@ -123,7 +123,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>depends</literal> — specifies that the named components must be
+ <literal>depends</literal> — specifies that the named components must be
started first, if they are installed. </para>
</listitem>
</itemizedlist>
@@ -163,23 +163,23 @@
<itemizedlist>
<listitem>
- <para><literal>BUILT_IN</literal> — Precedence of all built-in Seam
+ <para><literal>BUILT_IN</literal> — Precedence of all built-in Seam
components</para>
</listitem>
<listitem>
- <para><literal>FRAMEWORK</literal> — Precedence to use for components of
+ <para><literal>FRAMEWORK</literal> — Precedence to use for components of
frameworks which extend Seam</para>
</listitem>
<listitem>
- <para><literal>APPLICATION</literal> — Predence of application components (the
+ <para><literal>APPLICATION</literal> — Predence of application components (the
default precedence)</para>
</listitem>
<listitem>
- <para><literal>DEPLOYMENT</literal> — Precedence to use for components which
+ <para><literal>DEPLOYMENT</literal> — Precedence to use for components which
override application components in a particular deployment</para>
</listitem>
<listitem>
- <para><literal>MOCK</literal> — Precedence for mock objects used in testing</para>
+ <para><literal>MOCK</literal> — Precedence for mock objects used in testing</para>
</listitem>
</itemizedlist>
</listitem>
@@ -240,19 +240,19 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — specifies the name of the context variable. Default
+ <literal>value</literal> — specifies the name of the context variable. Default
to the name of the component attribute. Alternatively, specifies a JSF EL expression,
surrounded by <literal>#{...}</literal>. </para>
</listitem>
<listitem>
<para>
- <literal>create</literal> — specifies that Seam should instantiate the
+ <literal>create</literal> — specifies that Seam should instantiate the
component with the same name as the context variable if the context variable is
undefined (null) in all contexts. Default to false. </para>
</listitem>
<listitem>
<para>
- <literal>required</literal> — specifies Seam should throw an exception if the
+ <literal>required</literal> — specifies Seam should throw an exception if the
context variable is undefined in all contexts. </para>
</listitem>
</itemizedlist>
@@ -281,12 +281,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — specifies the name of the context variable. Default
+ <literal>value</literal> — specifies the name of the context variable. Default
to the name of the component attribute. </para>
</listitem>
<listitem>
<para>
- <literal>required</literal> — specifies Seam should throw an exception if the
+ <literal>required</literal> — specifies Seam should throw an exception if the
component attribute is null during outjection. </para>
</listitem>
</itemizedlist>
@@ -338,12 +338,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — specifies the name of the context variable. If the
+ <literal>value</literal> — specifies the name of the context variable. If the
method is a getter method, default to the JavaBeans property name. </para>
</listitem>
<listitem>
<para>
- <literal>scope</literal> — specifies the scope that Seam should bind the
+ <literal>scope</literal> — specifies the scope that Seam should bind the
returned value to. Only meaningful for factory methods which return a value. </para>
</listitem>
</itemizedlist>
@@ -366,7 +366,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — specifies the name of the log category. Default to
+ <literal>value</literal> — specifies the name of the log category. Default to
the name of the component class. </para>
</listitem>
</itemizedlist>
@@ -388,7 +388,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — specifies the name of the request parameter.
+ <literal>value</literal> — specifies the name of the request parameter.
Default to the name of the component attribute. </para>
</listitem>
</itemizedlist>
@@ -506,12 +506,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
+ <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
result in a new long-running conversation context. </para>
</listitem>
<listitem>
<para>
- <literal>join</literal> — determines the behavior when a long-running
+ <literal>join</literal> — determines the behavior when a long-running
conversation is already in progress. If <literal>true</literal>, the context is
propagated. If <literal>false</literal>, an exception is thrown. Default to
<literal>false</literal>. This setting is ignored when
@@ -519,18 +519,18 @@
</listitem>
<listitem>
<para>
- <literal>nested</literal> — specifies that a nested conversation should be
+ <literal>nested</literal> — specifies that a nested conversation should be
started if a long-running conversation is already in progress. </para>
</listitem>
<listitem>
<para>
- <literal>flushMode</literal> — set the flush mode of any Seam-managed
+ <literal>flushMode</literal> — set the flush mode of any Seam-managed
Hibernate sessions or JPA persistence contexts that are created during this
conversation. </para>
</listitem>
<listitem>
<para>
- <literal>pageflow</literal> — a process definition name of a jBPM process
+ <literal>pageflow</literal> — a process definition name of a jBPM process
definition deployed via <literal>org.jboss.seam.core.jbpm.pageflowDefinitions.</literal>
</para>
</listitem>
@@ -555,12 +555,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
+ <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
result in the end of the current long-running conversation. </para>
</listitem>
<listitem>
<para>
- <literal>beforeRedirect</literal> — by default, the conversation will not
+ <literal>beforeRedirect</literal> — by default, the conversation will not
actually be destroyed until after any redirect has occurred. Setting
<literal>beforeRedirect=true</literal> specifies that the conversation should be
destroyed at the end of the current request, and that the redirect will be processed in
@@ -586,13 +586,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>taskIdParameter</literal> — the name of a request parameter which
+ <literal>taskIdParameter</literal> — the name of a request parameter which
holds the id of the task. Default to <literal>"taskId"</literal>, which is also the
default used by the Seam <literal>taskList</literal> JSF component. </para>
</listitem>
<listitem>
<para>
- <literal>flushMode</literal> — set the flush mode of any Seam-managed
+ <literal>flushMode</literal> — set the flush mode of any Seam-managed
Hibernate sessions or JPA persistence contexts that are created during this
conversation. </para>
</listitem>
@@ -617,13 +617,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>taskIdParameter</literal> — the name of a request parameter which
+ <literal>taskIdParameter</literal> — the name of a request parameter which
holds the id of the task. Default to <literal>"taskId"</literal>, which is also the
default used by the Seam <literal>taskList</literal> JSF component. </para>
</listitem>
<listitem>
<para>
- <literal>flushMode</literal> — set the flush mode of any Seam-managed
+ <literal>flushMode</literal> — set the flush mode of any Seam-managed
Hibernate sessions or JPA persistence contexts that are created during this
conversation. </para>
</listitem>
@@ -654,17 +654,17 @@
<itemizedlist>
<listitem>
<para>
- <literal>transition</literal> — the name of the jBPM transition to be
+ <literal>transition</literal> — the name of the jBPM transition to be
triggered when ending the task. Defaults to the default transition. </para>
</listitem>
<listitem>
<para>
- <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
+ <literal>ifOutcome</literal> — specifies the JSF outcome or outcomes that
result in the end of the task. </para>
</listitem>
<listitem>
<para>
- <literal>beforeRedirect</literal> — by default, the conversation will not
+ <literal>beforeRedirect</literal> — by default, the conversation will not
actually be destroyed until after any redirect has occurred. Setting
<literal>beforeRedirect=true</literal> specifies that the conversation should be
destroyed at the end of the current request, and that the redirect will be processed in
@@ -685,7 +685,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>definition</literal> — the name of the jBPM process definition
+ <literal>definition</literal> — the name of the jBPM process definition
deployed via <literal>org.jboss.seam.core.jbpm.processDefinitions</literal>. </para>
</listitem>
</itemizedlist>
@@ -703,7 +703,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>processIdParameter</literal> — the name a request parameter holding
+ <literal>processIdParameter</literal> — the name a request parameter holding
the process id. Default to <literal>"processId"</literal>. </para>
</listitem>
</itemizedlist>
@@ -747,7 +747,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>ifOutcome</literal> — the JSF outcomes that cause a transaction
+ <literal>ifOutcome</literal> — the JSF outcomes that cause a transaction
rollback (no outcomes is interpreted to mean any outcome). </para>
</listitem>
</itemizedlist>
@@ -792,16 +792,16 @@
<itemizedlist>
<listitem>
<para>
- <literal>viewId</literal> — specifies the JSF view id to redirect to. </para>
+ <literal>viewId</literal> — specifies the JSF view id to redirect to. </para>
</listitem>
<listitem>
<para>
- <literal>message</literal> — a message to be displayed, default to the
+ <literal>message</literal> — a message to be displayed, default to the
exception message. </para>
</listitem>
<listitem>
<para>
- <literal>end</literal> — specifies that the long-running conversation should
+ <literal>end</literal> — specifies that the long-running conversation should
end, default to <literal>false</literal>. </para>
</listitem>
</itemizedlist>
@@ -817,17 +817,17 @@
<itemizedlist>
<listitem>
<para>
- <literal>errorCode</literal> — the HTTP error code, default to
+ <literal>errorCode</literal> — the HTTP error code, default to
<literal>500</literal>. </para>
</listitem>
<listitem>
<para>
- <literal>message</literal> — a message to be sent with the HTTP error, default
+ <literal>message</literal> — a message to be sent with the HTTP error, default
to the exception message. </para>
</listitem>
<listitem>
<para>
- <literal>end</literal> — specifies that the long-running conversation should
+ <literal>end</literal> — specifies that the long-running conversation should
end, default to <literal>false</literal>. </para>
</listitem>
</itemizedlist>
@@ -861,11 +861,11 @@
<itemizedlist>
<listitem>
<para>
- <literal>outcome</literal> — the JSF outcome when validation fails. </para>
+ <literal>outcome</literal> — the JSF outcome when validation fails. </para>
</listitem>
<listitem>
<para>
- <literal>refreshEntities</literal> — specifies that any invalid entity in the
+ <literal>refreshEntities</literal> — specifies that any invalid entity in the
managed state should be refreshed from the database when validation fails. Default to
<literal>false</literal>. (Useful with extended persistence contexts.) </para>
</listitem>
@@ -1003,12 +1003,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>id</literal> — the JSF converter id. Defaults to the component name.
+ <literal>id</literal> — the JSF converter id. Defaults to the component name.
</para>
</listitem>
<listitem>
<para>
- <literal>forClass</literal> — if specified, register this component as the default converter for a type.
+ <literal>forClass</literal> — if specified, register this component as the default converter for a type.
</para>
</listitem>
</itemizedlist>
@@ -1026,7 +1026,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>id</literal> — the JSF validator id. Defaults to the component name.
+ <literal>id</literal> — the JSF validator id. Defaults to the component name.
</para>
</listitem>
</itemizedlist>
@@ -1054,12 +1054,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — name of the conversation context variable. Default
+ <literal>value</literal> — name of the conversation context variable. Default
to the attribute name. </para>
</listitem>
<listitem>
<para>
- <literal>scope</literal> — if <literal>scope=ScopeType.PAGE</literal> is
+ <literal>scope</literal> — if <literal>scope=ScopeType.PAGE</literal> is
explicitly specified, the <literal>DataModel</literal> will be kept in the
<literal>PAGE</literal> context. </para>
</listitem>
@@ -1077,7 +1077,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — name of the conversation context variable. Not
+ <literal>value</literal> — name of the conversation context variable. Not
needed if there is exactly one <literal>@DataModel</literal> in the component. </para>
</listitem>
</itemizedlist>
@@ -1094,7 +1094,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — name of the conversation context variable. Not
+ <literal>value</literal> — name of the conversation context variable. Not
needed if there is exactly one <literal>@DataModel</literal> in the component. </para>
</listitem>
</itemizedlist>
1.4 +1 -1 jboss-seam/doc/reference/en/modules/cache.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: cache.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/cache.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- cache.xml 27 Feb 2007 16:31:02 -0000 1.3
+++ cache.xml 15 Jun 2007 07:36:20 -0000 1.4
@@ -11,7 +11,7 @@
nodes of the cluster. What these silly people are really thinking of
is a "share nothing except for the database" architecture. Of course,
sharing the database is the primary problem with scaling a multi-user
- application—so the claim that this architecture is highly scalable
+ application—so the claim that this architecture is highly scalable
is absurd, and tells you a lot about the kind of applications that these
folks spend most of their time working on.
</para>
1.59 +102 -102 jboss-seam/doc/reference/en/modules/components.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: components.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/components.xml,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -b -r1.58 -r1.59
--- components.xml 30 May 2007 00:01:00 -0000 1.58
+++ components.xml 15 Jun 2007 07:36:20 -0000 1.59
@@ -124,42 +124,42 @@
<itemizedlist>
<listitem>
<para>
- <literal>add(FacesMessage facesMessage)</literal> — add
+ <literal>add(FacesMessage facesMessage)</literal> — add
a faces message, which will be displayed during the next render
response phase that occurs in the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>add(String messageTemplate)</literal> — add
+ <literal>add(String messageTemplate)</literal> — add
a faces message, rendered from the given message template
which may contain EL expressions.
</para>
</listitem>
<listitem>
<para>
- <literal>add(Severity severity, String messageTemplate)</literal> —
+ <literal>add(Severity severity, String messageTemplate)</literal> —
add a faces message, rendered from the given message template
which may contain EL expressions.
</para>
</listitem>
<listitem>
<para>
- <literal>addFromResourceBundle(String key)</literal> —
+ <literal>addFromResourceBundle(String key)</literal> —
add a faces message, rendered from a message template defined
in the Seam resource bundle which may contain EL expressions.
</para>
</listitem>
<listitem>
<para>
- <literal>addFromResourceBundle(Severity severity, String key)</literal> —
+ <literal>addFromResourceBundle(Severity severity, String key)</literal> —
add a faces message, rendered from a message template defined
in the Seam resource bundle which may contain EL expressions.
</para>
</listitem>
<listitem>
<para>
- <literal>clear()</literal> — clear all messages.
+ <literal>clear()</literal> — clear all messages.
</para>
</listitem>
</itemizedlist>
@@ -175,33 +175,33 @@
<itemizedlist>
<listitem>
<para>
- <literal>redirect.viewId</literal> — the JSF view id
+ <literal>redirect.viewId</literal> — the JSF view id
to redirect to.
</para>
</listitem>
<listitem>
<para>
- <literal>redirect.conversationPropagationEnabled</literal> —
+ <literal>redirect.conversationPropagationEnabled</literal> —
determines whether the conversation will propagate across the
redirect.
</para>
</listitem>
<listitem>
<para>
- <literal>redirect.parameters</literal> — a map of
+ <literal>redirect.parameters</literal> — a map of
request parameter name to value, to be passed in the redirect
request.
</para>
</listitem>
<listitem>
<para>
- <literal>execute()</literal> — perform the redirect
+ <literal>execute()</literal> — perform the redirect
immediately.
</para>
</listitem>
<listitem>
<para>
- <literal>captureCurrentRequest()</literal> — stores
+ <literal>captureCurrentRequest()</literal> — stores
the view id and request parameters of the current GET
request (in the conversation context), for later use
by calling <literal>execute()</literal>.
@@ -229,21 +229,21 @@
<itemizedlist>
<listitem>
<para>
- <literal>raiseEvent(String type)</literal> — raise
+ <literal>raiseEvent(String type)</literal> — raise
an event of a particular type and distribute to all
observers.
</para>
</listitem>
<listitem>
<para>
- <literal>raiseAsynchronousEvent(String type)</literal> —
+ <literal>raiseAsynchronousEvent(String type)</literal> —
raise an event to be processed asynchronously by the EJB3
timer service.
</para>
</listitem>
<listitem>
<para>
- <literal>raiseTimedEvent(String type, ....)</literal> —
+ <literal>raiseTimedEvent(String type, ....)</literal> —
schedule an event to be processed asynchronously by the EJB3
timer service.
</para>
@@ -251,7 +251,7 @@
<listitem>
<para>
<literal>addListener(String type, String methodBinding)</literal>
- — add an observer for a particular event type.
+ — add an observer for a particular event type.
</para>
</listitem>
</itemizedlist>
@@ -267,7 +267,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>interpolate(String template)</literal> — scan
+ <literal>interpolate(String template)</literal> — scan
the template for JSF EL expressions of the form <literal>#{...}</literal>
and replace them with their evaluated values.
</para>
@@ -284,13 +284,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>createValueBinding(String expression)</literal> — create
+ <literal>createValueBinding(String expression)</literal> — create
a value binding object.
</para>
</listitem>
<listitem>
<para>
- <literal>createMethodBinding(String expression)</literal> — create
+ <literal>createMethodBinding(String expression)</literal> — create
a method binding object.
</para>
</listitem>
@@ -307,7 +307,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>pojoCache.cfgResourceName</literal> — the name of
+ <literal>pojoCache.cfgResourceName</literal> — the name of
the configuration file. Default to <literal>treecache.xml</literal>.
</para>
</listitem>
@@ -366,7 +366,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>resourceBundle.bundleNames</literal> — the names of
+ <literal>resourceBundle.bundleNames</literal> — the names of
the Java resource bundles to search. Default to <literal>messages</literal>.
</para>
</listitem>
@@ -383,49 +383,49 @@
<itemizedlist>
<listitem>
<para>
- <literal>select()</literal> — select the specified locale.
+ <literal>select()</literal> — select the specified locale.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.locale</literal> — the actual
+ <literal>localeSelector.locale</literal> — the actual
<literal>java.util.Locale</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.localeString</literal> — the
+ <literal>localeSelector.localeString</literal> — the
stringified representation of the locale.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.language</literal> — the language for
+ <literal>localeSelector.language</literal> — the language for
the specified locale.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.country</literal> — the country for
+ <literal>localeSelector.country</literal> — the country for
the specified locale.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.variant</literal> — the variant for
+ <literal>localeSelector.variant</literal> — the variant for
the specified locale.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.supportedLocales</literal> — a list
+ <literal>localeSelector.supportedLocales</literal> — a list
of <literal>SelectItem</literal>s representing the supported locales
listed in <literal>jsf-config.xml</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>localeSelector.cookieEnabled</literal> — specifies
+ <literal>localeSelector.cookieEnabled</literal> — specifies
that the locale selection should be persisted via a cookie.
</para>
</listitem>
@@ -442,24 +442,24 @@
<itemizedlist>
<listitem>
<para>
- <literal>select()</literal> — select the specified locale.
+ <literal>select()</literal> — select the specified locale.
</para>
</listitem>
<listitem>
<para>
- <literal>timezoneSelector.timezone</literal> — the actual
+ <literal>timezoneSelector.timezone</literal> — the actual
<literal>java.util.TimeZone</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>timezoneSelector.timeZoneId</literal> — the
+ <literal>timezoneSelector.timeZoneId</literal> — the
stringified representation of the timezone.
</para>
</listitem>
<listitem>
<para>
- <literal>timezoneSelector.cookieEnabled</literal> — specifies
+ <literal>timezoneSelector.cookieEnabled</literal> — specifies
that the timezone selection should be persisted via a cookie.
</para>
</listitem>
@@ -485,31 +485,31 @@
<itemizedlist>
<listitem>
<para>
- <literal>select()</literal> — select the specified theme.
+ <literal>select()</literal> — select the specified theme.
</para>
</listitem>
<listitem>
<para>
- <literal>theme.availableThemes</literal> — the list of
+ <literal>theme.availableThemes</literal> — the list of
defined themes.
</para>
</listitem>
<listitem>
<para>
- <literal>themeSelector.theme</literal> — the selected
+ <literal>themeSelector.theme</literal> — the selected
theme.
</para>
</listitem>
<listitem>
<para>
- <literal>themeSelector.themes</literal> — a list
+ <literal>themeSelector.themes</literal> — a list
of <literal>SelectItem</literal>s representing the defined
themes.
</para>
</listitem>
<listitem>
<para>
- <literal>themeSelector.cookieEnabled</literal> — specifies
+ <literal>themeSelector.cookieEnabled</literal> — specifies
that the theme selection should be persisted via a cookie.
</para>
</listitem>
@@ -549,104 +549,104 @@
<itemizedlist>
<listitem>
<para>
- <literal>getId()</literal> — returns the current conversation id
+ <literal>getId()</literal> — returns the current conversation id
</para>
</listitem>
<listitem>
<para>
- <literal>isNested()</literal> — is the current conversation a
+ <literal>isNested()</literal> — is the current conversation a
nested conversation?
</para>
</listitem>
<listitem>
<para>
- <literal>isLongRunning()</literal> — is the current conversation a
+ <literal>isLongRunning()</literal> — is the current conversation a
long-running conversation?
</para>
</listitem>
<listitem>
<para>
- <literal>getId()</literal> — returns the current conversation id
+ <literal>getId()</literal> — returns the current conversation id
</para>
</listitem>
<listitem>
<para>
- <literal>getParentId()</literal> — returns the conversation id
+ <literal>getParentId()</literal> — returns the conversation id
of the parent conversation
</para>
</listitem>
<listitem>
<para>
- <literal>getRootId()</literal> — returns the conversation id
+ <literal>getRootId()</literal> — returns the conversation id
of the root conversation
</para>
</listitem>
<listitem>
<para>
- <literal>setTimeout(int timeout)</literal> — sets the timeout
+ <literal>setTimeout(int timeout)</literal> — sets the timeout
for the current conversation
</para>
</listitem>
<listitem>
<para>
- <literal>setViewId(String outcome)</literal> — sets the view id
+ <literal>setViewId(String outcome)</literal> — sets the view id
to be used when switching back to the current conversation from the
conversation switcher, conversation list, or breadcrumbs.
</para>
</listitem>
<listitem>
<para>
- <literal>setDescription(String description)</literal> — sets the
+ <literal>setDescription(String description)</literal> — sets the
description of the current conversation to be displayed in the
conversation switcher, conversation list, or breadcrumbs.
</para>
</listitem>
<listitem>
<para>
- <literal>redirect()</literal> — redirect to the last well-defined
+ <literal>redirect()</literal> — redirect to the last well-defined
view id for this conversation (useful after login challenges).
</para>
</listitem>
<listitem>
<para>
- <literal>leave()</literal> — exit the scope of this conversation,
+ <literal>leave()</literal> — exit the scope of this conversation,
without actually ending the conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>begin()</literal> — begin a long-running conversation
+ <literal>begin()</literal> — begin a long-running conversation
(equivalent to <literal>@Begin</literal>).
</para>
</listitem>
<listitem>
<para>
- <literal>beginPageflow(String pageflowName)</literal> — begin a
+ <literal>beginPageflow(String pageflowName)</literal> — begin a
long-running conversation with a pageflow (equivalent to
<literal>@Begin(pageflow="...")</literal>).
</para>
</listitem>
<listitem>
<para>
- <literal>end()</literal> — end a long-running conversation
+ <literal>end()</literal> — end a long-running conversation
(equivalent to <literal>@End</literal>).
</para>
</listitem>
<listitem>
<para>
- <literal>pop()</literal> — pop the conversation stack, returning
+ <literal>pop()</literal> — pop the conversation stack, returning
to the parent conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>root()</literal> — return to the root conversation of
+ <literal>root()</literal> — return to the root conversation of
the conversation stack.
</para>
</listitem>
<listitem>
<para>
- <literal>changeFlushMode(FlushModeType flushMode)</literal> — change
+ <literal>changeFlushMode(FlushModeType flushMode)</literal> — change
the flush mode of the conversation.
</para>
</listitem>
@@ -701,25 +701,25 @@
<itemizedlist>
<listitem>
<para>
- <literal>isInProcess()</literal> — returns <literal>true</literal>
+ <literal>isInProcess()</literal> — returns <literal>true</literal>
if there is currently a pageflow in process
</para>
</listitem>
<listitem>
<para>
- <literal>getProcessInstance()</literal> — returns jBPM
+ <literal>getProcessInstance()</literal> — returns jBPM
<literal>ProcessInstance</literal> for the current pageflow
</para>
</listitem>
<listitem>
<para>
- <literal>begin(String pageflowName)</literal> — begin a pageflow
+ <literal>begin(String pageflowName)</literal> — begin a pageflow
in the context of the current conversation
</para>
</listitem>
<listitem>
<para>
- <literal>reposition(String nodeName)</literal> — reposition the
+ <literal>reposition(String nodeName)</literal> — reposition the
current pageflow to a particular node
</para>
</listitem>
@@ -736,13 +736,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>setId(String actorId)</literal> — sets the jBPM
+ <literal>setId(String actorId)</literal> — sets the jBPM
actor id of the current user.
</para>
</listitem>
<listitem>
<para>
- <literal>getGroupActorIds()</literal> — returns a
+ <literal>getGroupActorIds()</literal> — returns a
<literal>Set</literal> to which jBPM actor ids for the
current users groups may be added.
</para>
@@ -760,7 +760,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>setName(String transitionName)</literal> — sets the
+ <literal>setName(String transitionName)</literal> — sets the
jBPM transition name to be used when the current task is ended
via <literal>@EndTask</literal>.
</para>
@@ -778,62 +778,62 @@
<itemizedlist>
<listitem>
<para>
- <literal>businessProcess.taskId</literal> — the id of the task
+ <literal>businessProcess.taskId</literal> — the id of the task
associated with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>businessProcess.processId</literal> — the id of the process
+ <literal>businessProcess.processId</literal> — the id of the process
associated with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>businessProcess.hasCurrentTask()</literal> — is a task
+ <literal>businessProcess.hasCurrentTask()</literal> — is a task
instance associated with the current conversation?
</para>
</listitem>
<listitem>
<para>
- <literal>businessProcess.hasCurrentProcess()</literal> — is a process
+ <literal>businessProcess.hasCurrentProcess()</literal> — is a process
instance associated with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>createProcess(String name)</literal> — create an
+ <literal>createProcess(String name)</literal> — create an
instance of the named process definition and associate it with
the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>startTask()</literal> — start the task
+ <literal>startTask()</literal> — start the task
associated with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>endTask(String transitionName)</literal> — end the task
+ <literal>endTask(String transitionName)</literal> — end the task
associated with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>resumeTask(Long id)</literal> — associate the task with
+ <literal>resumeTask(Long id)</literal> — associate the task with
the given id with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>resumeProcess(Long id)</literal> — associate the process
+ <literal>resumeProcess(Long id)</literal> — associate the process
with the given id with the current conversation.
</para>
</listitem>
<listitem>
<para>
- <literal>transition(String transitionName)</literal> — trigger
+ <literal>transition(String transitionName)</literal> — trigger
the transition.
</para>
</listitem>
@@ -996,37 +996,37 @@
<itemizedlist>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.host</literal> — the hostname of the SMTP server to use
+ <literal>org.jboss.seam.mail.mailSession.host</literal> — the hostname of the SMTP server to use
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.port</literal> — the port of the SMTP server to use
+ <literal>org.jboss.seam.mail.mailSession.port</literal> — the port of the SMTP server to use
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.username</literal> — the username to use to connect to the SMTP server.
+ <literal>org.jboss.seam.mail.mailSession.username</literal> — the username to use to connect to the SMTP server.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.password</literal> — the password to use to connect to the SMTP server
+ <literal>org.jboss.seam.mail.mailSession.password</literal> — the password to use to connect to the SMTP server
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.debug</literal> — enable JavaMail debugging (very verbose)
+ <literal>org.jboss.seam.mail.mailSession.debug</literal> — enable JavaMail debugging (very verbose)
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.ssl</literal> — enable SSL connection to SMTP (will default to port 465)
+ <literal>org.jboss.seam.mail.mailSession.ssl</literal> — enable SSL connection to SMTP (will default to port 465)
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.mail.mailSession.sessionJndiName</literal> — name under which a javax.mail.Session is bound to JNDI.
+ <literal>org.jboss.seam.mail.mailSession.sessionJndiName</literal> — name under which a javax.mail.Session is bound to JNDI.
If supplied, all other properties will be ignored.
</para>
</listitem>
@@ -1054,26 +1054,26 @@
<itemizedlist>
<listitem>
<para>
- <literal>org.jboss.seam.core.init.jndiPattern</literal> — the JNDI
+ <literal>org.jboss.seam.core.init.jndiPattern</literal> — the JNDI
pattern used for looking up session beans
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.init.debug</literal> — enable Seam
+ <literal>org.jboss.seam.core.init.debug</literal> — enable Seam
debug mode
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.init.clientSideConversations</literal> —
+ <literal>org.jboss.seam.core.init.clientSideConversations</literal> —
if set to <literal>true</literal>, Seam will save conversation context
variables in the client instead of in the <literal>HttpSession</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.init.userTransactionName</literal> — the JNDI
+ <literal>org.jboss.seam.core.init.userTransactionName</literal> — the JNDI
name to use when looking up the JTA <literal>UserTransaction</literal> object.
</para>
</listitem>
@@ -1090,27 +1090,27 @@
<itemizedlist>
<listitem>
<para>
- <literal>org.jboss.seam.core.manager.conversationTimeout</literal> —
+ <literal>org.jboss.seam.core.manager.conversationTimeout</literal> —
the conversation context timeout in milliseconds.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.manager.concurrentRequestTimeout</literal> —
+ <literal>org.jboss.seam.core.manager.concurrentRequestTimeout</literal> —
maximum wait time for a thread attempting to gain a lock on the long-running
conversation context.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.manager.conversationIdParameter</literal> —
+ <literal>org.jboss.seam.core.manager.conversationIdParameter</literal> —
the request parameter used to propagate the conversation id, default
to <literal>conversationId</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.manager.conversationIsLongRunningParameter</literal> —
+ <literal>org.jboss.seam.core.manager.conversationIsLongRunningParameter</literal> —
the request parameter used to propagate information about whether the conversation
is long-running, default to <literal>conversationIsLongRunning</literal>.
</para>
@@ -1128,7 +1128,7 @@
<listitem>
<para>
<literal>org.jboss.seam.core.pages.noConversationViewId</literal>
- — global setting for the view id to redirect to when a
+ — global setting for the view id to redirect to when a
conversation entry is not found on the server side.
</para>
</listitem>
@@ -1182,14 +1182,14 @@
<itemizedlist>
<listitem>
<para>
- <literal>org.jboss.seam.core.jbpm.processDefinitions</literal> —
+ <literal>org.jboss.seam.core.jbpm.processDefinitions</literal> —
a list of resource names of jPDL files to be used for orchestration
of business processes.
</para>
</listitem>
<listitem>
<para>
- <literal>org.jboss.seam.core.jbpm.pageflowDefinitions</literal> —
+ <literal>org.jboss.seam.core.jbpm.pageflowDefinitions</literal> —
a list of resource names of jPDL files to be used for orchestration
of conversation page flows.
</para>
@@ -1235,7 +1235,7 @@
<listitem>
<para>
<literal>org.jboss.seam.jms.queueConnection.queueConnectionFactoryJndiName</literal>
- — the JNDI name of a JMS <literal>QueueConnectionFactory</literal>. Default
+ — the JNDI name of a JMS <literal>QueueConnectionFactory</literal>. Default
to <literal>UIL2ConnectionFactory</literal>
</para>
</listitem>
@@ -1253,7 +1253,7 @@
<listitem>
<para>
<literal>org.jboss.seam.jms.topicConnection.topicConnectionFactoryJndiName</literal>
- — the JNDI name of a JMS <literal>TopicConnectionFactory</literal>. Default
+ — the JNDI name of a JMS <literal>TopicConnectionFactory</literal>. Default
to <literal>UIL2ConnectionFactory</literal>
</para>
</listitem>
@@ -1428,12 +1428,12 @@
<listitem>
<para>
<literal><emphasis><entityManager></emphasis>.entityManagerFactory</literal>
- — a value binding expression that evaluates to an instance of
+ — a value binding expression that evaluates to an instance of
<literal>EntityManagerFactory</literal>.
</para>
<para>
<literal><emphasis><entityManager></emphasis>.persistenceUnitJndiName</literal>
- — the JNDI name of the entity manager factory, default to
+ — the JNDI name of the entity manager factory, default to
<literal>java:/<emphasis><managedPersistenceContext></emphasis></literal>.
</para>
</listitem>
@@ -1451,7 +1451,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>entityManagerFactory.persistenceUnitName</literal> —
+ <literal>entityManagerFactory.persistenceUnitName</literal> —
the name of the persistence unit.
</para>
</listitem>
@@ -1472,12 +1472,12 @@
<listitem>
<para>
<literal><emphasis><session></emphasis>.sessionFactory</literal>
- — a value binding expression that evaluates to an instance of
+ — a value binding expression that evaluates to an instance of
<literal>SessionFactory</literal>.
</para>
<para>
<literal><emphasis><session></emphasis>.sessionFactoryJndiName</literal>
- — the JNDI name of the session factory, default to
+ — the JNDI name of the session factory, default to
<literal>java:/<emphasis><managedSession></emphasis></literal>.
</para>
</listitem>
@@ -1494,7 +1494,7 @@
<itemizedlist>
<listitem>
<para>
- <literal><sessionFactory>.cfgResourceName</literal> —
+ <literal><sessionFactory>.cfgResourceName</literal> —
the path to the configuration file. Default to <literal>hibernate.cfg.xml</literal>.
</para>
</listitem>
@@ -1515,7 +1515,7 @@
<listitem>
<para>
<literal><emphasis><managedQueueSender></emphasis>.queueJndiName</literal>
- — the JNDI name of the JMS queue.
+ — the JNDI name of the JMS queue.
</para>
</listitem>
</itemizedlist>
@@ -1532,7 +1532,7 @@
<listitem>
<para>
<literal><emphasis><managedTopicPublisher></emphasis>.topicJndiName</literal>
- — the JNDI name of the JMS topic.
+ — the JNDI name of the JMS topic.
</para>
</listitem>
</itemizedlist>
@@ -1549,7 +1549,7 @@
<listitem>
<para>
<literal><emphasis><managedWorkingMemory></emphasis>.ruleBase</literal>
- — a value expression that evaluates to an instance of <literal>RuleBase</literal>.
+ — a value expression that evaluates to an instance of <literal>RuleBase</literal>.
</para>
</listitem>
</itemizedlist>
@@ -1568,11 +1568,11 @@
<listitem>
<para>
<literal><emphasis><ruleBase></emphasis>.ruleFiles</literal>
- — a list of files containing Drools rules.
+ — a list of files containing Drools rules.
</para>
<para>
<literal><emphasis><ruleBase></emphasis>.dslFile</literal>
- — a Drools DSL definition.
+ — a Drools DSL definition.
</para>
</listitem>
</itemizedlist>
1.59 +7 -7 jboss-seam/doc/reference/en/modules/concepts.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: concepts.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/concepts.xml,v
retrieving revision 1.58
retrieving revision 1.59
diff -u -b -r1.58 -r1.59
--- concepts.xml 14 Jun 2007 16:24:26 -0000 1.58
+++ concepts.xml 15 Jun 2007 07:36:20 -0000 1.59
@@ -543,7 +543,7 @@
a <literal>User</literal> class which is usually used as a session-scoped component representing the
current user but is used in user administration screens as a conversation-scoped component. The
<literal>@Role</literal> annotation lets us define an additional named role for a component, with a
- different scope—it lets us bind the same component class to different context variables. (Any
+ different scope—it lets us bind the same component class to different context variables. (Any
Seam component <emphasis>instance</emphasis> may be bound to multiple context variables, but this lets
us do it at the class level, and take advantage of auto-instantiation.)
</para>
@@ -863,32 +863,32 @@
<orderedlist>
<listitem>
<para>
- <literal>BUILT_IN</literal> — the lowest precedece components are
+ <literal>BUILT_IN</literal> — the lowest precedece components are
the components built in to Seam.
</para>
</listitem>
<listitem>
<para>
- <literal>FRAMEWORK</literal> — components defined by third-party
+ <literal>FRAMEWORK</literal> — components defined by third-party
frameworks may override built-in components, but are overridden by
application components.
</para>
</listitem>
<listitem>
<para>
- <literal>APPLICATION</literal> — the default precedence. This is
+ <literal>APPLICATION</literal> — the default precedence. This is
appropriate for most application components.
</para>
</listitem>
<listitem>
<para>
- <literal>DEPLOYMENT</literal> — for application components which
+ <literal>DEPLOYMENT</literal> — for application components which
are deployment-specific.
</para>
</listitem>
<listitem>
<para>
- <literal>MOCK</literal> — for mock objects used in testing.
+ <literal>MOCK</literal> — for mock objects used in testing.
</para>
</listitem>
</orderedlist>
@@ -974,7 +974,7 @@
}]]></programlisting>
<para>
- It doesn't matter if you declare the <literal>log</literal> variable static or not—it will work
+ It doesn't matter if you declare the <literal>log</literal> variable static or not—it will work
either way, except for entity bean components which require the <literal>log</literal> variable to be
static.
</para>
1.49 +14 -28 jboss-seam/doc/reference/en/modules/configuration.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: configuration.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/configuration.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -b -r1.48 -r1.49
--- configuration.xml 29 May 2007 19:52:05 -0000 1.48
+++ configuration.xml 15 Jun 2007 07:36:20 -0000 1.49
@@ -48,20 +48,6 @@
</para>
<para>
- If you are using Sun's JSF 1.2 reference implementation, you should
- also add this to <literal>faces-config.xml</literal>:
- </para>
-
- <programlisting><![CDATA[<application>
- <el-resolver>org.jboss.seam.jsf.SeamELResolver</el-resolver>
-</application>]]></programlisting>
-
- <para>
- (This line should not strictly speaking be necessary, but it works
- around a minor bug in the RI.)
- </para>
-
- <para>
Some JSF implementations have a broken implementation of server-side state
saving that interferes with Seam's conversation propagation. If you have problems
with conversation propagation during form submissions, try switching to client-side
@@ -152,7 +138,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests.
</para>
</listitem>
@@ -177,7 +163,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests.
</para>
</listitem>
@@ -200,7 +186,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>create-temp-files</literal> — If set to
+ <literal>create-temp-files</literal> — If set to
<literal>true</literal>, uploaded files are written to a temporary
file (instead of held in memory). This may be an important
consideration if large file uploads are expected. The default
@@ -209,7 +195,7 @@
</listitem>
<listitem>
<para>
- <literal>max-request-size</literal> — If the size of a file upload
+ <literal>max-request-size</literal> — If the size of a file upload
request (determined by reading the <literal>Content-Length</literal>
header in the request) exceeds this value, the request will be
aborted. The default setting is 0 (no size limit).
@@ -217,7 +203,7 @@
</listitem>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests.
</para>
</listitem>
@@ -242,12 +228,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>encoding</literal> — The encoding to use.
+ <literal>encoding</literal> — The encoding to use.
</para>
</listitem>
<listitem>
<para>
- <literal>override-client</literal> — If this is set to
+ <literal>override-client</literal> — If this is set to
<literal>true</literal>, the request encoding will be set to
whatever is specified by <literal>encoding</literal> no matter
whether the request already specifies an encoding or not. If
@@ -258,7 +244,7 @@
</listitem>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests.
</para>
</listitem>
@@ -286,7 +272,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>force-parser</literal> — forces all JSF pages to be validated by
+ <literal>force-parser</literal> — forces all JSF pages to be validated by
Ajax4jsf's XML syntax checker. If <literal>false</literal>, only AJAX responses
are validated and converted to well-formed XML. Setting <literal>force-parser</literal>
to <literal>false</literal> improves performance, but can provide visual artifacts
@@ -295,20 +281,20 @@
</listitem>
<listitem>
<para>
- <literal>enable-cache</literal> — enables caching of framework-generated resources
+ <literal>enable-cache</literal> — enables caching of framework-generated resources
(e.g. javascript, CSS, images, etc). When developing custom javascript or CSS, setting to
true prevents the browser from caching the resource.
</para>
</listitem>
<listitem>
<para>
- <literal>log4j-init-file</literal> — is used to setup per-application logging. A path,
+ <literal>log4j-init-file</literal> — is used to setup per-application logging. A path,
relative to web application context, to the log4j.xml configuration file should be provided.
</para>
</listitem>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests.
</para>
</listitem>
@@ -343,7 +329,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>url-pattern</literal> — Used to specify which requests
+ <literal>url-pattern</literal> — Used to specify which requests
are filtered, the default is all requests. If the url-pattern
is specified for the context filter, then the filter will be
enabled (unless explicitly disabled).
@@ -500,7 +486,7 @@
<para>
You might think this is silly and what kind of idiot framework designers would
make an empty file affect the behavior of their software?? Well, this is a
- workaround for a limitation of the JVM—if we didn't use this mechanism,
+ workaround for a limitation of the JVM—if we didn't use this mechanism,
our next best option would be to force you to list every component explicitly
in <literal>components.xml</literal>, just like some other competing
frameworks do! I think you'll like our way better.
1.37 +65 -65 jboss-seam/doc/reference/en/modules/controls.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: controls.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/controls.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -b -r1.36 -r1.37
--- controls.xml 1 Jun 2007 20:57:25 -0000 1.36
+++ controls.xml 15 Jun 2007 07:36:20 -0000 1.37
@@ -44,40 +44,40 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — the label.
+ <literal>value</literal> — the label.
</para>
</listitem>
<listitem>
<para>
- <literal>action</literal> — a method binding that specified
+ <literal>action</literal> — a method binding that specified
the action listener.
</para>
</listitem>
<listitem>
<para>
- <literal>view</literal> — the JSF view id to link to.
+ <literal>view</literal> — the JSF view id to link to.
</para>
</listitem>
<listitem>
<para>
- <literal>fragment</literal> — the fragment identifier to link to.
+ <literal>fragment</literal> — the fragment identifier to link to.
</para>
</listitem>
<listitem>
<para>
- <literal>disabled</literal> — is the link disabled?
+ <literal>disabled</literal> — is the link disabled?
</para>
</listitem>
<listitem>
<para>
- <literal>propagation</literal> — determines the conversation
+ <literal>propagation</literal> — determines the conversation
propagation style: <literal>begin</literal>, <literal>join</literal>,
<literal>nest</literal>, <literal>none</literal> or <literal>end</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>pageflow</literal> — a pageflow definition to begin.
+ <literal>pageflow</literal> — a pageflow definition to begin.
(This is only useful when <literal>propagation="begin"</literal> or
<literal>propagation="join"</literal>.)
</para>
@@ -107,7 +107,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>key</literal> — the key to cache rendered content,
+ <literal>key</literal> — the key to cache rendered content,
often a value expression. For example, if we were caching a page
fragment that displays a document, we might use
<literal>key="Document-#{document.id}"</literal>.
@@ -115,13 +115,13 @@
</listitem>
<listitem>
<para>
- <literal>enabled</literal> — a value expression that determines
+ <literal>enabled</literal> — a value expression that determines
if the cache should be used.
</para>
</listitem>
<listitem>
<para>
- <literal>region</literal> — a JBoss Cache node to use (different
+ <literal>region</literal> — a JBoss Cache node to use (different
nodes can have different expiry policies).
</para>
</listitem>
@@ -181,14 +181,14 @@
<itemizedlist>
<listitem>
<para>
- <literal>propagation</literal> — determines the conversation
+ <literal>propagation</literal> — determines the conversation
propagation style: <literal>begin</literal>, <literal>join</literal>,
<literal>nest</literal>, <literal>none</literal> or <literal>end</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>pageflow</literal> — a pageflow definition to begin.
+ <literal>pageflow</literal> — a pageflow definition to begin.
(This is only useful when <literal>propagation="begin"</literal> or
<literal>propagation="join"</literal>.)
</para>
@@ -308,7 +308,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>template</literal> — the facelets template to use to decorate the component
+ <literal>template</literal> — the facelets template to use to decorate the component
</para>
</listitem>
</itemizedlist>
@@ -367,13 +367,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>enumValue</literal> — the string representation of the enum
+ <literal>enumValue</literal> — the string representation of the enum
value.
</para>
</listitem>
<listitem>
<para>
- <literal>label</literal> — the label to be used when rendering the <literal>SelectItem</literal>.
+ <literal>label</literal> — the label to be used when rendering the <literal>SelectItem</literal>.
</para>
</listitem>
</itemizedlist>
@@ -430,13 +430,13 @@
<itemizedlist>
<listitem>
<para>
- <literal>createTempFiles</literal> — if this option is set to true, uploaded files are
+ <literal>createTempFiles</literal> — if this option is set to true, uploaded files are
streamed to a temporary file instead of in memory.
</para>
</listitem>
<listitem>
<para>
- <literal>maxRequestSize</literal> — the maximum size of a file upload request, in bytes.
+ <literal>maxRequestSize</literal> — the maximum size of a file upload request, in bytes.
</para>
</listitem>
</itemizedlist>
@@ -454,36 +454,36 @@
<itemizedlist>
<listitem>
<para>
- <literal>data</literal> — this value binding receives the binary file data.
+ <literal>data</literal> — this value binding receives the binary file data.
The receiving field should be declared as a <literal>byte[]</literal> or <literal>InputStream</literal> (required).
</para>
</listitem>
<listitem>
<para>
- <literal>contentType</literal> — this value binding receives the file's
+ <literal>contentType</literal> — this value binding receives the file's
content type (optional).
</para>
</listitem>
<listitem>
<para>
- <literal>fileName</literal> — this value binding receives the filename (optional).
+ <literal>fileName</literal> — this value binding receives the filename (optional).
</para>
</listitem>
<listitem>
<para>
- <literal>accept</literal> — a comma-separated list of content types to accept,
+ <literal>accept</literal> — a comma-separated list of content types to accept,
may not be supported by the browser. E.g. <literal>"images/png,images/jpg"</literal>,
<literal>"images/*"</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>style</literal> — The control's style
+ <literal>style</literal> — The control's style
</para>
</listitem>
<listitem>
<para>
- <literal>styleClass</literal> — The control's style class
+ <literal>styleClass</literal> — The control's style class
</para>
</listitem>
</itemizedlist>
@@ -508,7 +508,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — an EL expression specifying the rich text markup to render.
+ <literal>value</literal> — an EL expression specifying the rich text markup to render.
</para>
</listitem>
</itemizedlist>
@@ -567,7 +567,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — image to display. Can be a path <literal>String</literal>
+ <literal>value</literal> — image to display. Can be a path <literal>String</literal>
(loaded from the classpath), a <literal>byte[]</literal>, a <literal>java.io.File</literal>,
a <literal>java.io.InputStream</literal> or a <literal>java.net.URL</literal>. Currently supported
image formats are <literal>image/png</literal>, <literal>image/jpeg</literal> and <literal>image/gif</literal>.
@@ -575,7 +575,7 @@
</listitem>
<listitem>
<para>
- <literal>fileName</literal> — if not specified the served image will have a generated file name.
+ <literal>fileName</literal> — if not specified the served image will have a generated file name.
If you want to name your file, you should specify it here. This name should be unique
</para>
</listitem>
@@ -592,24 +592,24 @@
<itemizedlist>
<listitem>
<para>
- <literal>width</literal> — new width of the image
+ <literal>width</literal> — new width of the image
</para>
</listitem>
<listitem>
<para>
- <literal>height</literal> — new height of the image
+ <literal>height</literal> — new height of the image
</para>
</listitem>
<listitem>
<para>
- <literal>maintainRatio</literal> — if <literal>true</literal>, and <emphasis>one</emphasis> of
+ <literal>maintainRatio</literal> — if <literal>true</literal>, and <emphasis>one</emphasis> of
<literal>width</literal>/<literal>height</literal> are specified, the image will be resized with the
dimension not specified being calculated to maintain the aspect ratio.
</para>
</listitem>
<listitem>
<para>
- <literal>factor</literal> — scale the image by the given factor
+ <literal>factor</literal> — scale the image by the given factor
</para>
</listitem>
</itemizedlist>
@@ -621,7 +621,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>radius</literal> — perform a convolution blur with the given radius
+ <literal>radius</literal> — perform a convolution blur with the given radius
</para>
</listitem>
</itemizedlist>
@@ -633,7 +633,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>contentType</literal> — alter the type of the image to either <literal>image/jpeg</literal> or <literal>image/png</literal>
+ <literal>contentType</literal> — alter the type of the image to either <literal>image/jpeg</literal> or <literal>image/png</literal>
</para>
</listitem>
</itemizedlist>
@@ -671,40 +671,40 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — the label.
+ <literal>value</literal> — the label.
</para>
</listitem>
<listitem>
<para>
- <literal>action</literal> — a method binding that specified
+ <literal>action</literal> — a method binding that specified
the action listener.
</para>
</listitem>
<listitem>
<para>
- <literal>view</literal> — the JSF view id to link to.
+ <literal>view</literal> — the JSF view id to link to.
</para>
</listitem>
<listitem>
<para>
- <literal>fragment</literal> — the fragment identifier to link to.
+ <literal>fragment</literal> — the fragment identifier to link to.
</para>
</listitem>
<listitem>
<para>
- <literal>disabled</literal> — is the link disabled?
+ <literal>disabled</literal> — is the link disabled?
</para>
</listitem>
<listitem>
<para>
- <literal>propagation</literal> — determines the conversation
+ <literal>propagation</literal> — determines the conversation
propagation style: <literal>begin</literal>, <literal>join</literal>,
<literal>nest</literal>, <literal>none</literal> or <literal>end</literal>.
</para>
</listitem>
<listitem>
<para>
- <literal>pageflow</literal> — a pageflow definition to begin.
+ <literal>pageflow</literal> — a pageflow definition to begin.
(This is only useful when <literal>propagation="begin"</literal> or
<literal>propagation="join"</literal>.)
</para>
@@ -762,24 +762,24 @@
<itemizedlist>
<listitem>
<para>
- <literal>for</literal> — The id of the input field that the date picker will insert the
+ <literal>for</literal> — The id of the input field that the date picker will insert the
selected date into.
</para>
</listitem>
<listitem>
<para>
- <literal>dateFormat</literal> — The date format string. This should match the date format of the
+ <literal>dateFormat</literal> — The date format string. This should match the date format of the
input field.
</para>
</listitem>
<listitem>
<para>
- <literal>startYear</literal> — The popup year selector range will start at this year.
+ <literal>startYear</literal> — The popup year selector range will start at this year.
</para>
</listitem>
<listitem>
<para>
- <literal>endYear</literal> — The popup year selector range will end at this year.
+ <literal>endYear</literal> — The popup year selector range will end at this year.
</para>
</listitem>
</itemizedlist>
@@ -815,102 +815,102 @@
<itemizedlist>
<listitem>
<para>
- <literal>seam-date</literal> — This class is applied to the outer <literal>div</literal> containing the
+ <literal>seam-date</literal> — This class is applied to the outer <literal>div</literal> containing the
popup calendar. (1) It is also applied to the <literal>table</literal> that controls the inner layout of the
calendar. (2)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-header</literal> — This class is applied to the calendar header table row (<literal>tr</literal>)
+ <literal>seam-date-header</literal> — This class is applied to the calendar header table row (<literal>tr</literal>)
and header table cells (<literal>td</literal>). (3)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-header-prevMonth</literal> — This class is applied to the "previous month" table cell,
+ <literal>seam-date-header-prevMonth</literal> — This class is applied to the "previous month" table cell,
(<literal>td</literal>), which when clicked causes the calendar to display the month prior to the one currently
displayed. (4)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-header-nextMonth</literal> — This class is applied to the "next month" table cell,
+ <literal>seam-date-header-nextMonth</literal> — This class is applied to the "next month" table cell,
(<literal>td</literal>), which when clicked causes the calendar to display the month following the one currently
displayed. (5)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-headerDays</literal> — This class is applied to the calendar days header row
+ <literal>seam-date-headerDays</literal> — This class is applied to the calendar days header row
(<literal>tr</literal>), which contains the names of the week days. (6)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-footer</literal> — This class is applied to the calendar footer row
+ <literal>seam-date-footer</literal> — This class is applied to the calendar footer row
(<literal>tr</literal>), which displays the current date. (7)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-inMonth</literal> — This class is applied to the table cell
+ <literal>seam-date-inMonth</literal> — This class is applied to the table cell
(<literal>td</literal>) elements that contain a date within the month currently displayed. (8)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-outMonth</literal> — This class is applied to the table cell
+ <literal>seam-date-outMonth</literal> — This class is applied to the table cell
(<literal>td</literal>) elements that contain a date outside of the month currently displayed. (9)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-selected</literal> — This class is applied to the table cell
+ <literal>seam-date-selected</literal> — This class is applied to the table cell
(<literal>td</literal>) element that contains the currently selected date. (10)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-dayOff-inMonth</literal> — This class is applied to the table cell
+ <literal>seam-date-dayOff-inMonth</literal> — This class is applied to the table cell
(<literal>td</literal>) elements that contain a "day off" date (i.e. weekend days, Saturday and Sunday)
within the currently selected month. (11)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-dayOff-outMonth</literal> — This class is applied to the table cell
+ <literal>seam-date-dayOff-outMonth</literal> — This class is applied to the table cell
(<literal>td</literal>) elements that contain a "day off" date (i.e. weekend days, Saturday and Sunday)
outside of the currently selected month. (12)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-hover</literal> — This class is applied to the table cell
+ <literal>seam-date-hover</literal> — This class is applied to the table cell
(<literal>td</literal>) element over which the cursor is hovering. (13)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-monthNames</literal> — This class is applied to the <literal>div</literal>
+ <literal>seam-date-monthNames</literal> — This class is applied to the <literal>div</literal>
control that contains the popup month selector. (14)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-monthNameLink</literal> — This class is applied to the anchor (<literal>a</literal>)
+ <literal>seam-date-monthNameLink</literal> — This class is applied to the anchor (<literal>a</literal>)
controls that contain the popup month names. (15)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-years </literal> — This class is applied to the <literal>div</literal>
+ <literal>seam-date-years </literal> — This class is applied to the <literal>div</literal>
control that contains the popup year selector. (16)
</para>
</listitem>
<listitem>
<para>
- <literal>seam-date-yearLink</literal> — This class is applied to the anchor (<literal>a</literal>)
+ <literal>seam-date-yearLink</literal> — This class is applied to the anchor (<literal>a</literal>)
controls that contain the popup years. (15)
</para>
</listitem>
@@ -942,35 +942,35 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — an EL expression specifying the data that backs the <literal>List<SelectItem></literal>
+ <literal>value</literal> — an EL expression specifying the data that backs the <literal>List<SelectItem></literal>
</para>
</listitem>
<listitem>
<para>
- <literal>var</literal> — defines the name of the local variable that holds the current object during iteration
+ <literal>var</literal> — defines the name of the local variable that holds the current object during iteration
</para>
</listitem>
<listitem>
<para>
- <literal>label</literal> — the label to be used when rendering the <literal>SelectItem</literal>. Can reference
+ <literal>label</literal> — the label to be used when rendering the <literal>SelectItem</literal>. Can reference
the <literal>var</literal> variable
</para>
</listitem>
<listitem>
<para>
- <literal>disabled</literal> — if true the <literal>SelectItem</literal> will be rendered disabled. Can reference
+ <literal>disabled</literal> — if true the <literal>SelectItem</literal> will be rendered disabled. Can reference
the <literal>var</literal> variable
</para>
</listitem>
<listitem>
<para>
- <literal>noSelectionLabel</literal> — specifies the (optional) label to place at the top of list (if
+ <literal>noSelectionLabel</literal> — specifies the (optional) label to place at the top of list (if
<literal>required="true"</literal> is also specified then selecting this value will cause a validation error)
</para>
</listitem>
<listitem>
<para>
- <literal>hideNoSelectionLabel</literal> — if true, the <literal>noSelectionLabel</literal> will be hidden
+ <literal>hideNoSelectionLabel</literal> — if true, the <literal>noSelectionLabel</literal> will be hidden
when a value is selected
</para>
</listitem>
1.29 +13 -13 jboss-seam/doc/reference/en/modules/conversations.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: conversations.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/conversations.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -b -r1.28 -r1.29
--- conversations.xml 29 May 2007 19:52:05 -0000 1.28
+++ conversations.xml 15 Jun 2007 07:36:20 -0000 1.29
@@ -107,7 +107,7 @@
<para>
If the JSF request lifecycle is foreshortened by a redirect,
Seam transparently stores and restores the current conversation
- context—unless the conversation was already ended via
+ context—unless the conversation was already ended via
<literal>@End(beforeRedirect=true)</literal>.
</para>
</listitem>
@@ -426,8 +426,8 @@
solve the first problem, but this does nothing to help us with the second
problem. We <emphasis>could</emphasis> work around this by using the
RESTful approach of passing a request parameter and requerying
- for the selected object on the server side. In some cases—such as the
- Seam blog example application—this is indeed the best approach. The
+ for the selected object on the server side. In some cases—such as the
+ Seam blog example application—this is indeed the best approach. The
RESTful style supports bookmarking, since it does not require server-side state.
In other cases, where we don't care about bookmarks, the use of
<literal>@DataModel</literal> and <literal>@DataModelSelection</literal> is
@@ -444,14 +444,14 @@
The link may specify just the JSF view id:
</para>
- <programlisting><![CDATA[<s:link view=“/login.xhtml†value=“Loginâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link view=“/login.xhtml” value=“Login”/>]]></programlisting>
<para>
Or, it may specify an action method (in which case the action outcome determines
the page that results):
</para>
- <programlisting><![CDATA[<s:link action=“#{login.logout}†value=“Logoutâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link action=“#{login.logout}” value=“Logout”/>]]></programlisting>
<para>
If you specify <emphasis>both</emphasis> a JSF view id and an action method, the
@@ -459,39 +459,39 @@
non-null outcome:
</para>
- <programlisting><![CDATA[<s:link view="/loggedOut.xhtml" action=“#{login.logout}†value=“Logoutâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link view="/loggedOut.xhtml" action=“#{login.logout}” value=“Logout”/>]]></programlisting>
<para>
The link automatically propagates the selected row of a <literal>DataModel</literal>
using inside <literal><h:dataTable></literal>:
</para>
- <programlisting><![CDATA[<s:link view=“/hotel.xhtml†action=“#{hotelSearch.selectHotel}†value=“#{hotel.name}â€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link view=“/hotel.xhtml” action=“#{hotelSearch.selectHotel}” value=“#{hotel.name}”/>]]></programlisting>
<para>
You can leave the scope of an existing conversation:
</para>
- <programlisting><![CDATA[<s:link view=“/main.xhtml†propagation=“noneâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link view=“/main.xhtml” propagation=“none”/>]]></programlisting>
<para>
You can begin, end, or nest conversations:
</para>
- <programlisting><![CDATA[<s:link action=“#{issueEditor.viewComment}†propagation=“nestâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link action=“#{issueEditor.viewComment}” propagation=“nest”/>]]></programlisting>
<para>
If the link begins a conversation, you can even specify a pageflow to be used:
</para>
- <programlisting><![CDATA[<s:link action=“#{documentEditor.getDocument}†propagation=“beginâ€
- pageflow=“EditDocumentâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link action=“#{documentEditor.getDocument}” propagation=“begin”
+ pageflow=“EditDocument”/>]]></programlisting>
<para>
The <literal>taskInstance</literal> attribute if for use in jBPM task lists:
</para>
- <programlisting><![CDATA[<s:link action=“#{documentApproval.approveOrReject}†taskInstance=“#{task}â€/>]]></programlisting>
+ <programlisting><![CDATA[<s:link action=“#{documentApproval.approveOrReject}” taskInstance=“#{task}”/>]]></programlisting>
<para>
(See the DVD Store demo application for examples of this.)
@@ -501,7 +501,7 @@
Finally, if you need the "link" to be rendered as a button, use <literal><s:button></literal>:
</para>
- <programlisting><![CDATA[<s:button action=“#{login.logout}†value=“Logoutâ€/>]]></programlisting>
+ <programlisting><![CDATA[<s:button action=“#{login.logout}” value=“Logout”/>]]></programlisting>
</section>
1.14 +1 -1 jboss-seam/doc/reference/en/modules/drools.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: drools.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/drools.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -b -r1.13 -r1.14
--- drools.xml 8 Dec 2006 15:52:59 -0000 1.13
+++ drools.xml 15 Jun 2007 07:36:20 -0000 1.14
@@ -88,7 +88,7 @@
<para>
You can even allow a rule base to act as a jBPM action handler, decision
- handler, or assignment handler—in either a pageflow or business
+ handler, or assignment handler—in either a pageflow or business
process definition.
</para>
1.26 +30 -30 jboss-seam/doc/reference/en/modules/events.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: events.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/events.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- events.xml 12 Jun 2007 22:28:39 -0000 1.25
+++ events.xml 15 Jun 2007 07:36:20 -0000 1.26
@@ -601,36 +601,36 @@
</para>
<itemizedlist>
- <listitem><para><literal>org.jboss.seam.validationFailed</literal> — called when JSF validation fails</para></listitem>
- <listitem><para><literal>org.jboss.seam.noConversation</literal> — called when there is no long running conversation and a long running conversation is required</para></listitem>
- <listitem><para><literal>org.jboss.seam.preSetVariable.<name></literal> — called when the context variable <name> is set</para></listitem>
- <listitem><para><literal>org.jboss.seam.postSetVariable.<name></literal> — called when the context variable <name> is set</para></listitem>
- <listitem><para><literal>org.jboss.seam.preRemoveVariable.<name></literal> — called when the context variable <name> is unset</para></listitem>
- <listitem><para><literal>org.jboss.seam.postRemoveVariable.<name></literal> — called when the context variable <name> is unset</para></listitem>
- <listitem><para><literal>org.jboss.seam.preDestroyContext.<SCOPE></literal> — called before the <SCOPE> context is destroyed</para></listitem>
- <listitem><para><literal>org.jboss.seam.postDestroyContext.<SCOPE></literal> — called after the <SCOPE> context is destroyed</para></listitem>
- <listitem><para><literal>org.jboss.seam.beginConversation </literal>— called whenever a long-running conversation begins</para></listitem>
- <listitem><para><literal>org.jboss.seam.endConversation </literal>— called whenever a long-running conversation ends</para></listitem>
- <listitem><para><literal>org.jboss.seam.beginPageflow.<name> </literal>— called when the pageflow <name> begins</para></listitem>
- <listitem><para><literal>org.jboss.seam.endPageflow.<name> </literal>— called when the pageflow <name> ends</para></listitem>
- <listitem><para><literal>org.jboss.seam.createProcess.<name> </literal>— called when the process <name> is created</para></listitem>
- <listitem><para><literal>org.jboss.seam.endProcess.<name> </literal>— called when the process <name> ends</para></listitem>
- <listitem><para><literal>org.jboss.seam.initProcess.<name> </literal>— called when the process <name> is associated with the conversation</para></listitem>
- <listitem><para><literal>org.jboss.seam.initTask.<name> </literal>— called when the task <name> is associated with the conversation</para></listitem>
- <listitem><para><literal>org.jboss.seam.startTask.<name> </literal>— called when the task <name> is started</para></listitem>
- <listitem><para><literal>org.jboss.seam.endTask.<name> </literal>— called when the task <name> is ended</para></listitem>
- <listitem><para><literal>org.jboss.seam.postCreate.<name> </literal>— called when the component <name> is created</para></listitem>
- <listitem><para><literal>org.jboss.seam.preDestroy.<name> </literal>— called when the component <name> is destroyed</para></listitem>
- <listitem><para><literal>org.jboss.seam.beforePhase </literal>— called before the start of a JSF phase</para></listitem>
- <listitem><para><literal>org.jboss.seam.afterPhase </literal>— called after the end of a JSF phase</para></listitem>
- <listitem><para><literal>org.jboss.seam.postInitialization </literal>— called when Seam has initialized and started up all components</para></listitem>
- <listitem><para><literal>org.jboss.seam.postAuthenticate.<name> </literal>— called after a user is authenticated</para></listitem>
- <listitem><para><literal>org.jboss.seam.preAuthenticate.<name> </literal>— called before attempting to authenticate a user</para></listitem>
- <listitem><para><literal>org.jboss.seam.notLoggedIn</literal> — called there is no authenticated user and authentication is required</para></listitem>
- <listitem><para><literal>org.jboss.seam.rememberMe</literal> — occurs when Seam security detects the username in a cookie</para></listitem>
- <listitem><para><literal>org.jboss.seam.exceptionHandled.<Type></literal> — called when an uncaught exception is handled by Seam</para></listitem>
- <listitem><para><literal>org.jboss.seam.exceptionHandled</literal> — called when an uncaught exception is handled by Seam</para></listitem>
- <listitem><para><literal>org.jboss.seam.exceptionNotHandled</literal> — called when there was no handler for an uncaught exception</para></listitem>
+ <listitem><para><literal>org.jboss.seam.validationFailed</literal> — called when JSF validation fails</para></listitem>
+ <listitem><para><literal>org.jboss.seam.noConversation</literal> — called when there is no long running conversation and a long running conversation is required</para></listitem>
+ <listitem><para><literal>org.jboss.seam.preSetVariable.<name></literal> — called when the context variable <name> is set</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postSetVariable.<name></literal> — called when the context variable <name> is set</para></listitem>
+ <listitem><para><literal>org.jboss.seam.preRemoveVariable.<name></literal> — called when the context variable <name> is unset</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postRemoveVariable.<name></literal> — called when the context variable <name> is unset</para></listitem>
+ <listitem><para><literal>org.jboss.seam.preDestroyContext.<SCOPE></literal> — called before the <SCOPE> context is destroyed</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postDestroyContext.<SCOPE></literal> — called after the <SCOPE> context is destroyed</para></listitem>
+ <listitem><para><literal>org.jboss.seam.beginConversation </literal>— called whenever a long-running conversation begins</para></listitem>
+ <listitem><para><literal>org.jboss.seam.endConversation </literal>— called whenever a long-running conversation ends</para></listitem>
+ <listitem><para><literal>org.jboss.seam.beginPageflow.<name> </literal>— called when the pageflow <name> begins</para></listitem>
+ <listitem><para><literal>org.jboss.seam.endPageflow.<name> </literal>— called when the pageflow <name> ends</para></listitem>
+ <listitem><para><literal>org.jboss.seam.createProcess.<name> </literal>— called when the process <name> is created</para></listitem>
+ <listitem><para><literal>org.jboss.seam.endProcess.<name> </literal>— called when the process <name> ends</para></listitem>
+ <listitem><para><literal>org.jboss.seam.initProcess.<name> </literal>— called when the process <name> is associated with the conversation</para></listitem>
+ <listitem><para><literal>org.jboss.seam.initTask.<name> </literal>— called when the task <name> is associated with the conversation</para></listitem>
+ <listitem><para><literal>org.jboss.seam.startTask.<name> </literal>— called when the task <name> is started</para></listitem>
+ <listitem><para><literal>org.jboss.seam.endTask.<name> </literal>— called when the task <name> is ended</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postCreate.<name> </literal>— called when the component <name> is created</para></listitem>
+ <listitem><para><literal>org.jboss.seam.preDestroy.<name> </literal>— called when the component <name> is destroyed</para></listitem>
+ <listitem><para><literal>org.jboss.seam.beforePhase </literal>— called before the start of a JSF phase</para></listitem>
+ <listitem><para><literal>org.jboss.seam.afterPhase </literal>— called after the end of a JSF phase</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postInitialization </literal>— called when Seam has initialized and started up all components</para></listitem>
+ <listitem><para><literal>org.jboss.seam.postAuthenticate.<name> </literal>— called after a user is authenticated</para></listitem>
+ <listitem><para><literal>org.jboss.seam.preAuthenticate.<name> </literal>— called before attempting to authenticate a user</para></listitem>
+ <listitem><para><literal>org.jboss.seam.notLoggedIn</literal> — called there is no authenticated user and authentication is required</para></listitem>
+ <listitem><para><literal>org.jboss.seam.rememberMe</literal> — occurs when Seam security detects the username in a cookie</para></listitem>
+ <listitem><para><literal>org.jboss.seam.exceptionHandled.<Type></literal> — called when an uncaught exception is handled by Seam</para></listitem>
+ <listitem><para><literal>org.jboss.seam.exceptionHandled</literal> — called when an uncaught exception is handled by Seam</para></listitem>
+ <listitem><para><literal>org.jboss.seam.exceptionNotHandled</literal> — called when there was no handler for an uncaught exception</para></listitem>
</itemizedlist>
<para>
1.20 +1 -1 jboss-seam/doc/reference/en/modules/framework.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: framework.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/framework.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- framework.xml 29 Mar 2007 05:08:56 -0000 1.19
+++ framework.xml 15 Jun 2007 07:36:20 -0000 1.20
@@ -20,7 +20,7 @@
<para>
We should emphasize that the framework is extremely simple,
just a handful of simple classes that are easy to understand
- and extend. The "magic" is in Seam itself—the same magic
+ and extend. The "magic" is in Seam itself—the same magic
you use when creating any Seam application even without using
this framework.
</para>
1.10 +64 -64 jboss-seam/doc/reference/en/modules/itext.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: itext.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/itext.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -b -r1.9 -r1.10
--- itext.xml 13 Jun 2007 22:08:41 -0000 1.9
+++ itext.xml 15 Jun 2007 07:36:20 -0000 1.10
@@ -56,7 +56,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>type</literal> — The type of the document to be produced.
+ <literal>type</literal> — The type of the document to be produced.
Valid values are <literal>PDF</literal>, <literal>RTF</literal> and
<literal>HTML</literal> modes. Seam defaults to PDF generation, and many
of the features only work correctly when generating PDF documents.</para>
@@ -65,7 +65,7 @@
<listitem>
<para>
- <literal>pageSize</literal> — The size of the page to be generate.
+ <literal>pageSize</literal> — The size of the page to be generate.
The most commonly used values would be <literal>LETTER</literal> and
<literal>A4</literal>. A full list of supported pages sizes can be found
in <literal>com.lowagie.text.PageSize</literal> class. Alternatively,
@@ -74,7 +74,7 @@
</listitem>
<listitem>
<para>
- <literal>orientation</literal> — The orientation of the page.
+ <literal>orientation</literal> — The orientation of the page.
Valid values are <literal>portrait</literal> and
<literal>landscape</literal>. In landscape mode, the height and width page
size values are reversed. </para>
@@ -83,12 +83,12 @@
<listitem>
<para>
- <literal>margins</literal> — The left, right, top and bottom
+ <literal>margins</literal> — The left, right, top and bottom
margin values. </para>
</listitem>
<listitem>
<para>
- <literal>marginMirroring</literal> — Indicates that margin
+ <literal>marginMirroring</literal> — Indicates that margin
settings should be reversed an alternating pages.</para>
</listitem>
</itemizedlist>
@@ -202,12 +202,12 @@
</listitem>
<listitem>
<para>
- <literal>spacingBefore</literal> — The blank space to be inserted
+ <literal>spacingBefore</literal> — The blank space to be inserted
before the element. </para>
</listitem>
<listitem>
<para>
- <literal>spacingAfter</literal> — The blank space to be inserted
+ <literal>spacingAfter</literal> — The blank space to be inserted
after the element.</para>
</listitem>
<listitem>
@@ -270,7 +270,7 @@
<itemizedlist>
<listitem>
- <para><literal>value</literal> — The value to be displayed. This will
+ <para><literal>value</literal> — The value to be displayed. This will
typically be a value binding expression.</para>
</listitem>
</itemizedlist>
@@ -319,18 +319,18 @@
<itemizedlist>
<listitem>
- <para><literal>family</literal> — The font family. One of:
+ <para><literal>family</literal> — The font family. One of:
<literal>COURIER</literal>, <literal>HELVETICA</literal>,
<literal>TIMES-ROMAN</literal>, <literal>SYMBOL</literal> or
<literal>ZAPFDINGBATS</literal>.</para>
</listitem>
<listitem>
- <para><literal>size</literal> — The point size of the font.</para>
+ <para><literal>size</literal> — The point size of the font.</para>
</listitem>
<listitem>
- <para><literal>style</literal> — The font styles. Any combination of :
+ <para><literal>style</literal> — The font styles. Any combination of :
<literal>NORMAL</literal>, <literal>BOLD</literal>,
<literal>ITALIC</literal>, <literal>OBLIQUE</literal>,
<literal>UNDERLINE</literal>, <literal>LINE-THROUGH</literal></para>
@@ -425,40 +425,40 @@
<itemizedlist>
<listitem>
- <para><literal>resource</literal> — The location of the image resource
+ <para><literal>resource</literal> — The location of the image resource
to be included. Resources should be relative to the document root of the web
application. </para>
</listitem>
<listitem>
- <para><literal>value</literal> — A resource name or a method
+ <para><literal>value</literal> — A resource name or a method
expression binding to an application-generated image. </para>
</listitem>
<listitem>
- <para><literal>rotation</literal> — The rotation of the image in
+ <para><literal>rotation</literal> — The rotation of the image in
degrees. </para>
</listitem>
<listitem>
- <para><literal>height</literal> — The height of the image. </para>
+ <para><literal>height</literal> — The height of the image. </para>
</listitem>
<listitem>
- <para><literal>width</literal> — The width of the image. </para>
+ <para><literal>width</literal> — The width of the image. </para>
</listitem>
<listitem>
<para>
- <literal>alignment</literal>— The alignment of the image. (see
+ <literal>alignment</literal>— The alignment of the image. (see
<xref linkend="itext.alignment"/> for possible values) </para>
</listitem>
<listitem>
<para>
- <literal>alt</literal> — Alternative text representation for the
+ <literal>alt</literal> — Alternative text representation for the
image.</para>
</listitem>
<listitem>
@@ -473,12 +473,12 @@
</listitem>
<listitem>
<para>
- <literal>spacingBefore</literal> — The blank space to be inserted
+ <literal>spacingBefore</literal> — The blank space to be inserted
before the element.</para>
</listitem>
<listitem>
<para>
- <literal>spacingAfter</literal> — The blank space to be inserted
+ <literal>spacingAfter</literal> — The blank space to be inserted
after the element.</para>
</listitem>
@@ -502,7 +502,7 @@
</listitem>
<listitem>
<para>
- <literal>scalePercent</literal> — The scaling factor (as a
+ <literal>scalePercent</literal> — The scaling factor (as a
percentage) to use for the image. This can be expressed as a single
percentage value or as two percentage values representing separate x and y
scaling percentages.</para>
@@ -561,14 +561,14 @@
<itemizedlist>
<listitem>
- <para><literal>name</literal> — The name of an in-document anchor
+ <para><literal>name</literal> — The name of an in-document anchor
destination.</para>
</listitem>
<listitem>
- <para><literal>reference</literal> — The destination the link refers
+ <para><literal>reference</literal> — The destination the link refers
to. Links to other points in the document should begin with a "#". For
example, "#link1" to refer to an anchor postion with a
<literal>name</literal> of <literal>link1</literal>. Links may also be a
@@ -635,13 +635,13 @@
<listitem>
<para>
- <literal>alignment</literal> — The alignment of the header/footer
+ <literal>alignment</literal> — The alignment of the header/footer
box section. (see <xref linkend="itext.alignment"/> for alignment values)</para>
</listitem>
<listitem>
- <para><literal>backgroundColor</literal> — The background color of the
+ <para><literal>backgroundColor</literal> — The background color of the
header/footer box. (see <xref linkend="itext.colors"/> for color values)
</para>
</listitem>
@@ -650,7 +650,7 @@
<listitem>
- <para><literal>borderColor</literal> — The border color of the
+ <para><literal>borderColor</literal> — The border color of the
header/footer box. Individual border sides can be set using
<literal>borderColorLeft</literal>, <literal>borderColorRight</literal>,
<literal>borderColorTop</literal> and
@@ -659,7 +659,7 @@
</listitem>
<listitem>
<para>
- <literal>borderWidth</literal> — The width of the border.
+ <literal>borderWidth</literal> — The width of the border.
Inidvidual border sides can be specified using
<literal>borderWidthLeft</literal>, <literal>borderWidthRight</literal>,
<literal>borderWidthTop</literal> and
@@ -762,18 +762,18 @@
<listitem>
<para>
- <literal>alignment</literal> — The alignment of the header/footer
+ <literal>alignment</literal> — The alignment of the header/footer
box section. (see <xref linkend="itext.alignment"/> for alignment values)</para>
</listitem>
<listitem>
- <para><literal>number</literal> — The chapter number. Every chapter
+ <para><literal>number</literal> — The chapter number. Every chapter
should be assigned a chapter number.</para>
</listitem>
<listitem>
- <para><literal>numberDepth</literal> — The depth of numbering for
+ <para><literal>numberDepth</literal> — The depth of numbering for
section. All sections are numbered relative to their surrounding
chapter/sections. The fourth section of of the first section of chapter
three would be section 3.1.4, if displayed at the default number depth of
@@ -883,37 +883,37 @@
<itemizedlist>
<listitem>
- <para><literal>style</literal> — The ordering/bulleting style of list.
+ <para><literal>style</literal> — The ordering/bulleting style of list.
One of: <literal>NUMBERED</literal>, <literal>LETTERED</literal>,
<literal>GREEK</literal>, <literal>ROMAN</literal>,
<literal>ZAPFDINGBATS</literal>, <literal>ZAPFDINGBATS_NUMBER</literal>.
If no style is given, the list items are bulleted.</para>
</listitem>
<listitem>
- <para><literal>listSymbol</literal> — For bulleted lists, specifies
+ <para><literal>listSymbol</literal> — For bulleted lists, specifies
the bullet symbol. </para>
</listitem>
<listitem>
- <para><literal>indent</literal> — The indentation level of the
+ <para><literal>indent</literal> — The indentation level of the
list.</para>
</listitem>
<listitem>
- <para><literal>lowerCase</literal> — For list styles using letters,
+ <para><literal>lowerCase</literal> — For list styles using letters,
indicates whether the letters should be lower case.</para>
</listitem>
<listitem>
- <para><literal>charNumber</literal> — For ZAPFDINGBATS, indicates the
+ <para><literal>charNumber</literal> — For ZAPFDINGBATS, indicates the
character code of the bullet character.</para>
</listitem>
<listitem>
- <para><literal>numberType</literal> — For ZAPFDINGBATS_NUMBER,
+ <para><literal>numberType</literal> — For ZAPFDINGBATS_NUMBER,
indicates the numbering style.</para>
</listitem>
@@ -962,33 +962,33 @@
<listitem>
<para>
- <literal>alignment</literal> — The alignment of the header/footer
+ <literal>alignment</literal> — The alignment of the header/footer
box section. (see <xref linkend="itext.alignment"/> for alignment values)</para>
</listitem>
<listitem>
- <para><literal>alignment</literal> — The alignment of the list item.
+ <para><literal>alignment</literal> — The alignment of the list item.
(See <xref linkend="itext.alignment"/> for possible values)</para>
</listitem>
<listitem>
- <para><literal>indentationLeft</literal> — The left indentation
+ <para><literal>indentationLeft</literal> — The left indentation
amount.</para>
</listitem>
<listitem>
- <para><literal>indentationRight</literal> — The right indentation
+ <para><literal>indentationRight</literal> — The right indentation
amount.</para>
</listitem>
<listitem>
- <para><literal>listSymbol</literal> — Overrides the default list
+ <para><literal>listSymbol</literal> — Overrides the default list
symbol for this list item.</para>
</listitem>
@@ -1061,14 +1061,14 @@
<listitem>
- <para><literal>columns</literal> — The number of columns (cells) that
+ <para><literal>columns</literal> — The number of columns (cells) that
make up a table row.</para>
</listitem>
<listitem>
- <para><literal>widths</literal> — The relative widths of each column.
+ <para><literal>widths</literal> — The relative widths of each column.
There should be one value for each column. For example: widths="2 1 1" would
indicate that there are 3 columns and the first column should be twice the
size of the second and third column.</para>
@@ -1077,7 +1077,7 @@
<listitem>
- <para><literal>headerRows</literal> — The initial number of rows which
+ <para><literal>headerRows</literal> — The initial number of rows which
are considered to be headers or footer rows and should be repeated if the
table spans multiple pages. </para>
</listitem>
@@ -1085,7 +1085,7 @@
<listitem>
- <para><literal>footerRows</literal> — The number of rows that are
+ <para><literal>footerRows</literal> — The number of rows that are
considered to be footer rows. This value is subtracted from the
<literal>headerRows</literal> value. If document has 2 rows which make
up the header and one row that makes up the footer,
@@ -1096,12 +1096,12 @@
<listitem>
- <para><literal>widthPercentage</literal> — The percentage of the page
+ <para><literal>widthPercentage</literal> — The percentage of the page
width that the table spans.</para>
</listitem>
<listitem>
- <para><literal>horizontalAlignment</literal> — The horizontal
+ <para><literal>horizontalAlignment</literal> — The horizontal
alignment of the table. (See <xref linkend="itext.alignment"/> for possible
values)</para>
</listitem>
@@ -1135,13 +1135,13 @@
<listitem>
- <para><literal>spacingBefore</literal> — The blank space to be
+ <para><literal>spacingBefore</literal> — The blank space to be
inserted before the element.</para>
</listitem>
<listitem>
- <para><literal>spacingAfter</literal> — The blank space to be inserted
+ <para><literal>spacingAfter</literal> — The blank space to be inserted
after the element.</para>
</listitem>
<listitem>
@@ -1212,7 +1212,7 @@
<listitem>
<para>
- <literal>colspan</literal> — Cells can span more than one column
+ <literal>colspan</literal> — Cells can span more than one column
by declaring a <literal>colspan</literal> greater than 1. Tables do not have
the ability to span across multiple rows. </para>
</listitem>
@@ -1220,7 +1220,7 @@
<listitem>
- <para><literal>horizontalAlignment</literal> — The horizontal
+ <para><literal>horizontalAlignment</literal> — The horizontal
alignment of the cell. (see <xref linkend="itext.alignment"/> for possible
values)</para>
</listitem>
@@ -1228,7 +1228,7 @@
<listitem>
- <para><literal>verticalAlignment</literal> — The vertical alignment of
+ <para><literal>verticalAlignment</literal> — The vertical alignment of
the cell. (see <xref linkend="itext.alignment"/> for possible values)</para>
</listitem>
@@ -1236,7 +1236,7 @@
<listitem>
<para>
- <literal>padding</literal> — Padding on a given side can also be
+ <literal>padding</literal> — Padding on a given side can also be
specified using <literal>paddingLeft</literal>,
<literal>paddingRight</literal>, <literal>paddingTop</literal> and
<literal>paddingBottom</literal>.</para>
@@ -1846,7 +1846,7 @@
<listitem>
<para>
- <literal>key</literal> — The series name. </para>
+ <literal>key</literal> — The series name. </para>
</listitem>
<listitem>
<para>
@@ -2009,23 +2009,23 @@
<listitem>
<para>
- <literal>color</literal> — The color value. For gradient colors, this
+ <literal>color</literal> — The color value. For gradient colors, this
the starting color. <link linkend="itext.colors"/>
</para>
</listitem>
<listitem>
<para>
- <literal>color2</literal> — For gradient colors, this is the color
+ <literal>color2</literal> — For gradient colors, this is the color
that ends the gradient. </para>
</listitem>
<listitem>
<para>
- <literal>point</literal> — The co-ordinates where the gradient color
+ <literal>point</literal> — The co-ordinates where the gradient color
begins. </para>
</listitem>
<listitem>
<para>
- <literal>point2</literal> — The co-ordinates where the gradient color
+ <literal>point2</literal> — The co-ordinates where the gradient color
ends. </para>
</listitem>
</itemizedlist>
@@ -2068,37 +2068,37 @@
<listitem>
<para>
- <literal>width</literal> — The width of the stroke. </para>
+ <literal>width</literal> — The width of the stroke. </para>
</listitem>
<listitem>
- <para><literal>cap</literal> — The line cap type. Valid values are
+ <para><literal>cap</literal> — The line cap type. Valid values are
<literal>butt</literal>, <literal>round</literal> and
<literal>square</literal></para>
</listitem>
<listitem>
- <para><literal>join</literal> — The line join type. Valid values are
+ <para><literal>join</literal> — The line join type. Valid values are
<literal>miter</literal>, <literal>round</literal> and
<literal>bevel</literal></para>
</listitem>
<listitem>
<para>
- <literal>miterLimit</literal> — For miter joins, this value is the
+ <literal>miterLimit</literal> — For miter joins, this value is the
limit of the size of the join. </para>
</listitem>
<listitem>
<para>
- <literal>dash</literal> — The dash value sets the dash pattern to be
+ <literal>dash</literal> — The dash value sets the dash pattern to be
used to draw the line. The space separated integers indicate the length of each
alternating drawn and undrawn segments. </para>
</listitem>
<listitem>
<para>
- <literal>dashPhase</literal> — The dash phase indicates the offset
+ <literal>dashPhase</literal> — The dash phase indicates the offset
into the dash pattern that the the line should be drawn with. </para>
</listitem>
</itemizedlist>
1.31 +2 -2 jboss-seam/doc/reference/en/modules/jbpm.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: jbpm.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/jbpm.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -b -r1.30 -r1.31
--- jbpm.xml 14 May 2007 00:55:08 -0000 1.30
+++ jbpm.xml 15 Jun 2007 07:36:20 -0000 1.31
@@ -399,8 +399,8 @@
<para>
If we are beginning the pageflow during the <literal>RENDER_RESPONSE</literal>
- phase—during a <literal>@Factory</literal> or <literal>@Create</literal>
- method, for example—we consider ourselves to be already at the page being
+ phase—during a <literal>@Factory</literal> or <literal>@Create</literal>
+ method, for example—we consider ourselves to be already at the page being
rendered, and use a <literal><start-page></literal> node as the first node
in the pageflow, as in the example above.
</para>
1.20 +25 -25 jboss-seam/doc/reference/en/modules/mail.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: mail.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/mail.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- mail.xml 23 Apr 2007 22:26:59 -0000 1.19
+++ mail.xml 15 Jun 2007 07:36:20 -0000 1.20
@@ -12,7 +12,7 @@
<section>
<title>Creating a message</title>
- <para>You don't need to learn a whole new templating language to use Seam Mail—an email is just facelet!</para>
+ <para>You don't need to learn a whole new templating language to use Seam Mail—an email is just facelet!</para>
<programlisting><![CDATA[<m:message xmlns="http://www.w3.org/1999/xhtml"
xmlns:m="http://jboss.com/products/seam/mail"
@@ -371,24 +371,24 @@
<itemizedlist>
<listitem>
<para>
- <literal>importance</literal> — low, normal or high. By default normal, this sets the
+ <literal>importance</literal> — low, normal or high. By default normal, this sets the
importance of the mail message.
</para>
</listitem>
<listitem>
<para>
- <literal>precedence</literal> — sets the precedence of the message (e.g. bulk).
+ <literal>precedence</literal> — sets the precedence of the message (e.g. bulk).
</para>
</listitem>
<listitem>
<para>
- <literal>requestReadReceipt</literal> — by default false, if set, a read receipt will be
+ <literal>requestReadReceipt</literal> — by default false, if set, a read receipt will be
request will be added, with the read receipt being sent to the <literal>From:</literal> address.
</para>
</listitem>
<listitem>
<para>
- <literal>urlBase</literal> — If set, the value is prepended to the <literal>requestContextPath</literal> allowing
+ <literal>urlBase</literal> — If set, the value is prepended to the <literal>requestContextPath</literal> allowing
you to use components such as <literal><h:graphicImage></literal> in your emails.
</para>
</listitem>
@@ -404,12 +404,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — the name the email should come from.
+ <literal>name</literal> — the name the email should come from.
</para>
</listitem>
<listitem>
<para>
- <literal>address</literal> — the email address the email should come from.
+ <literal>address</literal> — the email address the email should come from.
</para>
</listitem>
</itemizedlist>
@@ -424,7 +424,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>address</literal> — the email address the email should come from.
+ <literal>address</literal> — the email address the email should come from.
</para>
</listitem>
</itemizedlist>
@@ -440,12 +440,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — the name of the recipient.
+ <literal>name</literal> — the name of the recipient.
</para>
</listitem>
<listitem>
<para>
- <literal>address</literal> — the email address of the recipient.
+ <literal>address</literal> — the email address of the recipient.
</para>
</listitem>
</itemizedlist>
@@ -461,12 +461,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — the name of the recipient.
+ <literal>name</literal> — the name of the recipient.
</para>
</listitem>
<listitem>
<para>
- <literal>address</literal> — the email address of the recipient.
+ <literal>address</literal> — the email address of the recipient.
</para>
</listitem>
</itemizedlist>
@@ -482,12 +482,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — the name of the recipient.
+ <literal>name</literal> — the name of the recipient.
</para>
</listitem>
<listitem>
<para>
- <literal>address</literal> — the email address of the recipient.
+ <literal>address</literal> — the email address of the recipient.
</para>
</listitem>
</itemizedlist>
@@ -502,12 +502,12 @@
<itemizedlist>
<listitem>
<para>
- <literal>name</literal> — The name of the header to add (e.g. <literal>X-Sent-From</literal>).
+ <literal>name</literal> — The name of the header to add (e.g. <literal>X-Sent-From</literal>).
</para>
</listitem>
<listitem>
<para>
- <literal>value</literal> — The value of the header to add (e.g. <literal>JBoss Seam</literal>).
+ <literal>value</literal> — The value of the header to add (e.g. <literal>JBoss Seam</literal>).
</para>
</listitem>
</itemizedlist>
@@ -522,33 +522,33 @@
<itemizedlist>
<listitem>
<para>
- <literal>value</literal> — The file to attach:
+ <literal>value</literal> — The file to attach:
</para>
<itemizedlist>
<listitem>
<para>
- <literal>String</literal> — A <literal>String</literal> is interpreted as a path to file within the classpath
+ <literal>String</literal> — A <literal>String</literal> is interpreted as a path to file within the classpath
</para>
</listitem>
<listitem>
<para>
- <literal>java.io.File</literal> — An EL expression can reference a <literal>File</literal> object
+ <literal>java.io.File</literal> — An EL expression can reference a <literal>File</literal> object
</para>
</listitem>
<listitem>
<para>
- <literal>java.net.URL</literal> — An EL expression can reference a <literal>URL</literal> object
+ <literal>java.net.URL</literal> — An EL expression can reference a <literal>URL</literal> object
</para>
</listitem>
<listitem>
<para>
- <literal>java.io.InputStream</literal> — An EL expression can reference an <literal>InputStream</literal>.
+ <literal>java.io.InputStream</literal> — An EL expression can reference an <literal>InputStream</literal>.
In this case both a <literal>fileName</literal> and a <literal>contentType</literal> must be specified.
</para>
</listitem>
<listitem>
<para>
- <literal>byte[]</literal> — An EL expression can reference an <literal>byte[]</literal>.
+ <literal>byte[]</literal> — An EL expression can reference an <literal>byte[]</literal>.
In this case both a <literal>fileName</literal> and a <literal>contentType</literal> must be specified.
</para>
</listitem>
@@ -571,12 +571,12 @@
</listitem>
<listitem>
<para>
- <literal>fileName</literal> — Specify the file name to use for the attached file.
+ <literal>fileName</literal> — Specify the file name to use for the attached file.
</para>
</listitem>
<listitem>
<para>
- <literal>contentType</literal> — Specify the MIME type of the attached file
+ <literal>contentType</literal> — Specify the MIME type of the attached file
</para>
</listitem>
</itemizedlist>
@@ -599,7 +599,7 @@
<itemizedlist>
<listitem>
<para>
- <literal>type</literal> — If set to <literal>plain</literal> then a plain text email will be generated otherwise an HTML email is generated.
+ <literal>type</literal> — If set to <literal>plain</literal> then a plain text email will be generated otherwise an HTML email is generated.
</para>
</listitem>
</itemizedlist>
1.10 +2 -2 jboss-seam/doc/reference/en/modules/persistence.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: persistence.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/persistence.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -b -r1.9 -r1.10
--- persistence.xml 17 Apr 2007 09:45:40 -0000 1.9
+++ persistence.xml 15 Jun 2007 07:36:20 -0000 1.10
@@ -16,7 +16,7 @@
Seam grew out of the frustration of the Hibernate team with the
statelessness typical of the previous generation of Java application
architectures. The state management architecture of Seam was originally
- designed to solve problems relating to persistence—in particular
+ designed to solve problems relating to persistence—in particular
problems associated with <emphasis>optimistic transaction processing</emphasis>.
Scalable online applications always use optimistic transactions. An atomic
(database/JTA) level transaction should not span a user interaction unless
@@ -124,7 +124,7 @@
<para>
This pattern is usually implemented as a single transaction which spans the entire request.
There are several problems with this implementation, the most serious being that we
- can never be sure that a transaction is successful until we commit it—but by the
+ can never be sure that a transaction is successful until we commit it—but by the
time the "open session in view" transaction is committed, the view is fully rendered, and
the rendered response may already have been flushed to the client. How can we notify the
user that their transaction was unsuccessful?
1.86 +5 -5 jboss-seam/doc/reference/en/modules/tutorial.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: tutorial.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/tutorial.xml,v
retrieving revision 1.85
retrieving revision 1.86
diff -u -b -r1.85 -r1.86
--- tutorial.xml 9 Jun 2007 02:35:39 -0000 1.85
+++ tutorial.xml 15 Jun 2007 07:36:20 -0000 1.86
@@ -828,7 +828,7 @@
<para> But <literal>MessageManagerBean</literal> is also responsible for fetching the list of messages
the first time we navigate to the message list page. There are various ways the user could navigate
- to the page, and not all of them are preceded by a JSF action—the user might have
+ to the page, and not all of them are preceded by a JSF action—the user might have
bookmarked the page, for example. So the job of fetching the message list takes place in a Seam
<emphasis>factory method</emphasis>, instead of in an action listener method. </para>
@@ -2540,7 +2540,7 @@
<para> If we navigate to this page from a bookmark, how does the data used by the
<literal><h:dataTable></literal> actually get initialized? Well, what happens is that
- the <literal>Blog</literal> is retrieved lazily—"pulled"—when needed, by a Seam
+ the <literal>Blog</literal> is retrieved lazily—"pulled"—when needed, by a Seam
component named <literal>blog</literal>. This is the opposite flow of control to what is usual in
traditional web action-based frameworks like Struts. </para>
@@ -2577,7 +2577,7 @@
</callout>
<callout arearefs="blog-unwrap">
<para> The <literal>@Unwrap</literal> annotation tells Seam to provide the return value of
- the method—the <literal>Blog</literal>—instead of the actual
+ the method—the <literal>Blog</literal>—instead of the actual
<literal>BlogService</literal> component to clients. This is the Seam
<emphasis>manager component pattern</emphasis>. </para>
</callout>
@@ -2769,14 +2769,14 @@
</pages>]]></programlisting>
</example>
- <para> Notice that the example is using page actions for some other functionality—the login
+ <para> Notice that the example is using page actions for some other functionality—the login
challenge, and the pageview counter. Also notice the use of a parameter in the page action method
binding. This is not a standard feature of JSF EL, but Seam lets you use it, not just for page actions,
but also in JSF method bindings. </para>
<para> When the <literal>entry.xhtml</literal> page is requested, Seam first binds the page parameter
<literal>blogEntryId</literal> to the model, then runs the page action, which retrieves the needed
- data—the <literal>blogEntry</literal>—and places it in the Seam event context.
+ data—the <literal>blogEntry</literal>—and places it in the Seam event context.
Finally, the following is rendered: </para>
<example>
1.8 +1 -1 jboss-seam/doc/reference/en/modules/validation.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: validation.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/validation.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- validation.xml 8 Jun 2007 20:17:52 -0000 1.7
+++ validation.xml 15 Jun 2007 07:36:21 -0000 1.8
@@ -111,7 +111,7 @@
<para>
This approach <emphasis>defines</emphasis> constraints on the model, and
- <emphasis>presents</emphasis> constraint violations in the view—a
+ <emphasis>presents</emphasis> constraint violations in the view—a
significantly better design.
</para>
1.11 +14 -18 jboss-seam/doc/reference/en/modules/xml.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: xml.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/xml.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -b -r1.10 -r1.11
--- xml.xml 9 Jun 2007 02:35:39 -0000 1.10
+++ xml.xml 15 Jun 2007 07:36:21 -0000 1.11
@@ -44,12 +44,12 @@
<itemizedlist>
<listitem>
- <para> Configure components that have been installed automatically—including both built-in
+ <para> Configure components that have been installed automatically—including both built-in
components, and application components that have been annotated with the
<literal>@Name</literal> annotation and picked up by Seam's deployment scanner. </para>
</listitem>
<listitem>
- <para> Install classes with no <literal>@Name</literal> annotation as Seam components—this
+ <para> Install classes with no <literal>@Name</literal> annotation as Seam components—this
is most useful for certain kinds of infrastructural components which can be installed multiple
times different names (for example Seam-managed persistence contexts). </para>
</listitem>
@@ -367,8 +367,6 @@
<property name="jndiPattern">@jndiPattern@</property>
</component>
- <component name="org.jboss.sean.core.ejb" installed="@embeddedEjb@" />
-
</components>]]></programlisting>
<para>
@@ -388,8 +386,6 @@
<core:init debug="true" jndi-pattern="@jndiPattern@"/>
- <core:ejb installed="@embeddedEjb@"/>
-
</components>]]></programlisting>
<para>
@@ -503,40 +499,40 @@
<itemizedlist>
<listitem>
- <para>components — <literal>http://jboss.com/products/seam/components</literal></para>
+ <para>components — <literal>http://jboss.com/products/seam/components</literal></para>
</listitem>
<listitem>
- <para>core — <literal>http://jboss.com/products/seam/core</literal></para>
+ <para>core — <literal>http://jboss.com/products/seam/core</literal></para>
</listitem>
<listitem>
- <para>drools — <literal>http://jboss.com/products/seam/drools</literal></para>
+ <para>drools — <literal>http://jboss.com/products/seam/drools</literal></para>
</listitem>
<listitem>
- <para>framework — <literal>http://jboss.com/products/seam/framework</literal></para>
+ <para>framework — <literal>http://jboss.com/products/seam/framework</literal></para>
</listitem>
<listitem>
- <para>jms — <literal>http://jboss.com/products/seam/jms</literal></para>
+ <para>jms — <literal>http://jboss.com/products/seam/jms</literal></para>
</listitem>
<listitem>
- <para>remoting — <literal>http://jboss.com/products/seam/remoting</literal></para>
+ <para>remoting — <literal>http://jboss.com/products/seam/remoting</literal></para>
</listitem>
<listitem>
- <para>theme — <literal>http://jboss.com/products/seam/theme</literal></para>
+ <para>theme — <literal>http://jboss.com/products/seam/theme</literal></para>
</listitem>
<listitem>
- <para>security — <literal>http://jboss.com/products/seam/security</literal></para>
+ <para>security — <literal>http://jboss.com/products/seam/security</literal></para>
</listitem>
<listitem>
- <para>mail — <literal>http://jboss.com/products/seam/mail</literal></para>
+ <para>mail — <literal>http://jboss.com/products/seam/mail</literal></para>
</listitem>
<listitem>
- <para>web — <literal>http://jboss.com/products/seam/web</literal></para>
+ <para>web — <literal>http://jboss.com/products/seam/web</literal></para>
</listitem>
<listitem>
- <para>pdf — <literal>http://jboss.com/products/seam/pdf</literal></para>
+ <para>pdf — <literal>http://jboss.com/products/seam/pdf</literal></para>
</listitem>
<listitem>
- <para> spring — <literal>http://jboss.com/products/seam/spring</literal></para>
+ <para> spring — <literal>http://jboss.com/products/seam/spring</literal></para>
</listitem>
</itemizedlist>
More information about the jboss-cvs-commits
mailing list