Documentation on Block component needs warning text
---------------------------------------------------
Key: TAPESTRY-2583
URL: https://issues.apache.org/jira/browse/TAPESTRY-2583
Project: Tapestry
Issue Type: Improvement
Components: Documentation
Affects Versions: 4.1.5
Reporter: Albert Tumanov
The documentation page
http://tapestry.apache.org/tapestry4.1/components/general/block.html
says "When a Block component renders normally, it does absolutely nothing."
It is not quite correct, because the pageBeginRender() method of the Block will
always be executed
(even if the Block is never rendered).
And the method usually contains some expensive database calls that would better
be avoided.
I propose to add a warning text into the documentation, like this:
"NB: the pageBeginRender() method of the Block will always be executed (even if
the Block is never rendered)"
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
