[
https://issues.apache.org/jira/browse/TILES-571?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13807057#comment-13807057
]
Mck SembWever commented on TILES-571:
-------------------------------------
Regarding TilesConfigurer, that's spring and the documentation update belongs
in either
http://docs.spring.io/spring/docs/3.2.x/javadoc-api/org/springframework/web/servlet/view/tiles3/TilesConfigurer.html
or
http://docs.spring.io/spring/docs/3.2.x/spring-framework-reference/html/view.html#view-tiles-integrate
At Tiles i think the following page needs this information:
http://tiles.apache.org/framework/config-reference.html
but i'm unsure where to put it in or what will make most sense.
[~analogkid76] Being new to this and seeing this documentation from the
newcomer's perspective i'd appreciate your opinion on how this page really
should be improved.
> Please make the significance of underscore (_) in tiles definition filename
> more obvious
> ----------------------------------------------------------------------------------------
>
> Key: TILES-571
> URL: https://issues.apache.org/jira/browse/TILES-571
> Project: Tiles
> Issue Type: Task
> Affects Versions: 3.0.1
> Environment: Apache Tomcat 7.0.42, JSE 1.7.0_45, Windows
> Reporter: Eric E
> Assignee: Mck SembWever
> Priority: Minor
>
> In reading the Tiles documentation, it was not obvious to me that including
> an underscore (_) in my tiles definition filename would cause Tiles to
> interpret whatever follows the underscore as a locale.
> For example, in my TilesConfigurer configuration, I had the following:
> {code}
> <bean id="tilesConfigurer"
> class="org.springframework.web.servlet.view.tiles3.TilesConfigurer">
> <property name="definitions">
> <list>
> <value>/WEB-INF/templates/layouts.xml</value>
> <value>/WEB-INF/views/base_views.xml</value>
> </list>
> </property>
> </bean>
> {code}
> This caused Tiles, apparently, to assign the Locale "views" to the second
> definition. This was clearly not what I intended, and the side effect of
> this was that Tiles discarded the second definition, and my view contained in
> that definition could not be resolved.
> Only after spending some time with a debugger did I discover the code in
> org.apache.tiles.request.locale.PostfixedApplicationResource that causes this
> behaviour.
> It would be nice if the documentation more clearly warns developers about
> this so that others do not have to go through the same trouble.
--
This message was sent by Atlassian JIRA
(v6.1#6144)
